cliV1 1.0.15__tar.gz

cliv1-1.0.15/LICENSE

@@ -0,0 +1,28 @@
+License: 
+========
+The MIT License (MIT)
+http://opensource.org/licenses/MIT
+
+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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+Trade Mark:
+==========
+APIMATIC is a trade mark for APIMATIC Limited

cliv1-1.0.15/MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE
+include README.md

cliv1-1.0.15/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: cliV1
+Version: 1.0.15
+Summary: Simple calculator API hosted on APIMATIC
+Author-email: CLI devs <support@cli.org>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: apimatic-core>=0.2.24,~=0.2.0
+Requires-Dist: apimatic-core-interfaces>=0.1.8,~=0.1.0
+Requires-Dist: apimatic-requests-client-adapter>=0.1.10,~=0.1.0
+Requires-Dist: python-dotenv<2.0,>=0.21
+Provides-Extra: testutils
+Requires-Dist: pytest>=7.2.2; extra == "testutils"
+Dynamic: license-file
+
+
+# Getting Started with APIMATIC Calculator
+
+## Introduction
+
+Simple calculator API hosted on APIMATIC
+
+## Install the Package
+
+The package is compatible with Python versions `3.7+`.
+Install the package from PyPi using the following pip command:
+
+```bash
+pip install cliV1==1.0.15
+```
+
+You can also view the package at:
+https://pypi.python.org/pypi/cliV1/1.0.15
+
+## Initialize the API Client
+
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/client.md)
+
+The following parameters are configurable for the API Client:
+
+| Parameter | Type | Description |
+|  --- | --- | --- |
+| http_client_instance | `Union[Session, HttpClientProvider]` | The Http Client passed from the sdk user for making requests |
+| override_http_client_configuration | `bool` | The value which determines to override properties of the passed Http Client from the sdk user |
+| http_call_back | `HttpCallBack` | The callback value that is invoked before and after an HTTP call is made to an endpoint |
+| timeout | `float` | The value to use for connection timeout. <br> **Default: 60** |
+| max_retries | `int` | The number of times to retry an endpoint call if it fails. <br> **Default: 0** |
+| backoff_factor | `float` | A backoff factor to apply between attempts after the second try. <br> **Default: 2** |
+| retry_statuses | `Array of int` | The http statuses on which retry is to be done. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
+| retry_methods | `Array of string` | The http methods on which retry is to be done. <br> **Default: ["GET", "PUT"]** |
+| proxy_settings | [`ProxySettings`](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+
+The API client can be initialized as follows:
+
+### Code-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+from apimaticcalculator.configuration import Environment
+
+client = ApimaticcalculatorClient(
+    environment=Environment.PRODUCTION
+)
+```
+
+### Environment-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+
+# Specify the path to your .env file if it’s located outside the project’s root directory.
+client = ApimaticcalculatorClient.from_environment(dotenv_path='/path/to/.env')
+```
+
+See the [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md) section for details.
+
+## List of APIs
+
+* [Simple Calculator](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/controllers/simple-calculator.md)
+
+## SDK Infrastructure
+
+### Configuration
+
+* [ProxySettings](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md)
+* [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md)
+
+### HTTP
+
+* [HttpResponse](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-response.md)
+* [HttpRequest](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-request.md)
+
+### Utilities
+
+* [ApiHelper](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/api-helper.md)
+* [HttpDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-date-time.md)
+* [RFC3339DateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/rfc3339-date-time.md)
+* [UnixDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/unix-date-time.md)
+

cliv1-1.0.15/README.md

@@ -0,0 +1,84 @@
+
+# Getting Started with APIMATIC Calculator
+
+## Introduction
+
+Simple calculator API hosted on APIMATIC
+
+## Install the Package
+
+The package is compatible with Python versions `3.7+`.
+Install the package from PyPi using the following pip command:
+
+```bash
+pip install cliV1==1.0.15
+```
+
+You can also view the package at:
+https://pypi.python.org/pypi/cliV1/1.0.15
+
+## Initialize the API Client
+
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/client.md)
+
+The following parameters are configurable for the API Client:
+
+| Parameter | Type | Description |
+|  --- | --- | --- |
+| http_client_instance | `Union[Session, HttpClientProvider]` | The Http Client passed from the sdk user for making requests |
+| override_http_client_configuration | `bool` | The value which determines to override properties of the passed Http Client from the sdk user |
+| http_call_back | `HttpCallBack` | The callback value that is invoked before and after an HTTP call is made to an endpoint |
+| timeout | `float` | The value to use for connection timeout. <br> **Default: 60** |
+| max_retries | `int` | The number of times to retry an endpoint call if it fails. <br> **Default: 0** |
+| backoff_factor | `float` | A backoff factor to apply between attempts after the second try. <br> **Default: 2** |
+| retry_statuses | `Array of int` | The http statuses on which retry is to be done. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
+| retry_methods | `Array of string` | The http methods on which retry is to be done. <br> **Default: ["GET", "PUT"]** |
+| proxy_settings | [`ProxySettings`](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+
+The API client can be initialized as follows:
+
+### Code-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+from apimaticcalculator.configuration import Environment
+
+client = ApimaticcalculatorClient(
+    environment=Environment.PRODUCTION
+)
+```
+
+### Environment-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+
+# Specify the path to your .env file if it’s located outside the project’s root directory.
+client = ApimaticcalculatorClient.from_environment(dotenv_path='/path/to/.env')
+```
+
+See the [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md) section for details.
+
+## List of APIs
+
+* [Simple Calculator](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/controllers/simple-calculator.md)
+
+## SDK Infrastructure
+
+### Configuration
+
+* [ProxySettings](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md)
+* [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md)
+
+### HTTP
+
+* [HttpResponse](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-response.md)
+* [HttpRequest](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-request.md)
+
+### Utilities
+
+* [ApiHelper](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/api-helper.md)
+* [HttpDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-date-time.md)
+* [RFC3339DateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/rfc3339-date-time.md)
+* [UnixDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/unix-date-time.md)
+

cliv1-1.0.15/apimaticcalculator/__init__.py

@@ -0,0 +1,12 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "api_helper",
+    "apimaticcalculator_client",
+    "configuration",
+    "controllers",
+    "exceptions",
+    "http",
+    "models",
+    "utilities",
+]

cliv1-1.0.15/apimaticcalculator/api_helper.py

@@ -0,0 +1,19 @@
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.utilities.api_helper import ApiHelper as CoreApiHelper
+
+
+class APIHelper(CoreApiHelper):
+    """
+    A Helper Class for various functions associated with API Calls.
+
+    This class contains static methods for operations that need to be
+    performed during API requests. All of the methods inside this class are
+    static methods, there is no need to ever initialise an instance of this
+    class.
+    """

cliv1-1.0.15/apimaticcalculator/apimaticcalculator_client.py

@@ -0,0 +1,63 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+# ruff: noqa: E501
+from apimatic_core.configurations.global_configuration import (
+    GlobalConfiguration,
+)
+from apimatic_core.decorators.lazy_property import (
+    LazyProperty,
+)
+
+from apimaticcalculator.configuration import (
+    Configuration,
+    Environment,
+)
+from apimaticcalculator.controllers.base_controller import (
+    BaseController,
+)
+from apimaticcalculator.controllers.simple_calculator_controller import (
+    SimpleCalculatorController,
+)
+
+
+class ApimaticcalculatorClient(object):
+    """Client that provide access to the ApimaticcalculatorClient APIs."""
+
+    @LazyProperty
+    def simple_calculator(self):
+        """Provide access to the SimpleCalculatorController endpoints."""
+        return SimpleCalculatorController(self.global_configuration)
+
+    def __init__(self, http_client_instance=None,
+                 override_http_client_configuration=False, http_call_back=None,
+                 timeout=60, max_retries=0, backoff_factor=2,
+                 retry_statuses=None, retry_methods=None, proxy_settings=None,
+                 environment=Environment.PRODUCTION, config=None):
+        """Initialize a new instance of ApimaticcalculatorClient."""
+        self.config = config or Configuration(
+            http_client_instance=http_client_instance,
+            override_http_client_configuration=override_http_client_configuration,
+            http_call_back=http_call_back, timeout=timeout,
+            max_retries=max_retries, backoff_factor=backoff_factor,
+            retry_statuses=retry_statuses, retry_methods=retry_methods,
+            proxy_settings=proxy_settings, environment=environment)
+
+        self.global_configuration = GlobalConfiguration(self.config)\
+            .global_errors(BaseController.global_errors())\
+            .base_uri_executor(self.config.get_base_uri)\
+            .user_agent(BaseController.user_agent(),
+                BaseController.user_agent_parameters())
+
+    @classmethod
+    def from_environment(cls, dotenv_path=None, **overrides):
+        """Create a client instance using environment variables.
+
+        Returns:
+            ApimaticcalculatorClient instance.
+
+        """
+        return cls(config=Configuration
+            .from_environment(dotenv_path=dotenv_path, **overrides))

cliv1-1.0.15/apimaticcalculator/configuration.py

@@ -0,0 +1,229 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+# ruff: noqa: E501
+import os
+from enum import Enum
+
+from apimatic_core.http.configurations.http_client_configuration import (
+    HttpClientConfiguration,
+)
+from apimatic_requests_client_adapter.requests_client import (
+    RequestsClient,
+)
+from dotenv import load_dotenv
+
+from apimaticcalculator.http.proxy_settings import (
+    ProxySettings,
+)
+
+
+class Environment(Enum):
+    """An enum for SDK environments."""
+
+    # This environment connect to the LIVE calculator API
+    PRODUCTION = 0
+
+    @classmethod
+    def from_value(cls, value, default=None):
+        """Convert a value (string or int) to an Environment enum member.
+
+        Args:
+            value (Union[str, int]): The value to convert.
+            default (Environment): The fallback enum member if conversion fails.
+
+        Returns:
+            Environment: Matching enum member or fallback if invalid.
+
+        """
+        if value is None:
+            return default
+
+        # Try to match directly by enum member
+        if isinstance(value, cls):
+            return value
+
+        # Handle integer or string conversion
+        for member in cls:
+            if (str(member.value).lower() == str(value).lower()
+                or member.name.lower() == str(value).lower()):
+                return member
+
+        # Fallback to provided default
+        return default
+
+
+class Server(Enum):
+    """An enum for API servers."""
+
+    DEFAULT = 0
+
+    @classmethod
+    def from_value(cls, value, default=None):
+        """Convert a value (string or int) to a Server enum member.
+
+        Args:
+            value (Union[str, int]): The value to convert.
+            default (Server): The fallback enum member if conversion fails.
+
+        Returns:
+            Server: Matching enum member or fallback if invalid.
+
+        """
+        if value is None:
+            return default
+
+        # Try to match directly by enum member
+        if isinstance(value, cls):
+            return value
+
+        # Handle integer or string conversion
+        for member in cls:
+            if (str(member.value).lower() == str(value).lower()
+                or member.name.lower() == str(value).lower()):
+                return member
+
+        # Fallback to provided default
+        return default
+
+
+class Configuration(HttpClientConfiguration):
+    """A class used for configuring the SDK by a user."""
+
+    @property
+    def environment(self):
+        """Return current environment."""
+        return self._environment
+
+    def __init__(self, http_client_instance=None,
+                 override_http_client_configuration=False, http_call_back=None,
+                 timeout=60, max_retries=0, backoff_factor=2, retry_statuses=None,
+                 retry_methods=None, proxy_settings=None,
+                 environment=Environment.PRODUCTION):
+        """Initialize Configuration object."""
+        if retry_methods is None:
+            retry_methods = ["GET", "PUT"]
+
+        if retry_statuses is None:
+            retry_statuses = [408, 413, 429, 500, 502, 503, 504, 521,
+                522, 524]
+
+        super().__init__(
+            http_client_instance=http_client_instance,
+            override_http_client_configuration=override_http_client_configuration,
+            http_call_back=http_call_back, timeout=timeout,
+            max_retries=max_retries, backoff_factor=backoff_factor,
+            retry_statuses=retry_statuses, retry_methods=retry_methods,
+            proxy_settings=proxy_settings,
+        )
+
+        # Current API environment
+        self._environment = environment
+
+        # The Http Client to use for making requests.
+        self.set_http_client(self.create_http_client())
+
+    def clone_with(self, http_client_instance=None,
+                   override_http_client_configuration=None, http_call_back=None,
+                   timeout=None, max_retries=None, backoff_factor=None,
+                   retry_statuses=None, retry_methods=None, proxy_settings=None,
+                   environment=None):
+        """Clone configuration with overrides."""
+        http_client_instance = http_client_instance or self.http_client_instance
+        override_http_client_configuration =\
+            (override_http_client_configuration
+            or self.override_http_client_configuration)
+        http_call_back = http_call_back or self.http_callback
+        timeout = timeout or self.timeout
+        max_retries = max_retries or self.max_retries
+        backoff_factor = backoff_factor or self.backoff_factor
+        retry_statuses = retry_statuses or self.retry_statuses
+        retry_methods = retry_methods or self.retry_methods
+        proxy_settings = proxy_settings or self.proxy_settings
+        environment = environment or self.environment
+        return Configuration(
+            http_client_instance=http_client_instance,
+            override_http_client_configuration=override_http_client_configuration,
+            http_call_back=http_call_back, timeout=timeout, max_retries=max_retries,
+            backoff_factor=backoff_factor, retry_statuses=retry_statuses,
+            retry_methods=retry_methods, proxy_settings=proxy_settings,
+            environment=environment,
+        )
+
+    def create_http_client(self):
+        """Create the HTTP client instance."""
+        return RequestsClient(
+            timeout=self.timeout, max_retries=self.max_retries,
+            backoff_factor=self.backoff_factor, retry_statuses=self.retry_statuses,
+            retry_methods=self.retry_methods,
+            http_client_instance=self.http_client_instance,
+            override_http_client_configuration=self.override_http_client_configuration,
+            response_factory=self.http_response_factory,
+            proxies=self.proxy_settings.to_proxies() if self.proxy_settings else None,
+        )
+
+    # All the environments the SDK can run in
+    environments = {
+        Environment.PRODUCTION: {
+            Server.DEFAULT: "https://examples.apimatic.io/apps/calculator",
+        },
+    }
+
+    def get_base_uri(self, server=Server.DEFAULT):
+        """Generate the appropriate base URI for the environment and the server.
+
+        Args:
+            server (Configuration.Server): The server enum for which the base
+            URI is required.
+
+        Returns:
+            String: The base URI.
+
+        """
+        return self.environments[self.environment][server]
+
+    @classmethod
+    def from_environment(cls, dotenv_path=None, **overrides):
+        """Create Configuration object from .env and environment variables.
+
+        Args:
+            dotenv_path (str, optional): Path to the .env file to load.
+             If None, the default .env file is used.
+            **overrides: Optional values overriding setting from environment variables.
+
+        Returns:
+            Configuration: A configuration object populated with the resolved values.
+
+        """
+        # load .env automatically
+        load_dotenv(dotenv_path or None, override=True)
+
+        override_http_client_configuration = os.getenv(
+            "OVERRIDE_HTTP_CLIENT_CONFIGURATION", "false").lower() == "true"
+        timeout = int(os.getenv("TIMEOUT", "60"))
+        max_retries = int(os.getenv("MAX_RETRIES", "0"))
+        backoff_factor = float(os.getenv("BACKOFF_FACTOR", "2"))
+        statuses = os.getenv("RETRY_STATUSES", None)
+        retry_statuses = [int(v.strip()) for v in statuses.split(",")
+                          if v.strip().isdigit()] if statuses else None
+        methods = os.getenv("RETRY_METHODS", None)
+        retry_methods = [v.strip() for v in methods.split(",") if v.strip()]\
+            if methods else None
+        environment = Environment.from_value(
+            os.getenv("ENVIRONMENT"), Environment.PRODUCTION)
+
+        # Preparing default configuration
+        default_config = cls(
+            override_http_client_configuration=override_http_client_configuration,
+            timeout=timeout,
+            max_retries=max_retries,
+            backoff_factor=backoff_factor,
+            retry_statuses=retry_statuses,
+            retry_methods=retry_methods,
+            environment=environment,
+            proxy_settings=ProxySettings.from_environment(),
+        )
+
+        return default_config.clone_with(**overrides)

cliv1-1.0.15/apimaticcalculator/controllers/__init__.py

@@ -0,0 +1,6 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "base_controller",
+    "simple_calculator_controller",
+]

cliv1-1.0.15/apimaticcalculator/controllers/base_controller.py

@@ -0,0 +1,67 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+from apimatic_core.api_call import ApiCall
+from apimatic_core.types.error_case import ErrorCase
+
+from apimaticcalculator.exceptions.api_exception import (
+    APIException,
+)
+
+
+class BaseController(object):
+    """All controllers inherit from this base class.
+
+    Attributes:
+        config (Configuration): The HttpClient which a specific controller
+            instance will use. By default all the controller objects share
+            the same HttpClient. A user can use his own custom HttpClient
+            as well.
+        http_call_back (HttpCallBack): An object which holds call back
+            methods to be called before and after the execution of an HttpRequest.
+        new_api_call_builder (APICall): Returns the API Call builder instance.
+
+    """
+
+    @staticmethod
+    def user_agent():
+        """Return UserAgent value."""
+        return "APIMATIC 3.0"
+
+    @staticmethod
+    def user_agent_parameters():
+        """Return UserAgentParameters value."""
+        return {
+        }
+
+    @staticmethod
+    def global_errors():
+        """Return GlobalErrors value."""
+        return {
+            "default": ErrorCase()
+                .error_message("HTTP response not OK.")
+                .exception_type(APIException),
+        }
+
+    def __init__(self, config):
+        """Initialize BaseController object."""
+        self._config = config.get_http_client_configuration()
+        self._http_call_back = self.config.http_callback
+        self.api_call = ApiCall(config)
+
+    @property
+    def config(self):
+        """Return Configuration object."""
+        return self._config
+
+    @property
+    def http_call_back(self):
+        """Return HttpCallBack object."""
+        return self._http_call_back
+
+    @property
+    def new_api_call_builder(self):
+        """Return New ApiCallBuilder object."""
+        return self.api_call.new_builder

cliv1-1.0.15/apimaticcalculator/controllers/simple_calculator_controller.py

@@ -0,0 +1,69 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+# ruff: noqa: D410, E501, E101, D206
+from apimatic_core.request_builder import RequestBuilder
+from apimatic_core.response_handler import ResponseHandler
+from apimatic_core.types.parameter import Parameter
+
+from apimaticcalculator.api_helper import APIHelper
+from apimaticcalculator.configuration import (
+    Server,
+)
+from apimaticcalculator.controllers.base_controller import (
+    BaseController,
+)
+from apimaticcalculator.http.http_method_enum import (
+    HttpMethodEnum,
+)
+
+
+class SimpleCalculatorController(BaseController):
+    """A Controller to access Endpoints in the apimaticcalculator API."""
+
+    def __init__(self, config):
+        """Initialize SimpleCalculatorController object."""
+        super(SimpleCalculatorController, self).__init__(config)
+
+    def calculate(self,
+                  operation,
+                  x,
+                  y):
+        """Perform a GET request to /{operation}.
+
+        Calculates the expression using the specified operation.
+
+        Args:
+            operation (OperationTypeEnum): The operator to apply on the variables
+            x (float): The LHS value
+            y (float): The RHS value
+
+        Returns:
+            float: Response from the API.
+
+        Raises:
+            APIException: When an error occurs while fetching the data from the
+                remote API. This exception includes the HTTP Response code, an error
+                message, and the HTTP body that was received in the request.
+
+        """
+        return super().new_api_call_builder.request(
+            RequestBuilder().server(Server.DEFAULT)
+            .path("/{operation}")
+            .http_method(HttpMethodEnum.GET)
+            .template_param(Parameter()
+                .key("operation")
+                .value(operation)
+                .should_encode(True))
+            .query_param(Parameter()
+                .key("x")
+                .value(x))
+            .query_param(Parameter()
+                .key("y")
+                .value(y)),
+        ).response(
+            ResponseHandler()
+            .deserializer(APIHelper.json_deserialize),
+        ).execute()

cliv1-1.0.15/apimaticcalculator/exceptions/__init__.py

@@ -0,0 +1,5 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "api_exception",
+]

cliv1-1.0.15/apimaticcalculator/exceptions/api_exception.py

@@ -0,0 +1,36 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+
+class APIException(Exception):
+    """Class that handles HTTP Exceptions when fetching API Endpoints.
+
+    Attributes:
+        response_code (int): The status code of the response.
+        response (HttpResponse): The HttpResponse of the API call.
+
+    """
+
+    def __init__(self,
+                 reason,
+                 response):
+        """Initialize APIException object.
+
+        Args:
+            reason (string): The reason (or error message) for the Exception
+                to be raised.
+            response (HttpResponse): The HttpResponse of the API call.
+
+        """
+        super(APIException, self).__init__(reason)
+        self.reason = reason
+        self.response = response
+        self.response_code = response.status_code
+
+    def __str__(self):
+        """Return a human-readable string representation."""
+        return (f"{self.__class__.__name__}("
+                f"status_code={self.response_code!s}, "
+                f"message={self.reason!s})")

cliv1-1.0.15/apimaticcalculator/http/__init__.py

@@ -0,0 +1,10 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "http_call_back",
+    "http_client_provider",
+    "http_method_enum",
+    "http_request",
+    "http_response",
+    "proxy_settings",
+]

cliv1-1.0.15/apimaticcalculator/http/http_call_back.py

@@ -0,0 +1,20 @@
+
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.http_callback import HttpCallBack as CoreHttpCallback
+
+
+class HttpCallBack(CoreHttpCallback):
+    """
+    An interface for the callback to be called before and after the
+    HTTP call for an endpoint is made.
+
+    This class should not be instantiated but should be used as a base class
+    for HttpCallBack classes.
+
+    """

cliv1-1.0.15/apimaticcalculator/http/http_client_provider.py

@@ -0,0 +1,23 @@
+"""
+ apimaticcalculator
+
+ This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+from abc import ABC
+
+from apimatic_core_interfaces.client.http_client_provider import (
+    HttpClientProvider as CoreHttpClientProvider,
+)
+
+
+class HttpClientProvider(CoreHttpClientProvider, ABC):
+    """
+     Defines a contract for providing HTTP client configuration.
+
+     Classes implementing this interface are expected to supply a configured
+     HTTP session and timeout value that will be used by the SDK's internal
+     HTTP layer when making network requests.
+
+     This allows developers to inject their own custom HTTP clients while
+     maintaining compatibility with the SDK's request/response handling.
+    """

cliv1-1.0.15/apimaticcalculator/http/http_method_enum.py

@@ -0,0 +1,25 @@
+
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core_interfaces.types.http_method_enum import (
+    HttpMethodEnum as CoreHttpMethodEnum,
+)
+
+
+class HttpMethodEnum(CoreHttpMethodEnum):
+    """
+    Enumeration of an HTTP Method
+
+    Attributes:
+        GET: A GET Request
+        POST: A POST Request
+        PUT: A PUT Request
+        PATCH: A PATCH Request
+        DELETE: A DELETE Request
+
+    """

cliv1-1.0.15/apimaticcalculator/http/http_request.py

@@ -0,0 +1,55 @@
+
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.request.http_request import HttpRequest as CoreHttpRequest
+
+
+class HttpRequest(CoreHttpRequest):
+    """
+    Represent an HTTP request to be sent to the server.
+
+    Encapsulates request details such as the HTTP method, target URL, headers,
+     query parameters, body parameters, and any files included with the request.
+
+    Attributes:
+        http_method: The HTTP method to use for the request.
+        query_url (str): The URL to which the request will be sent.
+        headers (dict[str, str] | None): Headers to include with the request.
+        query_parameters (dict[str, str] | None): Query parameters appended
+            to the request URL.
+        parameters (dict[str, str] | None): Form or body parameters sent
+            with the request.
+        files (dict | None): Files to be sent with the request.
+
+    """
+
+    def __init__(self,
+                 http_method,
+                 query_url,
+                 headers=None,
+                 query_parameters=None,
+                 parameters=None,
+                 files=None):
+        """
+        Initialize an HttpRequest instance.
+
+        Args:
+            http_method: The HTTP method to use for the request.
+            query_url: The URL to which the request will be sent.
+            headers: Headers to include with the request.
+            query_parameters: Query parameters appended to the request URL.
+            parameters: Form or body parameters sent with the request.
+            files: Files to be sent with the request.
+
+        """
+        super().__init__(http_method,
+                         query_url,
+                         headers,
+                         query_parameters,
+                         parameters,
+                         files)

cliv1-1.0.15/apimaticcalculator/http/http_response.py

@@ -0,0 +1,45 @@
+
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.response.http_response import HttpResponse as CoreHttpResponse
+
+
+class HttpResponse(CoreHttpResponse):
+    """
+    Represent an HTTP response returned by the server.
+
+    Stores response metadata such as status code, reason phrase, headers, and
+     the raw response body, along with the originating request.
+
+    Attributes:
+        status_code (int): The HTTP status code returned by the server.
+        reason_phrase (str): The reason phrase associated with the status code.
+        headers (dict[str, str]): Response headers as key-value pairs.
+        text (str): The raw response body as a string.
+        request: The request object that resulted in this response.
+
+    """
+
+    def __init__(self,
+                 status_code,
+                 reason_phrase,
+                 headers,
+                 text,
+                 request):
+        """
+        Initialize an HttpResponse instance.
+
+        Args:
+            status_code: The HTTP status code returned by the server.
+            reason_phrase: The reason phrase associated with the status code.
+            headers: Response headers as key-value pairs.
+            text: The raw response body as a string.
+            request: The request object that resulted in this response.
+
+        """
+        super().__init__(status_code, reason_phrase, headers, text, request)

cliv1-1.0.15/apimaticcalculator/http/proxy_settings.py

@@ -0,0 +1,50 @@
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+import os
+from typing import Optional
+
+from apimatic_core.http.configurations.proxy_settings import (
+    ProxySettings as CoreProxySettings,
+)
+
+
+class ProxySettings(CoreProxySettings):
+    """A simple data model for configuring HTTP(S) proxy settings."""
+
+    @classmethod
+    def from_environment(cls) -> Optional["ProxySettings"]:
+        """
+        Create an instance of this class using environment-based configuration.
+
+        This method attempts to construct and return an instance using relevant
+        environment variables, if available. If the required configuration is
+        not present, it may return `None` to indicate that no valid instance
+        could be created.
+
+        Returns:
+            Optional[cls]: A configured instance of this class, or `None` if
+            configuration data is missing or invalid.
+
+        """
+        address = os.getenv("PROXY_ADDRESS", None)
+        if not address:
+            return None
+
+        port = os.getenv("PROXY_PORT", None)
+        if port is not None:
+            try:
+                port = int(port)
+            except (TypeError, ValueError):
+                port = None
+
+        return cls(
+            address=address,
+            port=port,
+            username=os.getenv("PROXY_USERNAME", None),
+            password=os.getenv("PROXY_PASSWORD", None),
+        )

cliv1-1.0.15/apimaticcalculator/models/__init__.py

@@ -0,0 +1,5 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "operation_type_enum",
+]

cliv1-1.0.15/apimaticcalculator/models/operation_type_enum.py

@@ -0,0 +1,51 @@
+"""apimaticcalculator.
+
+This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+
+# ruff: noqa: E501
+
+class OperationTypeEnum(object):
+    """Implementation of the 'OperationType' enum.
+
+    Possible operators are sum, subtract, multiply, divide
+
+    Attributes:
+        SUM: The enum member of type str.
+        SUBTRACT: The enum member of type str.
+        MULTIPLY: The enum member of type str.
+        DIVIDE: The enum member of type str.
+
+    """
+
+    SUM = "SUM"
+
+    SUBTRACT = "SUBTRACT"
+
+    MULTIPLY = "MULTIPLY"
+
+    DIVIDE = "DIVIDE"
+
+    @classmethod
+    def from_value(cls, value, default=None):
+        """Return the matching enum value for the given input."""
+        if value is None:
+            return default
+
+        # If numeric and matches directly
+        if isinstance(value, int):
+            for name, val in cls.__dict__.items():
+                if not name.startswith("_") and val == value:
+                    return val
+
+        # If string, perform case-insensitive match
+        if isinstance(value, str):
+            value_lower = value.lower()
+            for name, val in cls.__dict__.items():
+                if not name.startswith("_") and (
+                    name.lower() == value_lower or str(val).lower() == value_lower
+                ):
+                    return val
+
+        # Fallback to default
+        return default

cliv1-1.0.15/apimaticcalculator/utilities/__init__.py

@@ -0,0 +1,6 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "file_wrapper",
+    "pagination",
+]

cliv1-1.0.15/apimaticcalculator/utilities/file_wrapper.py

@@ -0,0 +1,45 @@
+"""
+apimaticcalculator
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.types.file_wrapper import FileWrapper as CoreFileWrapper
+
+
+class FileWrapper(CoreFileWrapper):
+    """A wrapper to allow passing in content type for file uploads."""
+
+    def __init__(self, file, content_type: str="application/octet-stream") -> None:
+        """Initialize a new `FileWrapper` instance.
+
+        Args:
+            file: A readable file-like object or byte stream to wrap.
+            content_type (str, optional): The MIME type to associate with the
+                file. Defaults to `"application/octet-stream"`.
+
+        """
+        super().__init__(file, content_type)
+
+    def __repr__(self) -> str:
+        """Return a detailed string representation of the instance.
+
+        Returns:
+            str: A detailed, unambiguous representation of the wrapper.
+
+        """
+        return (f"{self.__class__.__name__}("
+                f"file={self._file_stream!r}, "
+                f"content_type={self.content_type!r})")
+
+    def __str__(self) -> str:
+        """Return a user-friendly string representation of the instance.
+
+        Returns:
+            str: A concise, readable representation of the wrapper.
+
+        """
+        return (f"{self.__class__.__name__}("
+                f"file={self._file_stream!s}, "
+                f"content_type={self.content_type!s})")

cliv1-1.0.15/cliV1.egg-info/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: cliV1
+Version: 1.0.15
+Summary: Simple calculator API hosted on APIMATIC
+Author-email: CLI devs <support@cli.org>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: apimatic-core>=0.2.24,~=0.2.0
+Requires-Dist: apimatic-core-interfaces>=0.1.8,~=0.1.0
+Requires-Dist: apimatic-requests-client-adapter>=0.1.10,~=0.1.0
+Requires-Dist: python-dotenv<2.0,>=0.21
+Provides-Extra: testutils
+Requires-Dist: pytest>=7.2.2; extra == "testutils"
+Dynamic: license-file
+
+
+# Getting Started with APIMATIC Calculator
+
+## Introduction
+
+Simple calculator API hosted on APIMATIC
+
+## Install the Package
+
+The package is compatible with Python versions `3.7+`.
+Install the package from PyPi using the following pip command:
+
+```bash
+pip install cliV1==1.0.15
+```
+
+You can also view the package at:
+https://pypi.python.org/pypi/cliV1/1.0.15
+
+## Initialize the API Client
+
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/client.md)
+
+The following parameters are configurable for the API Client:
+
+| Parameter | Type | Description |
+|  --- | --- | --- |
+| http_client_instance | `Union[Session, HttpClientProvider]` | The Http Client passed from the sdk user for making requests |
+| override_http_client_configuration | `bool` | The value which determines to override properties of the passed Http Client from the sdk user |
+| http_call_back | `HttpCallBack` | The callback value that is invoked before and after an HTTP call is made to an endpoint |
+| timeout | `float` | The value to use for connection timeout. <br> **Default: 60** |
+| max_retries | `int` | The number of times to retry an endpoint call if it fails. <br> **Default: 0** |
+| backoff_factor | `float` | A backoff factor to apply between attempts after the second try. <br> **Default: 2** |
+| retry_statuses | `Array of int` | The http statuses on which retry is to be done. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
+| retry_methods | `Array of string` | The http methods on which retry is to be done. <br> **Default: ["GET", "PUT"]** |
+| proxy_settings | [`ProxySettings`](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+
+The API client can be initialized as follows:
+
+### Code-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+from apimaticcalculator.configuration import Environment
+
+client = ApimaticcalculatorClient(
+    environment=Environment.PRODUCTION
+)
+```
+
+### Environment-Based Client Initialization
+
+```python
+from apimaticcalculator.apimaticcalculator_client import ApimaticcalculatorClient
+
+# Specify the path to your .env file if it’s located outside the project’s root directory.
+client = ApimaticcalculatorClient.from_environment(dotenv_path='/path/to/.env')
+```
+
+See the [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md) section for details.
+
+## List of APIs
+
+* [Simple Calculator](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/controllers/simple-calculator.md)
+
+## SDK Infrastructure
+
+### Configuration
+
+* [ProxySettings](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/proxy-settings.md)
+* [Environment-Based Client Initialization](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/environment-based-client-initialization.md)
+
+### HTTP
+
+* [HttpResponse](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-response.md)
+* [HttpRequest](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-request.md)
+
+### Utilities
+
+* [ApiHelper](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/api-helper.md)
+* [HttpDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/http-date-time.md)
+* [RFC3339DateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/rfc3339-date-time.md)
+* [UnixDateTime](https://www.github.com/WasifMatic/acme-python-sdk/tree/1.0.15/doc/unix-date-time.md)
+

cliv1-1.0.15/cliV1.egg-info/SOURCES.txt

@@ -0,0 +1,30 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.cfg
+apimaticcalculator/__init__.py
+apimaticcalculator/api_helper.py
+apimaticcalculator/apimaticcalculator_client.py
+apimaticcalculator/configuration.py
+apimaticcalculator/controllers/__init__.py
+apimaticcalculator/controllers/base_controller.py
+apimaticcalculator/controllers/simple_calculator_controller.py
+apimaticcalculator/exceptions/__init__.py
+apimaticcalculator/exceptions/api_exception.py
+apimaticcalculator/http/__init__.py
+apimaticcalculator/http/http_call_back.py
+apimaticcalculator/http/http_client_provider.py
+apimaticcalculator/http/http_method_enum.py
+apimaticcalculator/http/http_request.py
+apimaticcalculator/http/http_response.py
+apimaticcalculator/http/proxy_settings.py
+apimaticcalculator/models/__init__.py
+apimaticcalculator/models/operation_type_enum.py
+apimaticcalculator/utilities/__init__.py
+apimaticcalculator/utilities/file_wrapper.py
+cliV1.egg-info/PKG-INFO
+cliV1.egg-info/SOURCES.txt
+cliV1.egg-info/dependency_links.txt
+cliV1.egg-info/requires.txt
+cliV1.egg-info/top_level.txt

cliv1-1.0.15/cliV1.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cliv1-1.0.15/cliV1.egg-info/requires.txt

@@ -0,0 +1,7 @@
+apimatic-core>=0.2.24,~=0.2.0
+apimatic-core-interfaces>=0.1.8,~=0.1.0
+apimatic-requests-client-adapter>=0.1.10,~=0.1.0
+python-dotenv<2.0,>=0.21
+
+[testutils]
+pytest>=7.2.2

cliv1-1.0.15/cliV1.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+apimaticcalculator
+dist
+doc

cliv1-1.0.15/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "cliV1"
+description = "Simple calculator API hosted on APIMATIC"
+version = "1.0.15"
+readme = "README.md"
+keywords = []
+dependencies = ["apimatic-core~=0.2.0, >= 0.2.24", "apimatic-core-interfaces~=0.1.0, >= 0.1.8", "apimatic-requests-client-adapter~=0.1.0, >= 0.1.10", "python-dotenv>=0.21, <2.0"]
+classifiers = []
+requires-python = ">=3.7"
+[[project.authors]]
+name = "CLI devs"
+email = "support@cli.org"
+
+[project.urls]
+[project.optional-dependencies]
+testutils = ["pytest>=7.2.2"]
+[tool]
+[tool.setuptools]
+[tool.setuptools.packages]
+[tool.setuptools.packages.find]
+exclude = ["tests", "tests.*"]

cliv1-1.0.15/setup.cfg

@@ -0,0 +1,8 @@
+[meta-data]
+license_files = 
+	LICENSE
+
+[egg_info]
+tag_build = 
+tag_date = 0
+