libcruft-util/log.hpp

/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * Copyright 2012-2018 Danny Robson <danny@nerdcruft.net>
 */

#ifndef CRUFT_UTIL_LOG_HPP
#define CRUFT_UTIL_LOG_HPP

#include "nocopy.hpp"

#include "preprocessor.hpp"
#include "format.hpp"

#include <iosfwd>
#include <string>

// Windows.h or one of its friends defines a macro 'ERROR'. Screw Microsoft.
#ifdef ERROR
#undef ERROR
#endif

namespace cruft {
    ///////////////////////////////////////////////////////////////////////////
    // rfc5424 log levels. It is assumed they are contiguous to simplify array
    // indexing in logging code.
    enum level_t {
        EMERGENCY,              /** system is unusable */
        ALERT,                  /** action must be taken immediately */
        CRITICAL,               /** critical conditions */
        ERROR,                  /** error conditions */
        WARNING,
        WARN = WARNING,         /** warning conditions */
        NOTICE,                 /** normal but significant condition */
        INFORMATIONAL,
        INFO = INFORMATIONAL,   /** informational messages */
        DEBUG                   /** debug-level messages */
    };

    #define MAP_LEVEL_T(F) MAP0(F, EMERGENCY, ALERT, CRITICAL, ERROR, WARN, NOTICE, INFO, DEBUG)

    constexpr auto DEFAULT_LOG_LEVEL = NOTICE;

    //-------------------------------------------------------------------------
    const std::string& to_string (level_t);

    //-------------------------------------------------------------------------
    std::ostream&
    operator<< (std::ostream&, level_t);


    ///////////////////////////////////////////////////////////////////////////
    // Query or set the global logging level filter. If the severity passed to
    // a logging call is less than this then the output is discarded.
    //
    // The initial logging level can be controlled by setting the environment
    // variable LOG_LEVEL to a string corresponding to the names of the values
    // in level_t.
    //
    // Otherwise we fall back to the hard coded default from above.
    //
    // As a special case, a blank value for the environment variable LOG_LEVEL
    // corresponds to the maximum log level. It indicates a preference for
    // minimum output, and may be changed to disable all output in future
    // updates.
    level_t log_level (void);
    level_t log_level (level_t);

    ///////////////////////////////////////////////////////////////////////////
    void log (level_t, const std::string &msg);


    template <typename ...Args, size_t N>
    void
    log (level_t l, const char (&fmt)[N], Args &&...args)
    {
        log (
            l,
            to_string (
                format::printf (fmt) (
                    std::forward<Args> (args)...
                )
            )
        );
    }


    //-------------------------------------------------------------------------
    // Various convenience macros for logging specific strings with a well
    // known severity.
    //
    // LOG_DEBUG is treated similarly to assert; if NDEBUG is defined then we
    // compile out the statement so as to gain a little runtime efficiency
    // speed.
    #define LOG_EMERGENCY(...)  do { cruft::log(cruft::EMERGENCY, ##__VA_ARGS__); } while (0)
    #define LOG_ALERT(...)      do { cruft::log(cruft::ALERT,     ##__VA_ARGS__); } while (0)
    #define LOG_CRITICAL(...)   do { cruft::log(cruft::CRITICAL,  ##__VA_ARGS__); } while (0)
    #define LOG_ERROR(...)      do { cruft::log(cruft::ERROR,     ##__VA_ARGS__); } while (0)
    #define LOG_WARNING(...)    do { cruft::log(cruft::WARNING,   ##__VA_ARGS__); } while (0)
    #define LOG_WARN(...)       do { cruft::log(cruft::WARN,      ##__VA_ARGS__); } while (0)
    #define LOG_NOTICE(...)     do { cruft::log(cruft::NOTICE,    ##__VA_ARGS__); } while (0)
    #define LOG_INFO(...)       do { cruft::log(cruft::INFO,      ##__VA_ARGS__); } while (0)
#if !defined(NDEBUG)
    #define LOG_DEBUG(...)      do { cruft::log(cruft::DEBUG,     ##__VA_ARGS__); } while (0)
#else
    #define LOG_DEBUG(...)      do { ; } while (0)
#endif


    ///////////////////////////////////////////////////////////////////////////
    class scoped_logger : public nocopy {
    public:
        scoped_logger (level_t, std::string);
        ~scoped_logger ();

    protected:
        const level_t     m_level;
        const std::string m_message;
    };


    ///////////////////////////////////////////////////////////////////////////
    class scoped_timer : public nocopy {
    public:
        scoped_timer (level_t, std::string);
        ~scoped_timer ();

    private:
        const level_t m_level;
        const std::string m_message;
        uint64_t m_start;
    };
}

#endif