gz/common/Console.hh

Go to the documentation of this file.

/*
 * Copyright (C) 2016 Open Source Robotics Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
*/
#ifndef IGNITION_COMMON_CONSOLE_HH_
#define IGNITION_COMMON_CONSOLE_HH_
 
#include <iostream>
#include <fstream>
#include <sstream>
#include <string>
 
#include <gz/common/config.hh>
#include <gz/common/Export.hh>
#include <gz/common/SuppressWarning.hh>
#include <gz/common/Util.hh>
 
namespace ignition
{
  namespace common
  {
    #define ignerr (ignition::common::Console::err(__FILE__, __LINE__))
 
    #define ignwarn (ignition::common::Console::warn(__FILE__, __LINE__))
 
    #define ignmsg (ignition::common::Console::msg())
 
    #define igndbg (ignition::common::Console::dbg(__FILE__, __LINE__))
 
    #define ignlog (ignition::common::Console::log())
 
    #define ignLogInit(_dir, _file)\
        ignition::common::Console::log.Init(_dir, _file)
 
    #define ignLogClose()\
        ignition::common::Console::log.Close()
 
    #define ignLogDirectory()\
        (ignition::common::Console::log.LogDirectory())
 
    class IGNITION_COMMON_VISIBLE FileLogger : public std::ostream
    {
      public: explicit FileLogger(const std::string &_filename = "");
 
      public: virtual ~FileLogger();
 
      public: void Init(const std::string &_directory,
                        const std::string &_filename);
 
      public: void Close();
 
      public: virtual FileLogger &operator()();
 
      public: virtual FileLogger &operator()(
                  const std::string &_file, int _line);
 
      public: std::string LogDirectory() const;
 
      protected: class Buffer : public std::stringbuf
                 {
                   public: explicit Buffer(const std::string &_filename);
 
                   public: virtual ~Buffer();
 
                   public: std::streamsize xsputn(
                        const char *_char, std::streamsize _count) override;
 
                   public: int sync() override;
 
                   public: std::ofstream *stream;
                   // public: std::mutex syncMutex;
                 };
 
      IGN_COMMON_WARN_IGNORE__DLL_INTERFACE_MISSING
      private: std::string logDirectory;
      IGN_COMMON_WARN_RESUME__DLL_INTERFACE_MISSING
 
      private: bool initialized;
    };
 
    class IGNITION_COMMON_VISIBLE Logger : public std::ostream
    {
      public: enum LogType
              {
                STDOUT,
                STDERR
              };
 
      public: Logger(const std::string &_prefix, const int _color,
                     const LogType _type, const int _verbosity);
 
      public: virtual ~Logger();
 
      public: virtual Logger &operator()();
 
      public: virtual Logger &operator()(
                  const std::string &_file, int _line);
 
      protected: class Buffer : public std::stringbuf
                 {
                   public: Buffer(LogType _type, const int _color,
                                  const int _verbosity);
 
                   public: virtual ~Buffer();
 
                   public: std::streamsize xsputn(
                        const char *_char, std::streamsize _count) override;
 
                   public: int sync() override;
 
                   public: LogType type;
 
                   public: int color;
 
                   public: int verbosity;
 
                   // public: std::mutex syncMutex;
                 };
 
      IGN_COMMON_WARN_IGNORE__DLL_INTERFACE_MISSING
      private: std::string prefix;
      IGN_COMMON_WARN_RESUME__DLL_INTERFACE_MISSING
    };
 
    class IGNITION_COMMON_VISIBLE Console
    {
      public: static void SetVerbosity(const int _level);
 
      public: static int Verbosity();
 
      public: static void SetPrefix(const std::string &_customPrefix);
 
      public: static std::string Prefix();
 
      public: static Logger msg;
 
      public: static Logger err;
 
      public: static Logger dbg;
 
      public: static Logger warn;
 
      public: static FileLogger log;
 
      private: static int verbosity;
 
      IGN_COMMON_WARN_IGNORE__DLL_INTERFACE_MISSING
      private: static std::string customPrefix;
      IGN_COMMON_WARN_RESUME__DLL_INTERFACE_MISSING
    };
  }
}
#endif