Graphite Logger is a simple, one-header-only logging library for C++.
- Scalable.
- Free.
- Open-source.
- Easy to use.
- Cross-platform.
- Standard C++ 11 support.
Graphite Logger does not require any spcial installation or building because currently it is a header only library. Graphite Logger just needs to be included in your project.
To do so, follow these steps:
- Download the repository either by cloning it with Git or from the GitHub page.
- Move it to either your compiler's include path or to your project's include path.
- Include it in your source file.
- If you have put it in the compiler's path, add the following line at the begin of yout code:
#include <GraphiteLogger/GraphiteLogger.hpp>- Else, write:
#include "${your own path}/GraphiteLogger/GraphiteLogger.hpp"- Where "your own path" is the path to the directory where you have Graphite Logger include files.
Using default log levels (same as Linux):
#define GRAPHITE_LOGGER__USE_DEFAULT_LOG_LEVELS
#include <GraphiteLogger/GraphiteLogger.hpp>
int main()
{
using namespace GraphiteLogger::LogLevels;
GraphiteLogger::Logger logger("UsefulLogger",debug);
logger.addOutput(&std::cout);
logger[emergency] << "Terminating program... Exit code: " << 4;
logger[critical] << "Undefined behaviour detected.";
logger[error] << "atoi() cannot transform \"479878754524347787864456546\" (out of range).";
logger[warning] << "Comparison of integers of different flavors.";
logger[notice] << "Pass by const reference would be more efficient than past by value";
logger[info] << "Exited struggleFunction() successfully.";
logger[debug] << "i is " << 1;
}Using own levels:
#include <GraphiteLogger/GraphiteLogger.hpp>
int main()
{
constexpr int my_own_level_1 = 4;
constexpr int my_own_level_2 = 5;
constexpr int my_own_level_3 = 6;
GraphiteLogger::Logger logger("UsefulLogger",my_own_level_2);
logger.addOutput(&std::cout);
logger[my_own_level_1] << "Some important data that will be shown.";
logger[my_own_level_2] << "Some not as important data that will be shown.";
logger[my_own_level_3] << "Some data that will not be shown.";
}Logging to files:
#include <GraphiteLogger/GraphiteLogger.hpp>
int main()
{
constexpr int my_own_level_1 = 4;
constexpr int my_own_level_2 = 5;
constexpr int my_own_level_3 = 6;
GraphiteLogger::Logger logger("UsefulLogger",my_own_level_2);
std::ofstream ofile("out.log");
logger.addOutput(&ofile);
logger[my_own_level_1] << "Some important data that will be shown.";
logger[my_own_level_2] << "Some not as important data that will be shown.";
logger[my_own_level_3] << "Some data that will not be shown.";
}Logging to multiple outputs:
#include <GraphiteLogger/GraphiteLogger.hpp>
int main()
{
constexpr int my_own_level_1 = 4;
std::ofstream ofile1("out1.log");
GraphiteLogger::Logger logger("UsefulLogger",my_own_level_1,{&std::cout,&ofile1});
std::ofstream ofile2("out2.log");
std::ofstream ofile3("out3.log");
logger.addOutput(&ofile2);
logger.addOutput(&ofile3);
logger[my_own_level_1] << "Logging to ofile1, ofile2, ofile3 and to std::cout!";
}