Class: Liquid::Context

Inherits:
Object
  • Object
show all
Defined in:
lib/liquid/context.rb

Overview

Context keeps the variable stack and resolves variables, as well as keywords

context['variable'] = 'testing'
context['variable'] #=> 'testing'
context['true']     #=> true
context['10.2232']  #=> 10.2232

context.stack do
   context['bob'] = 'bobsen'
end

context['bob']  #=> nil  class Context

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(environments = {}, outer_scope = {}, registers = {}, rethrow_errors = false) ⇒ Context

Returns a new instance of Context.



18
19
20
21
22
23
24
25
26
27
 
# File 'lib/liquid/context.rb', line 18

def initialize(environments = {}, outer_scope = {}, registers = {}, rethrow_errors = false)
  @environments   = [environments].flatten
  @scopes         = [(outer_scope || {})]
  @registers      = registers
  @errors         = []
  @rethrow_errors = rethrow_errors
  squash_instance_assigns_with_environments

  @interrupts = []
end

Instance Attribute Details

#environments ⇒ Object (readonly)

Returns the value of attribute environments.



16
17
18
 
# File 'lib/liquid/context.rb', line 16

def environments
  @environments
end

#errors ⇒ Object (readonly)

Returns the value of attribute errors.



16
17
18
 
# File 'lib/liquid/context.rb', line 16

def errors
  @errors
end

#registers ⇒ Object (readonly)

Returns the value of attribute registers.



16
17
18
 
# File 'lib/liquid/context.rb', line 16

def registers
  @registers
end

#scopes ⇒ Object (readonly)

Returns the value of attribute scopes.



16
17
18
 
# File 'lib/liquid/context.rb', line 16

def scopes
  @scopes
end

Instance Method Details

#[](key) ⇒ Object 



119
120
121
 
# File 'lib/liquid/context.rb', line 119

def [](key)
  resolve(key)
end

#[]=(key, value) ⇒ Object

Only allow String, Numeric, Hash, Array, Proc, Boolean or Liquid::Drop



115
116
117
 
# File 'lib/liquid/context.rb', line 115

def []=(key, value)
  @scopes[0][key] = value
end

#add_filters(filters) ⇒ Object

Adds filters to this context.

Note that this does not register the filters with the main Template object. see Template.register_filter for that



37
38
39
40
41
42
43
44
45
 
# File 'lib/liquid/context.rb', line 37

def add_filters(filters)
  filters = [filters].flatten.compact

  filters.each do |f|
    raise ArgumentError, "Expected module but got: #{f.class}" unless f.is_a?(Module)
    Strainer.add_known_filter(f)
    strainer.extend(f)
  end
end

#clear_instance_assigns ⇒ Object 



110
111
112
 
# File 'lib/liquid/context.rb', line 110

def clear_instance_assigns
  @scopes[0] = {}
end

#handle_error(e) ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/liquid/context.rb', line 62

def handle_error(e)
  errors.push(e)
  raise if @rethrow_errors

  case e
  when SyntaxError
    "Liquid syntax error: #{e.message}"
  else
    "Liquid error: #{e.message}"
  end
end

#has_interrupt? ⇒ Boolean

are there any not handled interrupts?

Returns:

  • (Boolean) 


48
49
50
 
# File 'lib/liquid/context.rb', line 48

def has_interrupt?
  !@interrupts.empty?
end

#has_key?(key) ⇒ Boolean

Returns:

  • (Boolean) 


123
124
125
 
# File 'lib/liquid/context.rb', line 123

def has_key?(key)
  resolve(key) != nil
end

#invoke(method, *args) ⇒ Object 



74
75
76
 
# File 'lib/liquid/context.rb', line 74

def invoke(method, *args)
  strainer.invoke(method, *args)
end

#merge(new_scopes) ⇒ Object

Merge a hash of variables in the current local scope



85
86
87
 
# File 'lib/liquid/context.rb', line 85

def merge(new_scopes)
  @scopes[0].merge!(new_scopes)
end

#pop ⇒ Object

Pop from the stack. use Context#stack instead

Raises:



90
91
92
93
 
# File 'lib/liquid/context.rb', line 90

def pop
  raise ContextError if @scopes.size == 1
  @scopes.shift
end

#pop_interrupt ⇒ Object

pop an interrupt from the stack



58
59
60
 
# File 'lib/liquid/context.rb', line 58

def pop_interrupt
  @interrupts.pop
end

#push(new_scope = {}) ⇒ Object

Push new local scope on the stack. use Context#stack instead

Raises:



79
80
81
82
 
# File 'lib/liquid/context.rb', line 79

def push(new_scope={})
  @scopes.unshift(new_scope)
  raise StackLevelError, "Nesting too deep" if @scopes.length > 100
end

#push_interrupt(e) ⇒ Object

push an interrupt to the stack. this interrupt is considered not handled.



53
54
55
 
# File 'lib/liquid/context.rb', line 53

def push_interrupt(e)
  @interrupts.push(e)
end

#stack(new_scope = {}) ⇒ Object

Pushes a new local scope on the stack, pops it at the end of the block

Example:

context.stack do
   context['var'] = 'hi'
end

context['var]  #=> nil



103
104
105
106
107
108
 
# File 'lib/liquid/context.rb', line 103

def stack(new_scope={})
  push(new_scope)
  yield
ensure
  pop
end

#strainer ⇒ Object 



29
30
31
 
# File 'lib/liquid/context.rb', line 29

def strainer
  @strainer ||= Strainer.create(self)
end