You can build and test the library using CMake, this implementation requires C++11.
It is recomended that you install CURL prior to installation of this API
Compile the library and tests by running:
$ cmake -Bbuild -DFDPAPI_BUILD_TESTS=ON
$ cmake --build build
Important For multi-config compilers such as Visual Studio xcode or ninja the config type needs to be set to Release otherwise the API will not build for example:
$ cmake -Bbuild -DFDPAPI_BUILD_TESTS=ON
$ cmake --build build --config=Release
The library can be installed system-wide using:
$ cmake --build build --target install
Note that this will require Boost to be installed to your system, or you may need to build a shared library:
$ cmake -B build -DFDPAPI_BUILD_TESTS=ON -DBUILD_SHARED_LIBS=ON
After doing so, the library can be discovered and utilised in other CMake projects using:
find_package(fdpapi)
target_link_libraries(my_project PRIVATE fdpapi::fdpapi)
The main class the user will interact with is DataPipeline which has only the required methods such as link_read etc. This class has a member which is a pointer to an underlying DataPipelineImpl_ class which performs the various procedures required to handle the data. A logger has been used to give as much feedback to the user as possible, the verbosity being handled by a log level argument.
The environment variable FDP_LOG_LEVEL=[TRACE:DEBUG:INFO:WARN:ERROR:CRITICAL:OFF] can be set to specify the logging output level.
The unit tests use the local registry, this needs to be running prior to running the tests see: the CLI documentation
Tests can be lauched using the following command:
$ ./build/bin/fdpapi-tests
$ build\bin\Release\fdpapi-tests.exe