File: context.rb

package info (click to toggle)
ruby-cabin 0.9.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 272 kB
  • sloc: ruby: 1,306; makefile: 12
file content (50 lines) | stat: -rw-r--r-- 1,495 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
require "cabin/namespace"

# Logging context exists to make it easy to add and later undo any changes made
# to the context data associated with a given Logging::Channel
# 
# Usage:
#
#     context = channel.context
#     context["foo"] = "Hello world!"
#     channel.info("Sample log") # output includes { "foo" => "Hello world!" }
#     context.clear
#     channel.info("Sample log 2") # context cleared, key "foo" removed.
#
# Essentially, a Cabin::Context acts as a transactional proxy on top of a
# Cabin::Channel. Any changes you make in a context are passed through to
# the channel while keeping an ordered record of the changes made so
# you can unroll those changes when the context is no longer needed..
# 
class Cabin::Context
  def initialize(channel)
    @changes = []
    @channel = channel
  end # def initialize

  def on_clear(&block)
    @clear_callback = block
  end # def on_clear

  def []=(key, value)
    # Maintain a record of what was changed so clear() can undo this context.
    # This record is in reverse order so it can be undone in reverse later.
    @changes.unshift([key, value, @channel[key]])
    @channel[key] = value
  end # def []=

  def [](key)
    @channel[key]
  end # def []
  
  # Undo any changes made to the channel by this context.
  def clear
    @changes.each do |key, value, original|
      if original.nil?
        @channel.remove(key)
      else
        @channel[key] = original
      end
    end
  end # def clear
end # class Cabin::Context