Skip to content

Latest commit

 

History

History
82 lines (58 loc) · 2.47 KB

installing.md

File metadata and controls

82 lines (58 loc) · 2.47 KB
Raw

Installing

Since not_null is a single-header, header-only library -- there are various possible options for how this could be installed and used in any project.

The short version is that, in order to use this, you must at least have a -I to the include directory of this project, or directly to the directory not_null.hpp is installed in.

You can easily copy the not_null.hpp file wherever you would like into your project, git submodule this repository in, install it with your favorite package manager, etc.

However, if you are using either conan or CMake (or both), you can also follow the additional instructions below:

Conan

This project provides a conanfile.py and public hosting on bintray for packages.

Just follow the instructions in the bintray link for setting up this source as a conan repository, and add NotNull/<the version you want>@not_null/stable as a dependency in your conanfile.py, and you can install this into your project.

CMake

This project is written with idiomatic & "modern" CMake (3.4+) and provides the target NotNull::NotNull which can be used as a dependency in your cmake build.

You can either add this project via add_subdirectory or pull this project in with a find_package call after installing it.

Via subdirectory

If you have added this repo as a git submodule, or as a subtree, or just straight-up copied directly into your repo, you can add this project via add_subdirectory call before your target so that you can use the NotNull::NotNull target.

For example:

# Add the 'not_null' repo sometime before you depend on the target
add_subdirectory("external/not_null")

# ...

add_library(MyLibrary ...)
target_link_libraries(MyLibrary
  PRIVATE NotNull::NotNull
)

And in your implementation of MyLibrary, you can easily include the project with #include "not_null.hpp"!

Via installation

You can also create an installation package of not_null and share with other users, or just use locally on your system.

Then, to consume this package you just need to find it with find_package. For example:

find_package(NotNull REQUIRED)

# ...

add_library(MyLibrary ...)
target_link_libraries(MyLibrary
  PRIVATE NotNull::NotNull # 'PRIVATE" assuming private dependency...
)

And in your implementation of MyLibrary, you can easily include the project with #include "not_null.hpp"!