Class: Cathode::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/cathode/base.rb

Overview

Holds the top-level Cathode accessors for defining an API.

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.tokens_required ⇒ Object (readonly)

Returns the value of attribute tokens_required.



33
34
35
 
# File 'lib/cathode/base.rb', line 33

def tokens_required
  @tokens_required
end

Class Method Details

.define(&block) ⇒ Object

Defines an API



38
39
40
 
# File 'lib/cathode/base.rb', line 38

def define(&block)
  instance_eval(&block)
end

.require_tokens ⇒ Object

Configures this API to require incoming requests to have a valid token



85
86
87
 
# File 'lib/cathode/base.rb', line 85

def require_tokens
  @tokens_required = true
end

.resource(resource_name, params = nil, &block) ⇒ Object

Defines a singular resource on version 1.0.0 of the API



66
67
68
69
70
 
# File 'lib/cathode/base.rb', line 66

def resource(resource_name, params = nil, &block)
  version 1 do
    resource resource_name, params, &block
  end
end

.resources(resource_name, params = nil, &block) ⇒ Object

Defines a plural resource on version 1.0.0 of the API



78
79
80
81
82
 
# File 'lib/cathode/base.rb', line 78

def resources(resource_name, params = nil, &block)
  version 1 do
    resources resource_name, params, &block
  end
end

.version(version_number, &block) ⇒ Object

Defines a new version



56
57
58
 
# File 'lib/cathode/base.rb', line 56

def version(version_number, &block)
  Version.define(version_number, &block)
end

.versions ⇒ Cathode::ObjectCollection

Lists the collection of versions associated with this API



44
45
46
 
# File 'lib/cathode/base.rb', line 44

def versions
  Version.all
end