README.md in tee_logger-2.7.0 vs README.md in tee_logger-3.0.0

- old
+ new

@@ -1,130 +1,145 @@ -[![Gem Version](https://badge.fury.io/rb/tee_logger.svg)](http://badge.fury.io/rb/tee_logger) -[![Build Status](https://travis-ci.org/k-ta-yamada/tee_logger.svg)](https://travis-ci.org/k-ta-yamada/tee_logger) -[![Code Climate](https://codeclimate.com/github/k-ta-yamada/tee_logger/badges/gpa.svg)](https://codeclimate.com/github/k-ta-yamada/tee_logger) -[![Test Coverage](https://codeclimate.com/github/k-ta-yamada/tee_logger/badges/coverage.svg)](https://codeclimate.com/github/k-ta-yamada/tee_logger/coverage) - -> Sorry, I changed Usage from version 2.0.0 - -- [Rubygems.org](https://rubygems.org/gems/tee_logger) -- [GitHub](https://github.com/k-ta-yamada/tee_logger) -- [RubyDoc.info](http://www.rubydoc.info/gems/tee_logger) - -# TeeLogger - -logging to file and standard output. -require standard library only. - - -## Characteristic - -- simple: use standard lib only. -- like Logger: see usage. -- enabled or disabled by switching the output of the console and the logfile. - - -## Installation - -Add this line to your application's Gemfile: - -```ruby -gem 'tee_logger' -``` - -And then execute: - - $ bundle - -Or install it yourself as: - - $ gem install tee_logger - - -## Usage - -```ruby -require 'tee_logger' - -# Logger.new like options(logdev, shift_age, shift_size) -# options default value is -# logdev = './tee_logger.log' -# shift_age = 0 -# shift_size = 1_048_576 -tl = TeeLogger.new - -# let's logging -tl.debug 'hello' -tl.debug(:progname) { 'hello world' } -tl.progname = 'App' -tl.debug 'hello tee_logger' - -# disable only when specified -tl.info 'this message is logfile only', :console -tl.info 'this message is console only', :logfile - -# disable console output -tl.disable(:console) -tl.info 'this message is logfile only' - -# enable console output -tl.enable(:console) -tl.info 'this message is logfile and console' - -# disable logfile output -tl.disable(:logfile) -tl.info 'this message is consle only' - -# enable logfile output -tl.enable(:logfile) -tl.info 'this message is logfile and console' - -# disabe in block -tl.disable(:console) do - tl.info 'this message is logfile only' -end -tl.info 'this message is logfile and console' - -# and others like Logger's -tl.debug? # => true -tl.info? # => true -tl.warn? # => true -tl.error? # => true -tl.fatal? # => true - -tl.level # => 0 -tl.level = Logger::INFO -tl.debug 'this message is not logging' - -tl.formatter # => nil or Proc -tl.formatter = proc { |severity, datetime, progname, message| "#{severity}:#{message}" } - -tl.datetime_format # => nil or Proc -tl.datetime_format = '%Y%m%d %H%M%S ' -``` - - -## Development - -After checking out the repo, run `bundle install` to install dependencies. -Then, run `rake rspec` to run the tests. -You can also run `budle exec pry -r ./lib/tee_logger` for an interactive prompt -that will allow you to experiment. - -To install this gem onto your local machine, run `bundle exec rake install`. -To release a new version, update the version number in `version.rb`, -and then run `bundle exec rake release`, -which will create a git tag for the version, -push git commits and tags, -and push the `.gem` file to [rubygems.org](https://rubygems.org). - - -## Contributing - -Bug reports and pull requests are welcome on GitHub at https://github.com/k-ta-yamada/tee_logger. -This project is intended to be a safe, -welcoming space for collaboration, -and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct. - - -## License - -The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT). +[![Gem Version](https://badge.fury.io/rb/tee_logger.svg)](http://badge.fury.io/rb/tee_logger) +[![Build Status](https://travis-ci.org/k-ta-yamada/tee_logger.svg)](https://travis-ci.org/k-ta-yamada/tee_logger) +[![Code Climate](https://codeclimate.com/github/k-ta-yamada/tee_logger/badges/gpa.svg)](https://codeclimate.com/github/k-ta-yamada/tee_logger) +[![Test Coverage](https://codeclimate.com/github/k-ta-yamada/tee_logger/badges/coverage.svg)](https://codeclimate.com/github/k-ta-yamada/tee_logger/coverage) + +> Sorry. In from version 2 to version 3, changed usage. +> see also [CHANGELOG.md](/CHANGELOG.md#v300). + +- [Rubygems.org](https://rubygems.org/gems/tee_logger) +- [GitHub](https://github.com/k-ta-yamada/tee_logger) +- [RubyDoc.info](http://www.rubydoc.info/gems/tee_logger) + +# TeeLogger + +logging to file and standard output. +require standard library only. + + +## Characteristic + +- use standard lib only. +- like Logger: see usage. +- enabled or disabled by switching the output of the console and the logfile. + + +## Installation + +Add this line to your application's Gemfile: + +```ruby +gem 'tee_logger' +``` + +And then execute: + +``` +$ bundle +``` + +Or install it yourself as: + +``` +$ gem install tee_logger +``` + + +## Usage + +```ruby +require 'tee_logger' + +# Logger.new like options(logdev, shift_age, shift_size) +# options default value is +# logdev = './tee_logger.log' +# shift_age = 0 +# shift_size = 1_048_576 +tl = TeeLogger.new + +# let's logging +tl.debug 'hello' +tl.debug(:progname) { 'hello world' } +tl.progname = 'App' +tl.debug 'hello tee_logger' + +# enable only when specified +tl.info 'this message is console and logfile' +tl.info 'this message is console only', :console +tl.info 'this message is logfile only', :logfile + +# log meassage indent +tl.info 'hello' # => 'hello' +tl.info 'hello', 0 # => 'hello' +tl.info 'hello', 2 # => ' hello' + +# enabling and indent +tl.info 'this message is console only', 2, :console +tl.info 'this message is console only', :console, 2 + +# disable console output +tl.disable(:console) +tl.info 'this message is logfile only' + +# enable console output +tl.enable(:console) +tl.info 'this message is logfile and console' + +# disable logfile output +tl.disable(:logfile) +tl.info 'this message is consle only' + +# enable logfile output +tl.enable(:logfile) +tl.info 'this message is logfile and console' + +# disabe in block +tl.disable(:console) do + tl.info 'this message is logfile only' +end +tl.info 'this message is logfile and console' + +# and others like Logger's +tl.debug? # => true +tl.info? # => true +tl.warn? # => true +tl.error? # => true +tl.fatal? # => true + +tl.level # => 0 +tl.level = Logger::INFO +tl.debug 'this message is not logging' + +tl.formatter # => nil or Proc +tl.formatter = proc { |severity, datetime, progname, message| "#{severity}:#{message}" } + +tl.datetime_format # => nil or Proc +tl.datetime_format = '%Y%m%d %H%M%S ' +``` + + +## Development + +After checking out the repo, run `bundle install` to install dependencies. +Then, run `rake rspec` to run the tests. +You can also run `budle exec pry -r ./lib/tee_logger` for an interactive prompt +that will allow you to experiment. + +To install this gem onto your local machine, run `bundle exec rake install`. +To release a new version, update the version number in `version.rb`, +and then run `bundle exec rake release`, +which will create a git tag for the version, +push git commits and tags, +and push the `.gem` file to [rubygems.org](https://rubygems.org). + + +## Contributing + +Bug reports and pull requests are welcome on GitHub at https://github.com/k-ta-yamada/tee_logger. +This project is intended to be a safe, +welcoming space for collaboration, +and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct. + + +## License + +The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).