Class: HaveAPI::Resource

Inherits:
Common
  • Object
show all
Defined in:
lib/haveapi/resource.rb

Direct Known Subclasses

Authentication::Token::Resources::Token

Class Method Summary collapse

Methods inherited from Common

has_attr, inherit_attrs

Class Method Details

.actions ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/haveapi/resource.rb', line 24

def self.actions
  constants.select do |c|
    obj = const_get(c)

    begin
      if obj.obj_type == :action
        yield obj
      end

    rescue NoMethodError
      next
    end
  end
end

.define_action(name, superclass: Action, &block) ⇒ Object 



111
112
113
114
115
116
117
118
 
# File 'lib/haveapi/resource.rb', line 111

def self.define_action(name, superclass: Action, &block)
  return false if const_defined?(name)

  cls = Class.new(superclass)
  const_set(name, cls)
  superclass.delayed_inherited(cls)
  cls.class_exec(&block)
end

.define_resource(name, superclass: Resource, &block) ⇒ Object 



102
103
104
105
106
107
108
109
 
# File 'lib/haveapi/resource.rb', line 102

def self.define_resource(name, superclass: Resource, &block)
  return false if const_defined?(name)

  cls = Class.new(superclass)
  const_set(name, cls)
  cls.class_exec(&block) if block
  cls
end

.describe(hash, context) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/haveapi/resource.rb', line 79

def self.describe(hash, context)
  ret = {description: self.desc, actions: {}, resources: {}}

  context.resource = self

  hash[:actions].each do |action, url|
    context.action = action
    context.url = url

    a_name = action.to_s.demodulize.underscore

    a_desc = action.describe(context)

    ret[:actions][a_name] = a_desc if a_desc
  end

  hash[:resources].each do |resource, children|
    ret[:resources][resource.to_s.demodulize.underscore] = resource.describe(children, context)
  end

  ret
end

.inherited(subclass) ⇒ Object 



11
12
13
 
# File 'lib/haveapi/resource.rb', line 11

def self.inherited(subclass)
  subclass.instance_variable_set(:@obj_type, obj_type)
end

.params(name, &block) ⇒ Object 



15
16
17
18
19
20
21
22
 
# File 'lib/haveapi/resource.rb', line 15

def self.params(name, &block)
  if block
    @params ||= {}
    @params[name] = block
  else
    @params[name]
  end
end

.resource_name ⇒ Object 



54
55
56
57
58
 
# File 'lib/haveapi/resource.rb', line 54

def self.resource_name
  ret = self.to_s.demodulize

  singular ? ret.singularize.underscore : ret.tableize
end

.resources ⇒ Object 



39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/haveapi/resource.rb', line 39

def self.resources
  constants.select do |c|
    obj = const_get(c)

    begin
      if obj.obj_type == :resource
        yield obj
      end

    rescue NoMethodError
      next
    end
  end
end

.routes(prefix = '/') ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/haveapi/resource.rb', line 60

def self.routes(prefix='/')
  ret = []
  prefix = "#{prefix}#{@route || resource_name}/"

  actions do |a|
    # Call used_by for selected model adapters. It is safe to do
    # only when all classes are loaded.
    a.initialize

    ret << Route.new(a.build_route(prefix).chomp('/'), a)
  end

  resources do |r|
    ret << {r => r.routes(prefix)}
  end

  ret
end