Class: ManageIQ::API::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/manageiq/api/client/api.rb,
lib/manageiq/api/client/error.rb,
lib/manageiq/api/client/action.rb,
lib/manageiq/api/client/client.rb,
lib/manageiq/api/client/version.rb,
lib/manageiq/api/client/identity.rb,
lib/manageiq/api/client/resource.rb,
lib/manageiq/api/client/collection.rb,
lib/manageiq/api/client/connection.rb,
lib/manageiq/api/client/exceptions.rb,
lib/manageiq/api/client/api_version.rb,
lib/manageiq/api/client/null_logger.rb,
lib/manageiq/api/client/server_info.rb,
lib/manageiq/api/client/product_info.rb,
lib/manageiq/api/client/action_result.rb,
lib/manageiq/api/client/authentication.rb,
lib/manageiq/api/client/collection_options.rb

Defined Under Namespace

Classes: API, Action, ActionResult, ApiVersion, Authentication, Collection, CollectionOptions, Connection, Error, Exception, Identity, NullLogger, ProductInfo, Resource, ResourceNotFound, ServerInfo

Constant Summary collapse

DEFAULT_URL = 
URI.parse("http://localhost:3000")
VERSION = 
"0.3.4".freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client_options = {}) ⇒ Client

Returns a new instance of Client.



28
29
30
31
32
33
34
 
# File 'lib/manageiq/api/client/client.rb', line 28

def initialize(client_options = {})
  @client_options = client_options.dup
  @logger = client_options[:logger] || self.class.logger
  @url = extract_url(client_options)
  @authentication = ManageIQ::API::Client::Authentication.new(client_options)
  reconnect
end

Instance Attribute Details

#api ⇒ Object (readonly)

Returns the value of attribute api.



10
11
12
 
# File 'lib/manageiq/api/client/client.rb', line 10

def api
  @api
end

#authentication ⇒ Object (readonly)

Returns the value of attribute authentication.



7
8
9
 
# File 'lib/manageiq/api/client/client.rb', line 7

def authentication
  @authentication
end

#authorization ⇒ Object (readonly)

Returns the value of attribute authorization.



13
14
15
 
# File 'lib/manageiq/api/client/client.rb', line 13

def authorization
  @authorization
end

#client_options ⇒ Object (readonly)

Returns the value of attribute client_options.



4
5
6
 
# File 'lib/manageiq/api/client/client.rb', line 4

def client_options
  @client_options
end

#collections ⇒ Object (readonly)

Returns the value of attribute collections.



16
17
18
 
# File 'lib/manageiq/api/client/client.rb', line 16

def collections
  @collections
end

#connection ⇒ Object (readonly)

Returns the value of attribute connection.



8
9
10
 
# File 'lib/manageiq/api/client/client.rb', line 8

def connection
  @connection
end

#identity ⇒ Object (readonly)

Returns the value of attribute identity.



12
13
14
 
# File 'lib/manageiq/api/client/client.rb', line 12

def identity
  @identity
end

#logger ⇒ Object (readonly)

Returns the value of attribute logger.



5
6
7
 
# File 'lib/manageiq/api/client/client.rb', line 5

def logger
  @logger
end

#product_info ⇒ Object (readonly)

Returns the value of attribute product_info.



15
16
17
 
# File 'lib/manageiq/api/client/client.rb', line 15

def product_info
  @product_info
end

#server_info ⇒ Object (readonly)

Returns the value of attribute server_info.



14
15
16
 
# File 'lib/manageiq/api/client/client.rb', line 14

def server_info
  @server_info
end

#url ⇒ Object (readonly)

Returns the value of attribute url.



6
7
8
 
# File 'lib/manageiq/api/client/client.rb', line 6

def url
  @url
end

#user_settings ⇒ Object (readonly)

Returns the value of attribute user_settings.



11
12
13
 
# File 'lib/manageiq/api/client/client.rb', line 11

def 
  @user_settings
end

Class Method Details

.logger ⇒ Object 



20
21
22
 
# File 'lib/manageiq/api/client/client.rb', line 20

def self.logger
  @logger ||= NullLogger.new
end

.logger=(logger) ⇒ Object 



24
25
26
 
# File 'lib/manageiq/api/client/client.rb', line 24

def self.logger=(logger)
  @logger = logger
end

Instance Method Details

#load_definitions ⇒ Object 



36
37
38
39
40
41
42
43
44
45
 
# File 'lib/manageiq/api/client/client.rb', line 36

def load_definitions
  entrypoint     = connection.get("", :attributes => "authorization")
  @api           = ManageIQ::API::Client::API.new(entrypoint)
  @user_settings = Hash(entrypoint["settings"]).dup
  @identity      = ManageIQ::API::Client::Identity.new(Hash(entrypoint["identity"]))
  @authorization = Hash(entrypoint["authorization"]).dup
  @server_info   = ServerInfo.new(Hash(entrypoint["server_info"]))
  @product_info  = ProductInfo.new(Hash(entrypoint["product_info"]))
  @collections   = load_collections(entrypoint["collections"])
end

#reconnect ⇒ Object 



60
61
62
63
 
# File 'lib/manageiq/api/client/client.rb', line 60

def reconnect
  @connection = ManageIQ::API::Client::Connection.new(self, client_options.slice(:ssl, :open_timeout, :timeout))
  load_definitions
end

#update_authentication(auth_options = {}) ⇒ Object 



47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/manageiq/api/client/client.rb', line 47

def update_authentication(auth_options = {})
  return @authentication unless ManageIQ::API::Client::Authentication.auth_options_specified?(auth_options)
  saved_auth = @authentication
  @authentication = ManageIQ::API::Client::Authentication.new(auth_options)
  begin
    reconnect
  rescue
    @authentication = saved_auth
    raise
  end
  @authentication
end