installing.md

Installing

Since {Scope} 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 scope.hpp is installed in.

You can easily copy the scope.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 Scope/<the version you want>@scope/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 Scope::Scope 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 Scope::Scope target.

For example:

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

# ...

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

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

Via installation

You can also create an installation package of {Scope} 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(Scope REQUIRED)

# ...

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

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