Module: Apipie::DSL::Action

Included in:
Concern, Controller
Defined in:
lib/apipie/dsl_definition.rb

Instance Method Summary collapse

Instance Method Details

#api(method, path, desc = nil, options = {}) ⇒ Object

# load paths from routes and don’t provide description

api



82
83
84
85
86
 
# File 'lib/apipie/dsl_definition.rb', line 82

def api(method, path, desc = nil, options={}) #:doc:
  return unless Apipie.active_dsl?
  _apipie_dsl_data[:api] = true
  _apipie_dsl_data[:api_args] << [method, path, desc, options]
end

#api!(desc = nil, options = {}) ⇒ Object

# load paths from routes

api! "short description",



91
92
93
94
95
 
# File 'lib/apipie/dsl_definition.rb', line 91

def api!(desc = nil, options={}) #:doc:
  return unless Apipie.active_dsl?
  _apipie_dsl_data[:api] = true
  _apipie_dsl_data[:api_from_routes] = { :desc => desc, :options =>options }
end

#def_param_group(name, &block) ⇒ Object 



74
75
76
 
# File 'lib/apipie/dsl_definition.rb', line 74

def def_param_group(name, &block)
  Apipie.add_param_group(self, name, &block)
end

#example(example) ⇒ Object

Show some example of what does the described method return.



109
110
111
112
 
# File 'lib/apipie/dsl_definition.rb', line 109

def example(example) #:doc:
  return unless Apipie.active_dsl?
  _apipie_dsl_data[:examples] << example.strip_heredoc
end

#resource_description(options = {}, &block) ⇒ Object

Describe whole resource

Example: api :desc => “Show user profile”, :path => “/users/”, :version => ‘1.0 - 3.4.2012’ param :id, Fixnum, :desc => “User ID”, :required => true desc <<-EOS

Long description...

EOS

Raises:

  • (ArgumentError) 


122
123
124
125
126
127
128
129
130
131
132
 
# File 'lib/apipie/dsl_definition.rb', line 122

def resource_description(options = {}, &block) #:doc:
  return unless Apipie.active_dsl?
  raise ArgumentError, "Block expected" unless block_given?

  dsl_data = ResourceDescriptionDsl.eval_dsl(self, &block)
  versions = dsl_data[:api_versions]
  @apipie_resource_descriptions = versions.map do |version|
    Apipie.define_resource_description(self, version, dsl_data)
  end
  Apipie.set_controller_versions(self, versions)
end

#see(*args) ⇒ Object

Reference other similar method

api :PUT, '/articles/:id'
see "articles#create"
def update; end



102
103
104
105
 
# File 'lib/apipie/dsl_definition.rb', line 102

def see(*args)
  return unless Apipie.active_dsl?
  _apipie_dsl_data[:see] << args
end