cabin 0.5.0 → 0.6.0

data/examples/pipe.rb

@@ -0,0 +1,14 @@
+require "cabin"
+require "open4"
+
+cmd = 'strace -e trace=write date'
+
+logger = Cabin::Channel.get
+logger.subscribe(STDOUT)
+logger.level = :info
+
+status = Open4::popen4(cmd) do |pid, stdin, stdout, stderr|
+  stdin.close
+  logger.pipe(stdout => :info, stderr => :error)
+end
+

data/lib/cabin/channel.rb

@@ -1,4 +1,5 @@
 require "cabin/mixins/logger"
+require "cabin/mixins/pipe"
 require "cabin/mixins/timestamp"
 require "cabin/mixins/timer"
 require "cabin/namespace"
@@ -88,6 +89,7 @@ class Cabin::Channel
 
   include Cabin::Mixins::Timestamp
   include Cabin::Mixins::Logger
+  include Cabin::Mixins::Pipe
   include Cabin::Mixins::Timer
 
   # All channels come with a metrics provider.

data/lib/cabin/mixins/pipe.rb

@@ -0,0 +1,50 @@
+require "cabin/namespace"
+
+# This module provides a 'pipe' method which instructs cabin to pipe anything
+# read from the IO given to be logged.
+module Cabin::Mixins::Pipe
+
+  # Pipe IO objects to method calls on a logger.
+  #
+  # The argument is a hash of IO to method symbols. 
+  #
+  #     logger.pipe(io => :the_method)
+  #
+  # For each line read from 'io', logger.the_method(the_line) will be called.
+  #
+  # Example:
+  #
+  #     cmd = "strace -e trace=write date"
+  #     Open4::popen4(cmd) do |pid, stdin, stdout, stderr|
+  #       stdin.close
+  #
+  #       # Make lines from stdout be logged as 'info'
+  #       # Make lines from stderr be logged as 'error'
+  #       logger.pipe(stdout => :info, stderr => :error)
+  #     end
+  #
+  # Output:
+  #
+  #     write(1, "Fri Jan 11 22:49:42 PST 2013\n", 29) = 29 {"level":"error"}
+  #     Fri Jan 11 22:49:42 PST 2013 {"level":"info"}
+  #     +++ exited with 0 +++ {"level":"error"}
+  def pipe(io_to_method_map)
+    fds = io_to_method_map.keys
+
+    while !fds.empty?
+      readers, _, _ = IO.select(fds, nil, nil, nil)
+      readers.each do |fd|
+        begin
+          line = fd.readline.chomp
+        rescue EOFError
+          fd.close rescue nil
+          fds.delete(fd)
+          next
+        end
+
+        method_name = io_to_method_map[fd]
+        send(method_name, line)
+      end # readers.each
+    end # while !fds.empty?
+  end # def pipe
+end # module Cabin::Mixins::Logger

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: cabin
 version: !ruby/object:Gem::Version
+  version: 0.6.0
   prerelease:
-  version: 0.5.0
 platform: ruby
 authors:
 - Jordan Sissel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-11-09 00:00:00.000000000 Z
+date: 2013-01-12 00:00:00.000000000 Z
 dependencies: []
 description: This is an experiment to try and make logging more flexible and more consumable. Plain text logs are bullshit, let's emit structured and contextual logs. Metrics, too!
 email:
@@ -19,72 +19,41 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- !binary |-
-  bGliL2NhYmluLnJi
-- !binary |-
-  bGliL2NhYmluL2NoYW5uZWwucmI=
-- !binary |-
-  bGliL2NhYmluL2NvbnRleHQucmI=
-- !binary |-
-  bGliL2NhYmluL2luc3BlY3RhYmxlLnJi
-- !binary |-
-  bGliL2NhYmluL21ldHJpYy5yYg==
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MucmI=
-- !binary |-
-  bGliL2NhYmluL25hbWVzcGFjZS5yYg==
-- !binary |-
-  bGliL2NhYmluL3B1Ymxpc2hlci5yYg==
-- !binary |-
-  bGliL2NhYmluL3RpbWVyLnJi
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MvY291bnRlci5yYg==
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MvZ2F1Z2UucmI=
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MvaGlzdG9ncmFtLnJi
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MvbWV0ZXIucmI=
-- !binary |-
-  bGliL2NhYmluL21ldHJpY3MvdGltZXIucmI=
-- !binary |-
-  bGliL2NhYmluL21peGlucy9DQVBTTE9DSy5yYg==
-- !binary |-
-  bGliL2NhYmluL21peGlucy9jb2xvcnMucmI=
-- !binary |-
-  bGliL2NhYmluL21peGlucy9kcmFnb25zLnJi
-- !binary |-
-  bGliL2NhYmluL21peGlucy9sb2dnZXIucmI=
-- !binary |-
-  bGliL2NhYmluL21peGlucy90aW1lci5yYg==
-- !binary |-
-  bGliL2NhYmluL21peGlucy90aW1lc3RhbXAucmI=
-- !binary |-
-  bGliL2NhYmluL291dHB1dHMvaW8ucmI=
-- !binary |-
-  bGliL2NhYmluL291dHB1dHMvc3RkbGliLWxvZ2dlci5yYg==
-- !binary |-
-  bGliL2NhYmluL291dHB1dHMvemVyb21xLnJi
-- !binary |-
-  bGliL2NhYmluL291dHB1dHMvZW0vc3RkbGliLWxvZ2dlci5yYg==
-- !binary |-
-  ZXhhbXBsZXMvZmlib25hY2NpLXRpbWluZy5yYg==
-- !binary |-
-  ZXhhbXBsZXMvbWV0cmljcy5yYg==
-- !binary |-
-  ZXhhbXBsZXMvc2FtcGxlLnJi
-- !binary |-
-  ZXhhbXBsZXMvc2luYXRyYS1sb2dnaW5nLnJi
-- !binary |-
-  dGVzdC9hbGwucmI=
-- !binary |-
-  dGVzdC9taW5pdGVzdC1wYXRjaC5yYg==
-- !binary |-
-  dGVzdC90ZXN0X2xvZ2dpbmcucmI=
-- !binary |-
-  dGVzdC90ZXN0X21ldHJpY3MucmI=
-- !binary |-
-  dGVzdC90ZXN0X3plcm9tcS5yYg==
+- lib/cabin.rb
+- lib/cabin/metrics.rb
+- lib/cabin/timer.rb
+- lib/cabin/namespace.rb
+- lib/cabin/metric.rb
+- lib/cabin/context.rb
+- lib/cabin/publisher.rb
+- lib/cabin/channel.rb
+- lib/cabin/inspectable.rb
+- lib/cabin/mixins/logger.rb
+- lib/cabin/mixins/timer.rb
+- lib/cabin/mixins/CAPSLOCK.rb
+- lib/cabin/mixins/pipe.rb
+- lib/cabin/mixins/colors.rb
+- lib/cabin/mixins/timestamp.rb
+- lib/cabin/mixins/dragons.rb
+- lib/cabin/metrics/timer.rb
+- lib/cabin/metrics/histogram.rb
+- lib/cabin/metrics/meter.rb
+- lib/cabin/metrics/gauge.rb
+- lib/cabin/metrics/counter.rb
+- lib/cabin/outputs/stdlib-logger.rb
+- lib/cabin/outputs/io.rb
+- lib/cabin/outputs/zeromq.rb
+- lib/cabin/outputs/em/stdlib-logger.rb
+- examples/metrics.rb
+- examples/fibonacci-timing.rb
+- examples/sample.rb
+- examples/pipe.rb
+- examples/sinatra-logging.rb
+- test/test_metrics.rb
+- test/all.rb
+- test/minitest-patch.rb
+- test/test_logging.rb
+- test/test_zeromq.rb
 - LICENSE
 - CHANGELIST
 - bin/rubygems-cabin-test
@@ -98,14 +67,14 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: !binary |-
         MA==
   none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: !binary |-
         MA==