Home

User Guide

The wiki section of this repository provides details on the libraries that are provided within this "common" package.

All the libraries included are used within our primary kdb+ application which supported BuaBook. If you have any issues, please raise a GitHub issue and we will investigate.

Library Summary

The libraries included are:

• cargs.q: Enhanced command-line argument parser
• convert.q: Type conversion functions
• cron.q: Timer job scheduler
• csv.q: CSV file reader and writer
• event.q: Event manager
• file.q: File and folder discovery
• ipc.q: Inter-process communication
• log.q: Simple console logger, with color and log level configuration
• mail.q: Sending e-mail via mailx / mutt
• ns.q: Namespace and meta functionality
• os.q: Operating system abstraction library
• require.q: A dynamic code loading library
• slack.q: Send messages to Slack via WebHook
• terminal.q: Terminal window size tracking
• time.q: Time accessor and utility library
• type.q: Type checking and normalisation functions
• tz.q: Timezone conversion library
• util.q: Other utility functions
• wsc.q: WebSocket client connection library

Require Library Recommended

It is recommended that you use the Require library to load other libraries into a kdb+ process. To add Require into your process initialisation, please follow the initialisation section on the wiki.

If you choose not to use Require, you must ensure that all the dependencies between the libraries are fulfilled as part of your loading functionality.

Additional Libraries

Below is a list of libraries that are built on top of the kdb-common libraries:

• kdb-systemd - systemd Notification Interface for kdb
• kdb-elasticsearch - Elasticsearch Interface for kdb

If you have an open-source library built on top of kdb-common that you would like to list here, please modify this file and send me a pull request.

Licensing

This library is licensed under the Apache License 2.0:

A permissive license whose main conditions require preservation of copyright and license notices. Contributors provide an express grant of patent rights. Licensed works, modifications, and larger works may be distributed under different terms and without source code.

For more details, please see https://choosealicense.com/licenses/apache-2.0/.