cloudmersive-validate-api-client 1.4.2 → 2.0.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (153) hide show
  1. checksums.yaml +4 -4
  2. metadata +3 -154
  3. data/Gemfile +0 -7
  4. data/README.md +0 -158
  5. data/Rakefile +0 -8
  6. data/cloudmersive-validate-api-client.gemspec +0 -45
  7. data/docs/AddressApi.md +0 -228
  8. data/docs/AddressGetServersResponse.md +0 -9
  9. data/docs/AddressVerifySyntaxOnlyResponse.md +0 -11
  10. data/docs/CheckResponse.md +0 -8
  11. data/docs/DomainApi.md +0 -228
  12. data/docs/EmailApi.md +0 -173
  13. data/docs/FirstNameValidationRequest.md +0 -8
  14. data/docs/FirstNameValidationResponse.md +0 -9
  15. data/docs/FullEmailValidationResponse.md +0 -16
  16. data/docs/FullNameValidationRequest.md +0 -8
  17. data/docs/FullNameValidationResponse.md +0 -17
  18. data/docs/GeolocateResponse.md +0 -16
  19. data/docs/GetGenderRequest.md +0 -9
  20. data/docs/GetGenderResponse.md +0 -9
  21. data/docs/GetTimezonesRequest.md +0 -8
  22. data/docs/GetTimezonesResponse.md +0 -13
  23. data/docs/IPAddressApi.md +0 -63
  24. data/docs/LastNameValidationRequest.md +0 -8
  25. data/docs/LastNameValidationResponse.md +0 -9
  26. data/docs/LeadEnrichmentApi.md +0 -61
  27. data/docs/LeadEnrichmentRequest.md +0 -21
  28. data/docs/LeadEnrichmentResponse.md +0 -25
  29. data/docs/NameApi.md +0 -283
  30. data/docs/ParseAddressRequest.md +0 -9
  31. data/docs/ParseAddressResponse.md +0 -16
  32. data/docs/PhoneNumberApi.md +0 -63
  33. data/docs/PhoneNumberValidateRequest.md +0 -9
  34. data/docs/PhoneNumberValidationResponse.md +0 -15
  35. data/docs/Timezone.md +0 -10
  36. data/docs/UserAgentApi.md +0 -63
  37. data/docs/UserAgentValidateRequest.md +0 -8
  38. data/docs/UserAgentValidateResponse.md +0 -21
  39. data/docs/ValidateAddressRequest.md +0 -13
  40. data/docs/ValidateAddressResponse.md +0 -10
  41. data/docs/ValidateCountryRequest.md +0 -8
  42. data/docs/ValidateCountryResponse.md +0 -13
  43. data/docs/ValidateIdentifierRequest.md +0 -15
  44. data/docs/ValidateIdentifierResponse.md +0 -9
  45. data/docs/ValidateUrlRequestFull.md +0 -8
  46. data/docs/ValidateUrlRequestSyntaxOnly.md +0 -8
  47. data/docs/ValidateUrlResponseFull.md +0 -12
  48. data/docs/ValidateUrlResponseSyntaxOnly.md +0 -9
  49. data/docs/VatApi.md +0 -63
  50. data/docs/VatLookupRequest.md +0 -8
  51. data/docs/VatLookupResponse.md +0 -19
  52. data/docs/WhoisResponse.md +0 -22
  53. data/git_push.sh +0 -55
  54. data/lib/cloudmersive-validate-api-client.rb +0 -85
  55. data/lib/cloudmersive-validate-api-client/api/address_api.rb +0 -243
  56. data/lib/cloudmersive-validate-api-client/api/domain_api.rb +0 -243
  57. data/lib/cloudmersive-validate-api-client/api/email_api.rb +0 -188
  58. data/lib/cloudmersive-validate-api-client/api/ip_address_api.rb +0 -78
  59. data/lib/cloudmersive-validate-api-client/api/lead_enrichment_api.rb +0 -78
  60. data/lib/cloudmersive-validate-api-client/api/name_api.rb +0 -298
  61. data/lib/cloudmersive-validate-api-client/api/phone_number_api.rb +0 -78
  62. data/lib/cloudmersive-validate-api-client/api/user_agent_api.rb +0 -78
  63. data/lib/cloudmersive-validate-api-client/api/vat_api.rb +0 -78
  64. data/lib/cloudmersive-validate-api-client/api_client.rb +0 -389
  65. data/lib/cloudmersive-validate-api-client/api_error.rb +0 -38
  66. data/lib/cloudmersive-validate-api-client/configuration.rb +0 -209
  67. data/lib/cloudmersive-validate-api-client/models/address_get_servers_response.rb +0 -201
  68. data/lib/cloudmersive-validate-api-client/models/address_verify_syntax_only_response.rb +0 -219
  69. data/lib/cloudmersive-validate-api-client/models/check_response.rb +0 -189
  70. data/lib/cloudmersive-validate-api-client/models/first_name_validation_request.rb +0 -189
  71. data/lib/cloudmersive-validate-api-client/models/first_name_validation_response.rb +0 -199
  72. data/lib/cloudmersive-validate-api-client/models/full_email_validation_response.rb +0 -269
  73. data/lib/cloudmersive-validate-api-client/models/full_name_validation_request.rb +0 -189
  74. data/lib/cloudmersive-validate-api-client/models/full_name_validation_response.rb +0 -279
  75. data/lib/cloudmersive-validate-api-client/models/geolocate_response.rb +0 -269
  76. data/lib/cloudmersive-validate-api-client/models/get_gender_request.rb +0 -199
  77. data/lib/cloudmersive-validate-api-client/models/get_gender_response.rb +0 -199
  78. data/lib/cloudmersive-validate-api-client/models/get_timezones_request.rb +0 -189
  79. data/lib/cloudmersive-validate-api-client/models/get_timezones_response.rb +0 -241
  80. data/lib/cloudmersive-validate-api-client/models/last_name_validation_request.rb +0 -189
  81. data/lib/cloudmersive-validate-api-client/models/last_name_validation_response.rb +0 -199
  82. data/lib/cloudmersive-validate-api-client/models/lead_enrichment_request.rb +0 -319
  83. data/lib/cloudmersive-validate-api-client/models/lead_enrichment_response.rb +0 -359
  84. data/lib/cloudmersive-validate-api-client/models/parse_address_request.rb +0 -199
  85. data/lib/cloudmersive-validate-api-client/models/parse_address_response.rb +0 -269
  86. data/lib/cloudmersive-validate-api-client/models/phone_number_validate_request.rb +0 -199
  87. data/lib/cloudmersive-validate-api-client/models/phone_number_validation_response.rb +0 -259
  88. data/lib/cloudmersive-validate-api-client/models/timezone.rb +0 -209
  89. data/lib/cloudmersive-validate-api-client/models/user_agent_validate_request.rb +0 -189
  90. data/lib/cloudmersive-validate-api-client/models/user_agent_validate_response.rb +0 -319
  91. data/lib/cloudmersive-validate-api-client/models/validate_address_request.rb +0 -239
  92. data/lib/cloudmersive-validate-api-client/models/validate_address_response.rb +0 -209
  93. data/lib/cloudmersive-validate-api-client/models/validate_country_request.rb +0 -189
  94. data/lib/cloudmersive-validate-api-client/models/validate_country_response.rb +0 -241
  95. data/lib/cloudmersive-validate-api-client/models/validate_identifier_request.rb +0 -259
  96. data/lib/cloudmersive-validate-api-client/models/validate_identifier_response.rb +0 -199
  97. data/lib/cloudmersive-validate-api-client/models/validate_url_request_full.rb +0 -189
  98. data/lib/cloudmersive-validate-api-client/models/validate_url_request_syntax_only.rb +0 -189
  99. data/lib/cloudmersive-validate-api-client/models/validate_url_response_full.rb +0 -229
  100. data/lib/cloudmersive-validate-api-client/models/validate_url_response_syntax_only.rb +0 -199
  101. data/lib/cloudmersive-validate-api-client/models/vat_lookup_request.rb +0 -189
  102. data/lib/cloudmersive-validate-api-client/models/vat_lookup_response.rb +0 -299
  103. data/lib/cloudmersive-validate-api-client/models/whois_response.rb +0 -329
  104. data/lib/cloudmersive-validate-api-client/version.rb +0 -15
  105. data/spec/api/address_api_spec.rb +0 -83
  106. data/spec/api/domain_api_spec.rb +0 -83
  107. data/spec/api/email_api_spec.rb +0 -71
  108. data/spec/api/ip_address_api_spec.rb +0 -47
  109. data/spec/api/lead_enrichment_api_spec.rb +0 -47
  110. data/spec/api/name_api_spec.rb +0 -95
  111. data/spec/api/phone_number_api_spec.rb +0 -47
  112. data/spec/api/user_agent_api_spec.rb +0 -47
  113. data/spec/api/vat_api_spec.rb +0 -47
  114. data/spec/api_client_spec.rb +0 -226
  115. data/spec/configuration_spec.rb +0 -42
  116. data/spec/models/address_get_servers_response_spec.rb +0 -48
  117. data/spec/models/address_verify_syntax_only_response_spec.rb +0 -60
  118. data/spec/models/check_response_spec.rb +0 -42
  119. data/spec/models/first_name_validation_request_spec.rb +0 -42
  120. data/spec/models/first_name_validation_response_spec.rb +0 -48
  121. data/spec/models/full_email_validation_response_spec.rb +0 -90
  122. data/spec/models/full_name_validation_request_spec.rb +0 -42
  123. data/spec/models/full_name_validation_response_spec.rb +0 -96
  124. data/spec/models/geolocate_response_spec.rb +0 -90
  125. data/spec/models/get_gender_request_spec.rb +0 -48
  126. data/spec/models/get_gender_response_spec.rb +0 -48
  127. data/spec/models/get_timezones_request_spec.rb +0 -42
  128. data/spec/models/get_timezones_response_spec.rb +0 -72
  129. data/spec/models/last_name_validation_request_spec.rb +0 -42
  130. data/spec/models/last_name_validation_response_spec.rb +0 -48
  131. data/spec/models/lead_enrichment_request_spec.rb +0 -120
  132. data/spec/models/lead_enrichment_response_spec.rb +0 -144
  133. data/spec/models/parse_address_request_spec.rb +0 -48
  134. data/spec/models/parse_address_response_spec.rb +0 -90
  135. data/spec/models/phone_number_validate_request_spec.rb +0 -48
  136. data/spec/models/phone_number_validation_response_spec.rb +0 -84
  137. data/spec/models/timezone_spec.rb +0 -54
  138. data/spec/models/user_agent_validate_request_spec.rb +0 -42
  139. data/spec/models/user_agent_validate_response_spec.rb +0 -120
  140. data/spec/models/validate_address_request_spec.rb +0 -72
  141. data/spec/models/validate_address_response_spec.rb +0 -54
  142. data/spec/models/validate_country_request_spec.rb +0 -42
  143. data/spec/models/validate_country_response_spec.rb +0 -72
  144. data/spec/models/validate_identifier_request_spec.rb +0 -84
  145. data/spec/models/validate_identifier_response_spec.rb +0 -48
  146. data/spec/models/validate_url_request_full_spec.rb +0 -42
  147. data/spec/models/validate_url_request_syntax_only_spec.rb +0 -42
  148. data/spec/models/validate_url_response_full_spec.rb +0 -66
  149. data/spec/models/validate_url_response_syntax_only_spec.rb +0 -48
  150. data/spec/models/vat_lookup_request_spec.rb +0 -42
  151. data/spec/models/vat_lookup_response_spec.rb +0 -108
  152. data/spec/models/whois_response_spec.rb +0 -126
  153. data/spec/spec_helper.rb +0 -111
@@ -1,78 +0,0 @@
1
- =begin
2
- #validateapi
3
-
4
- #The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
5
-
6
- OpenAPI spec version: v1
7
-
8
- Generated by: https://github.com/swagger-api/swagger-codegen.git
9
- Swagger Codegen version: 2.3.1
10
-
11
- =end
12
-
13
- require "uri"
14
-
15
- module CloudmersiveValidateApiClient
16
- class PhoneNumberApi
17
- attr_accessor :api_client
18
-
19
- def initialize(api_client = ApiClient.default)
20
- @api_client = api_client
21
- end
22
-
23
- # Validate phone number (basic)
24
- # Validate a phone number by analyzing the syntax
25
- # @param value Phone number to validate in a PhoneNumberValidateRequest object. Try a phone number such as \"1.800.463.3339\", and either leave DefaultCountryCode blank or use \"US\".
26
- # @param [Hash] opts the optional parameters
27
- # @return [PhoneNumberValidationResponse]
28
- def phone_number_syntax_only(value, opts = {})
29
- data, _status_code, _headers = phone_number_syntax_only_with_http_info(value, opts)
30
- return data
31
- end
32
-
33
- # Validate phone number (basic)
34
- # Validate a phone number by analyzing the syntax
35
- # @param value Phone number to validate in a PhoneNumberValidateRequest object. Try a phone number such as \"1.800.463.3339\", and either leave DefaultCountryCode blank or use \"US\".
36
- # @param [Hash] opts the optional parameters
37
- # @return [Array<(PhoneNumberValidationResponse, Fixnum, Hash)>] PhoneNumberValidationResponse data, response status code and response headers
38
- def phone_number_syntax_only_with_http_info(value, opts = {})
39
- if @api_client.config.debugging
40
- @api_client.config.logger.debug "Calling API: PhoneNumberApi.phone_number_syntax_only ..."
41
- end
42
- # verify the required parameter 'value' is set
43
- if @api_client.config.client_side_validation && value.nil?
44
- fail ArgumentError, "Missing the required parameter 'value' when calling PhoneNumberApi.phone_number_syntax_only"
45
- end
46
- # resource path
47
- local_var_path = "/validate/phonenumber/basic"
48
-
49
- # query parameters
50
- query_params = {}
51
-
52
- # header parameters
53
- header_params = {}
54
- # HTTP header 'Accept' (if needed)
55
- header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/json', 'application/xml', 'text/xml'])
56
- # HTTP header 'Content-Type'
57
- header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'text/json'])
58
-
59
- # form parameters
60
- form_params = {}
61
-
62
- # http body (model)
63
- post_body = @api_client.object_to_http_body(value)
64
- auth_names = ['Apikey']
65
- data, status_code, headers = @api_client.call_api(:POST, local_var_path,
66
- :header_params => header_params,
67
- :query_params => query_params,
68
- :form_params => form_params,
69
- :body => post_body,
70
- :auth_names => auth_names,
71
- :return_type => 'PhoneNumberValidationResponse')
72
- if @api_client.config.debugging
73
- @api_client.config.logger.debug "API called: PhoneNumberApi#phone_number_syntax_only\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
74
- end
75
- return data, status_code, headers
76
- end
77
- end
78
- end
@@ -1,78 +0,0 @@
1
- =begin
2
- #validateapi
3
-
4
- #The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
5
-
6
- OpenAPI spec version: v1
7
-
8
- Generated by: https://github.com/swagger-api/swagger-codegen.git
9
- Swagger Codegen version: 2.3.1
10
-
11
- =end
12
-
13
- require "uri"
14
-
15
- module CloudmersiveValidateApiClient
16
- class UserAgentApi
17
- attr_accessor :api_client
18
-
19
- def initialize(api_client = ApiClient.default)
20
- @api_client = api_client
21
- end
22
-
23
- # Parse an HTTP User-Agent string, identify robots
24
- # Uses a parsing system and database to parse the User-Agent into its structured component parts, such as Browser, Browser Version, Browser Engine, Operating System, and importantly, Robot identification.
25
- # @param request Input parse request
26
- # @param [Hash] opts the optional parameters
27
- # @return [UserAgentValidateResponse]
28
- def user_agent_parse(request, opts = {})
29
- data, _status_code, _headers = user_agent_parse_with_http_info(request, opts)
30
- return data
31
- end
32
-
33
- # Parse an HTTP User-Agent string, identify robots
34
- # Uses a parsing system and database to parse the User-Agent into its structured component parts, such as Browser, Browser Version, Browser Engine, Operating System, and importantly, Robot identification.
35
- # @param request Input parse request
36
- # @param [Hash] opts the optional parameters
37
- # @return [Array<(UserAgentValidateResponse, Fixnum, Hash)>] UserAgentValidateResponse data, response status code and response headers
38
- def user_agent_parse_with_http_info(request, opts = {})
39
- if @api_client.config.debugging
40
- @api_client.config.logger.debug "Calling API: UserAgentApi.user_agent_parse ..."
41
- end
42
- # verify the required parameter 'request' is set
43
- if @api_client.config.client_side_validation && request.nil?
44
- fail ArgumentError, "Missing the required parameter 'request' when calling UserAgentApi.user_agent_parse"
45
- end
46
- # resource path
47
- local_var_path = "/validate/useragent/parse"
48
-
49
- # query parameters
50
- query_params = {}
51
-
52
- # header parameters
53
- header_params = {}
54
- # HTTP header 'Accept' (if needed)
55
- header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/json', 'application/xml', 'text/xml'])
56
- # HTTP header 'Content-Type'
57
- header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'text/json'])
58
-
59
- # form parameters
60
- form_params = {}
61
-
62
- # http body (model)
63
- post_body = @api_client.object_to_http_body(request)
64
- auth_names = ['Apikey']
65
- data, status_code, headers = @api_client.call_api(:POST, local_var_path,
66
- :header_params => header_params,
67
- :query_params => query_params,
68
- :form_params => form_params,
69
- :body => post_body,
70
- :auth_names => auth_names,
71
- :return_type => 'UserAgentValidateResponse')
72
- if @api_client.config.debugging
73
- @api_client.config.logger.debug "API called: UserAgentApi#user_agent_parse\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
74
- end
75
- return data, status_code, headers
76
- end
77
- end
78
- end
@@ -1,78 +0,0 @@
1
- =begin
2
- #validateapi
3
-
4
- #The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
5
-
6
- OpenAPI spec version: v1
7
-
8
- Generated by: https://github.com/swagger-api/swagger-codegen.git
9
- Swagger Codegen version: 2.3.1
10
-
11
- =end
12
-
13
- require "uri"
14
-
15
- module CloudmersiveValidateApiClient
16
- class VatApi
17
- attr_accessor :api_client
18
-
19
- def initialize(api_client = ApiClient.default)
20
- @api_client = api_client
21
- end
22
-
23
- # Validate a VAT number
24
- # Checks if a VAT code is valid, and if it is, returns more information about it. The first two letters of the VAT number must be letters that indicate the country, such as LU20260743. Possible country codes include Austria (AT), Belgium (BE), Bulgaria (BG), Cyprus (CY), Czech Republic (CZ), Germany (DE), Denmark (DK), Estonia (EE), Greece (EL), Spain (ES), Finland (FI), France (FR), United Kingdom (GB), Croatia (HR), Hungary (HU), Ireland (IE), Italy (IT), Lithuania (LT), Luxembourg (LU), Latvia (LV), Malta (MT), The Netherlands (NL), Poland (PL), Portugal (PT), Romania (RO), Sweden (SE), Slovenia (SI), Slovakia (SK).
25
- # @param input Input VAT code
26
- # @param [Hash] opts the optional parameters
27
- # @return [VatLookupResponse]
28
- def vat_vat_lookup(input, opts = {})
29
- data, _status_code, _headers = vat_vat_lookup_with_http_info(input, opts)
30
- return data
31
- end
32
-
33
- # Validate a VAT number
34
- # Checks if a VAT code is valid, and if it is, returns more information about it. The first two letters of the VAT number must be letters that indicate the country, such as LU20260743. Possible country codes include Austria (AT), Belgium (BE), Bulgaria (BG), Cyprus (CY), Czech Republic (CZ), Germany (DE), Denmark (DK), Estonia (EE), Greece (EL), Spain (ES), Finland (FI), France (FR), United Kingdom (GB), Croatia (HR), Hungary (HU), Ireland (IE), Italy (IT), Lithuania (LT), Luxembourg (LU), Latvia (LV), Malta (MT), The Netherlands (NL), Poland (PL), Portugal (PT), Romania (RO), Sweden (SE), Slovenia (SI), Slovakia (SK).
35
- # @param input Input VAT code
36
- # @param [Hash] opts the optional parameters
37
- # @return [Array<(VatLookupResponse, Fixnum, Hash)>] VatLookupResponse data, response status code and response headers
38
- def vat_vat_lookup_with_http_info(input, opts = {})
39
- if @api_client.config.debugging
40
- @api_client.config.logger.debug "Calling API: VatApi.vat_vat_lookup ..."
41
- end
42
- # verify the required parameter 'input' is set
43
- if @api_client.config.client_side_validation && input.nil?
44
- fail ArgumentError, "Missing the required parameter 'input' when calling VatApi.vat_vat_lookup"
45
- end
46
- # resource path
47
- local_var_path = "/validate/vat/lookup"
48
-
49
- # query parameters
50
- query_params = {}
51
-
52
- # header parameters
53
- header_params = {}
54
- # HTTP header 'Accept' (if needed)
55
- header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/json', 'application/xml', 'text/xml'])
56
- # HTTP header 'Content-Type'
57
- header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'text/json'])
58
-
59
- # form parameters
60
- form_params = {}
61
-
62
- # http body (model)
63
- post_body = @api_client.object_to_http_body(input)
64
- auth_names = ['Apikey']
65
- data, status_code, headers = @api_client.call_api(:POST, local_var_path,
66
- :header_params => header_params,
67
- :query_params => query_params,
68
- :form_params => form_params,
69
- :body => post_body,
70
- :auth_names => auth_names,
71
- :return_type => 'VatLookupResponse')
72
- if @api_client.config.debugging
73
- @api_client.config.logger.debug "API called: VatApi#vat_vat_lookup\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
74
- end
75
- return data, status_code, headers
76
- end
77
- end
78
- end
@@ -1,389 +0,0 @@
1
- =begin
2
- #validateapi
3
-
4
- #The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
5
-
6
- OpenAPI spec version: v1
7
-
8
- Generated by: https://github.com/swagger-api/swagger-codegen.git
9
- Swagger Codegen version: 2.3.1
10
-
11
- =end
12
-
13
- require 'date'
14
- require 'json'
15
- require 'logger'
16
- require 'tempfile'
17
- require 'typhoeus'
18
- require 'uri'
19
-
20
- module CloudmersiveValidateApiClient
21
- class ApiClient
22
- # The Configuration object holding settings to be used in the API client.
23
- attr_accessor :config
24
-
25
- # Defines the headers to be used in HTTP requests of all API calls by default.
26
- #
27
- # @return [Hash]
28
- attr_accessor :default_headers
29
-
30
- # Initializes the ApiClient
31
- # @option config [Configuration] Configuration for initializing the object, default to Configuration.default
32
- def initialize(config = Configuration.default)
33
- @config = config
34
- @user_agent = "Swagger-Codegen/#{VERSION}/ruby"
35
- @default_headers = {
36
- 'Content-Type' => "application/json",
37
- 'User-Agent' => @user_agent
38
- }
39
- end
40
-
41
- def self.default
42
- @@default ||= ApiClient.new
43
- end
44
-
45
- # Call an API with given options.
46
- #
47
- # @return [Array<(Object, Fixnum, Hash)>] an array of 3 elements:
48
- # the data deserialized from response body (could be nil), response status code and response headers.
49
- def call_api(http_method, path, opts = {})
50
- request = build_request(http_method, path, opts)
51
- response = request.run
52
-
53
- if @config.debugging
54
- @config.logger.debug "HTTP response body ~BEGIN~\n#{response.body}\n~END~\n"
55
- end
56
-
57
- unless response.success?
58
- if response.timed_out?
59
- fail ApiError.new('Connection timed out')
60
- elsif response.code == 0
61
- # Errors from libcurl will be made visible here
62
- fail ApiError.new(:code => 0,
63
- :message => response.return_message)
64
- else
65
- fail ApiError.new(:code => response.code,
66
- :response_headers => response.headers,
67
- :response_body => response.body),
68
- response.status_message
69
- end
70
- end
71
-
72
- if opts[:return_type]
73
- data = deserialize(response, opts[:return_type])
74
- else
75
- data = nil
76
- end
77
- return data, response.code, response.headers
78
- end
79
-
80
- # Builds the HTTP request
81
- #
82
- # @param [String] http_method HTTP method/verb (e.g. POST)
83
- # @param [String] path URL path (e.g. /account/new)
84
- # @option opts [Hash] :header_params Header parameters
85
- # @option opts [Hash] :query_params Query parameters
86
- # @option opts [Hash] :form_params Query parameters
87
- # @option opts [Object] :body HTTP body (JSON/XML)
88
- # @return [Typhoeus::Request] A Typhoeus Request
89
- def build_request(http_method, path, opts = {})
90
- url = build_request_url(path)
91
- http_method = http_method.to_sym.downcase
92
-
93
- header_params = @default_headers.merge(opts[:header_params] || {})
94
- query_params = opts[:query_params] || {}
95
- form_params = opts[:form_params] || {}
96
-
97
- update_params_for_auth! header_params, query_params, opts[:auth_names]
98
-
99
- # set ssl_verifyhosts option based on @config.verify_ssl_host (true/false)
100
- _verify_ssl_host = @config.verify_ssl_host ? 2 : 0
101
-
102
- req_opts = {
103
- :method => http_method,
104
- :headers => header_params,
105
- :params => query_params,
106
- :params_encoding => @config.params_encoding,
107
- :timeout => @config.timeout,
108
- :ssl_verifypeer => @config.verify_ssl,
109
- :ssl_verifyhost => _verify_ssl_host,
110
- :sslcert => @config.cert_file,
111
- :sslkey => @config.key_file,
112
- :verbose => @config.debugging
113
- }
114
-
115
- # set custom cert, if provided
116
- req_opts[:cainfo] = @config.ssl_ca_cert if @config.ssl_ca_cert
117
-
118
- if [:post, :patch, :put, :delete].include?(http_method)
119
- req_body = build_request_body(header_params, form_params, opts[:body])
120
- req_opts.update :body => req_body
121
- if @config.debugging
122
- @config.logger.debug "HTTP request body param ~BEGIN~\n#{req_body}\n~END~\n"
123
- end
124
- end
125
-
126
- request = Typhoeus::Request.new(url, req_opts)
127
- download_file(request) if opts[:return_type] == 'File'
128
- request
129
- end
130
-
131
- # Check if the given MIME is a JSON MIME.
132
- # JSON MIME examples:
133
- # application/json
134
- # application/json; charset=UTF8
135
- # APPLICATION/JSON
136
- # */*
137
- # @param [String] mime MIME
138
- # @return [Boolean] True if the MIME is application/json
139
- def json_mime?(mime)
140
- (mime == "*/*") || !(mime =~ /Application\/.*json(?!p)(;.*)?/i).nil?
141
- end
142
-
143
- # Deserialize the response to the given return type.
144
- #
145
- # @param [Response] response HTTP response
146
- # @param [String] return_type some examples: "User", "Array[User]", "Hash[String,Integer]"
147
- def deserialize(response, return_type)
148
- body = response.body
149
-
150
- # handle file downloading - return the File instance processed in request callbacks
151
- # note that response body is empty when the file is written in chunks in request on_body callback
152
- return @tempfile if return_type == 'File'
153
-
154
- return nil if body.nil? || body.empty?
155
-
156
- # return response body directly for String return type
157
- return body if return_type == 'String'
158
-
159
- # ensuring a default content type
160
- content_type = response.headers['Content-Type'] || 'application/json'
161
-
162
- fail "Content-Type is not supported: #{content_type}" unless json_mime?(content_type)
163
-
164
- begin
165
- data = JSON.parse("[#{body}]", :symbolize_names => true)[0]
166
- rescue JSON::ParserError => e
167
- if %w(String Date DateTime).include?(return_type)
168
- data = body
169
- else
170
- raise e
171
- end
172
- end
173
-
174
- convert_to_type data, return_type
175
- end
176
-
177
- # Convert data to the given return type.
178
- # @param [Object] data Data to be converted
179
- # @param [String] return_type Return type
180
- # @return [Mixed] Data in a particular type
181
- def convert_to_type(data, return_type)
182
- return nil if data.nil?
183
- case return_type
184
- when 'String'
185
- data.to_s
186
- when 'Integer'
187
- data.to_i
188
- when 'Float'
189
- data.to_f
190
- when 'BOOLEAN'
191
- data == true
192
- when 'DateTime'
193
- # parse date time (expecting ISO 8601 format)
194
- DateTime.parse data
195
- when 'Date'
196
- # parse date time (expecting ISO 8601 format)
197
- Date.parse data
198
- when 'Object'
199
- # generic object (usually a Hash), return directly
200
- data
201
- when /\AArray<(.+)>\z/
202
- # e.g. Array<Pet>
203
- sub_type = $1
204
- data.map {|item| convert_to_type(item, sub_type) }
205
- when /\AHash\<String, (.+)\>\z/
206
- # e.g. Hash<String, Integer>
207
- sub_type = $1
208
- {}.tap do |hash|
209
- data.each {|k, v| hash[k] = convert_to_type(v, sub_type) }
210
- end
211
- else
212
- # models, e.g. Pet
213
- CloudmersiveValidateApiClient.const_get(return_type).new.tap do |model|
214
- model.build_from_hash data
215
- end
216
- end
217
- end
218
-
219
- # Save response body into a file in (the defined) temporary folder, using the filename
220
- # from the "Content-Disposition" header if provided, otherwise a random filename.
221
- # The response body is written to the file in chunks in order to handle files which
222
- # size is larger than maximum Ruby String or even larger than the maximum memory a Ruby
223
- # process can use.
224
- #
225
- # @see Configuration#temp_folder_path
226
- def download_file(request)
227
- tempfile = nil
228
- encoding = nil
229
- request.on_headers do |response|
230
- content_disposition = response.headers['Content-Disposition']
231
- if content_disposition and content_disposition =~ /filename=/i
232
- filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
233
- prefix = sanitize_filename(filename)
234
- else
235
- prefix = 'download-'
236
- end
237
- prefix = prefix + '-' unless prefix.end_with?('-')
238
- encoding = response.body.encoding
239
- tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
240
- @tempfile = tempfile
241
- end
242
- request.on_body do |chunk|
243
- chunk.force_encoding(encoding)
244
- tempfile.write(chunk)
245
- end
246
- request.on_complete do |response|
247
- tempfile.close
248
- @config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
249
- "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
250
- "will be deleted automatically with GC. It's also recommended to delete the temp file "\
251
- "explicitly with `tempfile.delete`"
252
- end
253
- end
254
-
255
- # Sanitize filename by removing path.
256
- # e.g. ../../sun.gif becomes sun.gif
257
- #
258
- # @param [String] filename the filename to be sanitized
259
- # @return [String] the sanitized filename
260
- def sanitize_filename(filename)
261
- filename.gsub(/.*[\/\\]/, '')
262
- end
263
-
264
- def build_request_url(path)
265
- # Add leading and trailing slashes to path
266
- path = "/#{path}".gsub(/\/+/, '/')
267
- URI.encode(@config.base_url + path)
268
- end
269
-
270
- # Builds the HTTP request body
271
- #
272
- # @param [Hash] header_params Header parameters
273
- # @param [Hash] form_params Query parameters
274
- # @param [Object] body HTTP body (JSON/XML)
275
- # @return [String] HTTP body data in the form of string
276
- def build_request_body(header_params, form_params, body)
277
- # http form
278
- if header_params['Content-Type'] == 'application/x-www-form-urlencoded' ||
279
- header_params['Content-Type'] == 'multipart/form-data'
280
- data = {}
281
- form_params.each do |key, value|
282
- case value
283
- when ::File, ::Array, nil
284
- # let typhoeus handle File, Array and nil parameters
285
- data[key] = value
286
- else
287
- data[key] = value.to_s
288
- end
289
- end
290
- elsif body
291
- data = body.is_a?(String) ? body : body.to_json
292
- else
293
- data = nil
294
- end
295
- data
296
- end
297
-
298
- # Update hearder and query params based on authentication settings.
299
- #
300
- # @param [Hash] header_params Header parameters
301
- # @param [Hash] query_params Query parameters
302
- # @param [String] auth_names Authentication scheme name
303
- def update_params_for_auth!(header_params, query_params, auth_names)
304
- Array(auth_names).each do |auth_name|
305
- auth_setting = @config.auth_settings[auth_name]
306
- next unless auth_setting
307
- case auth_setting[:in]
308
- when 'header' then header_params[auth_setting[:key]] = auth_setting[:value]
309
- when 'query' then query_params[auth_setting[:key]] = auth_setting[:value]
310
- else fail ArgumentError, 'Authentication token must be in `query` of `header`'
311
- end
312
- end
313
- end
314
-
315
- # Sets user agent in HTTP header
316
- #
317
- # @param [String] user_agent User agent (e.g. swagger-codegen/ruby/1.0.0)
318
- def user_agent=(user_agent)
319
- @user_agent = user_agent
320
- @default_headers['User-Agent'] = @user_agent
321
- end
322
-
323
- # Return Accept header based on an array of accepts provided.
324
- # @param [Array] accepts array for Accept
325
- # @return [String] the Accept header (e.g. application/json)
326
- def select_header_accept(accepts)
327
- return nil if accepts.nil? || accepts.empty?
328
- # use JSON when present, otherwise use all of the provided
329
- json_accept = accepts.find { |s| json_mime?(s) }
330
- return json_accept || accepts.join(',')
331
- end
332
-
333
- # Return Content-Type header based on an array of content types provided.
334
- # @param [Array] content_types array for Content-Type
335
- # @return [String] the Content-Type header (e.g. application/json)
336
- def select_header_content_type(content_types)
337
- # use application/json by default
338
- return 'application/json' if content_types.nil? || content_types.empty?
339
- # use JSON when present, otherwise use the first one
340
- json_content_type = content_types.find { |s| json_mime?(s) }
341
- return json_content_type || content_types.first
342
- end
343
-
344
- # Convert object (array, hash, object, etc) to JSON string.
345
- # @param [Object] model object to be converted into JSON string
346
- # @return [String] JSON string representation of the object
347
- def object_to_http_body(model)
348
- return model if model.nil? || model.is_a?(String)
349
- local_body = nil
350
- if model.is_a?(Array)
351
- local_body = model.map{|m| object_to_hash(m) }
352
- else
353
- local_body = object_to_hash(model)
354
- end
355
- local_body.to_json
356
- end
357
-
358
- # Convert object(non-array) to hash.
359
- # @param [Object] obj object to be converted into JSON string
360
- # @return [String] JSON string representation of the object
361
- def object_to_hash(obj)
362
- if obj.respond_to?(:to_hash)
363
- obj.to_hash
364
- else
365
- obj
366
- end
367
- end
368
-
369
- # Build parameter value according to the given collection format.
370
- # @param [String] collection_format one of :csv, :ssv, :tsv, :pipes and :multi
371
- def build_collection_param(param, collection_format)
372
- case collection_format
373
- when :csv
374
- param.join(',')
375
- when :ssv
376
- param.join(' ')
377
- when :tsv
378
- param.join("\t")
379
- when :pipes
380
- param.join('|')
381
- when :multi
382
- # return the array directly as typhoeus will handle it as expected
383
- param
384
- else
385
- fail "unknown collection format: #{collection_format.inspect}"
386
- end
387
- end
388
- end
389
- end