elastly 0.1.0__py3-none-any.whl

elastly/models/writeback_ack_request_results_inner.py

@@ -0,0 +1,93 @@
+# coding: utf-8
+
+"""
+    Elastly API
+
+    Elastly public API v1: price serving, canonical ingest, write-back claims and webhooks. Authenticate every request with an API key: Authorization: Bearer elastly_live_...
+
+    The version of the OpenAPI document: 1.0.0
+    Contact: support@elastly.io
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictBool, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class WritebackAckRequestResultsInner(BaseModel):
+    """
+    WritebackAckRequestResultsInner
+    """ # noqa: E501
+    id: StrictStr
+    ok: StrictBool
+    error: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["id", "ok", "error"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of WritebackAckRequestResultsInner from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of WritebackAckRequestResultsInner from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "id": obj.get("id"),
+            "ok": obj.get("ok"),
+            "error": obj.get("error")
+        })
+        return _obj
+
+

elastly/rest.py

@@ -0,0 +1,264 @@
+# coding: utf-8
+
+"""
+    Elastly API
+
+    Elastly public API v1: price serving, canonical ingest, write-back claims and webhooks. Authenticate every request with an API key: Authorization: Bearer elastly_live_...
+
+    The version of the OpenAPI document: 1.0.0
+    Contact: support@elastly.io
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+import io
+import json
+import re
+import ssl
+
+import urllib3
+
+from elastly.exceptions import ApiException, ApiValueError
+
+SUPPORTED_SOCKS_PROXIES = {"socks5", "socks5h", "socks4", "socks4a"}
+RESTResponseType = urllib3.HTTPResponse
+
+
+def is_socks_proxy_url(url):
+    if url is None:
+        return False
+    split_section = url.split("://")
+    if len(split_section) < 2:
+        return False
+    else:
+        return split_section[0].lower() in SUPPORTED_SOCKS_PROXIES
+
+
+class RESTResponse(io.IOBase):
+
+    def __init__(self, resp) -> None:
+        self.response = resp
+        self.status = resp.status
+        self.reason = resp.reason
+        self.data = None
+
+    def read(self):
+        if self.data is None:
+            self.data = self.response.data
+        return self.data
+
+    @property
+    def headers(self):
+        """Returns a dictionary of response headers."""
+        return self.response.headers
+
+    def getheaders(self):
+        """Returns a dictionary of the response headers; use ``headers`` instead."""
+        return self.response.headers
+
+    def getheader(self, name, default=None):
+        """Returns a given response header; use ``headers.get()`` instead."""
+        return self.response.headers.get(name, default)
+
+
+class RESTClientObject:
+
+    def __init__(self, configuration) -> None:
+        # urllib3.PoolManager will pass all kw parameters to connectionpool
+        # https://github.com/shazow/urllib3/blob/f9409436f83aeb79fbaf090181cd81b784f1b8ce/urllib3/poolmanager.py#L75  # noqa: E501
+        # https://github.com/shazow/urllib3/blob/f9409436f83aeb79fbaf090181cd81b784f1b8ce/urllib3/connectionpool.py#L680  # noqa: E501
+        # Custom SSL certificates and client certificates: http://urllib3.readthedocs.io/en/latest/advanced-usage.html  # noqa: E501
+
+        # cert_reqs
+        if configuration.verify_ssl:
+            cert_reqs = ssl.CERT_REQUIRED
+        else:
+            cert_reqs = ssl.CERT_NONE
+
+        pool_args = {
+            "cert_reqs": cert_reqs,
+            "ca_certs": configuration.ssl_ca_cert,
+            "cert_file": configuration.cert_file,
+            "key_file": configuration.key_file,
+            "ca_cert_data": configuration.ca_cert_data,
+        }
+        if configuration.assert_hostname is not None:
+            pool_args['assert_hostname'] = (
+                configuration.assert_hostname
+            )
+
+        if configuration.retries is not None:
+            pool_args['retries'] = configuration.retries
+
+        if configuration.tls_server_name:
+            pool_args['server_hostname'] = configuration.tls_server_name
+
+
+        if configuration.socket_options is not None:
+            pool_args['socket_options'] = configuration.socket_options
+
+        if configuration.connection_pool_maxsize is not None:
+            pool_args['maxsize'] = configuration.connection_pool_maxsize
+
+        # https pool manager
+        self.pool_manager: urllib3.PoolManager
+
+        if configuration.proxy:
+            if is_socks_proxy_url(configuration.proxy):
+                from urllib3.contrib.socks import SOCKSProxyManager
+                pool_args["proxy_url"] = configuration.proxy
+                pool_args["headers"] = configuration.proxy_headers
+                self.pool_manager = SOCKSProxyManager(**pool_args)
+            else:
+                pool_args["proxy_url"] = configuration.proxy
+                pool_args["proxy_headers"] = configuration.proxy_headers
+                self.pool_manager = urllib3.ProxyManager(**pool_args)
+        else:
+            self.pool_manager = urllib3.PoolManager(**pool_args)
+
+    def request(
+        self,
+        method,
+        url,
+        headers=None,
+        body=None,
+        post_params=None,
+        _request_timeout=None
+    ):
+        """Perform requests.
+
+        :param method: http request method
+        :param url: http request url
+        :param headers: http request headers
+        :param body: request json body, for `application/json`
+        :param post_params: request post parameters,
+                            `application/x-www-form-urlencoded`
+                            and `multipart/form-data`
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        """
+        method = method.upper()
+        assert method in [
+            'GET',
+            'HEAD',
+            'DELETE',
+            'POST',
+            'PUT',
+            'PATCH',
+            'OPTIONS'
+        ]
+
+        if post_params and body:
+            raise ApiValueError(
+                "body parameter cannot be used with post_params parameter."
+            )
+
+        post_params = post_params or {}
+        headers = headers or {}
+
+        timeout = None
+        if _request_timeout:
+            if isinstance(_request_timeout, (int, float)):
+                timeout = urllib3.Timeout(total=_request_timeout)
+            elif (
+                    isinstance(_request_timeout, tuple)
+                    and len(_request_timeout) == 2
+                ):
+                timeout = urllib3.Timeout(
+                    connect=_request_timeout[0],
+                    read=_request_timeout[1]
+                )
+
+        try:
+            # For `POST`, `PUT`, `PATCH`, `OPTIONS`, `DELETE`
+            if method in ['POST', 'PUT', 'PATCH', 'OPTIONS', 'DELETE']:
+
+                # no content type provided or payload is json
+                content_type = headers.get('Content-Type')
+                if (
+                    not content_type
+                    or re.search('json', content_type, re.IGNORECASE)
+                ):
+                    request_body = None
+                    if body is not None:
+                        request_body = json.dumps(body)
+                    r = self.pool_manager.request(
+                        method,
+                        url,
+                        body=request_body,
+                        timeout=timeout,
+                        headers=headers,
+                        preload_content=False
+                    )
+                elif content_type == 'application/x-www-form-urlencoded':
+                    r = self.pool_manager.request(
+                        method,
+                        url,
+                        fields=post_params,
+                        encode_multipart=False,
+                        timeout=timeout,
+                        headers=headers,
+                        preload_content=False
+                    )
+                elif content_type == 'multipart/form-data':
+                    # must del headers['Content-Type'], or the correct
+                    # Content-Type which generated by urllib3 will be
+                    # overwritten.
+                    del headers['Content-Type']
+                    # Ensures that dict objects are serialized
+                    post_params = [(a, json.dumps(b)) if isinstance(b, dict) else (a,b) for a, b in post_params]
+                    r = self.pool_manager.request(
+                        method,
+                        url,
+                        fields=post_params,
+                        encode_multipart=True,
+                        timeout=timeout,
+                        headers=headers,
+                        preload_content=False
+                    )
+                # Pass a `string` parameter directly in the body to support
+                # other content types than JSON when `body` argument is
+                # provided in serialized form.
+                elif isinstance(body, str) or isinstance(body, bytes):
+                    r = self.pool_manager.request(
+                        method,
+                        url,
+                        body=body,
+                        timeout=timeout,
+                        headers=headers,
+                        preload_content=False
+                    )
+                elif headers['Content-Type'].startswith('text/') and isinstance(body, bool):
+                    request_body = "true" if body else "false"
+                    r = self.pool_manager.request(
+                        method,
+                        url,
+                        body=request_body,
+                        preload_content=False,
+                        timeout=timeout,
+                        headers=headers)
+                else:
+                    # Cannot generate the request from given parameters
+                    msg = """Cannot prepare a request message for provided
+                             arguments. Please check that your arguments match
+                             declared content type."""
+                    raise ApiException(status=0, reason=msg)
+            # For `GET`, `HEAD`
+            else:
+                r = self.pool_manager.request(
+                    method,
+                    url,
+                    fields={},
+                    timeout=timeout,
+                    headers=headers,
+                    preload_content=False
+                )
+        except urllib3.exceptions.SSLError as e:
+            msg = "\n".join([type(e).__name__, str(e)])
+            raise ApiException(status=0, reason=msg)
+
+        return RESTResponse(r)

elastly-0.1.0.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: elastly
+Version: 0.1.0
+Summary: Elastly API
+Home-page: https://elastly.io/docs/sdk
+Author: Elastly
+Author-email: Elastly <support@elastly.io>
+License: MIT
+Project-URL: Repository, https://github.com/elastly/elastly-python
+Keywords: OpenAPI,OpenAPI-Generator,Elastly API
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2.11
+Requires-Dist: typing-extensions>=4.7.1
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+# Elastly Python SDK
+
+The official Python client for the [Elastly](https://elastly.io) REST API.
+
+Elastly prices quote and order lines for B2B sellers. Send a line (product, customer, quantity) and get back a price with the reasoning behind it: which pricing rules fired, what each one added, and how confident the engine is. The engine learns from the outcomes you feed back, so prices improve over time.
+
+This client covers the full v1 API:
+
+- **Prices**: price up to 100 lines in one call.
+- **Ingest**: push products, customers, quotes, and orders from your own system in staged batches.
+- **Write-backs**: pull approved price changes into your system and confirm them once applied.
+
+## Install
+
+```bash
+pip install elastly
+```
+
+Requires Python 3.9 or newer.
+
+## Authenticate
+
+Create an API key in the dashboard (Settings, then API keys). Keys are scoped: an `erp` key prices lines, a `connector` key ingests data and claims write-backs. Send the key as a bearer token.
+
+## Price a line
+
+```python
+import uuid
+
+import elastly
+
+configuration = elastly.Configuration(access_token="elastly_live_...")
+
+with elastly.ApiClient(configuration) as api_client:
+    prices = elastly.PricesApi(api_client)
+
+    response = prices.get_prices(
+        idempotency_key=str(uuid.uuid4()),
+        prices_request=elastly.PricesRequest(
+            lines=[
+                elastly.PricesRequestLinesInner(
+                    product_sku="SKU-1042",
+                    customer_external_id="CUST-88",
+                    quantity=25,
+                )
+            ]
+        ),
+    )
+
+    for line in response.lines:
+        result = line.actual_instance
+        if result.ok:
+            print(result.price_cents, result.currency, result.reason_summary)
+        else:
+            print("failed:", result.code, result.message)
+```
+
+Every response line is either a priced result (`ok` is true) or a per-line error. One bad line never fails the batch.
+
+## Retries and idempotency
+
+`POST /v1/prices` requires an `Idempotency-Key` header. Use a fresh key for each logical request and reuse the same key on retries. A replay returns the stored response, so a retried call never prices twice.
+
+## Close the loop
+
+Elastly learns from the difference between the price it recommended and the price your team actually charged. When you ingest quotes, echo the `pricingDecisionId` you received from the prices call on the matching quote line. Skip that and the engine has nothing to learn from.
+
+## Documentation
+
+- [API reference](https://elastly.io/docs/api)
+- Per-endpoint docs for this client live in [docs](./docs).
+
+## About this repository
+
+This code is generated from the Elastly OpenAPI contract, so pull requests against generated files get overwritten by the next release. If something is broken or missing, open an issue or email support@elastly.io.
+
+## License
+
+[MIT](./LICENSE)

elastly-0.1.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+elastly/__init__.py,sha256=iwN6tChEZh3EvVymuAUOZkobmLChZL_0LLDajUTYH3A,6491
+elastly/api_client.py,sha256=4HpoGQMQZFMbXqMItaIP510A9SMWtzElGBSjZ4Tt8z8,27869
+elastly/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
+elastly/configuration.py,sha256=5AHGfk7TtX0pv30GVy85Z7BYdOAP9VvmRwPryZH8ms4,19922
+elastly/exceptions.py,sha256=ae7HN-3jIsUIe2JINrb4-b_Z2aYFUaELGPgagF-FgUQ,6622
+elastly/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+elastly/rest.py,sha256=XAIPf-jrTPnQiDJxQnjnL1FO-qNgLFVCHB3jsHVub08,9748
+elastly/api/__init__.py,sha256=7e1hkgZHc41ZBFzd0dTaq9-KexV973r2JCBokn1b9Ns,191
+elastly/api/ingest_api.py,sha256=MTn2ALQx15SKZyErbJRIUfoX-bPYeOVg1FGEA-fnyOA,43900
+elastly/api/prices_api.py,sha256=oGSxbvqdlnCHRe8afmYtrNyaw5NIf3AK-c62Q5ISQow,14073
+elastly/api/writebacks_api.py,sha256=8Uq9Y7Lyo4TJjWCyQptwovlA7pkMmLsRA9WVyjhJW2A,23976
+elastly/models/__init__.py,sha256=JFB_yvOxlenHcgdqy1GL1zfrVslzfxokd4QHf21dvU0,3264
+elastly/models/ack_writebacks_response.py,sha256=IxpKTNvS5Hb4nCyHogKCvSs3m3PBjgPleEyiAqFf9Nc,3006
+elastly/models/api_error.py,sha256=haMxugYkxrbPGhnI4VP3POFsZFog4QMjhlq2Z88MsB8,2826
+elastly/models/api_error_error.py,sha256=QB63nFOfq9fjqsX9gsxKxqkVRt6We8lq_79ElLYmMSQ,4003
+elastly/models/batch_created_response.py,sha256=vgjL9FoF0Uyod51t_n6U4FaavW2dbA2r-ZsVoOvWwLM,2768
+elastly/models/batch_status_response.py,sha256=5geBYBnSpdwadwQmBNNYbbN4Z3FxroM-Cv1MuDN1iqI,3772
+elastly/models/claim_writebacks_request.py,sha256=Tdk3lFtddND1KenjGFnR3Vgs4Pe05kL-4OGwTIhbK6s,2754
+elastly/models/claim_writebacks_response.py,sha256=Tf2XyfzhorZqdicg2l3hhcgo6mOH3AXZoAobbZEp-q4,3153
+elastly/models/claim_writebacks_response_tasks_inner.py,sha256=o76gahsDOFxgH4Yx1IfpJKW5ImOEnOCmsxZCJV5is_c,4677
+elastly/models/commit_batch_response.py,sha256=HF0aIkOO4nnL04uSlrwG6_Wxyb0bqr-JiGDrXzs2R8c,2631
+elastly/models/prices_request.py,sha256=9OV6Nec7UmMNVBeUISjGG81zv2RNVdp3SVevvVNF4Og,3167
+elastly/models/prices_request_lines_inner.py,sha256=g_GT2tTKDFrMLJ479qYZ8Awd0DhuXopDiYNGZ-8fWJQ,4550
+elastly/models/prices_response.py,sha256=llRo2cKBM1AWHUXXxdQdfu6YJ7VdA6EtIm5ZpIeoghI,3080
+elastly/models/prices_response_lines_inner.py,sha256=WKJSNRsiV5oKeLqA_cL4prWvY7EEJGASxVDhtpeR3mc,6016
+elastly/models/prices_response_lines_inner_one_of.py,sha256=U5hf5rp6c8NynVf5o19ndSmQaVYGVxrxjk3UHdwFJW0,5343
+elastly/models/prices_response_lines_inner_one_of1.py,sha256=ITExAs9aYf7aVxhIO0u61RgcXzqx2HJ2kwGvvvkULF4,4155
+elastly/models/prices_response_lines_inner_one_of_explanation.py,sha256=X8sx19lRZGmv8twyL2IH_so_ZII1HapDHFBQoEe3fdg,4549
+elastly/models/prices_response_lines_inner_one_of_explanation_drivers_inner.py,sha256=cu976drbQ5RKJkeymAfv0PUgBAvpkdVrx9ec0gmAxFg,3280
+elastly/models/prices_response_lines_inner_one_of_reason_inner.py,sha256=HKPGOeLV5D3XfJsVLsljchPcC5T_oVVwg_eq1RUSYMc,3063
+elastly/models/stage_records_request.py,sha256=iyVVtWMsT-2J3jXpcLjC90APSmfUXoJ9Yi-HynkAPao,7692
+elastly/models/stage_records_request_one_of.py,sha256=xpXIi7U66xQdkjHC47-PummWp8eeej4g4U_Z7keuKOE,3633
+elastly/models/stage_records_request_one_of1.py,sha256=FjEhgTjvTwXkV8HXXBt5KnubFmk5pK5WuogytOiFbvM,3643
+elastly/models/stage_records_request_one_of1_records_inner.py,sha256=g5G99FnAEs_NWHQuovoXQJryivVMZagEy9SLqPGFk4Y,4524
+elastly/models/stage_records_request_one_of2.py,sha256=D_wxAu1wREBPa7DHaHmPhAXgvM22pOBn8kVUnxHhiOg,3637
+elastly/models/stage_records_request_one_of2_records_inner.py,sha256=SCVjYP6nWLIGMBCG6iGIvzit9uHsdlHHGZrA_yx1gEM,7395
+elastly/models/stage_records_request_one_of2_records_inner_lines_inner.py,sha256=GGZnCU3RxTgb2RqmuXkZnG91iqCleURP-pNtg5z2GiI,4966
+elastly/models/stage_records_request_one_of3.py,sha256=oiscd5TiSyWPe4kPfTpLOk_0F6cWqUudo61Uwkycb3U,3637
+elastly/models/stage_records_request_one_of3_records_inner.py,sha256=VBnDzWC7zcPaon_e70bV40wxv4g3-EudMd_eJSJ8JL8,5795
+elastly/models/stage_records_request_one_of3_records_inner_lines_inner.py,sha256=om1ZOXCoAoTYLHJ7gIVX0eb2OzbQ3A5OecGgi1BXFcc,3483
+elastly/models/stage_records_request_one_of_records_inner.py,sha256=82LiX06D4tRIWEuUwo-LFeLw1gUW-KKnVXIYEhrX_DE,4820
+elastly/models/stage_records_response.py,sha256=xey5i_ePHHJT-Vna_t_pGbLDFUdqOb-pM2NjWkDTEXc,2712
+elastly/models/writeback_ack_request.py,sha256=yqDeEobC-x2wRxhDbQuC633iX_CAjmF_svBSIhKQ6B0,3248
+elastly/models/writeback_ack_request_results_inner.py,sha256=XSgSqHuvhEagVTyDWIN2En5STjNweuIp9Wv1SnZIri4,2802
+elastly-0.1.0.dist-info/licenses/LICENSE,sha256=rpV3vU7iX3rhXWyLOo7fPu0wu_KH7VESfNOEbTG0Fh4,1064
+elastly-0.1.0.dist-info/METADATA,sha256=yzUreB4FTSw-HfRwKMjlX8mokNSABYSnQFlBoeK5Kf8,3453
+elastly-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+elastly-0.1.0.dist-info/top_level.txt,sha256=gaFFVlxXhUUqQmbGGrBs-i7qZ5GeawVtcrwbnVSWFJ0,8
+elastly-0.1.0.dist-info/RECORD,,

elastly-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

elastly-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elastly
+
+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.

elastly-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+elastly