Class: Sinatra::Rabbit::Collection

Inherits:
Object
  • Object
show all
Defined in:
lib/sinatra/rabbit.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, &block) ⇒ Collection

Returns a new instance of Collection.



119
120
121
122
123
124
125
 
# File 'lib/sinatra/rabbit.rb', line 119

def initialize(name, &block)
  @name = name
  @description = ""
  @operations = {}
  instance_eval(&block) if block_given?
  generate_documentation
end

Instance Attribute Details

#name ⇒ Object (readonly)

Returns the value of attribute name.



117
118
119
 
# File 'lib/sinatra/rabbit.rb', line 117

def name
  @name
end

#operations ⇒ Object (readonly)

Returns the value of attribute operations.



117
118
119
 
# File 'lib/sinatra/rabbit.rb', line 117

def operations
  @operations
end

Instance Method Details

#add_feature_params(features) ⇒ Object 



181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
 
# File 'lib/sinatra/rabbit.rb', line 181

def add_feature_params(features)
  features.each do |f|
    f.operations.each do |fop|
      if cop = operations[fop.name]
        fop.params.each_key do |k|
          if cop.params.has_key?(k)
            raise DuplicateParamException, "Parameter '#{k}' for operation #{fop.name} defined by collection #{@name} and by feature #{f.name}"
          else
            cop.params[k] = fop.params[k]
          end
        end
      end
    end
  end
end

#description(text = '') ⇒ Object

Set/Return description for collection If first parameter is not present, full description will be returned.



130
131
132
133
 
# File 'lib/sinatra/rabbit.rb', line 130

def description(text='')
  return @description if text.blank?
  @description = text
end

#generate ⇒ Object 



166
167
168
169
170
171
172
173
174
175
176
177
178
179
 
# File 'lib/sinatra/rabbit.rb', line 166

def generate
  operations.values.each { |op| op.generate }
  app = ::Sinatra::Application
  collname = name # Work around Ruby's weird scoping/capture
  app.send(:define_method, "#{name.to_s.singularize}_url") do |id|
      url_for "/api/#{collname}/#{id}", :full
  end

  if index_op = operations[:index]
    app.send(:define_method, "#{name}_url") do
      url_for index_op.path.gsub(/\/\?$/,''), :full
    end
  end
end

#generate_documentation ⇒ Object 



135
136
137
138
139
140
141
142
143
144
 
# File 'lib/sinatra/rabbit.rb', line 135

def generate_documentation
  coll, oper, features = self, @operations, Deltacloud::driver.features(name)
  ::Sinatra::Application.get("/api/docs/#{@name}") do
    @collection, @operations, @features = coll, oper, features
    respond_to do |format|
      format.html { haml :'docs/collection' }
      format.xml { haml :'docs/collection' }
    end
  end
end

#operation(name, opts = {}, &block) ⇒ Object

Add a new operation for this collection. For the standard REST operations :index, :show, :update, and :destroy, we already know what method to use and whether this is an operation on the URL for individual elements or for the whole collection.

For non-standard operations, options must be passed:

:method : one of the HTTP methods
:member : whether this is an operation on the collection or an
          individual element (FIXME: custom operations on the
          collection will use a nonsensical URL) The URL for the
          operation is the element URL with the name of the operation
          appended

This also defines a helper method like show_instance_url that returns the URL to this operation (in request context)

Raises:



161
162
163
164
 
# File 'lib/sinatra/rabbit.rb', line 161

def operation(name, opts = {}, &block)
  raise DuplicateOperationException if @operations[name]
  @operations[name] = Operation.new(self, name, opts, &block)
end