1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
FunctionalPlus
==============
Requirements and Installation
-----------------------------
You can install FunctionalPlus in **one of the following 5 ways**:
### way 1: using [cmake](https://cmake.org/)
```bash
git clone https://github.com/Dobiasd/FunctionalPlus
cd FunctionalPlus
mkdir build
cd build
cmake ..
make
sudo make install
```
<a id="cmake-dependency"></a>
And then, you can add **FunctionalPlus** as a dependency in your cmake project as in the following.
```cmake
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 [ExternalProject](#way-2-using-cmakes-externalproject) below.
#### Building the unit tests
Unit Tests are disabled by default. Building the tests (optional) requires [doctest](https://github.com/onqtam/doctest).
First, install the required locales
````bash
sudo locale-gen ru_RU
sudo locale-gen ru_RU.UTF-8
sudo locale-gen el_GR
sudo locale-gen el_GR.UTF-8
sudo localedef -c -i ru_RU -f CP1251 ru_RU.CP1251
sudo localedef -c -i el_GR -f CP1253 el_GR.CP1253
````
Then, install doctest:
```bash
git clone https://github.com/onqtam/doctest
cd doctest
mkdir -p build && cd build
cmake .. -DDOCTEST_WITH_TESTS=off -DDOCTEST_WITH_MAIN_IN_STATIC_LIB=OFF
make
sudo make install
```
Then, compile & run the tests
````bash
git clone https://github.com/Dobiasd/FunctionalPlus
cd FunctionalPlus
mkdir build
cd build
cmake .. -DFPLUS_BUILD_UNITTEST=ON
make
make test
````
As an alternative, doctest global installation can be skipped by using [conan](https://conan.io):
````bash
# pip install conan # (if conan is not installed)
git clone https://github.com/Dobiasd/FunctionalPlus
cd FunctionalPlus
mkdir build
cd build
conan install .. -obuild_unittest=True --build=missing
cmake .. -DFPLUS_BUILD_UNITTEST=ON -DFPLUS_UNITTEST_USE_CONAN=ON
make
make test
````
### way 2: using [cmake's ExternalProject](https://cmake.org/cmake/help/v3.0/module/ExternalProject.html)
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
cmake_minimum_required(VERSION 3.0 FATAL_ERROR)
project(FplusMinimalExternalExample)
set(CMAKE_CXX_STANDARD 14)
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
)
set(FPLUS_INCLUDE_DIR ${CMAKE_BINARY_DIR}/thirdparty/fplus/include)
include_directories(${FPLUS_INCLUDE_DIR})
add_executable(main src/main.cpp)
add_dependencies(main functional_plus)
```
### way 3: using [cget](https://github.com/pfultz2/cget/)
```bash
# Setup up toolchain to use c++14
cget init --std=c++14
# Test and install
cget install Dobiasd/FunctionalPlus
```
### way 4: download manually
Just [download](https://github.com/Dobiasd/FunctionalPlus/archive/master.zip)/extract FunctionalPlus and tell your compiler to use the `include` directory.
### way 5: using [Conan C/C++ package manager](https://conan.io)
Just add a *conanfile.txt* with FunctionalPlus as a requirement and chose the generator for your project.
```
[requires]
functionalplus/v0.2.13-p0@dobiasd/stable
[generators]
cmake
```
Then install it:
```bash
conan install conanfile.txt
```
### way 6: using [conda-forge](https://conda-forge.org/)
```bash
conda config --add channels conda-forge
conda install FunctionalPlus
```
Visit [`conda-forge/FunctionalPlus-feedstock`](https://github.com/conda-forge/FunctionalPlus-feedstock) for more details.
### way 7: using [Homebrew](https://brew.sh/)
```bash
brew install functionalplus
```
And then, you can add **FunctionalPlus** as a dependency in your cmake project [as in way 1](#cmake-dependency).
If you're not using cmake, you might need to add `$(brew --prefix functionalplus)/include` to the additional include paths for your compiler.
|
