vsphere-automation-cis 0.4.4 → 0.4.5

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7a560919df237bef0b0269629ba0aaf799e81622e6c9ba5e2acb2b79b93bd135
4
- data.tar.gz: 6afb9f00cbcfa503dbac0eb254e1c666447ae500cc7e76dfb8f241a087c4ed36
3
+ metadata.gz: 533db8a6fd9eb28f9b59c27da8c5328d8179489957ee2622042d9e844d2781bd
4
+ data.tar.gz: 5b2598fe24471e61687e88a16a5e8f86fe972911038c4ba8ac2dd14d4e326455
5
5
  SHA512:
6
- metadata.gz: 9a7fff1bc8c1cc3aa8a062a1358c9c3d67070a63170a1ac0dde791a9e4a015a0c9ae089d3f97c0d261b6632833b988e6ceb70ccc62569c986c92370731615b17
7
- data.tar.gz: 72f9a124615192f7c0921c53f8f0cee596690189188fe61feade7558b3f616d957466f44ac49feedf3e71c2c9a090152a8f58cd971fd304604d4c594f81e791a
6
+ metadata.gz: 7e7c75382d72a550f962aacac76908dcfc0524125b82f1a01b3a5d89e94334ede7137637b261ca12427bd9d2d42141de5035c9a968c3372e6b5898334384b37b
7
+ data.tar.gz: b0652700c6c38b17987ea0c58154cbf39759966ecd87aa1e1cbde6977fc18d47486b497364a556d6b9b20c1e6116c6396ba6730361862af1d14e15fba490cbfe
data/Gemfile.lock CHANGED
@@ -1,13 +1,13 @@
1
1
  PATH
2
2
  remote: ../runtime
3
3
  specs:
4
- vsphere-automation-runtime (0.4.4)
4
+ vsphere-automation-runtime (0.4.5)
5
5
 
6
6
  PATH
7
7
  remote: .
8
8
  specs:
9
- vsphere-automation-cis (0.4.4)
10
- vsphere-automation-runtime (~> 0.4.4)
9
+ vsphere-automation-cis (0.4.5)
10
+ vsphere-automation-runtime (~> 0.4.5)
11
11
 
12
12
  GEM
13
13
  remote: https://rubygems.org/
@@ -22,7 +22,7 @@ GEM
22
22
  hashdiff (1.0.0)
23
23
  jaro_winkler (1.5.3)
24
24
  method_source (0.9.2)
25
- parallel (1.17.0)
25
+ parallel (1.18.0)
26
26
  parser (2.6.5.0)
27
27
  ast (~> 2.4.0)
28
28
  pry (0.12.2)
@@ -31,19 +31,19 @@ GEM
31
31
  public_suffix (4.0.1)
32
32
  rainbow (3.0.0)
33
33
  rake (12.3.3)
34
- rspec (3.8.0)
35
- rspec-core (~> 3.8.0)
36
- rspec-expectations (~> 3.8.0)
37
- rspec-mocks (~> 3.8.0)
38
- rspec-core (3.8.2)
39
- rspec-support (~> 3.8.0)
40
- rspec-expectations (3.8.5)
34
+ rspec (3.9.0)
35
+ rspec-core (~> 3.9.0)
36
+ rspec-expectations (~> 3.9.0)
37
+ rspec-mocks (~> 3.9.0)
38
+ rspec-core (3.9.0)
39
+ rspec-support (~> 3.9.0)
40
+ rspec-expectations (3.9.0)
41
41
  diff-lcs (>= 1.2.0, < 2.0)
42
- rspec-support (~> 3.8.0)
43
- rspec-mocks (3.8.2)
42
+ rspec-support (~> 3.9.0)
43
+ rspec-mocks (3.9.0)
44
44
  diff-lcs (>= 1.2.0, < 2.0)
45
- rspec-support (~> 3.8.0)
46
- rspec-support (3.8.3)
45
+ rspec-support (~> 3.9.0)
46
+ rspec-support (3.9.0)
47
47
  rubocop (0.73.0)
48
48
  jaro_winkler (~> 1.5.1)
49
49
  parallel (~> 1.10)
data/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  The Ruby gem for the vSphere CIS API
4
4
 
5
5
  - API version: 2.0.0
6
- - Package version: 0.4.4
6
+ - Package version: 0.4.5
7
7
 
8
8
  ## Installation
9
9
 
@@ -0,0 +1,260 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'json'
4
+ require 'logger'
5
+ require 'net/http'
6
+ require 'openssl'
7
+ require 'uri'
8
+ require 'vsphere-automation-runtime/configuration'
9
+ require 'vsphere-automation-runtime/version'
10
+
11
+ module VSphereAutomation
12
+ # The client responsible for communicating with the API.
13
+ class ApiClient
14
+ # The Configuration object holding settings to be used in the API client.
15
+ attr_accessor :config
16
+
17
+ # Defines the headers to be used in HTTP requests of all API calls by
18
+ # default.
19
+ #
20
+ # @return [Hash]
21
+ attr_reader :default_headers
22
+
23
+ # Creates a new instance
24
+ #
25
+ # @param config [Configuration] configuration object with values to use
26
+ def initialize(config = Configuration.default)
27
+ @config = config
28
+ @http = create_http
29
+ @user_agent = default_user_agent
30
+ @default_headers = { 'Content-Type' => 'application/json',
31
+ 'User-Agent' => @user_agent }
32
+ end
33
+
34
+ # Retrieves an instance of the object in it's default state
35
+ #
36
+ # @return [ApiClient] an instance of the object in it's default state
37
+ def self.default
38
+ DEFAULT
39
+ end
40
+
41
+ # Build the collection of parameters
42
+ def build_collection_param(params, format)
43
+ params
44
+ end
45
+
46
+ # Make a request to an API endpoint with the given options
47
+ #
48
+ # @param http_method [Symbol] the HTTP method to be used
49
+ # @param path [String] the path request will be made to
50
+ # @param opts [Hash] any additional options needed
51
+ # @return [Array<(Object, Fixnum, Hash)>] the deserialized body, status
52
+ # code, and headers.
53
+ def call_api(http_method, path, opts = {})
54
+ query_params = opts.fetch(:query_params, {})
55
+ header_params = opts.fetch(:header_params, {})
56
+ form_params = opts.fetch(:form_params, {})
57
+ add_auth(query_params, header_params, opts.fetch(:auth_names, []))
58
+
59
+ uri = build_request_uri(path, query_params)
60
+ request = Net::HTTP.const_get(http_method.capitalize).new(uri)
61
+
62
+ add_form_params(request, form_params)
63
+ add_header_params(request, header_params)
64
+ request.body = opts[:body] if opts[:body]
65
+ request.content_type = request['Content-Type'] if request['Content-Type']
66
+
67
+ if @config.debugging
68
+ @config.logger.debug("Request Body:\n#{request.body}\n")
69
+ end
70
+
71
+ response = @http.request(request)
72
+ @cookie = cookie_from_response(response)
73
+ api_key_from_response(response)
74
+
75
+ return_type = opts.fetch(:return_type, {}).fetch(response.code, nil)
76
+ data = deserialize(response, return_type)
77
+ [data, Integer(response.code), response.each_header.to_h]
78
+ end
79
+
80
+ # Takes an object and returns the object as an HTTP body
81
+ #
82
+ # @param object [Object] object to transform
83
+ # @return [String] object as JSON string
84
+ def object_to_http_body(object)
85
+ return object.map { |o| object_to_http_body(o) } if object.is_a?(Array)
86
+
87
+ return object unless object.respond_to?(:to_hash)
88
+
89
+ object.to_hash.to_json
90
+ end
91
+
92
+ # Select an Accept header to use
93
+ #
94
+ # @param types [Array] a list of suggested types
95
+ # @return [String] the Accept header value
96
+ def select_header_accept(types)
97
+ return DEFAULT_MIME_TYPE unless types.is_a?(Array)
98
+
99
+ types.find { |t| t.include?('json') } || types.join(', ')
100
+ end
101
+
102
+ # Select an Content-Type header to use
103
+ #
104
+ # @param types [Array] a list of suggested types
105
+ # @return [String] the Content-Type header value
106
+ def select_header_content_type(types)
107
+ return DEFAULT_MIME_TYPE unless types.is_a?(Array)
108
+
109
+ types.find { |t| t.include?('json') } || types.first
110
+ end
111
+
112
+ private
113
+
114
+ def add_auth(query_params, header_params, auth_names)
115
+ auth_names.map do |name|
116
+ settings = @config.auth_settings.fetch(name, {})
117
+ case settings[:in]
118
+ when 'header'
119
+ header_params[settings[:key]] = settings[:value]
120
+ api_key_from_cookie(settings) unless settings[:value]
121
+ when 'query'
122
+ query_params[settings[:key]] = settings[:value]
123
+ end
124
+ end
125
+ end
126
+
127
+ def add_form_params(request, form_params)
128
+ request.set_form_data(form_params) unless form_params.empty?
129
+ end
130
+
131
+ def add_header_params(request, headers)
132
+ header_params = @default_headers.merge(headers)
133
+ header_params.merge!(Hash(@cookie))
134
+ header_params.map { |name, value| request[name] = value }
135
+ end
136
+
137
+ def add_query_params(uri, query_params)
138
+ uri.query = URI.encode_www_form(query_params)
139
+ end
140
+
141
+ def build_request_uri(path = '', query_params = {})
142
+ path = "/#{path}".gsub(%r{/+}, '/')
143
+ uri = URI.parse(@config.base_url + path)
144
+ add_query_params(uri, query_params)
145
+ forced_query_params = path.split('?')[1]
146
+ return URI.join(uri, '?' + forced_query_params) if forced_query_params
147
+
148
+ uri
149
+ end
150
+
151
+ def create_http
152
+ uri = build_request_uri
153
+ http = Net::HTTP.new(uri.host, uri.port)
154
+ http.use_ssl = @config.scheme == 'https'
155
+ http.verify_mode = OpenSSL::SSL::VERIFY_NONE unless @config.verify_ssl_host
156
+ http.read_timeout = @config.timeout
157
+ http
158
+ end
159
+
160
+ # The default user agent
161
+ #
162
+ # @return [String] the default user agent
163
+ def default_user_agent
164
+ "SDK/#{VSphereAutomation::Runtime::VERSION} "\
165
+ "Ruby/#{RUBY_VERSION} "\
166
+ "(#{Gem::Platform.local.os}; "\
167
+ "#{Gem::Platform.local.version}; "\
168
+ "#{Gem::Platform.local.cpu})"
169
+ end
170
+
171
+ # Deserialize the response to the given return type
172
+ #
173
+ # @param [Response] response the HTTP response
174
+ # @param [String] return_type the type to return
175
+ # @return [Object] the response represented as the return type
176
+ def deserialize(response, return_type)
177
+ body = response.body
178
+
179
+ return nil if body.nil? || body.empty? || return_type.nil?
180
+
181
+ begin
182
+ data = JSON.parse("[#{body}]", symbolize_names: true).first
183
+ rescue JSON::ParserError => e
184
+ raise e unless %w[String Date DateTime].include?(return_type)
185
+
186
+ data = body
187
+ end
188
+
189
+ convert_to_type(data, return_type)
190
+ end
191
+
192
+ def convert_to_type(data, return_type)
193
+ return nil if data.nil?
194
+ case return_type
195
+ when 'String'
196
+ data.to_s
197
+ when 'Integer'
198
+ data.to_i
199
+ when 'Float'
200
+ data.to_f
201
+ when 'BOOLEAN'
202
+ data == true
203
+ when 'DateTime'
204
+ # parse date time (expecting ISO 8601 format)
205
+ DateTime.parse data
206
+ when 'Date'
207
+ # parse date time (expecting ISO 8601 format)
208
+ Date.parse data
209
+ when 'Object'
210
+ # generic object (usually a Hash), return directly
211
+ data
212
+ when /\AArray<(.+)>\z/
213
+ # e.g. Array<Pet>
214
+ sub_type = $1
215
+ data.map { |item| convert_to_type(item, sub_type) }
216
+ when /\AHash\<String, (.+)\>\z/
217
+ # e.g. Hash<String, Integer>
218
+ sub_type = $1
219
+ {}.tap do |hash|
220
+ data.each { |k, v| hash[k] = convert_to_type(v, sub_type) }
221
+ end
222
+ else
223
+ # models, e.g. Pet
224
+ VSphereAutomation.const_get(return_type).new.tap do |model|
225
+ model.build_from_hash data
226
+ end
227
+ end
228
+ end
229
+
230
+ # Create the Cookie header from a response
231
+ #
232
+ # @param response [Net::HTTPResponse] the response
233
+ # @return [Hash, nil] the Cookie header
234
+ def cookie_from_response(response)
235
+ { 'Cookie' => response['set-cookie'] } if response['set-cookie']
236
+ end
237
+
238
+ def api_key_from_response(response)
239
+ key = @config.auth_settings['api_key'][:key]
240
+ @config.api_key[key] = response[key] if response[key]
241
+ end
242
+
243
+ def api_key_from_cookie(auth)
244
+ return if @cookie.nil?
245
+
246
+ regex = /(?<key>#{auth[:key]})=(?<value>\w+)/
247
+ matches = Hash(@cookie)['Cookie'].match(regex)
248
+ key = @config.auth_settings['api_key'][:key]
249
+ @config.api_key[key] = matches[:value] if matches
250
+ end
251
+
252
+ # An instance of the object in it's default state
253
+ DEFAULT = new
254
+
255
+ # The default MIME type for Content-Type and Accept headers
256
+ DEFAULT_MIME_TYPE = 'application/json'
257
+
258
+ private_constant :DEFAULT, :DEFAULT_MIME_TYPE
259
+ end
260
+ end
@@ -0,0 +1,34 @@
1
+ # Copyright (c) 2018-2019 VMware, Inc. All Rights Reserved.
2
+ # SPDX-License-Identifier: MIT
3
+
4
+ # DO NOT MODIFY. THIS CODE IS GENERATED. CHANGES WILL BE OVERWRITTEN.
5
+
6
+ # cis - No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
7
+
8
+
9
+ module VSphereAutomation
10
+ class ApiError < StandardError
11
+ attr_reader :code, :response_headers, :response_body
12
+
13
+ # Usage examples:
14
+ # ApiError.new
15
+ # ApiError.new("message")
16
+ # ApiError.new(:code => 500, :response_headers => {}, :response_body => "")
17
+ # ApiError.new(:code => 404, :message => "Not Found")
18
+ def initialize(arg = nil)
19
+ if arg.is_a? Hash
20
+ if arg.key?(:message) || arg.key?('message')
21
+ super(arg[:message] || arg['message'])
22
+ else
23
+ super arg
24
+ end
25
+
26
+ arg.each do |k, v|
27
+ instance_variable_set "@#{k}", v
28
+ end
29
+ else
30
+ super arg
31
+ end
32
+ end
33
+ end
34
+ end
@@ -0,0 +1,212 @@
1
+ # Copyright (c) 2018-2019 VMware, Inc. All Rights Reserved.
2
+ # SPDX-License-Identifier: MIT
3
+
4
+ # DO NOT MODIFY. THIS CODE IS GENERATED. CHANGES WILL BE OVERWRITTEN.
5
+
6
+ # cis - No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
7
+
8
+
9
+ require 'uri'
10
+
11
+ module VSphereAutomation
12
+ class Configuration
13
+ # Defines url scheme
14
+ attr_accessor :scheme
15
+
16
+ # Defines url host
17
+ attr_accessor :host
18
+
19
+ # Defines url base path
20
+ attr_accessor :base_path
21
+
22
+ # Defines API keys used with API Key authentications.
23
+ #
24
+ # @return [Hash] key: parameter name, value: parameter value (API key)
25
+ #
26
+ # @example parameter name is "api_key", API key is "xxx" (e.g. "api_key=xxx" in query string)
27
+ # config.api_key['api_key'] = 'xxx'
28
+ attr_accessor :api_key
29
+
30
+ # Defines API key prefixes used with API Key authentications.
31
+ #
32
+ # @return [Hash] key: parameter name, value: API key prefix
33
+ #
34
+ # @example parameter name is "Authorization", API key prefix is "Token" (e.g. "Authorization: Token xxx" in headers)
35
+ # config.api_key_prefix['api_key'] = 'Token'
36
+ attr_accessor :api_key_prefix
37
+
38
+ # Defines the username used with HTTP basic authentication.
39
+ #
40
+ # @return [String]
41
+ attr_accessor :username
42
+
43
+ # Defines the password used with HTTP basic authentication.
44
+ #
45
+ # @return [String]
46
+ attr_accessor :password
47
+
48
+ # Defines the access token (Bearer) used with OAuth2.
49
+ attr_accessor :access_token
50
+
51
+ # Set this to enable/disable debugging. When enabled (set to true), HTTP request/response
52
+ # details will be logged with `logger.debug` (see the `logger` attribute).
53
+ # Default to false.
54
+ #
55
+ # @return [true, false]
56
+ attr_accessor :debugging
57
+
58
+ # Defines the logger used for debugging.
59
+ # Default to `Rails.logger` (when in Rails) or logging to STDOUT.
60
+ #
61
+ # @return [#debug]
62
+ attr_accessor :logger
63
+
64
+ # Defines the temporary folder to store downloaded files
65
+ # (for API endpoints that have file response).
66
+ # Default to use `Tempfile`.
67
+ #
68
+ # @return [String]
69
+ attr_accessor :temp_folder_path
70
+
71
+ # The time limit for HTTP request in seconds.
72
+ # Default to 0 (never times out).
73
+ attr_accessor :timeout
74
+
75
+ # Set this to false to skip client side validation in the operation.
76
+ # Default to true.
77
+ # @return [true, false]
78
+ attr_accessor :client_side_validation
79
+
80
+ ### TLS/SSL setting
81
+ # Set this to false to skip verifying SSL certificate when calling API from https server.
82
+ # Default to true.
83
+ #
84
+ # @note Do NOT set it to false in production code, otherwise you would face multiple types of cryptographic attacks.
85
+ #
86
+ # @return [true, false]
87
+ attr_accessor :verify_ssl
88
+
89
+ ### TLS/SSL setting
90
+ # Set this to false to skip verifying SSL host name
91
+ # Default to true.
92
+ #
93
+ # @note Do NOT set it to false in production code, otherwise you would face multiple types of cryptographic attacks.
94
+ #
95
+ # @return [true, false]
96
+ attr_accessor :verify_ssl_host
97
+
98
+ ### TLS/SSL setting
99
+ # Set this to customize the certificate file to verify the peer.
100
+ #
101
+ # @return [String] the path to the certificate file
102
+ #
103
+ # @see The `cainfo` option of Typhoeus, `--cert` option of libcurl. Related source code:
104
+ # https://github.com/typhoeus/typhoeus/blob/master/lib/typhoeus/easy_factory.rb#L145
105
+ attr_accessor :ssl_ca_cert
106
+
107
+ ### TLS/SSL setting
108
+ # Client certificate file (for client certificate)
109
+ attr_accessor :cert_file
110
+
111
+ ### TLS/SSL setting
112
+ # Client private key file (for client certificate)
113
+ attr_accessor :key_file
114
+
115
+ # Set this to customize parameters encoding of array parameter with multi collectionFormat.
116
+ # Default to nil.
117
+ #
118
+ # @see The params_encoding option of Ethon. Related source code:
119
+ # https://github.com/typhoeus/ethon/blob/master/lib/ethon/easy/queryable.rb#L96
120
+ attr_accessor :params_encoding
121
+
122
+ attr_accessor :inject_format
123
+
124
+ attr_accessor :force_ending_format
125
+
126
+ def initialize
127
+ @scheme = 'https'
128
+ @host = '&lt;vcenter&gt;'
129
+ @base_path = '/rest'
130
+ @api_key = {}
131
+ @api_key_prefix = {}
132
+ @timeout = nil
133
+ @client_side_validation = true
134
+ @verify_ssl = true
135
+ @verify_ssl_host = true
136
+ @params_encoding = :multi
137
+ @cert_file = nil
138
+ @key_file = nil
139
+ @debugging = false
140
+ @inject_format = false
141
+ @force_ending_format = false
142
+ @logger = defined?(Rails) ? Rails.logger : Logger.new(STDOUT)
143
+
144
+ yield(self) if block_given?
145
+ end
146
+
147
+ # The default Configuration object.
148
+ def self.default
149
+ @@default ||= Configuration.new
150
+ end
151
+
152
+ def configure
153
+ yield(self) if block_given?
154
+ end
155
+
156
+ def scheme=(scheme)
157
+ # remove :// from scheme
158
+ @scheme = scheme.sub(/:\/\//, '')
159
+ end
160
+
161
+ def host=(host)
162
+ # remove http(s):// and anything after a slash
163
+ @host = host.sub(/https?:\/\//, '').split('/').first
164
+ end
165
+
166
+ def base_path=(base_path)
167
+ # Add leading and trailing slashes to base_path
168
+ @base_path = "/#{base_path}".gsub(/\/+/, '/')
169
+ @base_path = '' if @base_path == '/'
170
+ end
171
+
172
+ def base_url
173
+ url = "#{scheme}://#{[host, base_path].join('/').gsub(/\/+/, '/')}".sub(/\/+\z/, '')
174
+ URI.encode(url)
175
+ end
176
+
177
+ # Gets API key (with prefix if set).
178
+ # @param [String] param_name the parameter name of API key auth
179
+ def api_key_with_prefix(param_name)
180
+ if @api_key_prefix[param_name]
181
+ "#{@api_key_prefix[param_name]} #{@api_key[param_name]}"
182
+ else
183
+ @api_key[param_name]
184
+ end
185
+ end
186
+
187
+ # Gets Basic Auth token string
188
+ def basic_auth_token
189
+ 'Basic ' + ["#{username}:#{password}"].pack('m').delete("\r\n")
190
+ end
191
+
192
+ # Returns Auth Settings hash for api client.
193
+ def auth_settings
194
+ {
195
+ 'api_key' =>
196
+ {
197
+ type: 'api_key',
198
+ in: 'header',
199
+ key: 'vmware-api-session-id',
200
+ value: api_key_with_prefix('vmware-api-session-id')
201
+ },
202
+ 'basic_auth' =>
203
+ {
204
+ type: 'basic',
205
+ in: 'header',
206
+ key: 'Authorization',
207
+ value: basic_auth_token
208
+ },
209
+ }
210
+ end
211
+ end
212
+ end
@@ -8,6 +8,6 @@
8
8
 
9
9
  module VSphereAutomation
10
10
  module CIS
11
- VERSION = '0.4.4'
11
+ VERSION = '0.4.5'
12
12
  end
13
13
  end
@@ -0,0 +1,248 @@
1
+ require 'spec_helper'
2
+
3
+ describe VSphereAutomation::ApiClient do
4
+ describe '.default' do
5
+ it 'returns the same instance every time' do
6
+ first_instance = VSphereAutomation::ApiClient.default
7
+ second_instance = VSphereAutomation::ApiClient.default
8
+ third_instance = VSphereAutomation::ApiClient.default
9
+ expect(first_instance).to be(second_instance)
10
+ expect(first_instance).to be(third_instance)
11
+ end
12
+ end
13
+
14
+ describe '#build_collection_param' do
15
+ context 'when called with format :multi' do
16
+ it 'returns the collection' do
17
+ params = { foo: 'bar', baz: 'quux' }
18
+ expect(subject.build_collection_param(params, :multi)).to eq(params)
19
+ end
20
+ end
21
+ end
22
+
23
+ describe '#call_api' do
24
+ let(:host) { 'example.com' }
25
+ let(:config) do
26
+ VSphereAutomation::Configuration.new.tap do |c|
27
+ c.scheme = 'https'
28
+ c.host = host
29
+ end
30
+ end
31
+ let(:url) { 'https://example.com/rest/test' }
32
+ subject { VSphereAutomation::ApiClient.new(config) }
33
+
34
+ it 'adds headers to request' do
35
+ headers = { 'foo' => 'bar' }
36
+ stub_request(:get, url).with(headers: headers)
37
+
38
+ subject.call_api(:GET, '/test', header_params: headers)
39
+
40
+ expect(a_request(:get, url).with(headers: headers)).to have_been_made
41
+ end
42
+
43
+ it 'adds query parameters to request' do
44
+ query_params = { 'foo' => 'bar' }
45
+ stub_request(:get, url).with(query: query_params)
46
+
47
+ subject.call_api(:GET, '/test', query_params: query_params)
48
+
49
+ expect(a_request(:get, url).with(query: query_params)).to have_been_made
50
+ end
51
+
52
+ it 'keeps query parameters from the path to request' do
53
+ # The specs have some paths that contain query parameters already. This
54
+ # test is to make sure they don't get overwritten.
55
+ key = '~foo'
56
+ value = 'bar'
57
+ query_params = { key => value }
58
+ stub_request(:post, url).with(query: query_params)
59
+
60
+ subject.call_api(:POST, "/test?#{key}=#{value}")
61
+
62
+ expect(a_request(:post, url).with(query: query_params)).to have_been_made
63
+ end
64
+
65
+ it 'adds form parameters to the request body' do
66
+ form_params = { 'foo' => 'bar' }
67
+ body = form_params.to_a.map { |e| e.join('=') }.join('&')
68
+ stub_request(:get, url).with(body: body)
69
+
70
+ subject.call_api(:GET, '/test', form_params: form_params)
71
+
72
+ expect(a_request(:get, url).with(body: body)).to have_been_made
73
+ end
74
+
75
+ it 'uses basic auth information from configuration' do
76
+ auth_name = 'basic_auth'
77
+ auth_header = { config.auth_settings[auth_name][:key] =>
78
+ config.auth_settings[auth_name][:value] }
79
+ stub_request(:get, url).with(headers: auth_header)
80
+
81
+ subject.call_api(:GET, '/test', auth_names: [auth_name])
82
+
83
+ expect(a_request(:get, url)
84
+ .with(headers: auth_header)).to have_been_made
85
+ end
86
+
87
+ it 'use API key information from configuration' do
88
+ auth_name = 'api_key'
89
+ config.api_key[config.auth_settings[auth_name][:key]] = 'foo'
90
+ auth_header = { config.auth_settings[auth_name][:key] =>
91
+ config.auth_settings[auth_name][:value] }
92
+ stub_request(:get, url).with(headers: auth_header)
93
+
94
+ subject.call_api(:GET, '/test', auth_names: [auth_name])
95
+
96
+ expect(a_request(:get, url)
97
+ .with(headers: auth_header)).to have_been_made
98
+ end
99
+
100
+ it 'updates api_key from responses with set-cookie header' do
101
+ key = config.auth_settings['api_key'][:key]
102
+ value = 'foo'
103
+ cookie = "#{key}=#{value};Path=/rest;Secure;HttpOnly"
104
+ set_cookie_header = { 'set-cookie' => cookie }
105
+ stub_request(:get, url + '1').to_return(headers: set_cookie_header)
106
+ stub_request(:get, url + '2')
107
+
108
+ subject.call_api(:GET, '/test1')
109
+ subject.call_api(:GET, '/test2', auth_names: ['api_key'])
110
+
111
+ expect(a_request(:get, url + '1')).to have_been_made
112
+ expect(a_request(:get, url + '2')).to have_been_made
113
+ expect(subject.config.api_key[key]).to eq(value)
114
+ end
115
+
116
+ it 'updates api_key from responses with api_key header' do
117
+ key = config.auth_settings['api_key'][:key]
118
+ value = 'foo'
119
+ auth_header = { key => value }
120
+
121
+ stub_request(:get, url + '1').to_return(headers: auth_header)
122
+ stub_request(:get, url + '2').with(headers: auth_header)
123
+
124
+ subject.call_api(:GET, '/test1')
125
+ subject.call_api(:GET, '/test2', auth_names: ['api_key'])
126
+
127
+ expect(a_request(:get, url + '1')).to have_been_made
128
+ expect(a_request(:get, url + '2')
129
+ .with(headers: auth_header)).to have_been_made
130
+ end
131
+
132
+ it 'adds the body to requests when available' do
133
+ body = { foo: 'bar' }.to_json
134
+ stub_request(:post, url).with(body: body)
135
+
136
+ subject.call_api(:POST, '/test', body: body)
137
+
138
+ expect(a_request(:post, url).with(body: body)).to have_been_made
139
+ end
140
+
141
+ it 'sets the Content-Type on requests when available' do
142
+ content_type = { 'Content-Type' => 'application/json' }
143
+ body = { foo: 'bar' }.to_json
144
+
145
+ stub_request(:post, url).with(body: body, headers: content_type)
146
+
147
+ subject.call_api(:POST, '/test', body: body, header_params: content_type)
148
+
149
+ expect(a_request(:post, url)
150
+ .with(body: body, headers: content_type)).to have_been_made
151
+ end
152
+ end
153
+
154
+ describe '#object_to_http_body' do
155
+ context 'when given nil' do
156
+ it 'returns the object as is' do
157
+ expect(subject.object_to_http_body(nil)).to be_nil
158
+ end
159
+ end
160
+
161
+ context 'when given a string' do
162
+ it 'returns the object as is' do
163
+ expect(subject.object_to_http_body('asdf')).to eq('asdf')
164
+ end
165
+ end
166
+
167
+ context 'when given an object that responds to `to_hash`' do
168
+ it 'returns that object as JSON' do
169
+ obj = OpenStruct.new(foo: 'bar', baz: 'quux')
170
+ obj.to_hash = obj.to_h
171
+ json = obj.to_hash.to_json
172
+
173
+ expect(subject.object_to_http_body(obj)).to eq(json)
174
+ end
175
+ end
176
+
177
+ context 'when given an array' do
178
+ it 'returns a JSON array of objects' do
179
+ obj = OpenStruct.new(foo: 'bar', baz: 'quux')
180
+ obj.to_hash = obj.to_h
181
+ json = obj.to_hash.to_json
182
+
183
+ expect(subject.object_to_http_body([obj])).to eq([json])
184
+ end
185
+ end
186
+ end
187
+
188
+ describe '#select_header_accept' do
189
+ context 'when given anything other than an array' do
190
+ it 'returns application/json as a default' do
191
+ expect(subject.select_header_accept(nil)).to eq('application/json')
192
+ expect(subject.select_header_accept('')).to eq('application/json')
193
+ expect(subject.select_header_accept(1)).to eq('application/json')
194
+ end
195
+ end
196
+
197
+ context 'when given a list of types' do
198
+ context 'that includes a JSON type' do
199
+ it 'returns the first type containing JSON' do
200
+ xml = 'application/xml'
201
+ json = 'application/json'
202
+
203
+ expect(subject.select_header_accept([xml, json])).to eq(json)
204
+ end
205
+ end
206
+
207
+ context 'that does not include a JSON type' do
208
+ it 'returns the all of the types' do
209
+ xml = 'application/xml'
210
+ html = 'text/html'
211
+ result = [xml, html].join(', ')
212
+
213
+ expect(subject.select_header_accept([xml, html])).to eq(result)
214
+ end
215
+ end
216
+ end
217
+ end
218
+
219
+ describe '#select_header_content_type' do
220
+ context 'when given anything other than an array' do
221
+ it 'returns application/json as a default' do
222
+ expect(subject.select_header_content_type(nil)).to eq('application/json')
223
+ expect(subject.select_header_content_type('')).to eq('application/json')
224
+ expect(subject.select_header_content_type(1)).to eq('application/json')
225
+ end
226
+ end
227
+
228
+ context 'when given a list of types' do
229
+ context 'that includes a JSON type' do
230
+ it 'returns the first type containing JSON' do
231
+ xml = 'application/xml'
232
+ json = 'application/json'
233
+
234
+ expect(subject.select_header_content_type([xml, json])).to eq(json)
235
+ end
236
+ end
237
+
238
+ context 'that does not include a JSON type' do
239
+ it 'returns the first type' do
240
+ xml = 'application/xml'
241
+ html = 'text/html'
242
+
243
+ expect(subject.select_header_content_type([xml, html])).to eq(xml)
244
+ end
245
+ end
246
+ end
247
+ end
248
+ end
@@ -0,0 +1,38 @@
1
+ # Copyright (c) 2018-2019 VMware, Inc. All Rights Reserved.
2
+ # SPDX-License-Identifier: MIT
3
+
4
+ # DO NOT MODIFY. THIS CODE IS GENERATED. CHANGES WILL BE OVERWRITTEN.
5
+
6
+ # cis - No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
7
+
8
+
9
+ require 'spec_helper'
10
+
11
+ describe VSphereAutomation::Configuration do
12
+ let(:config) { VSphereAutomation::Configuration.default }
13
+
14
+ before(:each) do
15
+ # uncomment below to setup host and base_path
16
+ # require 'URI'
17
+ # uri = URI.parse("https://<vcenter>/rest")
18
+ # VSphereAutomation.configure do |c|
19
+ # c.host = uri.host
20
+ # c.base_path = uri.path
21
+ # end
22
+ end
23
+
24
+ describe '#base_url' do
25
+ it 'should have the default value' do
26
+ # uncomment below to test default value of the base path
27
+ # expect(config.base_url).to eq("https://<vcenter>/rest")
28
+ end
29
+
30
+ it 'should remove trailing slashes' do
31
+ [nil, '', '/', '//'].each do |base_path|
32
+ config.base_path = base_path
33
+ # uncomment below to test trailing slashes
34
+ # expect(config.base_url).to eq("https://<vcenter>/rest")
35
+ end
36
+ end
37
+ end
38
+ end
@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
22
22
  s.description = "A Ruby SDK for the vSphere REST APIs (CIS)"
23
23
  s.license = 'MIT'
24
24
  s.required_ruby_version = ">= 2.3"
25
- s.add_runtime_dependency 'vsphere-automation-runtime', '~> 0.4.4'
25
+ s.add_runtime_dependency 'vsphere-automation-runtime', '~> 0.4.5'
26
26
 
27
27
  s.add_development_dependency 'bundler', '~> 2.0'
28
28
  s.add_development_dependency 'pry', '~> 0.12.2'
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: vsphere-automation-cis
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.4
4
+ version: 0.4.5
5
5
  platform: ruby
6
6
  authors:
7
7
  - J.R. Garcia
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-10-04 00:00:00.000000000 Z
11
+ date: 2019-10-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: vsphere-automation-runtime
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: 0.4.4
19
+ version: 0.4.5
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: 0.4.4
26
+ version: 0.4.5
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: bundler
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -227,6 +227,9 @@ files:
227
227
  - lib/vsphere-automation-cis/api/tagging_tag_api.rb
228
228
  - lib/vsphere-automation-cis/api/tagging_tag_association_api.rb
229
229
  - lib/vsphere-automation-cis/api/tasks_api.rb
230
+ - lib/vsphere-automation-cis/api_client.rb
231
+ - lib/vsphere-automation-cis/api_error.rb
232
+ - lib/vsphere-automation-cis/configuration.rb
230
233
  - lib/vsphere-automation-cis/models/cis_session_create_result.rb
231
234
  - lib/vsphere-automation-cis/models/cis_session_info.rb
232
235
  - lib/vsphere-automation-cis/models/cis_session_result.rb
@@ -313,11 +316,15 @@ files:
313
316
  - pkg/vsphere-automation-cis-0.4.1.gem
314
317
  - pkg/vsphere-automation-cis-0.4.2.gem
315
318
  - pkg/vsphere-automation-cis-0.4.3.gem
319
+ - pkg/vsphere-automation-cis-0.4.4.gem
320
+ - pkg/vsphere-automation-cis-0.4.5.gem
316
321
  - spec/api/session_api_spec.rb
317
322
  - spec/api/tagging_category_api_spec.rb
318
323
  - spec/api/tagging_tag_api_spec.rb
319
324
  - spec/api/tagging_tag_association_api_spec.rb
320
325
  - spec/api/tasks_api_spec.rb
326
+ - spec/api_client_spec.rb
327
+ - spec/configuration_spec.rb
321
328
  - spec/models/cis_session_create_result_spec.rb
322
329
  - spec/models/cis_session_info_spec.rb
323
330
  - spec/models/cis_session_result_spec.rb
@@ -431,6 +438,8 @@ test_files:
431
438
  - spec/api/tagging_tag_association_api_spec.rb
432
439
  - spec/api/tagging_category_api_spec.rb
433
440
  - spec/api/tagging_tag_api_spec.rb
441
+ - spec/api_client_spec.rb
442
+ - spec/configuration_spec.rb
434
443
  - spec/models/cis_tagging_category_update_spec_spec.rb
435
444
  - spec/models/vapi_std_errors_invalid_argument_spec.rb
436
445
  - spec/models/cis_session_create_result_spec.rb