yall is a subsystems based logging library. It allows to create subsystems which will manage all the logging parameters for an area of the application. Subsystems can inherit from one another, override parents parameters...
yall is available on Linux and Windows (MSVC12 and MSVC14).
Informations about how to use yall can be found on the project wiki.
The main workflow to use yall is the following:
- Initialize the library
- Create subsystems
- Log messages
Git LFS is required to clone the repository. yall use CMake as build system generator, so, ensure CMake is installed on your system (version 3.6 minimum). The following dependencies are also required :
gccandg++.pthread: a Windows version is available. Installed by default on Linux.jansson: JSON parsing library.doxygen: used to generate documentation.criterion: available on Github. Used for unit testing. On Windows, it is available insideexternalfolder.valgrind(optional, Linux only) : some tests scripts use it to test the library.rpmbuildanddebbuild(optional, Linux only) : to generate Linux packages.python-sphinx,python-sphinx-rtd-themeandbreathe(optional, Linux) : to build the user documentation.
Then :
cmake -Bbuild -H. -DCMAKE_BUILD_TYPE=Release
make -C build
Launched inside the sources directory, these commands will create a build directory to run CMake inside, and build the library. The CMAKE_BUILD_TYPE variable will define what will be installed. Release here can be changed to Debug, to build the library with the debug symbols.
On Windows, the process is straightforward using CMake GUI and Visual Studio.
Once library is build, install it with :
sudo make -C build install
It requires sudo as the file are installed on the system in /usr/local.
The way to contribute to the project is define is CONTRIBUTING.md (currently under development).
For any problem that can't be solved using Debugging section of the documentation, there is multiple solutions :
- Send a mail to the maintainer :
naccyde <at> naccyde <dot> eu. - Fork the repository and create a pull-request.