Skip to content

Latest commit

 

History

History
219 lines (154 loc) · 6.25 KB

INSTALL.md

File metadata and controls

219 lines (154 loc) · 6.25 KB
Raw

FunctionalPlus

Requirements and Installation

You can install FunctionalPlus in one of the following ways:

way 1: using CMake

git clone https://github.com/Dobiasd/FunctionalPlus
cmake -S FunctionalPlus -B FunctionalPlus/build
cmake --build FunctionalPlus/build
sudo cmake --install FunctionalPlus/build

And then, you can add FunctionalPlus as a dependency in your CMake project as in the following.

find_package(FunctionalPlus REQUIRED)

add_executable(HelloWorld main.cpp)
target_link_libraries(HelloWorld FunctionalPlus::fplus)

If you want CMake to download and install the package automatically, see FetchContent or ExternalProject below.

Building the unit tests

Unit Tests are available from a separate CMakeLists.txt file. Building the tests requires doctest.

Install doctest:

git clone --depth=1 --branch=2.4.5 https://github.com/onqtam/doctest # 2.4.6 has a bug, see https://github.com/Dobiasd/FunctionalPlus/issues/250
cmake -S doctest -B doctest/build -DDOCTEST_WITH_TESTS=OFF -DDOCTEST_WITH_MAIN_IN_STATIC_LIB=OFF
cmake --build doctest/build -j 4
sudo cmake --install doctest/build

Then, compile & run the tests

git clone https://github.com/Dobiasd/FunctionalPlus
cmake -S FunctionalPlus/test -B FunctionalPlus/build
cmake --build FunctionalPlus/build -j 4
(cd FunctionalPlus/build; ctest)

As an alternative, doctest global installation can be skipped by installing to a local prefix:

git clone --depth=1 --branch=2.4.5 https://github.com/onqtam/doctest
cmake -S doctest -B doctest/build -DDOCTEST_WITH_TESTS=OFF -DDOCTEST_WITH_MAIN_IN_STATIC_LIB=OFF
cmake --build doctest/build
cmake --install doctest/build --prefix doctest

git clone https://github.com/Dobiasd/FunctionalPlus
cmake -S FunctionalPlus/test -B FunctionalPlus/build -D "CMAKE_PREFIX_PATH=${PWD}/doctest"
cmake --build FunctionalPlus/build
(cd FunctionalPlus/build; ctest)

way 2: using CMake's ExternalProject

You can also add FunctionalPlus as an ExternalProject to your CMakeLists.

The benefits of this:

  • No installation
  • Better version control with the GIT_TAG
    • Always get the latest version when GIT_TAG master
    • When you build your project, it will automatically update the headers if there is a change
    • Or get the specific version by setting it to a specific commit point
cmake_minimum_required(VERSION 3.8)
project(FplusMinimalExternalExample)

include(ExternalProject)
ExternalProject_Add(
    functional_plus
    GIT_REPOSITORY https://github.com/Dobiasd/FunctionalPlus.git
    GIT_TAG master

    SOURCE_DIR "${CMAKE_BINARY_DIR}/thirdparty/fplus"

    CONFIGURE_COMMAND ""
    BUILD_COMMAND ""
    INSTALL_COMMAND ""

    LOG_DOWNLOAD ON
    LOG_BUILD ON
)

ExternalProject_Get_Property(functional_plus SOURCE_DIR)

add_executable(main src/main.cpp)
add_dependencies(main functional_plus)
target_compile_features(main PRIVATE cxx_std_14)
target_include_directories(main PRIVATE "${SOURCE_DIR}")

way 3: using CMake 3.14 FetchContent

This should be preferred over the ExternalProject method.

This has similar benefits, but it's easier to set up in your CMakeLists.txt.

cmake_minimum_required(VERSION 3.14)
project(FplusMinimalExternalExample)

include(FetchContent)
FetchContent_Declare(
    functional_plus
    GIT_REPOSITORY https://github.com/Dobiasd/FunctionalPlus.git
    GIT_TAG master
)
FetchContent_MakeAvailable(functional_plus)

add_executable(main src/main.cpp)
target_compile_features(main PRIVATE cxx_std_14)
target_link_libraries(main PRIVATE FunctionalPlus::fplus)

way 4: using cget

# Setup up toolchain to use c++14
cget init --std=c++14
# Test and install
cget install Dobiasd/FunctionalPlus

way 5: download manually

Just download/extract FunctionalPlus and tell your compiler to use the include directory.

way 6: using Conan C/C++ package manager

Just add a conanfile.txt with FunctionalPlus as a requirement and chose the generator for your project.

[requires]
functionalplus/0.2.18-p0

[generators]
cmake

Then install it:

conan install conanfile.txt

way 7: using conda-forge

conda config --add channels conda-forge
conda install FunctionalPlus

Visit conda-forge/FunctionalPlus-feedstock for more details.

way 8: using Homebrew

brew install functionalplus

And then, you can add FunctionalPlus as a dependency in your CMake project as in way 1.

If you're not using CMake, you might need to add $(brew --prefix functionalplus)/include to the additional include paths for your compiler.

way 9: using the "all in one" include file

include_all_in_one/include/fplus/fplus.hpp is a standalone header that groups all FunctionalPlus code.

For example, download this file into external/fplus/include/fplus, like this:

mkdir -p external/fplus/include/fplus
wget -O external/fplus/include/fplus/fplus.hpp https://raw.githubusercontent.com/Dobiasd/FunctionalPlus/master/include_all_in_one/include/fplus/fplus.hpp

Then, compile like this:

g++ --std=c++14 src/main.cpp -Iexternal/fplus/include

or, with CMake:

cmake_minimum_required(VERSION 3.8)
project(YourProjectName)
add_executable(main src/main.cpp)
target_compile_features(main PRIVATE cxx_std_14)
target_include_directories(main PRIVATE external/fplus/include)

You can also use this standalone header on Compiler Explorer: See this example. Just add a line like this:

#include "https://raw.githubusercontent.com/Dobiasd/FunctionalPlus/master/include_all_in_one/include/fplus/fplus.hpp"