For more detailed documentation click here.
To install the base version of AtriumDB run:
$ pip install atriumdb
Clone the GitHub repository and change into its directory
$ git clone https://github.com/LaussenLabs/atriumdb
The instructions to build the C code on Linux are contained in two shell scripts in the repo tsc-lib/build_debug.sh and tsc-lib/build_release.sh. Once the two binaries are built they should be placed in a folder called bin in the sdk folder. However, it is recommended that you build the binaries using the provided Docker build container as it is a consistent build environment and contains all the necessary packages.
If you build using docker (recommended) it will cross compile both for Linux and Windows. First you build the docker image from the Dockerfile in the tsc-lib folder using the command:
$ docker build -t c-build tsc-lib
To build the docker container and the binaries for release you need edit the command below by changing "/path/to/atriumdb" to the path to the repository on your computer. Then run the command:
$ docker run --name c-build-release -v /path/to/atriumdb:/atriumdb --init -it c-build ./build_release.sh
If you want to build the binaries in debug mode use the command:
$ docker run --name c-build-debug -v /path/to/atriumdb:/atriumdb --init -it c-build ./build_debug.sh
NOTES:
- These commands will automatically place the built binaries in the proper folder in the SDK
- If you need to rebuild the binaries all you need to do is restart the container
- If you would rather run the build commands yourself inside the container just remove the ./build_release.sh from the end of the docker run command and it will give you a shell for the container
Once you have the binaries built, make sure that you have python build installed and you are in the sdk folder of the repo. Then run the below commands to build the python wheel file. Once built you can pip install it.
$ pip install build
$ cd sdk
$ python -m build