Skip to content

memgraph/mgclient

Repository files navigation

Actions Status

mgclient

mgclient is a C library interface for Memgraph database.

Building and installing on Apple

To build and install mgclient from source you will need:

  • CMake version >= 3.8
  • OpenSSL version >= 1.0.2
  • Apple LLVM/clang >= 8.0.0

Once everything is in place, create a build directory inside the project root directory and configure the build by running CMake from it:

mkdir build
cd build
cmake ..

NOTE: Dealing with OpenSSL might be a bit tricky. If OpenSSL is not available on the system, please use, e.g., brew package manager to install OpenSSL with the following command:

brew install [email protected]

If cmake can't locate OpenSSL, please set OPENSSL_ROOT_DIR to a valid path. Examples follow:

# M1 with brew installed
cmake -DOPENSSL_ROOT_DIR="$(brew --prefix openssl)" ..

# Using only ls command
cmake -DOPENSSL_ROOT_DIR="$(ls -rd -- /usr/local/Cellar/[email protected]/* | head -n 1)" ..

After running CMake, you should see a Makefile in the build directory. Then you can build the project by running:

make

This will build two mgclient library flavours: a static library (named libmgclient.a) and a shared library (named libmgclient.dylib).

To install the libraries and corresponding header files run:

make install

This will install to system default installation directory. If you want to change this location, use -DCMAKE_INSTALL_PREFIX option when running CMake.

Building and installing on Linux

To build and install mgclient from source you will need:

  • CMake version >= 3.8
  • OpenSSL version >= 1.0.2
  • gcc >= 8 or clang >= 8

To install minimum compile dependencies on Debian / Ubuntu:

apt-get install -y git cmake make gcc g++ libssl-dev

On RedHat / CentOS / Fedora:

yum install -y git cmake make gcc gcc-c++ openssl-devel

Once everything is in place, create a build directory inside the source directory and configure the build by running CMake from it:

mkdir build
cd build
cmake ..

After running CMake, you should see a Makefile in the build directory. Then you can build the project by running:

make

This will build two mgclient library flavours: a static library (usually named libmgclient.a) and a shared library (usually named libmgclient.so).

To install the libraries and corresponding header files run:

make install

This will install to system default installation directory. If you want to change this location, use -DCMAKE_INSTALL_PREFIX option when running CMake.

If you want to build and run tests, in the build directory run:

cmake -DBUILD_TESTING=ON -DBUILD_TESTING_INTEGRATION=ON ..
ctest

Building and installing on Windows

To build and install mgclient from source on Windows you will need:

  • CMake version >= 3.8
  • OpenSSL version >= 1.0.2
  • MinGW: gcc >= 8 or Windows Compiler (take a look here to understand versioning in a bit more details): VS >= 17 2022, MSVC >= 14.34, C >= 19.34

Windows Compiler

mkdir build
cd build
cmake ..
cmake --build .

Depending on where OpenSSL is installed you might need to define OPENSSL_ROOT_DIR, example follows:

cmake -DOPENSSL_ROOT_DIR="$VCPKG_ROOT\installed\x64-windows" ..

To install OpenSSL vcpkg can be used:

vcpkg install openssl:x64-windows

or you can download and install OpenSSL from here.

MinGW

  • Install MSYS2 from https://www.msys2.org/.
  • Install MinGW toolchain with the following command:
    pacman -S --needed git base-devel mingw-w64-i686-toolchain mingw-w64-x86_64-toolchain mingw-w64-i686-cmake mingw-w64-x86_64-cmake mingw-w64-i686-openssl mingw-w64-x86_64-openssl
    

Once the environment is ready, please run:

mkdir build
cd build
cmake .. -G "MinGW Makefiles"
cmake --build . --target install

Building WASM (Linux only)

Compiling mgclient for wasm requires the Emscripten sdk. This is automated in the following steps:

  1. mkdir build && cd build
  2. cmake .. -DWASM=ON
  3. make

Now there should be an mgclient.js and an mgclient.wasm found in mgclient/build/

Using the library

The library provides header files located under the include folder. All library functionality is documented in these files in Doxygen format. You can also build HTML version of the documentation by running doxygen command from project root directory.

Examples

All the examples of the usage of the mgclient are contained in the examples folder, including the C++ wrapper.

An example on how to include mgclient inside a CMake project is located under examples/CMakeLists.txt.