card-management-sdk 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a32008a1f6836380d63cf65c64b2605fba5595f32ebddd8d37890832aba819fe
-  data.tar.gz: 5dbed5478ee18be88200e22310f862769246d67be84970305b0eb42d43cebe79
+  metadata.gz: 6ff2ef9f926fbb6afc25ac437c81645c10db4f5427963089c0fdf4e0ad1dc98c
+  data.tar.gz: 2a2e662890f9e225bfda1cb87d787cd4ca67dc892b365893a0891e7913d37495
 SHA512:
-  metadata.gz: e53ecdad02ce9a0e77167c27f80d4225a6a697fb8d05986030af55681b391b2068d1e2224b073e15f2d7a4a70259206dce19f56ac0b41ceb5484d67f5970e985
-  data.tar.gz: 55a21a6eb4f7d3e4bbb1318df5179b70176aca596b3e028f2c1d6123cdf1075a6adc8e66e8db7a3d097ac5d757c012e6afbc861f1a1d7fc6d4a37e6dbc207173
+  metadata.gz: b93026a7850c80e1320c7f5064efd150a8a61061c46f06297793ffe156e9a028a02a0d325993a3cf4eb54e915e5e8e26a7871eb30710d28b1ea15bacdc7afe2a
+  data.tar.gz: 7c5abfc733b458ba4f32c49860553859be7a95e4dfdff5b483ec5c189427507eb55dd53371494032e62a18305f144fc2864c682e55e3c7466bd119e73c9aea34

data/README.md

@@ -16,27 +16,26 @@ Go to the Shell Developer Portal: [https://developer.shell.com](https://develope
 Install the gem from the command line:
 
 ```ruby
-gem install card-management-sdk -v 1.0.0
+gem install card-management-sdk -v 1.1.0
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'card-management-sdk', '1.0.0'
+gem 'card-management-sdk', '1.1.0'
 ```
 
-For additional gem details, see the [RubyGems page for the card-management-sdk gem](https://rubygems.org/gems/card-management-sdk/versions/1.0.0).
+For additional gem details, see the [RubyGems page for the card-management-sdk gem](https://rubygems.org/gems/card-management-sdk/versions/1.1.0).
 
 ## Initialize the API Client
 
-**_Note:_** Documentation for the client can be found [here.](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/client.md)
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/client.md)
 
 The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| `url` | `UrlEnum` | This variable specifies the type of environment. Environments:<br><br>* `api.shell.com` - Production<br>* `api-test.shell.com` - SIT<br>*Default*: `UrlEnum::ENUM_APITESTSHELLCOMTEST` |
-| `environment` | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION`** |
+| `environment` | `Environment` | The API environment. <br> **Default: `Environment.SIT`** |
 | `connection` | `Faraday::Connection` | The Faraday connection object passed by the SDK user for making requests |
 | `adapter` | `Faraday::Adapter` | The Faraday adapter object passed by the SDK user for performing http requests |
 | `timeout` | `Float` | The value to use for connection timeout. <br> **Default: 60** |
@@ -46,8 +45,8 @@ The following parameters are configurable for the API Client:
 | `retry_statuses` | `Array` | A list of HTTP statuses to retry. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
 | `retry_methods` | `Array` | A list of HTTP methods to retry. <br> **Default: %i[get put]** |
 | `http_callback` | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
-| `basic_auth_credentials` | [`BasicAuthCredentials`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/basic-authentication.md) | The credential object for Basic Authentication |
-| `bearer_token_credentials` | [`BearerTokenCredentials`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
+| `basic_auth_credentials` | [`BasicAuthCredentials`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/basic-authentication.md) | The credential object for Basic Authentication |
+| `bearer_token_credentials` | [`BearerTokenCredentials`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
 
 The API client can be initialized as follows:
 
@@ -61,28 +60,38 @@ client = ShellCardManagementApIs::Client.new(
     o_auth_client_id: 'OAuthClientId',
     o_auth_client_secret: 'OAuthClientSecret'
   ),
-  environment: Environment::PRODUCTION,
-  url: UrlEnum::ENUM_APITESTSHELLCOMTEST
+  environment: Environment::SIT
 )
 ```
 
+## Environments
+
+The SDK can be configured to use a different environment for making API calls. Available environments are:
+
+### Fields
+
+| Name | Description |
+|  --- | --- |
+| SIT | **Default** |
+| Production | - |
+
 ## Authorization
 
 This API uses the following authentication schemes.
 
-* [`BasicAuth (Basic Authentication)`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/basic-authentication.md)
-* [`BearerToken (OAuth 2 Client Credentials Grant)`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/oauth-2-client-credentials-grant.md)
+* [`BasicAuth (Basic Authentication)`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/basic-authentication.md)
+* [`BearerToken (OAuth 2 Client Credentials Grant)`](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/$a/https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/oauth-2-client-credentials-grant.md)
 
 ## List of APIs
 
-* [O Auth Authorization](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/controllers/o-auth-authorization.md)
-* [Customer](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/controllers/customer.md)
-* [Restriction](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/controllers/restriction.md)
-* [Card](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/controllers/card.md)
+* [O Auth Authorization](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/controllers/o-auth-authorization.md)
+* [Customer](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/controllers/customer.md)
+* [Restriction](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/controllers/restriction.md)
+* [Card](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/controllers/card.md)
 
 ## Classes Documentation
 
-* [Utility Classes](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/utility-classes.md)
-* [HttpResponse](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/http-response.md)
-* [HttpRequest](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.0.0/doc/http-request.md)
+* [Utility Classes](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/utility-classes.md)
+* [HttpResponse](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/http-response.md)
+* [HttpRequest](https://www.github.com/sdks-io/card-management-ruby-sdk/tree/1.1.0/doc/http-request.md)
 

data/lib/shell_card_management_ap_is/client.rb

@@ -43,8 +43,7 @@ module ShellCardManagementApIs
       max_retries: 0, retry_interval: 1, backoff_factor: 2,
       retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
       retry_methods: %i[get put], http_callback: nil,
-      environment: Environment::PRODUCTION,
-      url: UrlEnum::ENUM_APITESTSHELLCOMTEST, basic_auth_credentials: nil,
+      environment: Environment::SIT, basic_auth_credentials: nil,
       bearer_token_credentials: nil, config: nil
     )
       @config = if config.nil?
@@ -54,7 +53,7 @@ module ShellCardManagementApIs
                     backoff_factor: backoff_factor,
                     retry_statuses: retry_statuses,
                     retry_methods: retry_methods, http_callback: http_callback,
-                    environment: environment, url: url,
+                    environment: environment,
                     basic_auth_credentials: basic_auth_credentials,
                     bearer_token_credentials: bearer_token_credentials
                   )

data/lib/shell_card_management_ap_is/configuration.rb

@@ -7,15 +7,16 @@ module ShellCardManagementApIs
   # An enum for SDK environments.
   class Environment
     ENVIRONMENT = [
-      PRODUCTION = 'production'.freeze
+      SIT = 'SIT'.freeze,
+      PRODUCTION = 'Production'.freeze
     ].freeze
   end
 
   # An enum for API servers.
   class Server
     SERVER = [
-      DEFAULT = 'default'.freeze,
-      ACCESS_TOKEN_SERVER = 'access token server'.freeze
+      OAUTH_SERVER = 'OAuth Server'.freeze,
+      SHELL = 'Shell'.freeze
     ].freeze
   end
 
@@ -23,8 +24,7 @@ module ShellCardManagementApIs
   # are configured in this class.
   class Configuration < CoreLibrary::HttpClientConfiguration
     # The attribute readers for properties.
-    attr_reader :environment, :url, :basic_auth_credentials,
-                :bearer_token_credentials
+    attr_reader :environment, :basic_auth_credentials, :bearer_token_credentials
 
     class << self
       attr_reader :environments
@@ -35,8 +35,7 @@ module ShellCardManagementApIs
       max_retries: 0, retry_interval: 1, backoff_factor: 2,
       retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
       retry_methods: %i[get put], http_callback: nil,
-      environment: Environment::PRODUCTION,
-      url: UrlEnum::ENUM_APITESTSHELLCOMTEST, basic_auth_credentials: nil,
+      environment: Environment::SIT, basic_auth_credentials: nil,
       bearer_token_credentials: nil
     )
 
@@ -48,9 +47,6 @@ module ShellCardManagementApIs
       # Current API environment
       @environment = String(environment)
 
-      # This variable specifies the type of environment. Environments:   * `api.shell.com` - Production   * `api-test.shell.com` - SIT
-      @url = url
-
       # The object holding Basic Authentication credentials
       @basic_auth_credentials = basic_auth_credentials
 
@@ -64,7 +60,7 @@ module ShellCardManagementApIs
     def clone_with(connection: nil, adapter: nil, timeout: nil,
                    max_retries: nil, retry_interval: nil, backoff_factor: nil,
                    retry_statuses: nil, retry_methods: nil, http_callback: nil,
-                   environment: nil, url: nil, basic_auth_credentials: nil,
+                   environment: nil, basic_auth_credentials: nil,
                    bearer_token_credentials: nil)
       connection ||= self.connection
       adapter ||= self.adapter
@@ -76,7 +72,6 @@ module ShellCardManagementApIs
       retry_methods ||= self.retry_methods
       http_callback ||= self.http_callback
       environment ||= self.environment
-      url ||= self.url
       basic_auth_credentials ||= self.basic_auth_credentials
       bearer_token_credentials ||= self.bearer_token_credentials
 
@@ -87,7 +82,6 @@ module ShellCardManagementApIs
                         retry_statuses: retry_statuses,
                         retry_methods: retry_methods,
                         http_callback: http_callback, environment: environment,
-                        url: url,
                         basic_auth_credentials: basic_auth_credentials,
                         bearer_token_credentials: bearer_token_credentials)
     end
@@ -95,9 +89,13 @@ module ShellCardManagementApIs
 
     # All the environments the SDK can run in.
     ENVIRONMENTS = {
+      Environment::SIT => {
+        Server::OAUTH_SERVER => 'https://api-test.shell.com',
+        Server::SHELL => 'https://api-test.shell.com/test'
+      },
       Environment::PRODUCTION => {
-        Server::DEFAULT => 'https://{url}',
-        Server::ACCESS_TOKEN_SERVER => 'https://api-test.shell.com/v1/oauth'
+        Server::OAUTH_SERVER => 'https://api.shell.com',
+        Server::SHELL => 'https://api.shell.com'
       }
     }.freeze
 
@@ -105,13 +103,8 @@ module ShellCardManagementApIs
     # @param [Configuration::Server] server The server enum for which the base URI is
     # required.
     # @return [String] The base URI.
-    def get_base_uri(server = Server::DEFAULT)
-      parameters = {
-        'url' => { 'value' => url, 'encode' => false }
-      }
-      APIHelper.append_url_with_template_parameters(
-        ENVIRONMENTS[environment][server], parameters
-      )
+    def get_base_uri(server = Server::SHELL)
+      ENVIRONMENTS[environment][server].clone
     end
   end
 end