Module: Webmachine::Trace

Defined in:
lib/webmachine/trace.rb,
lib/webmachine/trace/fsm.rb,
lib/webmachine/trace/listener.rb,
lib/webmachine/trace/resource_proxy.rb,
lib/webmachine/trace/trace_resource.rb,
lib/webmachine/trace/pstore_trace_store.rb

Overview

Contains means to enable the Webmachine visual debugger.

Defined Under Namespace

Modules: FSM Classes: Listener, PStoreTraceStore, ResourceProxy, TraceResource

Constant Summary collapse

TRACE_STORES =

Classes that implement storage for visual debugger traces.

{
  :memory => Hash,
  :pstore => PStoreTraceStore
}
DEFAULT_TRACE_SUBSCRIBER = 
Webmachine::Events.subscribe(
  /wm\.trace\..+/,
  Webmachine::Trace::Listener.new
)

Class Method Summary collapse

Class Method Details

.fetch(key) ⇒ Array

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Fetches a given trace from the trace store. This is used to send specific trace information to the visual debugger.

Parameters:

  • key (String) —

    the trace’s key

Returns:

  • (Array) —

    the raw trace



57
58
59
 
# File 'lib/webmachine/trace.rb', line 57

def fetch(key)
  trace_store.fetch(key)
end

.record(key, trace) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Records a trace from a processed request. This is automatically called by ResourceProxy when finishing the request.

Parameters:

  • key (String) —

    a unique identifier for the request

  • trace (Array) —

    the raw trace generated by processing the request



40
41
42
 
# File 'lib/webmachine/trace.rb', line 40

def record(key, trace)
  trace_store[key] = trace
end

.trace?(resource) ⇒ true, false

Determines whether this resource instance should be traced.

Parameters:

Returns:

  • (true, false) —

    whether to trace the resource



26
27
28
29
30
31
 
# File 'lib/webmachine/trace.rb', line 26

def trace?(resource)
  # For now this defers to the resource to enable tracing in the
  # initialize method. At a later time, we can add tracing at the
  # Application level, perhaps.
  resource.trace?
end

.trace_listener=(listeners) ⇒ Array<Object>

Sets the trace listener objects. Defaults to Webmachine::Trace::Listener.new.

Parameters:

  • listeners (Array<Object>) —

    a list of event listeners

Returns:

  • (Array<Object>) —

    a list of event subscribers



85
86
87
88
89
90
91
 
# File 'lib/webmachine/trace.rb', line 85

def trace_listener=(listeners)
  Webmachine::Events.unsubscribe(DEFAULT_TRACE_SUBSCRIBER)

  Array(listeners).map do |listener|
    Webmachine::Events.subscribe(/wm\.trace\..+/, listener)
  end
end

.trace_store ⇒ Object 



72
73
74
75
76
77
78
 
# File 'lib/webmachine/trace.rb', line 72

def trace_store
  @trace_store ||= begin
                     opts = Array(@trace_store_opts).dup
                     type = opts.shift
                     TRACE_STORES[type].new(*opts)
                   end
end

.trace_store=(*args) ⇒ Object

Sets the trace storage method. The first parameter should be a Symbol, followed by any additional options for the store. Defaults to :memory, which is an in-memory Hash.

Examples:

Webmachine::Trace.trace_store = :pstore, "/tmp/webmachine.trace"


66
67
68
69
 
# File 'lib/webmachine/trace.rb', line 66

def trace_store=(*args)
  @trace_store = nil
  @trace_store_opts = args
end

.traces ⇒ Array<String>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Retrieves keys of traces that have been recorded. This is used to present a list of available traces in the visual debugger.

Returns:

  • (Array<String>) —

    a list of recorded traces



48
49
50
 
# File 'lib/webmachine/trace.rb', line 48

def traces
  trace_store.keys
end