install.md

Install and use eventpp in your project

• Install and use eventpp in your project
  • Include the source code in your project directly
  • Use CMake FetchContent
  • Use Vcpkg package manager
  • Use Conan package manager
  • Use Hunter package manager
  • Install using CMake locally and use it in CMake

eventpp package is available in C++ package managers Vcpkg, Conan, and Hunter.
eventpp is header only and not requires building. There are various methods to use eventpp.
Here lists all possible methods to use eventpp.

Include the source code in your project directly

eventpp is header only library. Just clone the source code, or use git submodule, then add the 'include' folder inside eventpp to your project include directory, then you can use the library.
You don't need to link to any source code.

Use CMake FetchContent

Add below code to your CMake file

include(FetchContent)
FetchContent_Declare(
    eventpp
    GIT_REPOSITORY https://github.com/wqking/eventpp
    GIT_TAG        d2db8af2a46c79f8dc75759019fba487948e9442 # v0.1.3
)
FetchContent_MakeAvailable(eventpp)

Then eventpp is available to your project. If GIT_TAG is omitted, the latest code on master branch will be used.

Use Vcpkg package manager

vcpkg install eventpp

Then in your CMake project CMakeLists.txt file, put below code, remember to replace ${TARGET} with your target,

find_package(eventpp CONFIG REQUIRED)
target_link_libraries(${TARGET} PRIVATE eventpp::eventpp)
find_path(EVENTPP_INCLUDE_DIR eventpp/eventqueue.h)
include_directories(${EVENTPP_INCLUDE_DIR})

Then run cmake, note you need -DCMAKE_TOOLCHAIN_FILE to specify vcpkg, and replace -G with your generator

cmake .. -DCMAKE_TOOLCHAIN_FILE=VCPKGDIR/vcpkg/scripts/buildsystems/vcpkg.cmake -G"MinGW Makefiles"

Note with vcpkg, only the released version can be used, which may be behind the latest update. You can't use the minor update on the master branch.

Use Conan package manager

In your CMake project, add a conanlist.txt file that should contain,

[requires]
eventpp/0.1.3

[generators]
CMakeDeps
CMakeToolchain

Then in your CMakeLists, add,

find_package(eventpp CONFIG REQUIRED)
target_link_libraries(${TARGET} PRIVATE eventpp::eventpp)

Then run conan install . --output-folder=build --build=missing in your project folder (assuming the default conan profile exists and is okay).
Then cd into folder build, run cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -G "Whatever generator you want" -DCMAKE_BUILD_TYPE=Release, alternatively it can also use cmake presets instead of passing the toolchain file on cmake >=3.23

There are more information here.

Use Hunter package manager

You may follow the example code on Hunter document. Below is the code snippet from that document,

hunter_add_package(eventpp)
find_package(eventpp CONFIG REQUIRED)

add_executable(main main.cpp)
target_link_libraries(main eventpp::eventpp)
include_directories(${EVENTPP_INCLUDE_DIR})

Install using CMake locally and use it in CMake

Note: this is only an alternative, you should use the FetchContent method instead of this.
If you are going to use eventpp in CMake managed project, you can install eventpp then use it in CMake.
In eventpp root folder, run the commands,

mkdir build
cd build
cmake ..
sudo make install

Then in the project CMakeLists.txt,

# the project target is mytest, just for example
add_executable(mytest test.cpp)

find_package(eventpp)
if(eventpp_FOUND)
    target_link_libraries(mytest eventpp::eventpp)
else(eventpp_FOUND)
    message(FATAL_ERROR "eventpp library is not found")
endif(eventpp_FOUND)

Note: when using the method 3 with MingW on Windows, by default CMake will install eventpp in system folder which is not writable. You should specify another folder to install. To do so, replace cmake .. with cmake .. -DCMAKE_INSTALL_PREFIX="YOUR_NEW_LIB_FOLDER".