Scrolls::Decorators

[fabiokung]

This is a proposal for an alternative (and simpler) frontend for Scrolls::Log. It should cover the common cases, but the underlying Scrolls::Log.log is still there when needed.

See test_decorators.rb for usage.

Example:

class MyService
  include Scrolls::Decorators

  log_context "myservice", release: "v51"

  def simple_log_with_context
    log
    # output: "myservice release=v51\n"
  end

  def basic_logging
    log "basic", "that", "works", data: "useful", number: 10
    # output: "myservice release=v51 basic that works data=useful number=10\n"
  end

  log
  def wrapping
    sleep 0.1
    # output:
    #  "myservice release=v51 class=MyService method=wrapping at=start\n"
    #  "myservice release=v51 class=MyService method=wrapping at=finish elapsed=0.1"
  end

  # and more ...
end

[asenchi]

I did a nearly full rewrite of Scrolls (v2 branch, going to be merged this week). I am still not sure about the method decorator but love the context decorator. I want to work a version of this PR into the release after v2 is merged/released.

[asenchi]

I've still never grown comfortable with this decorator. I think I am going to close this for now, and will readdress as time passes. I do really love the log_context at the top of a class, that could be really useful, but I don't have the time these days to hack on much, so keeping this lib short and sweet and working is my primary concern.

Thanks!