费了牛劲,写了N多的English,总算提交了新项目mlog。至于会不会被Reject,不是我目前应该考虑的事情。
这种英文恐怕是非常糟糕吧,不知道 sourceforge.net 的工作人员能不能看懂。“汗”一个先!
mlog将是基于 Apache Software Licence 2.0 的开源项目。
Descriptions:
mlog is a logging implementation, which is configuration based, portable, extendable, and simple to uses. It supports "logging-levels", "logging-catalogs" and "multiple output-targets". mlog is developments by liigo using C++ programing language.
mlog uses an optional config file, that just like java's *.properties file or windows' *.ini file. While mlog initializtion, it will searches and loads the config file, which maybe named "mlog-setting.txt" or "mlog-setting", in the current path. If not found, mlog will uses the default settings. In a common purpose, you do not even needs a config file.
mlog supports "logging-levels": trace, debug, info, warning, error, fatal, print. Every logging message has its own logging-level. By editting the config file, one or more or all logging-levels can be selected to output to the "logging-targets".
mlog supports "logging-catalogs", which is identified by a string. By editting the config file, users can determines which logging-catalogs(one or more, or none) can be output. The default logging-catalog is used by default.
mlog support "output-targets", which is the targets where the logging messages will be outputed to. At present, "console" and "file" is implemented, however, much more output-targets such as "email" or "database" can be easily extended.
mlog provides a sententious API. There is only one public class "MLog" with a few methods such as: trace(const char* szFormat, ...), debug(const char* szFormat, ...), info(const char* szFormat, ...), warning(const char* szFormat, ...), error(const char* szFormat, ...), fatal(const char* szFormat, ...), and print(const char* szFormat, ...), all these methods are "printf()" like, which is very familiar to C/C++ developers.
Uasages:
First, #include "mlog.h", and then,
MLog* log = MLog::GetLog();
log->trace("a trace message");
log->debug("a debug message, %d, %s, %f", 123, "liigo", 3.14159);
log->warning("a waring message");
log->error("an error message");
log->fatal("a fatal error message");
log->print("print a message");
or:
mlog->trace("a trace message");
mlog->debug("a debug message, %d, %s, %f", 123, "liigo.com", 3.14159);
mlog->warning("a waring message");
mlog->error("an error message");
mlog->fatal("a fatal error message");
mlog->print("print a message");
where, the "mlog" is a C++ macro (#define mlog MLog::GetLog()), which equals to MLog::GetLog().
Which logging messages are outputed, and where the messages are outputed is depends upon the settings of the config file. By default, the messages which logging-level is greater than or equals to "warning" will be outputed to the console window.