quill v2.1.0 Release Notes

  • ๐Ÿ‘Œ Improvements

    ๐Ÿ”ง This version includes breaking changes to the API. Those changes are related to how quill is configured, before calling quill::start() to start the backend thread.

    โšก๏ธ Check the updated examples.

    ๐Ÿ”ง Config.h - contains runtime configuration options

    ๐Ÿ”ง TweakMe.h - contains compile time configuration

    0๏ธโƒฃ For example quill::set_default_logger_handler(...) has been removed. To set a default filehandler :

      // create a handler
      quill::Handler* file_handler = quill::file_handler("test.log", "w");
        "%(ascii_time) [%(thread)] %(fileline:<28) %(level_name) %(logger_name:<12) - %(message)",
        "%Y-%m-%d %H:%M:%S.%Qms", quill::Timezone::GmtTime);
      // set the handler as the default handler for any newly created logger in the config
      quill::Config cfg;
      // configure must always be called prior to `start()`
    • โœ‚ Removed some API functions from Quill.h that were previously used for configuration. Instead, quill::Config object has to be created. For example quill::config::set_backend_thread_cpu_affinity(1); has been removed and instead the following code is needed :
      quill::Config cfg;
      cfg.backend_thread_cpu_affinity = 1;
    • QUILL_CHRONO_CLOCK has been moved from TweakMe.h to Config.h. It is now possible to switch between rdtsc and system clocks without re-compiling. See example_trivial_system_clock.cpp
    • QUILL_RDTSC_RESYNC_INTERVAL has been moved from TweakMe.h to Config.h.
    • ๐ŸŒฒ It is now possible to log user timestamps rather than the system's. This feature is useful for time simulations. See example_custom_clock.cpp and example_custom_clock_advanced.cpp
    • ๐Ÿšš Previously the logger names were limited to a maximum of 22 characters. This limitation has been removed.
    • โž• Added support for gcc 7.5.0. (#178)
    • โšก๏ธ Updated bundled fmt to 9.0.0