Class: Megam::API

Inherits:
Object
  • Object
show all
Defined in:
lib/megam/api.rb,
lib/megam/api/csars.rb,
lib/megam/api/login.rb,
lib/megam/api/errors.rb,
lib/megam/api/domains.rb,
lib/megam/api/sshkeys.rb,
lib/megam/api/version.rb,
lib/megam/api/accounts.rb,
lib/megam/api/assembly.rb,
lib/megam/api/requests.rb,
lib/megam/api/assemblies.rb,
lib/megam/api/components.rb,
lib/megam/api/app_requests.rb,
lib/megam/api/marketplaces.rb,
lib/megam/api/organizations.rb,
lib/megam/api/predef_clouds.rb,
lib/megam/api/marketplace_addons.rb,
lib/megam/api/cloud_tool_settings.rb

Defined Under Namespace

Modules: Errors

Constant Summary collapse

API_MEGAM_CO = 
"api.megam.co".freeze
API_VERSION2 = 
"/v2".freeze
X_Megam_DATE = 
"X-Megam-DATE".freeze
X_Megam_HMAC = 
"X-Megam-HMAC".freeze
X_Megam_OTTAI = 
"X-Megam-OTTAI".freeze
HEADERS = 
{
  'Accept' => 'application/json',
  'Accept-Encoding' => 'gzip',
  'User-Agent' => "megam-api/#{Megam::API::VERSION}",
  'X-Ruby-Version' => RUBY_VERSION,
  'X-Ruby-Platform' => RUBY_PLATFORM
}
OPTIONS = 
{
  :headers => {},
  :host => '127.0.0.1',
  :nonblock => false,
  :scheme => 'http'
}
API_VERSION1 = 
"/v1"
VERSION = 
"0.20"

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ API

It is assumed that every API call will use an API_KEY/email. This ensures validity of the person really the same guy on who he claims. 3 levels of options exits

  1. The global OPTIONS as available inside the API (OPTIONS)

  2. The options as passed via the instantiation of API will override global options. The ones that are passed are :email and :api_key and will

be merged into a class variable @options

  1. Upon merge of the options, the api_key, email as available in the @options is deleted.

Raises:

  • (ArgumentError) 


120
121
122
123
124
125
126
127
128
129
130
 
# File 'lib/megam/api.rb', line 120

def initialize(options={})
  @options = OPTIONS.merge(options)
  if File.exist?("#{ENV['MEGAM_HOME']}/nilavu.yml")
      @common = YAML.load_file("#{ENV['MEGAM_HOME']}/nilavu.yml")                  #COMMON YML
      @options[:host] = "#{@common["api"]["host"]}"
      @options[:scheme] = "#{@common["api"]["scheme"]}"
    end
  @api_key = @options.delete(:api_key) || ENV['MEGAM_API_KEY']
  @email = @options.delete(:email)
  raise ArgumentError, "You must specify [:email, :api_key]" if @email.nil? || @api_key.nil?
end

Instance Attribute Details

#text ⇒ Object

text is used to print stuff in the terminal (message, log, info, warn etc.)



77
78
79
 
# File 'lib/megam/api.rb', line 77

def text
  @text
end

Instance Method Details

#delete_assemblies(asm_id) ⇒ Object

Yet to be tested DELETE /nodes/:node_id



37
38
39
40
41
42
43
44
45
46
 
# File 'lib/megam/api/assemblies.rb', line 37

def delete_assemblies(asm_id)
  @options = {:path => '/nodes/#{asm_id}',
    :body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :delete,
    :body     => @options[:body]
  )
end

#delete_marketplaceapp(node_id) ⇒ Object

Yet to be tested DELETE /marketplacess/:node_id



38
39
40
41
42
43
44
45
46
47
 
# File 'lib/megam/api/csars.rb', line 38

def delete_marketplaceapp(node_id)
  @options = {:path => '/marketplaces/#{node_id}',
    :body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :delete,
    :body     => @options[:body]
  )
end

#get_accounts(email) ⇒ Object

GET /accounts Yet to be tested



5
6
7
8
9
10
11
12
13
14
15
 
# File 'lib/megam/api/accounts.rb', line 5

def get_accounts(email)

  @options = {:path => "/accounts/#{email}",
    :body => ''}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_addons(node_name) ⇒ Object

begin



5
6
7
8
9
10
11
12
13
 
# File 'lib/megam/api/marketplace_addons.rb', line 5

def get_addons(node_name)
  @options = {:path => "/marketplaceaddons/#{node_name}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_assemblies ⇒ Object

GET /nodes



4
5
6
7
8
9
10
11
12
 
# File 'lib/megam/api/assemblies.rb', line 4

def get_assemblies
  @options = {:path => '/assemblies',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_cloudtoolsetting(id) ⇒ Object 



13
14
15
16
17
18
19
20
21
 
# File 'lib/megam/api/cloud_tool_settings.rb', line 13

def get_cloudtoolsetting(id)
  @options = {:path => "/cloudtoolsettings/#{id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_cloudtoolsettings ⇒ Object 



3
4
5
6
7
8
9
10
11
 
# File 'lib/megam/api/cloud_tool_settings.rb', line 3

def get_cloudtoolsettings
  @options = {:path => '/cloudtoolsettings',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_components(comp_id) ⇒ Object 



3
4
5
6
7
8
9
10
11
 
# File 'lib/megam/api/components.rb', line 3

def get_components(comp_id)
  @options = {:path => "/components/#{comp_id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_csar(id) ⇒ Object 



15
16
17
18
19
20
21
22
23
 
# File 'lib/megam/api/csars.rb', line 15

def get_csar(id)
  @options = {:path => "/csars/#{id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_csars ⇒ Object

GET /csars



5
6
7
8
9
10
11
12
13
 
# File 'lib/megam/api/csars.rb', line 5

def get_csars
  @options = {:path => '/csars',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_domains(name) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
14
 
# File 'lib/megam/api/domains.rb', line 4

def get_domains(name)

  @options = {:path => "/domains/#{name}",
    :body => ''}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_marketplaceapp(id) ⇒ Object 



15
16
17
18
19
20
21
22
23
 
# File 'lib/megam/api/marketplaces.rb', line 15

def get_marketplaceapp(id)
  @options = {:path => "/marketplaces/#{id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )     
end

#get_marketplaceapps ⇒ Object

GET /nodes



5
6
7
8
9
10
11
12
13
 
# File 'lib/megam/api/marketplaces.rb', line 5

def get_marketplaceapps
  @options = {:path => '/marketplaces',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_one_assemblies(asm_id) ⇒ Object 



14
15
16
17
18
19
20
21
22
 
# File 'lib/megam/api/assemblies.rb', line 14

def get_one_assemblies(asm_id)
  @options = {:path => "/assemblies/#{asm_id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_one_assembly(asm_id) ⇒ Object 



3
4
5
6
7
8
9
10
11
12
 
# File 'lib/megam/api/assembly.rb', line 3

def get_one_assembly(asm_id)

  @options = {:path => "/assembly/#{asm_id}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_organizations(name) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
14
 
# File 'lib/megam/api/organizations.rb', line 4

def get_organizations(name)

  @options = {:path => "/organizations/#{name}",
    :body => ''}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_predefcloud(predefcloud_name) ⇒ Object 



13
14
15
16
17
18
19
20
21
 
# File 'lib/megam/api/predef_clouds.rb', line 13

def get_predefcloud(predefcloud_name)
  @options = {:path => "/predefclouds/#{predefcloud_name}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_predefclouds ⇒ Object 



3
4
5
6
7
8
9
10
11
 
# File 'lib/megam/api/predef_clouds.rb', line 3

def get_predefclouds
  @options = {:path => '/predefclouds',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_request(node_name) ⇒ Object 



15
16
17
18
19
20
21
22
23
 
# File 'lib/megam/api/requests.rb', line 15

def get_request(node_name)
  @options = {:path => "/requests/#{node_name}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_requests ⇒ Object

GET /requests



5
6
7
8
9
10
11
12
13
 
# File 'lib/megam/api/requests.rb', line 5

def get_requests
  @options = {:path => '/requests',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_sshkey(sshkey_name) ⇒ Object 



13
14
15
16
17
18
19
20
21
 
# File 'lib/megam/api/sshkeys.rb', line 13

def get_sshkey(sshkey_name)
  @options = {:path => "/sshkeys/#{sshkey_name}",:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#get_sshkeys ⇒ Object 



3
4
5
6
7
8
9
10
11
 
# File 'lib/megam/api/sshkeys.rb', line 3

def get_sshkeys
  @options = {:path => '/sshkeys',:body => ""}.merge(@options)

  request(
    :expects  => 200,
    :method   => :get,
    :body     => @options[:body]
  )
end

#last_response ⇒ Object 



109
110
111
 
# File 'lib/megam/api.rb', line 109

def last_response
  @last_response
end

#post_accounts(new_account) ⇒ Object

The body content needs to be a json.



18
19
20
21
22
23
24
25
26
27
 
# File 'lib/megam/api/accounts.rb', line 18

def post_accounts()
  @options = {:path => '/accounts/content',
  :body => Megam::JSONCompat.to_json()}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
    )
end

#post_addon(new_addon) ⇒ Object

end



15
16
17
18
19
20
21
22
23
24
 
# File 'lib/megam/api/marketplace_addons.rb', line 15

def post_addon(new_addon)
  @options = {:path => '/marketplaceaddons/content',
    :body => Megam::JSONCompat.to_json(new_addon)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_apprequest(new_req) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
 
# File 'lib/megam/api/app_requests.rb', line 4

def post_apprequest(new_req)
  @options = {:path => '/apprequests/content',
    :body => Megam::JSONCompat.to_json(new_req)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_assemblies(new_asm) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
 
# File 'lib/megam/api/assemblies.rb', line 24

def post_assemblies(new_asm)
  @options = {:path => '/assemblies/content',
    :body => Megam::JSONCompat.to_json(new_asm)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_auth ⇒ Object 



3
4
5
6
7
8
9
10
11
12
 
# File 'lib/megam/api/login.rb', line 3

def post_auth
  @options = {:path => '/auth', :body => ""}.merge(@options)

  request(
    :expects  => 200,
   :method   => :post,
    :body     => @options[:body]

    )
end

#post_cloudtoolsetting(new_cloudtoolsetting) ⇒ Object 



23
24
25
26
27
28
29
30
31
32
 
# File 'lib/megam/api/cloud_tool_settings.rb', line 23

def post_cloudtoolsetting(new_cloudtoolsetting)
  @options = {:path => '/cloudtoolsettings/content',
    :body => Megam::JSONCompat.to_json(new_cloudtoolsetting)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_csar(new_csar) ⇒ Object 



25
26
27
28
29
30
31
32
33
34
 
# File 'lib/megam/api/csars.rb', line 25

def post_csar(new_csar)
  @options = {:path => '/csars/content',
    :body => Megam::JSONCompat.to_json(new_node)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_domains(new_domain) ⇒ Object 



17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/megam/api/domains.rb', line 17

def post_domains(new_domain)

      @options = {:path => '/domains/content',
        :body =>  Megam::JSONCompat.to_json(new_domain)}.merge(@options)

   
  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
    )
end

#post_marketplaceapp(new_node) ⇒ Object 



25
26
27
28
29
30
31
32
33
34
 
# File 'lib/megam/api/marketplaces.rb', line 25

def post_marketplaceapp(new_node)
  @options = {:path => '/marketplaces/content',
    :body => Megam::JSONCompat.to_json(new_node)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_organizations(new_organization) ⇒ Object 



17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/megam/api/organizations.rb', line 17

def post_organizations(new_organization)

      @options = {:path => '/organizations/content',
        :body =>  Megam::JSONCompat.to_json(new_organization)}.merge(@options)


  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
    )
end

#post_predefcloud(new_predefcloud) ⇒ Object 



23
24
25
26
27
28
29
30
31
32
 
# File 'lib/megam/api/predef_clouds.rb', line 23

def post_predefcloud(new_predefcloud)
  @options = {:path => '/predefclouds/content',
    :body => Megam::JSONCompat.to_json(new_predefcloud)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_request(new_req) ⇒ Object 



25
26
27
28
29
30
31
32
33
34
 
# File 'lib/megam/api/requests.rb', line 25

def post_request(new_req)
  @options = {:path => '/requests/content',
    :body => Megam::JSONCompat.to_json(new_req)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#post_sshkey(new_sshkey) ⇒ Object 



23
24
25
26
27
28
29
30
31
32
 
# File 'lib/megam/api/sshkeys.rb', line 23

def post_sshkey(new_sshkey)
  @options = {:path => '/sshkeys/content',
    :body => Megam::JSONCompat.to_json(new_sshkey)}.merge(@options)

  request(
    :expects  => 201,
    :method   => :post,
    :body     => @options[:body]
  )
end

#request(params, &block) ⇒ Object 



132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
 
# File 'lib/megam/api.rb', line 132

def request(params,&block)
  just_color_debug("#{@options[:path]}")
  start = Time.now
  Megam::Log.debug("START")
  params.each do |pkey, pvalue|
    Megam::Log.debug("> #{pkey}: #{pvalue}")
  end

  begin
    response = connection.request(params, &block)
  rescue Excon::Errors::HTTPStatusError => error
    klass = case error.response.status

    when 401 then Megam::API::Errors::Unauthorized
    when 403 then Megam::API::Errors::Forbidden
    when 404 then Megam::API::Errors::NotFound
    when 408 then Megam::API::Errors::Timeout
    when 422 then Megam::API::Errors::RequestFailed
    when 423 then Megam::API::Errors::Locked
    when /50./ then Megam::API::Errors::RequestFailed
    else Megam::API::Errors::ErrorWithResponse
    end
    reerror = klass.new(error.message, error.response)
    reerror.set_backtrace(error.backtrace)
    Megam::Log.debug("#{reerror.response.body}")
    reerror.response.body = Megam::JSONCompat.from_json(reerror.response.body.chomp)
    Megam::Log.debug("RESPONSE ERR: Ruby Object")
    Megam::Log.debug("#{reerror.response.body}")
    raise(reerror)
  end

  @last_response = response
  Megam::Log.debug("RESPONSE: HTTP Status and Header Data")
  Megam::Log.debug("> HTTP #{response.remote_ip} #{response.status}")

  response.headers.each do |header, value|
    Megam::Log.debug("> #{header}: #{value}")
  end
  Megam::Log.debug("End HTTP Status/Header Data.")

  if response.body && !response.body.empty?
    if response.headers['Content-Encoding'] == 'gzip'
      Megam::Log.debug("RESPONSE: Content-Encoding is gzip")
      response.body = Zlib::GzipReader.new(StringIO.new(response.body)).read
    end
    Megam::Log.debug("RESPONSE: HTTP Body(JSON)")
    Megam::Log.debug("#{response.body}")

    begin
      unless response.headers[X_Megam_OTTAI]
        response.body = Megam::JSONCompat.from_json(response.body.chomp)
        Megam::Log.debug("RESPONSE: Ruby Object")
      else
        response.body = Megam::KoniPai.new.koni(response.body.chomp)
        Megam::Log.debug("RESPONSE: KoniPai Object ")
      end
      Megam::Log.debug("#{response.body}")
    rescue Exception => jsonerr
      Megam::Log.error(jsonerr)
      raise(jsonerr)
    end
  end
  Megam::Log.debug("END(#{(Time.now - start).to_s}s)")
  # reset (non-persistent) connection
  @connection.reset
  response
end