wesley-key-sdk 1.1.3 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3ea6f79455b8271f043bcdc0bba2a2d18c54981bb9f3ec2768fa599e2c1d138
-  data.tar.gz: 580d402b865b741c7e00af607f78b872fed04dc3c9b13ce946eac315af186f4f
+  metadata.gz: f7b95e92f79c8960c60c731fbdfab810714ecab62a0c8ff5cfa4a9a7bca45554
+  data.tar.gz: e435438de0eac36322e87d15c35d20d3bdd576d50b21a4eb28f8c9b15d684d9b
 SHA512:
-  metadata.gz: d4e91d1d6be472481870d8bc05c1ee3a8f707e164a74932ac10e21a1f741ea95d02a5aaecd59c4dab177e1b9492f1679eed1cae1bb920636816248b024fb9f4b
-  data.tar.gz: 0eac539342d687353f4a4a54b095d3230ee01fa5c7696728c7e171611b80d47298d4b230cdebe0150de5bc4e2816a8c30dd8873d610034b1a1fe117258a369a0
+  metadata.gz: ece54c83895b95f4f0552d9629e5b7df46d10134c9fa66efb5ba461d6c37b583a864e7f1bdfd25bb5a1db096bb17b7f687674446a3584a2832148e94e17ec5cd
+  data.tar.gz: 552ca4bd24b688068d8c8e48be59e4fed1575a443d4cfa6eb0da34dfac6d85a0c046b4fe7940e785587a22aa0174772ef3e33e6927fa56c9562d80c34f5202d6

data/LICENSE

@@ -3,7 +3,7 @@ License:
 The MIT License (MIT)
 http://opensource.org/licenses/MIT
 
-Copyright (c) 2014 - 2025 APIMATIC Limited
+Copyright (c) 2014 - 2026 APIMATIC Limited
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,25 +1,62 @@
 
-# Getting Started with Cypress Test API
+# Getting Started with Swagger Petstore
 
 ## Introduction
 
-This is a sample API to demonstrate an OpenAPI spec with multiple endpoints and a custom model.
+This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.
+
+Find out more about Swagger: [http://swagger.io](http://swagger.io)
 
 ## Install the Package
 
 Install the gem from the command line:
 
 ```bash
-gem install wesley-key-sdk -v 1.1.3
+gem install wesley-key-sdk -v 2.0.1
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'wesley-key-sdk', '1.1.3'
+gem 'wesley-key-sdk', '2.0.1'
+```
+
+For additional gem details, see the [RubyGems page for the wesley-key-sdk gem](https://rubygems.org/gems/wesley-key-sdk/versions/2.0.1).
+
+## IRB Console Usage
+
+You can explore the SDK interactively using IRB in two ways
+
+### 1. Use IRB with Installed Gem
+
+Open your system terminal (Command Prompt, Git Bash or macOS Terminal) and type the following command to start the irb console.
+
+```bash
+irb
+```
+
+Now you can load the SDK in the IRB
+
+```ruby
+require 'swagger_petstore'
+include SwaggerPetstore
+```
+
+### 2. Use IRB within SDK
+
+Open your system terminal (Command Prompt, Git Bash or macOS Terminal) and navigate to the root folder of SDK.
+
+```
+cd path/to/swagger_petstore
 ```
 
-For additional gem details, see the [RubyGems page for the wesley-key-sdk gem](https://rubygems.org/gems/wesley-key-sdk/versions/1.1.3).
+Now you can start the preconfigured irb console by running the following command
+
+```bash
+ruby bin/console
+```
+
+**_Note:_** This automatically loads the SDK from lib/
 
 ## Test the SDK
 
@@ -31,13 +68,13 @@ rake
 
 ## Initialize the API Client
 
-**_Note:_** Documentation for the client can be found [here.](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/client.md)
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/client.md)
 
 The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| default_host | `String` | *Default*: `'www.example.com'` |
+| test_header | `String` | This is a test header<br>*Default*: `'TestHeaderDefaultValue'` |
 | environment | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION`** |
 | 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 |
@@ -48,37 +85,92 @@ 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. |
-| proxy_settings | [`ProxySettings`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+| proxy_settings | [`ProxySettings`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+| api_key_credentials | [`ApiKeyCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/custom-header-signature.md) | The credential object for Custom Header Signature |
+| http_basic_credentials | [`HttpBasicCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/basic-authentication.md) | The credential object for Basic Authentication |
+| petstore_auth_credentials | [`PetstoreAuthCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/oauth-2-implicit-grant.md) | The credential object for OAuth 2 Implicit Grant |
 
 The API client can be initialized as follows:
 
+### Code-Based Client Initialization
+
 ```ruby
-require 'cypress_test_api'
-include CypressTestApi
+require 'swagger_petstore'
+include SwaggerPetstore
 
 client = Client.new(
-  environment: Environment::PRODUCTION,
-  default_host: 'www.example.com'
+  test_header: 'TestHeaderDefaultValue',
+  api_key_credentials: ApiKeyCredentials.new(
+    api_key: 'api_key'
+  ),
+  http_basic_credentials: HttpBasicCredentials.new(
+    username: 'username',
+    passwprd: 'passwprd'
+  ),
+  petstore_auth_credentials: PetstoreAuthCredentials.new(
+    o_auth_client_id: 'OAuthClientId',
+    o_auth_redirect_uri: 'OAuthRedirectUri',
+    o_auth_scopes: [
+      OAuthScopePetstoreAuthEnum::READPETS,
+      OAuthScopePetstoreAuthEnum::WRITEPETS
+    ]
+  ),
+  environment: Environment::PRODUCTION
 )
 ```
 
+### Environment-Based Client Initialization
+
+```ruby
+require 'swagger_petstore'
+include SwaggerPetstore
+
+# Create client from environment
+client = Client.from_env
+```
+
+See the [`Environment-Based Client Initialization`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/environment-based-client-initialization.md) section for details.
+
+## Environments
+
+The SDK can be configured to use a different environment for making API calls. Available environments are:
+
+### Fields
+
+| Name | Description |
+|  --- | --- |
+| production | **Default** |
+| environment2 | - |
+| environment3 | - |
+
+## Authorization
+
+This API uses the following authentication schemes.
+
+* [`api_key (Custom Header Signature)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/custom-header-signature.md)
+* [`httpBasic (Basic Authentication)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/basic-authentication.md)
+* [`petstore_auth (OAuth 2 Implicit Grant)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/auth/oauth-2-implicit-grant.md)
+
 ## List of APIs
 
-* [API](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/controllers/api.md)
+* [Pet](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/controllers/pet.md)
+* [Store](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/controllers/store.md)
+* [User](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/controllers/user.md)
 
 ## SDK Infrastructure
 
 ### Configuration
 
-* [ProxySettings](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/proxy-settings.md)
+* [ProxySettings](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/proxy-settings.md)
+* [Environment-Based Client Initialization](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/environment-based-client-initialization.md)
 
 ### HTTP
 
-* [HttpResponse](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/http-response.md)
-* [HttpRequest](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/http-request.md)
+* [HttpResponse](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/http-response.md)
+* [HttpRequest](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/http-request.md)
 
 ### Utilities
 
-* [ApiHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/api-helper.md)
-* [DateTimeHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/1.1.3/doc/date-time-helper.md)
+* [ApiHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/api-helper.md)
+* [DateTimeHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/2.0.1/doc/date-time-helper.md)
 

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# Load the lib folder into Ruby's load path
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+
+# Require the gem
+require 'swagger_petstore'
+
+puts 'SwaggerPetstore SDK loaded!'
+puts 'You can now create a client with: client = SwaggerPetstore::Client.new'
+puts 'Or use from_env: client = SwaggerPetstore::Client.from_env'
+
+# Start an interactive IRB session
+require 'irb'
+IRB.start

data/lib/{cypress_test_api → swagger_petstore}/api_helper.rb

@@ -1,9 +1,9 @@
-# cypress_test_api
+# swagger_petstore
 #
 # This file was automatically generated by APIMATIC v3.0
 # ( https://www.apimatic.io ).
 
-module CypressTestApi
+module SwaggerPetstore
   # API utility class
   class APIHelper < CoreLibrary::ApiHelper
   end

data/lib/swagger_petstore/client.rb

@@ -0,0 +1,95 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  #  swagger_petstore client class.
+  class Client
+    include CoreLibrary
+    attr_reader :config, :auth_managers
+
+    def user_agent_detail
+      config.user_agent_detail
+    end
+
+    # Returns the configured authentication petstore_auth instance.
+    def petstore_auth
+      @auth_managers['petstore_auth']
+    end
+
+    # Access to pet controller.
+    # @return [PetController] Returns the controller instance.
+    def pet
+      @pet ||= PetController.new @global_configuration
+    end
+
+    # Access to store controller.
+    # @return [StoreController] Returns the controller instance.
+    def store
+      @store ||= StoreController.new @global_configuration
+    end
+
+    # Access to user controller.
+    # @return [UserController] Returns the controller instance.
+    def user
+      @user ||= UserController.new @global_configuration
+    end
+
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 60,
+      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, proxy_settings: nil,
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      http_basic_credentials: nil, petstore_auth_credentials: nil,
+      test_header: 'TestHeaderDefaultValue', config: nil
+    )
+      @config = if config.nil?
+                  Configuration.new(
+                    connection: connection, adapter: adapter, timeout: timeout,
+                    max_retries: max_retries, retry_interval: retry_interval,
+                    backoff_factor: backoff_factor,
+                    retry_statuses: retry_statuses,
+                    retry_methods: retry_methods, http_callback: http_callback,
+                    proxy_settings: proxy_settings, environment: environment,
+                    api_key_credentials: api_key_credentials,
+                    http_basic_credentials: http_basic_credentials,
+                    petstore_auth_credentials: petstore_auth_credentials,
+                    test_header: test_header
+                  )
+                else
+                  config
+                end
+
+      @global_configuration = GlobalConfiguration.new(client_configuration: @config)
+                                                 .base_uri_executor(@config.method(:get_base_uri))
+                                                 .global_errors(BaseController::GLOBAL_ERRORS)
+                                                 .user_agent(BaseController.user_agent)
+                                                 .global_header('TestHeader', @config.test_header)
+
+      initialize_auth_managers(@global_configuration)
+      @global_configuration = @global_configuration.auth_managers(@auth_managers)
+    end
+
+    # Initializes the auth managers hash used for authenticating API calls.
+    # @param [GlobalConfiguration] global_config The global configuration of the SDK)
+    def initialize_auth_managers(global_config)
+      @auth_managers = {}
+      http_client_config = global_config.client_configuration
+      %w[api_key httpBasic petstore_auth].each { |auth| @auth_managers[auth] = nil }
+      @auth_managers['api_key'] = ApiKey.new(http_client_config.api_key_credentials)
+      @auth_managers['httpBasic'] = HttpBasic.new(http_client_config.http_basic_credentials)
+      @auth_managers['petstore_auth'] = PetstoreAuth.new(
+        http_client_config.petstore_auth_credentials, global_config
+      )
+    end
+
+    # Creates a client directly from environment variables.
+    def self.from_env(**overrides)
+      default_config = Configuration.build_default_config_from_env
+      new_config = default_config.clone_with(**overrides)
+      new(config: new_config)
+    end
+  end
+end

data/lib/swagger_petstore/configuration.rb

@@ -0,0 +1,197 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  # An enum for SDK environments.
+  class Environment
+    ENVIRONMENT = [
+      PRODUCTION = 'production'.freeze,
+      ENVIRONMENT2 = 'environment2'.freeze,
+      ENVIRONMENT3 = 'environment3'.freeze
+    ].freeze
+
+    # Converts a string or symbol into a valid Environment constant.
+    def self.from_value(value, default_value = PRODUCTION)
+      return default_value if value.nil?
+
+      str = value.to_s.strip.downcase
+      case str
+      when 'production' then PRODUCTION
+      when 'environment2' then ENVIRONMENT2
+      when 'environment3' then ENVIRONMENT3
+
+      else
+        warn "[Environment] Unknown environment '#{value}', falling back to #{default_value} "
+        default_value
+      end
+    end
+  end
+
+  # An enum for API servers.
+  class Server
+    SERVER = [
+      DEFAULT = 'default'.freeze
+    ].freeze
+
+    # Converts a string or symbol into a valid Server constant.
+    def self.from_value(value, default_value = DEFAULT)
+      return default_value if value.nil?
+
+      default_value
+    end
+  end
+
+  # All configuration including auth info and base URI for the API access
+  # are configured in this class.
+  class Configuration < CoreLibrary::HttpClientConfiguration
+    # The attribute readers for properties.
+    attr_reader :environment, :api_key_credentials, :http_basic_credentials,
+                :petstore_auth_credentials, :test_header
+
+    class << self
+      attr_reader :environments
+    end
+
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 60,
+      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, proxy_settings: nil,
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      http_basic_credentials: nil, petstore_auth_credentials: nil,
+      test_header: 'TestHeaderDefaultValue'
+    )
+      super connection: connection, adapter: adapter, timeout: timeout,
+            max_retries: max_retries, retry_interval: retry_interval,
+            backoff_factor: backoff_factor, retry_statuses: retry_statuses,
+            retry_methods: retry_methods, http_callback: http_callback,
+            proxy_settings: proxy_settings
+
+      # Current API environment
+      @environment = String(environment)
+
+      # The object holding Custom Header Signature credentials
+      @api_key_credentials = api_key_credentials
+
+      # The object holding Basic Authentication credentials
+      @http_basic_credentials = http_basic_credentials
+
+      # The object holding OAuth 2 Implicit Grant credentials
+      @petstore_auth_credentials = petstore_auth_credentials
+
+      # This is a test header
+      @test_header = test_header
+
+      # The Http Client to use for making requests.
+      set_http_client CoreLibrary::FaradayClient.new(self)
+    end
+
+    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,
+                   proxy_settings: nil, environment: nil,
+                   api_key_credentials: nil, http_basic_credentials: nil,
+                   petstore_auth_credentials: nil, test_header: nil)
+      connection ||= self.connection
+      adapter ||= self.adapter
+      timeout ||= self.timeout
+      max_retries ||= self.max_retries
+      retry_interval ||= self.retry_interval
+      backoff_factor ||= self.backoff_factor
+      retry_statuses ||= self.retry_statuses
+      retry_methods ||= self.retry_methods
+      http_callback ||= self.http_callback
+      proxy_settings ||= self.proxy_settings
+      environment ||= self.environment
+      api_key_credentials ||= self.api_key_credentials
+      http_basic_credentials ||= self.http_basic_credentials
+      petstore_auth_credentials ||= self.petstore_auth_credentials
+      test_header ||= self.test_header
+
+      Configuration.new(connection: connection, adapter: adapter,
+                        timeout: timeout, max_retries: max_retries,
+                        retry_interval: retry_interval,
+                        backoff_factor: backoff_factor,
+                        retry_statuses: retry_statuses,
+                        retry_methods: retry_methods,
+                        http_callback: http_callback,
+                        proxy_settings: proxy_settings,
+                        environment: environment,
+                        api_key_credentials: api_key_credentials,
+                        http_basic_credentials: http_basic_credentials,
+                        petstore_auth_credentials: petstore_auth_credentials,
+                        test_header: test_header)
+    end
+
+
+    # All the environments the SDK can run in.
+    ENVIRONMENTS = {
+      Environment::PRODUCTION => {
+        Server::DEFAULT => 'https://petstore.swagger.io/v2'
+      },
+      Environment::ENVIRONMENT2 => {
+        Server::DEFAULT => 'http://petstore.swagger.io/v2'
+      },
+      Environment::ENVIRONMENT3 => {
+        Server::DEFAULT => 'https://petstore.swagger.io/oauth'
+      }
+    }.freeze
+
+    # Generates the appropriate base URI for the environment and the server.
+    # @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)
+      ENVIRONMENTS[environment][server].clone
+    end
+
+    # Builds a Configuration instance using environment variables.
+    def self.build_default_config_from_env
+      # === Core environment ===
+      environment = Environment.from_value(ENV.fetch('ENVIRONMENT', 'production'))
+      test_header = ENV.fetch('TEST_HEADER', 'TestHeaderDefaultValue')
+      timeout = (ENV['TIMEOUT'] || 60).to_f
+      max_retries = (ENV['MAX_RETRIES'] || 0).to_i
+      retry_interval = (ENV['RETRY_INTERVAL'] || 1).to_f
+      backoff_factor = (ENV['BACKOFF_FACTOR'] || 2).to_f
+      retry_statuses = ENV.fetch('RETRY_STATUSES',
+                                 '[408, 413, 429, 500, 502, 503, 504, 521, 522, 524]').gsub(/[\[\]]/, '')
+                                          .split(',')
+                                          .map(&:strip)
+                                          .map do |item|
+                                            item.match?(/\A\d+\z/) ? item.to_i : item.downcase
+                                          end
+      retry_methods = ENV.fetch('RETRY_METHODS', '%i[get put]').gsub(/[\[\]]/, '')
+                                          .split(',')
+                                          .map(&:strip)
+                                          .map do |item|
+                                            item.match?(/\A\d+\z/) ? item.to_i : item.downcase
+                                          end
+
+      # === Authentication credentials ===
+      api_key_credentials = ApiKeyCredentials.from_env
+      http_basic_credentials = HttpBasicCredentials.from_env
+      petstore_auth_credentials = PetstoreAuthCredentials.from_env
+
+      # === Proxy settings ===
+      proxy_settings = ProxySettings.from_env
+
+      Configuration.new(
+        environment: environment,
+        test_header: test_header,
+        timeout: timeout,
+        max_retries: max_retries,
+        retry_interval: retry_interval,
+        backoff_factor: backoff_factor,
+        retry_statuses: retry_statuses,
+        retry_methods: retry_methods,
+        api_key_credentials: api_key_credentials,
+        http_basic_credentials: http_basic_credentials,
+        petstore_auth_credentials: petstore_auth_credentials,
+        proxy_settings: proxy_settings
+      )
+    end
+  end
+end

data/lib/{cypress_test_api → swagger_petstore}/controllers/base_controller.rb

@@ -1,9 +1,9 @@
-# cypress_test_api
+# swagger_petstore
 #
 # This file was automatically generated by APIMATIC v3.0
 # ( https://www.apimatic.io ).
 
-module CypressTestApi
+module SwaggerPetstore
   # BaseController.
   class BaseController
     include CoreLibrary