Installation¶
Requirements¶
In order to install yaramod
you will need:
CMake 3.6+
C++ compiler with C++17 support
If you want to use Python bindings then you will also need:
Python 3.6+
Compilation¶
Yaramod is primarily written in C++ so you’ll have to compile it to the library which you can then link to your own project. We do not provide any prebuild binary releases so if you would like to use it from C++ code, you need to compile it yourself. We use CMake for our build system so you’ll need to install it beforehand. We support 3 main platforms - Linux, Windows and macOS. The project might work also on other platforms but we do not provide any support for those nor any guarantees that it works.
In order to configure the project and start the compilation run
mkdir build
cmake -DCMAKE_BUILD_TYPE=<Release|Debug> ..
cmake --build .
If you would also like to build examples (located in src/examples/cpp) then also pass -DYARAMOD_EXAMPLES=ON
to the
second command, right after -DCMAKE_BUILD_TYPE=...
.
It is also possible to build Python bindings directly from CMake by providing an option -DYARAMOD_PYTHON=ON
.
Python Bindings¶
Yaramod also comes with Python 3 bindings in case you don’t want to deal with linking C++ libraries or you just simply prefer Python over C++. We deploy yaramod to PyPI so you can
install it directly from there using pip
.
pip install yaramod
In case you don’t want to use the latest release but would much rather use master
branch you can run
pip install .
from the root directory of yaramod directly.