LuaLogging
A simple API to use logging features in Lua.

## File appender

The file appender can be used to write log messages to a file. It uses Lua I/O routines to do its job.

    function logging.file {
        [filename = string,]
        [datePattern = string,]

        [logPattern = string,]
        [logPatterns = {
          [logging.DEBUG = string,]
          [logging.INFO  = string,]
          [logging.WARN  = string,]
          [logging.ERROR = string,]
          [logging.FATAL = string,]
        },]
        [timestampPattern = string,]
        [logLevel = log-level-constant,]
    }

- `filename`:
  The name of the file to be written to. On each call to log a message the file is opened for appending and closed immediately.
  If the file cannot be opened for appending the logging request returns nil and an error message.
  The default value is `"lualogging.log"`.
- `datePattern`:
  This is an optional parameter that can be used to specify a date pattern that will be passed to the `os.date` function to compose the filename.
  This is useful to create daily or monthly log files. If the user wants to create one log file per day he specifies a `"%Y-%m-%d"` pattern and a filename like `"temp%s.log"`.
- `logPatterns`:
  A table with logPattern strings indexed by the log-levels. A logPattern specifies how the message is written.
  If this parameter is omitted, a patterns table will be created with the parameter `logPattern` as the default value for each log-level. If `logPattern` also is omitted then each level will fall back to the current default setting, see `logging.defaultLogPatterns`.
- `logPattern`:
  This value will be used as the default value for each log-level that was omitted in `logPatterns`.
- `timestampPattern`:
  This is an optional parameter that can be used to specify a date/time formatting in the log message. See `logging.date` for the format. The default is taken from `logging.defaultTimestampPattern()`.
- `logLevel`:
  The initial log-level to set for the created logger.

## Example

    require"logging.file"

    local logger = logging.file {
        filename = "test%s.log",
        datePattern = "%Y-%m-%d",
    }

    logger:info("logging.file test")
    logger:debug("debugging...")
    logger:error("error!")