Class: Fog::Service

Inherits:
Object
  • Object
show all
Defined in:
lib/fog/core/service.rb

Defined Under Namespace

Modules: Collections Classes: Error, NotFound

Class Method Summary collapse

Class Method Details

.collection(new_collection) ⇒ Object 



85
86
87
 
# File 'lib/fog/core/service.rb', line 85

def collection(new_collection)
  collections << new_collection
end

.collections ⇒ Object 



89
90
91
 
# File 'lib/fog/core/service.rb', line 89

def collections
  @collections ||= []
end

.inherited(child) ⇒ Object 



21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/fog/core/service.rb', line 21

def inherited(child)
  child.class_eval <<-EOS, __FILE__, __LINE__
    module Collections
      include Fog::Service::Collections

      def service
        #{child}
      end
    end

    def self.service
      #{child}
    end
  EOS
end

.model(new_model) ⇒ Object 



93
94
95
 
# File 'lib/fog/core/service.rb', line 93

def model(new_model)
  models << new_model
end

.model_path(new_path) ⇒ Object 



81
82
83
 
# File 'lib/fog/core/service.rb', line 81

def model_path(new_path)
  @model_path = new_path
end

.models ⇒ Object 



97
98
99
 
# File 'lib/fog/core/service.rb', line 97

def models
  @models ||= []
end

.new(options = {}) ⇒ Object 



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/fog/core/service.rb', line 37

def new(options={})
  if Fog.bin
    default_credentials = Fog.credentials.reject {|key, value| !requirements.include?(key)}
    options = default_credentials.merge(options)
  end

  validate_arguments(options)
  setup_requirements

  if Fog.mocking?
    service::Mock.send(:include, service::Collections)
    service::Mock.new(options)
  else
    service::Real.send(:include, service::Collections)
    service::Real.new(options)
  end
end

.recognized ⇒ Object 



125
126
127
 
# File 'lib/fog/core/service.rb', line 125

def recognized
  @recognized ||= []
end

.recognizes(*args) ⇒ Object 



121
122
123
 
# File 'lib/fog/core/service.rb', line 121

def recognizes(*args)
  recognized.concat(args)
end

.request(new_request) ⇒ Object 



105
106
107
 
# File 'lib/fog/core/service.rb', line 105

def request(new_request)
  requests << new_request
end

.request_path(new_path) ⇒ Object 



101
102
103
 
# File 'lib/fog/core/service.rb', line 101

def request_path(new_path)
  @request_path = new_path
end

.requests ⇒ Object 



109
110
111
 
# File 'lib/fog/core/service.rb', line 109

def requests
  @requests ||= []
end

.requirements ⇒ Object 



117
118
119
 
# File 'lib/fog/core/service.rb', line 117

def requirements
  @requirements ||= []
end

.requires(*args) ⇒ Object 



113
114
115
 
# File 'lib/fog/core/service.rb', line 113

def requires(*args)
  requirements.concat(args)
end

.reset_data(keys = Mock.data.keys) ⇒ Object 



129
130
131
 
# File 'lib/fog/core/service.rb', line 129

def reset_data(keys=Mock.data.keys)
  Mock.reset_data(keys)
end

.setup_requirements ⇒ Object 



55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/fog/core/service.rb', line 55

def setup_requirements
  if superclass.respond_to?(:setup_requirements)
    superclass.setup_requirements
  end

  @required ||= false
  unless @required
    for collection in collections
      require [@model_path, collection].join('/')
      constant = collection.to_s.split('_').map {|characters| characters[0...1].upcase << characters[1..-1]}.join('')
      service::Collections.module_eval <<-EOS, __FILE__, __LINE__
        def #{collection}(attributes = {})
          #{service}::#{constant}.new({:connection => self}.merge(attributes))
        end
      EOS
    end
    for model in models
      require [@model_path, model].join('/')
    end
    for request in requests
      require [@request_path, request].join('/')
    end
    @required = true
  end
end

.validate_arguments(options) ⇒ Object 



133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/fog/core/service.rb', line 133

def validate_arguments(options)
  missing = requirements - options.keys
  unless missing.empty?
    raise ArgumentError, "Missing required arguments: #{missing.join(', ')}"
  end

  # FIXME: avoid failing for the services that don't have recognizes yet
  unless recognizes.empty?
    unrecognized = options.keys - requirements - recognized
    unless unrecognized.empty?
      raise ArgumentError, "Unrecognized arguments: #{unrecognized.join(', ')}"
    end
  end
end