README.md in logsly-1.3.1 vs README.md in logsly-1.3.2
- old
+ new
@@ -30,21 +30,22 @@
**Note**: [Logging v1.8.2](https://github.com/TwP/logging/tree/logging-1.8.2) is the last version that is Ruby 1.8.7 compatible. However, that version doesn't work in modern Ruby versions. Therefore I've taken the source from Logging v1.8.2 and brought it in manually as a submodule under the `Logsly::Logging182` namespace. I've tweaked the original source to allow properly requiring/referencing it as a submodule and to also make it work in modern Ruby. All source in the `Logsly::Logging182` namespace is [MIT License Copyright (c) 2012 Tim Pease](https://github.com/TwP/logging/tree/logging-1.8.2#license) and all credit is his.
## Settings
* `log_type`: custom string used to identify the type of the logger
-* `level`: the level in use (default: `'debug'`)
+* `level`: the level in use (default: `'info'`)
* `outputs`: list of named outputs to log to (default: `[]`)
## Outputs
### Stdout
```ruby
Logsly.stdout('my_stdout') do |logger|
+ level 'info' # (optional) if set, this level will be used instead of the logger's setting
pattern '[%d %-5l] : %m\n'
- colors 'my_colors' # use the 'my_colors' color scheme
+ colors 'my_colors' # use the 'my_colors' color scheme
end
```
Define a named stdout output to use with your loggers. Pass a block to customize it. The block will be lazy-eval'd when a logger using it is initialized. The block is passed the logger instance.
@@ -52,10 +53,11 @@
```ruby
Logsly.file('my_file') do |logger|
path "development.log"
+ level 'debug' # log debug level when outputting to this file
pattern '[%d %-5l] : %m\n'
# don't use a color scheme
end
```
@@ -67,9 +69,10 @@
Logsly.syslog('my_syslog') do |logger|
identity "my_syslog_logger" # or whatever
facility Syslog::LOG_LOCAL0 # or whatever (default: `LOG_LOCAL0`)
log_opts Syslog::LOG_PID # or whatever (default: `(LOG_PID | LOG_CONS)`)
+ # no custom level set, just use the logger's setting
pattern '%m\n'
# don't use a color scheme
end
```