Module: CasualAPI::DSL

Defined in:

lib/dsl.rb

Class Method Summary

• .extended(obj) ⇒ Object
• .normalize(hs) ⇒ Object
• .parse(file) ⇒ Object

Instance Method Summary

• #action_stack ⇒ Object
• #domain(*path, &block) ⇒ Object
• #path(method, *names, &block) ⇒ Object

Class Method Details

.extended(obj) ⇒ Object

# File 'lib/dsl.rb', line 233

def self.extended obj
  # add stacks and a context to an extended object.
  obj.instance_variable_set(:@action_stack, [])
  obj.instance_variable_set(:@domain_stack, [])
  obj.instance_variable_set(:@context_stack, [{}])
  obj.extend Action
  obj.extend Annotation
  obj.extend ExtExpression
  obj.extend SyntaxSugar
end

.normalize(hs) ⇒ Object

# File 'lib/dsl.rb', line 276

def self.normalize hs
  description = hs[:description] || {}
  description[:params] ||= {}
  parameters = hs[:action].parameters.map.with_index{|(_,n),i|
    { n => {
            required: i < hs[:action].arity,
            is_file: (hs[:is_file]||[]).include?(n),
            as_file: (hs[:as_file]||[]).include?(n),
            tempfile: (hs[:tempfile]||[]).include?(n),
            is_array: (hs[:is_array]||[]).include?(n),
            is_hash: (hs[:is_hash]||[]).include?(n),
           }
    }
  }.inject({}, :merge)
  { 
    method: hs[:method],
      names: hs[:names],
      description: description,
      domain: hs[:domain],
      action: hs[:action],
      parameters: parameters,
  }
end

.parse(file) ⇒ Object

# File 'lib/dsl.rb', line 269

def self.parse(file)
  obj = Object.new
  obj.extend DSL
  obj.instance_eval(open(file){|f|f.read})
  obj.action_stack.map{|x| normalize x }
end

Instance Method Details

#action_stack ⇒ Object

# File 'lib/dsl.rb', line 243

def action_stack
  @action_stack
end

#domain(*path, &block) ⇒ Object

# File 'lib/dsl.rb', line 247

def domain(*path , &block)
  # annotations don't effect over domain
  clear_annotaion
  @domain_stack.push *path
  @context_stack.push(@context_stack.last.clone)
  block.call
  @context_stack.pop
  @domain_stack.pop path.length
  # annotations don't effect over domain
  clear_annotaion
end

#path(method, *names, &block) ⇒ Object

# File 'lib/dsl.rb', line 259

def path(method, *names, &block)
  meta = @context_stack.last.clone
  meta[:method] = method
  meta[:names] = names
  meta[:domain] = @domain_stack.clone
  meta[:action] = block
  clear_annotaion    # annotations effect only a path.
  @action_stack.push meta
end