vesremont-api 0.2.0__tar.gz

vesremont_api-0.2.0/LICENSE

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

vesremont_api-0.2.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: vesremont-api
+Version: 0.2.0
+Summary: Small standard-library client for the Vesremont public API
+License-Expression: MIT
+Project-URL: Documentation, https://vesremont.com/for_ai/api_ai/
+Project-URL: Homepage, https://vesremont.com/developers/
+Project-URL: Source, https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python
+Project-URL: Issues, https://github.com/oooafganec-dev/vesremont-sdk/issues
+Keywords: vesremont,api,sdk,oauth,pkce
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Vesremont Python SDK 0.2.0
+
+Python 3.10+, только стандартная библиотека во время работы.
+MIT. Официальные исходники:
+https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python.
+Команда установки опубликованного релиза из PyPI:
+
+```bash
+python -m pip install vesremont-api==0.2.0
+```
+
+Альтернатива — прямой wheel с сайта Vesremont:
+
+```bash
+python -m pip install https://vesremont.com/developers/downloads/vesremont_api-0.2.0-py3-none-any.whl
+```
+
+Готовый wheel не требует сборки. Также доступен исходный sdist
+`vesremont_api-0.2.0.tar.gz`; для его сборки нужен setuptools 77.0.3+.
+Runtime-зависимостей нет.
+
+```python
+from vesremont_api import VesremontClient, ApiError
+
+api = VesremontClient()
+products = api.search("труборез", page=1, per_page=10)
+product = api.product(375094)
+draft = api.cart_draft(375094, 1)
+# draft["share_url"] передаётся покупателю, не в публичные логи.
+```
+
+`status`, `search`, `product`, `cart`, `cart_draft` — короткие помощники.
+Остальные REST-операции: `request(method, '/path', query={}, body={}, idempotency_key=...)`.
+Путь относительно `/api/v1`; GET вызывается без body. `filters` в query — JSON-строка.
+Подборку можно дополнить через `cart_draft(..., draft=token)`; token берётся
+из query `draft` ранее полученной share_url. Серверные схемы:
+https://vesremont.com/openapi.json.
+
+Для личных данных передайте уже полученный REST OAuth token:
+`VesremontClient(token=token)`. OAuth-протокол и минимальные scopes описаны
+в https://vesremont.com/llms/api.md. Браузерный OAuth мастер есть в Node CLI;
+в Python SDK второй мастер не дублируется. Токен не пишется на диск, не входит в URL.
+
+Timeout по умолчанию 15 секунд (параметр `timeout`, до 60). TLS проверяется,
+redirects и автоматические повторы отсутствуют; API host фиксирован.
+Ответ ограничен 2 MiB, тело запроса — 64 KiB.
+`ApiError` содержит `status`, `code`, `request_id`, `retry_after`, без raw body.
+После неопределённого исхода записи сначала перечитайте состояние.
+Для submit нужны prepare, подтверждение покупателя на Vesremont и стабильный
+`idempotency_key`; SDK не обходит эти проверки и не создаёт фиктивных заказов.
+
+Используйте с внешнего ПК/хостинга. Это production API, sandbox не предоставляется.
+Наличие SDK не означает включение отключённых операций или завершение приёмки.

vesremont_api-0.2.0/README.md

@@ -0,0 +1,53 @@
+# Vesremont Python SDK 0.2.0
+
+Python 3.10+, только стандартная библиотека во время работы.
+MIT. Официальные исходники:
+https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python.
+Команда установки опубликованного релиза из PyPI:
+
+```bash
+python -m pip install vesremont-api==0.2.0
+```
+
+Альтернатива — прямой wheel с сайта Vesremont:
+
+```bash
+python -m pip install https://vesremont.com/developers/downloads/vesremont_api-0.2.0-py3-none-any.whl
+```
+
+Готовый wheel не требует сборки. Также доступен исходный sdist
+`vesremont_api-0.2.0.tar.gz`; для его сборки нужен setuptools 77.0.3+.
+Runtime-зависимостей нет.
+
+```python
+from vesremont_api import VesremontClient, ApiError
+
+api = VesremontClient()
+products = api.search("труборез", page=1, per_page=10)
+product = api.product(375094)
+draft = api.cart_draft(375094, 1)
+# draft["share_url"] передаётся покупателю, не в публичные логи.
+```
+
+`status`, `search`, `product`, `cart`, `cart_draft` — короткие помощники.
+Остальные REST-операции: `request(method, '/path', query={}, body={}, idempotency_key=...)`.
+Путь относительно `/api/v1`; GET вызывается без body. `filters` в query — JSON-строка.
+Подборку можно дополнить через `cart_draft(..., draft=token)`; token берётся
+из query `draft` ранее полученной share_url. Серверные схемы:
+https://vesremont.com/openapi.json.
+
+Для личных данных передайте уже полученный REST OAuth token:
+`VesremontClient(token=token)`. OAuth-протокол и минимальные scopes описаны
+в https://vesremont.com/llms/api.md. Браузерный OAuth мастер есть в Node CLI;
+в Python SDK второй мастер не дублируется. Токен не пишется на диск, не входит в URL.
+
+Timeout по умолчанию 15 секунд (параметр `timeout`, до 60). TLS проверяется,
+redirects и автоматические повторы отсутствуют; API host фиксирован.
+Ответ ограничен 2 MiB, тело запроса — 64 KiB.
+`ApiError` содержит `status`, `code`, `request_id`, `retry_after`, без raw body.
+После неопределённого исхода записи сначала перечитайте состояние.
+Для submit нужны prepare, подтверждение покупателя на Vesremont и стабильный
+`idempotency_key`; SDK не обходит эти проверки и не создаёт фиктивных заказов.
+
+Используйте с внешнего ПК/хостинга. Это production API, sandbox не предоставляется.
+Наличие SDK не означает включение отключённых операций или завершение приёмки.

vesremont_api-0.2.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vesremont-api"
+version = "0.2.0"
+description = "Small standard-library client for the Vesremont public API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["vesremont", "api", "sdk", "oauth", "pkce"]
+classifiers = ["Programming Language :: Python :: 3", "Operating System :: OS Independent"]
+
+[project.urls]
+Documentation = "https://vesremont.com/for_ai/api_ai/"
+Homepage = "https://vesremont.com/developers/"
+Source = "https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python"
+Issues = "https://github.com/oooafganec-dev/vesremont-sdk/issues"
+
+[tool.setuptools]
+py-modules = ["vesremont_api"]

vesremont_api-0.2.0/setup.cfg

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

vesremont_api-0.2.0/vesremont_api.egg-info/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: vesremont-api
+Version: 0.2.0
+Summary: Small standard-library client for the Vesremont public API
+License-Expression: MIT
+Project-URL: Documentation, https://vesremont.com/for_ai/api_ai/
+Project-URL: Homepage, https://vesremont.com/developers/
+Project-URL: Source, https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python
+Project-URL: Issues, https://github.com/oooafganec-dev/vesremont-sdk/issues
+Keywords: vesremont,api,sdk,oauth,pkce
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Vesremont Python SDK 0.2.0
+
+Python 3.10+, только стандартная библиотека во время работы.
+MIT. Официальные исходники:
+https://github.com/oooafganec-dev/vesremont-sdk/tree/main/python.
+Команда установки опубликованного релиза из PyPI:
+
+```bash
+python -m pip install vesremont-api==0.2.0
+```
+
+Альтернатива — прямой wheel с сайта Vesremont:
+
+```bash
+python -m pip install https://vesremont.com/developers/downloads/vesremont_api-0.2.0-py3-none-any.whl
+```
+
+Готовый wheel не требует сборки. Также доступен исходный sdist
+`vesremont_api-0.2.0.tar.gz`; для его сборки нужен setuptools 77.0.3+.
+Runtime-зависимостей нет.
+
+```python
+from vesremont_api import VesremontClient, ApiError
+
+api = VesremontClient()
+products = api.search("труборез", page=1, per_page=10)
+product = api.product(375094)
+draft = api.cart_draft(375094, 1)
+# draft["share_url"] передаётся покупателю, не в публичные логи.
+```
+
+`status`, `search`, `product`, `cart`, `cart_draft` — короткие помощники.
+Остальные REST-операции: `request(method, '/path', query={}, body={}, idempotency_key=...)`.
+Путь относительно `/api/v1`; GET вызывается без body. `filters` в query — JSON-строка.
+Подборку можно дополнить через `cart_draft(..., draft=token)`; token берётся
+из query `draft` ранее полученной share_url. Серверные схемы:
+https://vesremont.com/openapi.json.
+
+Для личных данных передайте уже полученный REST OAuth token:
+`VesremontClient(token=token)`. OAuth-протокол и минимальные scopes описаны
+в https://vesremont.com/llms/api.md. Браузерный OAuth мастер есть в Node CLI;
+в Python SDK второй мастер не дублируется. Токен не пишется на диск, не входит в URL.
+
+Timeout по умолчанию 15 секунд (параметр `timeout`, до 60). TLS проверяется,
+redirects и автоматические повторы отсутствуют; API host фиксирован.
+Ответ ограничен 2 MiB, тело запроса — 64 KiB.
+`ApiError` содержит `status`, `code`, `request_id`, `retry_after`, без raw body.
+После неопределённого исхода записи сначала перечитайте состояние.
+Для submit нужны prepare, подтверждение покупателя на Vesremont и стабильный
+`idempotency_key`; SDK не обходит эти проверки и не создаёт фиктивных заказов.
+
+Используйте с внешнего ПК/хостинга. Это production API, sandbox не предоставляется.
+Наличие SDK не означает включение отключённых операций или завершение приёмки.

vesremont_api-0.2.0/vesremont_api.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+vesremont_api.py
+vesremont_api.egg-info/PKG-INFO
+vesremont_api.egg-info/SOURCES.txt
+vesremont_api.egg-info/dependency_links.txt
+vesremont_api.egg-info/top_level.txt

vesremont_api-0.2.0/vesremont_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

vesremont_api-0.2.0/vesremont_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+vesremont_api

vesremont_api-0.2.0/vesremont_api.py

@@ -0,0 +1,108 @@
+"""Vesremont REST client. Verified TLS, fixed origin, no redirects or retries."""
+import json
+import re
+import ssl
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import HTTPSHandler, HTTPRedirectHandler, Request, build_opener
+
+
+class ApiError(Exception):
+    def __init__(self, status, code, request_id=None, retry_after=None):
+        super().__init__(f"Vesremont: {code} (HTTP {status})")
+        self.status, self.code = status, code
+        self.request_id, self.retry_after = request_id, retry_after
+
+
+class _NoRedirect(HTTPRedirectHandler):
+    def redirect_request(self, req, fp, code, msg, headers, newurl):
+        return None
+
+
+def _safe(value):
+    return value if isinstance(value, str) and re.fullmatch(r"[A-Za-z0-9_.:-]{1,128}", value) else None
+
+
+def _id(value):
+    if type(value) is not int or not 1 <= value <= 2147483647:
+        raise ValueError("Positive product ID required")
+    return value
+
+
+class VesremontClient:
+    def __init__(self, token="", timeout=15):
+        if not isinstance(token, str) or (token and not re.fullmatch(r"[A-Za-z0-9_.~-]{1,8192}", token)):
+            raise ValueError("Invalid access token")
+        if type(timeout) not in (int, float) or not 0 < timeout <= 60:
+            raise ValueError("Timeout must be 0..60 seconds")
+        self._token, self._timeout = token, timeout
+        self._opener = build_opener(_NoRedirect(), HTTPSHandler(context=ssl.create_default_context()))
+
+    def request(self, method, path, *, query=None, body=None, idempotency_key=None):
+        if method not in ("GET", "POST", "PATCH", "DELETE") or not re.fullmatch(r"/[A-Za-z0-9_-]+(?:/[A-Za-z0-9_-]+)*/?", path):
+            raise ValueError("Invalid API method/path")
+        if body is not None and (method == "GET" or not isinstance(body, dict)):
+            raise ValueError("JSON object required; GET body is not supported")
+        if method == "POST" and path.rstrip("/") == "/orders/submit" and not idempotency_key:
+            raise ValueError("Idempotency-Key is required")
+        params = {}
+        for name, value in (query or {}).items():
+            if not re.fullmatch(r"[a-z_]{1,40}", name) or type(value) not in (str, int, float, bool):
+                raise ValueError("Query values must be scalar")
+            params[name] = str(value).lower() if type(value) is bool else str(value)
+        encoded = urlencode(params)
+        if len(encoded) > 8192:
+            raise ValueError("Query exceeds 8192 characters")
+        url = "https://vesremont.com/api/v1" + path + ("?" + encoded if encoded else "")
+        headers = {"Accept": "application/json", "User-Agent": "Vesremont-Python/0.2.0"}
+        if self._token:
+            headers["Authorization"] = "Bearer " + self._token
+        if idempotency_key is not None:
+            if not isinstance(idempotency_key, str) or not re.fullmatch(r"[A-Za-z0-9._:-]{16,128}", idempotency_key):
+                raise ValueError("Invalid idempotency key")
+            headers["Idempotency-Key"] = idempotency_key
+        payload = None if body is None else json.dumps(body, ensure_ascii=False, allow_nan=False).encode("utf-8")
+        if payload is not None:
+            if len(payload) > 65536:
+                raise ValueError("Request body exceeds 64 KiB")
+            headers["Content-Type"] = "application/json"
+        try:
+            try:
+                response = self._opener.open(Request(url, data=payload, headers=headers, method=method), timeout=self._timeout)
+            except HTTPError as error:
+                response = error
+            with response:
+                raw = response.read(2 * 1024 * 1024 + 1)
+                if len(raw) > 2 * 1024 * 1024:
+                    raise ApiError(response.code, "response_too_large")
+                try:
+                    data = json.loads(raw.decode("utf-8")) if raw else None
+                except (ValueError, UnicodeError):
+                    raise ApiError(response.code, "invalid_json") from None
+                if not 200 <= response.code < 300:
+                    problem = data if isinstance(data, dict) else {}
+                    raise ApiError(response.code, _safe(problem.get("code")) or "http_error",
+                                   _safe(problem.get("request_id")), _safe(response.headers.get("Retry-After")))
+                return data
+        except (URLError, OSError):
+            raise ApiError(0, "transport_error") from None
+
+    def status(self):
+        return self.request("GET", "/status")
+
+    def search(self, q, **query):
+        return self.request("GET", "/products", query={**query, "q": q})
+
+    def product(self, product_id):
+        return self.request("GET", f"/products/{_id(product_id)}")
+
+    def cart(self):
+        return self.request("GET", "/cart")
+
+    def cart_draft(self, product_id, quantity=1, draft=None):
+        if type(quantity) is not int or not 1 <= quantity <= 99:
+            raise ValueError("Quantity must be 1..99")
+        query = {"product_id": _id(product_id), "quantity": quantity}
+        if draft is not None:
+            query["draft"] = draft
+        return self.request("GET", "/cart-drafts/", query=query)