kettles 0.1__tar.gz

kettles-0.1/LICENSE

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

kettles-0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md kettles/version.txt dev.txt LICENSE
+recursive-exclude * test
+prune test*

kettles-0.1/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: kettles
+Version: 0.1
+Summary: kettles
+Home-page: https://github.com/cscshared/kettles
+Author: dev
+Author-email: developers@directbuy.com
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: deceit
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: raft; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest_aspec; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: bumpversion; extra == "dev"
+Requires-Dist: convocations; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: waddle; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# kettles
+
+a deceitful api wrapper for the kibo api
+
+powered by angry penguins.

kettles-0.1/README.md

@@ -0,0 +1,5 @@
+# kettles
+
+a deceitful api wrapper for the kibo api
+
+powered by angry penguins.

kettles-0.1/dev.txt

@@ -0,0 +1,13 @@
+pytest
+coverage
+flake8
+pylint
+raft
+twine
+pytest_aspec
+ipython
+bumpversion
+convocations
+pytest-cov
+waddle
+build

kettles-0.1/kettles/adapters.py

@@ -0,0 +1,22 @@
+from urllib3.util import Retry
+from requests.adapters import DEFAULT_POOLSIZE, DEFAULT_POOLBLOCK
+from deceit.adapters import RetryAdapter
+
+
+class KiboRetryAdapter(RetryAdapter):
+    def __init__(self, timeout=None, pool_connections=DEFAULT_POOLSIZE,
+                 pool_maxsize=DEFAULT_POOLSIZE,
+                 max_retries=None,
+                 pool_block=DEFAULT_POOLBLOCK,
+                 methods=None, statuses=None):
+        if not max_retries:
+            max_retries = Retry(
+                connect=5, read=5, redirect=4,
+                status_forcelist=statuses or [429, 502, 503, 504],
+                allowed_methods=methods or [
+                    'HEAD', 'GET', 'POST', 'PUT', 'PATCH', 'DELETE',
+                ], backoff_factor=10, respect_retry_after_header=True)
+        super().__init__(
+            timeout=timeout, pool_connections=pool_connections,
+            pool_maxsize=pool_maxsize, max_retries=max_retries,
+            pool_block=pool_block, methods=methods, statuses=statuses)

kettles-0.1/kettles/api.py

@@ -0,0 +1,93 @@
+import posixpath
+from deceit.api_client import BackendOauth2Client
+from .exceptions import KiboException
+from .adapters import KiboRetryAdapter
+
+
+class KiboApi(BackendOauth2Client):
+    def __init__(self, *args, base_url=None, default_timeout=300,
+                 exception_class=KiboException, token_url=None,
+                 client_id=None, password=None, scopes=None,
+                 tenant_id=None, site_id=None, correlation_id=None,
+                 **kwargs):
+        if not token_url:
+            token_url = posixpath.join(base_url, 'api/platform/applications/authtickets/oauth')
+        super().__init__(
+            None, *args, base_url=base_url, default_timeout=default_timeout,
+            exception_class=exception_class, token_url=token_url,
+            client_id=client_id, password=password, scopes=scopes,
+            include_client_id=True, **kwargs)
+        self.tenant_id = tenant_id
+        self.site_id = site_id
+        self.correlation_id = correlation_id
+        self.adapter = KiboRetryAdapter(timeout=default_timeout)
+        self.session.mount('https://', self.adapter)
+
+    def headers(self, *args, **kwargs):
+        headers = super().headers()
+        headers['authorization'] = f'Bearer {self.session.access_token}'
+        headers['content-type'] = 'application/json'
+        headers['x-vol-tenant'] = self.tenant_id
+        if self.site_id:
+            headers['x-vol-site'] = self.site_id  # pragma: nocover
+        if self.correlation_id:
+            headers['x-vol-correlation-id'] = self.correlation_id  # pragma: nocover
+        return headers
+
+    def get_orders_page(self, page_size=None, start_index=None, odata_filter=None, raw=False, **kwargs):
+        """
+        gets a single page of orders.
+
+        pass `raw`=`True` to get the raw response object instead of the parsed json.
+        max `pageSize` is 200
+        `startIndex` is 0-based
+
+        `odata_filter` is an OData filter string. For example, to get orders updated between June 5 and June 7, 2026:
+        ```
+        auditInfo.updateDate ge 2026-06-05T00:00:00Z and auditInfo.updateDate lt 2026-06-07T00:00:00Z
+        ```
+
+        docs for filtering examples: https://docs.kibocommerce.com/pages/sorting-and-filtering-apis
+        docs for orders api: https://docs.kibocommerce.com/api-reference/order/get-orders
+        """
+        params = {}
+        if page_size:
+            params['pageSize'] = page_size
+        if start_index:
+            params['startIndex'] = start_index
+        if odata_filter:
+            params['filter'] = odata_filter
+        return self.get('api/commerce/orders', params=params, raw=raw, **kwargs)
+
+    def get_orders(self, odata_filter=None, page_size=200, **kwargs):
+        """
+        gets all orders matching the filter by paging through results until there are no more.
+
+        `odata_filter` is an OData filter string.
+        For example, to get orders updated between June 5 and June 7, 2026:
+        ```
+        auditInfo.updateDate ge 2026-06-05T00:00:00Z and auditInfo.updateDate lt 2026-06-07T00:00:00Z
+        ```
+
+        docs for filtering examples: https://docs.kibocommerce.com/pages/sorting-and-filtering-apis
+        docs for orders api: https://docs.kibocommerce.com/api-reference/order/get-orders
+        """
+        start_index = 0
+        all_results = []
+        total_pages = 1
+        n = 0
+        while n < total_pages:
+            result = self.get_orders_page(
+                page_size=page_size,
+                start_index=start_index,
+                odata_filter=odata_filter,
+                **kwargs,
+            )
+            items = result.get('items') or []
+            if not items:
+                break  # pragma: nocover
+            all_results.extend(items)
+            start_index += page_size
+            total_pages = result['pageCount']
+            n += 1
+        return all_results

kettles-0.1/kettles/exceptions.py

@@ -0,0 +1,11 @@
+from deceit.exceptions import ApiException
+
+
+class KiboException(ApiException):
+    def __init__(
+        self, status_code=None, content=None, text=None, data=None,
+        headers=None,
+    ) -> None:
+        super().__init__(status_code, content, text, data, headers)
+        self.is_precondition_failed = status_code == 412
+        self.retryable = status_code == 429 or status_code == 412 or status_code >= 500

kettles-0.1/kettles/version_info.py

@@ -0,0 +1 @@
+_version = '0.1'

kettles-0.1/kettles.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: kettles
+Version: 0.1
+Summary: kettles
+Home-page: https://github.com/cscshared/kettles
+Author: dev
+Author-email: developers@directbuy.com
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: deceit
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: raft; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest_aspec; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: bumpversion; extra == "dev"
+Requires-Dist: convocations; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: waddle; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# kettles
+
+a deceitful api wrapper for the kibo api
+
+powered by angry penguins.

kettles-0.1/kettles.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+dev.txt
+pyproject.toml
+setup.py
+kettles/__init__.py
+kettles/adapters.py
+kettles/api.py
+kettles/exceptions.py
+kettles/version_info.py
+kettles.egg-info/PKG-INFO
+kettles.egg-info/SOURCES.txt
+kettles.egg-info/dependency_links.txt
+kettles.egg-info/requires.txt
+kettles.egg-info/top_level.txt

kettles-0.1/kettles.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kettles-0.1/kettles.egg-info/requires.txt

@@ -0,0 +1,16 @@
+deceit
+
+[dev]
+pytest
+coverage
+flake8
+pylint
+raft
+twine
+pytest_aspec
+ipython
+bumpversion
+convocations
+pytest-cov
+waddle
+build

kettles-0.1/kettles.egg-info/top_level.txt

@@ -0,0 +1 @@
+kettles

kettles-0.1/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"

kettles-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kettles-0.1/setup.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python
+
+from setuptools import setup
+# from importlib.resources import open_text
+# Version info -- read without importing
+_locals = {}
+
+# PyYAML ships a split Python 2/3 codebase. Unfortunately, some pip versions
+# attempt to interpret both halves of PyYAML, yielding SyntaxErrors. Thus, we
+# exclude whichever appears inappropriate for the installing interpreter.
+exclude = ["*.yaml2", 'test']
+
+# Frankenstein long_description: version-specific changelog note + README
+with open('README.md') as f:
+    long_description = f.read()
+
+extras = {}
+all_extras = set()
+for x in [ 'dev' ]:
+    filename = f'{x}.txt'
+    with open(filename, 'r') as f:
+        st = f.read()
+    rg = st.split()
+    extras[x] = rg
+    if x != 'dev':
+        all_extras |= set(rg)
+if all_extras:
+    all_extras = list(all_extras)
+    all_extras.sort()
+    extras['all'] = all_extras
+
+
+setup(
+    name='kettles',
+    version='0.1',
+    description='kettles',
+    license='MIT',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    author='dev',
+    author_email='developers@directbuy.com',
+    url='https://github.com/cscshared/kettles',
+    packages=[
+        'kettles',
+    ],
+    classifiers=[
+        'Development Status :: 5 - Production/Stable',
+        'Environment :: Console',
+        'Intended Audience :: Developers',
+        'Intended Audience :: System Administrators',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: POSIX',
+        'Operating System :: Unix',
+        'Operating System :: MacOS :: MacOS X',
+        'Operating System :: Microsoft :: Windows',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Topic :: Software Development',
+        'Topic :: Software Development :: Libraries',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+    ],
+    install_requires=[
+        'deceit',
+    ],
+    extras_require=extras,
+)