Installation Guide

Installation and Reuse

There are a few different ways of installing/reusing units in your project.

Copy

As units is a header-only library you can simply copy src/include directory to your source tree and use it as regular header files.

NOTE: Until C++20 arrives the library has some 3rd party dependencies that provide experimental C++20 features. The list of dependencies include:

range-v3@ericniebler (only for gcc-9, gcc-10 uses gcc's concepts implementation)
fmt@_

All of them are easily to obtain with conan.

NOTE: In case a full library's repository is to be compiled (instead of just copying src/include headers), additionally, the library's unit tests depend on Catch2@catchorg conan package.

cmake + conan

To use units as a cmake imported library via cmake configuration files the following steps may be done:

clone the repository with its submodules:
```
git clone --recurse-submodules https://github.com/mpusz/units.git
```
or in case it is already cloned without submodules initialize, fetch, and checkout them with:
```
git submodule update --init
```

add the following remotes to your local conan instance

conan remote add conan-mpusz https://api.bintray.com/conan/mpusz/conan-mpusz

add units as a dependency to your conan file. For example to use testing version of 0.5.0 of mp-units add:
- conanfile.txt
```
[requires]
mp-units/0.5.0@mpusz/testing
```
- conanfile.py
```
requires = "mp-units/0.5.0@mpusz/testing"
```

link your cmake target with units

target_link_libraries(<your_target> PUBLIC|PRIVATE|INTERFACE CONAN_PKG::mp-units)

install conan dependencies before configuring cmake

cd build
conan install .. -pr <your_conan_profile> -s compiler.cppstd=20 -b=outdated -u

Full build and unit testing

In case you would like to build all the code in this repository (with unit tests and examples) you should use the CMakeLists.txt from the parent directory and run Conan with CONAN_RUN_TESTS=True.

git clone --recurse-submodules https://github.com/mpusz/units.git
mkdir units/build && cd units/build
conan install .. -pr <your_conan_profile> -s compiler.cppstd=20 -e CONAN_RUN_TESTS=True -b outdated
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
ctest -VV

Packaging

To create a conan package and test cmake installation and conan packaging run:

conan create . <username>/<channel> -pr <your_conan_profile> -s compiler.cppstd=20 -e CONAN_RUN_TESTS=True -b outdated

Upload package to conan server

conan upload -r <remote-name> --all mp-units/0.5.0@<user>/<channel>

2.7 KiB Raw Blame History