python-wb 0.1.0__tar.gz

python_wb-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Browser Use Inc.
+
+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.

python_wb-0.1.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: python-wb
+Version: 0.1.0
+Summary: Библиотека для работы с API Wildberries на Python.
+Author-email: MistakeTZ <mistaketz@gmail.com>
+Project-URL: Homepage, https://github.com/mistaketz/pywb
+Project-URL: Bug Tracker, https://github.com/mistaketz/pywb/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.13.5
+Requires-Dist: build>=1.4.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: setuptools>=82.0.1
+Dynamic: license-file
+
+## pywb
+
+Asynchronous Python client for working with the Wildberries Seller API.
+
+The library provides:
+
+- async HTTP client based on `aiohttp`
+- typed request/response models via `pydantic`
+- centralized API error mapping to Python exceptions
+- support for multiple Wildberries API domains
+
+## Features
+
+- Easy entry point through `WBClient`
+- Domain routing (`common`, `content`, `statistics`, etc.)
+- Built-in methods:
+  - ping (`client.ping()`)
+  - content ping (`client.ping_content()`)
+  - statistics orders report (`client.get_orders(...)`)
+  - etc.
+- Generic low-level method execution:
+  - `await client(SomeWBMethod(...))`
+- Context manager support:
+  - `async with WBClient(...) as client:`
+
+## Requirements
+
+- Python 3.12+
+
+## Installation
+
+Using `uv`:
+
+```bash
+uv add python-wb
+```
+
+With `pip`:
+
+```bash
+pip install python-wb
+```
+
+## Quick Start
+
+```python
+import asyncio
+from pywb import WBClient
+
+
+async def main() -> None:
+    token = "YOUR_WB_API_TOKEN"
+
+    async with WBClient(token) as client:
+        result = await client.ping()
+        print(result.ts, result.status)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Usage
+
+### 1) Health check
+
+```python
+result = await client.ping()
+print(result.status)
+```
+
+### 2) Content API health check
+
+```python
+result = await client.ping_content()
+print(result.status)
+```
+
+### 3) Get orders from Statistics API
+
+```python
+from datetime import datetime
+
+orders = await client.get_orders(
+    date_from=datetime(2026, 1, 1, 0, 0, 0),
+    flag=0,
+)
+
+if orders:
+    print(orders[0].srid, orders[0].brand)
+```
+
+`date_from` accepts either:
+
+- ISO 8601 string (example: `"2022-03-04T18:08:31"`)
+- `datetime` object
+
+## Low-Level Method Call
+
+You can call method objects directly through the client:
+
+```python
+from pywb.methods import Ping
+
+response = await client(Ping())
+```
+
+This is useful when adding new method classes while keeping one transport layer.
+
+## Error Handling
+
+HTTP errors are mapped to dedicated exceptions:
+
+- `BadRequestError` (400)
+- `UnauthorizedError` (401)
+- `PaymentRequiredError` (402)
+- `AccessDeniedError` (403)
+- `NotFoundError` (404)
+- `ConflictError` (409)
+- `PayloadTooLargeError` (413)
+- `UnprocessableEntityError` (422)
+- `TooManyRequestsError` (429)
+- `InternalServerError` (5xx)
+
+Base type: `WBApiError`
+
+Example:
+
+```python
+from pywb.exceptions import BadRequestError
+
+try:
+    await client.get_orders(date_from="2022-03-04T18:08:31")
+except BadRequestError as e:
+    print(e)
+    print(e.payload)
+```
+
+Network/transport failures in the `aiohttp` session are raised as `WBNetworkError`.
+
+## Sandbox and Domains
+
+The client supports domain-based URL routing through `WBDomain` and `WB_ROUTER`.
+
+To enable sandbox mode (only where available for a domain):
+
+```python
+client = WBClient(token="YOUR_TOKEN", is_sandbox=True)
+```
+
+If sandbox is unavailable for a domain, a `ValueError` is raised by the session router.
+
+## Development
+
+Run the example script:
+
+```bash
+python examples/ping.py
+```
+
+## Notes
+
+- Keep your API token secret and do not commit it to git.
+- Respect Wildberries API rate limits for each endpoint.
+- For the statistics orders endpoint, use pagination strategy based on the last record timestamp when handling large datasets.

python_wb-0.1.0/README.md

@@ -0,0 +1,165 @@
+## pywb
+
+Asynchronous Python client for working with the Wildberries Seller API.
+
+The library provides:
+
+- async HTTP client based on `aiohttp`
+- typed request/response models via `pydantic`
+- centralized API error mapping to Python exceptions
+- support for multiple Wildberries API domains
+
+## Features
+
+- Easy entry point through `WBClient`
+- Domain routing (`common`, `content`, `statistics`, etc.)
+- Built-in methods:
+  - ping (`client.ping()`)
+  - content ping (`client.ping_content()`)
+  - statistics orders report (`client.get_orders(...)`)
+  - etc.
+- Generic low-level method execution:
+  - `await client(SomeWBMethod(...))`
+- Context manager support:
+  - `async with WBClient(...) as client:`
+
+## Requirements
+
+- Python 3.12+
+
+## Installation
+
+Using `uv`:
+
+```bash
+uv add python-wb
+```
+
+With `pip`:
+
+```bash
+pip install python-wb
+```
+
+## Quick Start
+
+```python
+import asyncio
+from pywb import WBClient
+
+
+async def main() -> None:
+    token = "YOUR_WB_API_TOKEN"
+
+    async with WBClient(token) as client:
+        result = await client.ping()
+        print(result.ts, result.status)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Usage
+
+### 1) Health check
+
+```python
+result = await client.ping()
+print(result.status)
+```
+
+### 2) Content API health check
+
+```python
+result = await client.ping_content()
+print(result.status)
+```
+
+### 3) Get orders from Statistics API
+
+```python
+from datetime import datetime
+
+orders = await client.get_orders(
+    date_from=datetime(2026, 1, 1, 0, 0, 0),
+    flag=0,
+)
+
+if orders:
+    print(orders[0].srid, orders[0].brand)
+```
+
+`date_from` accepts either:
+
+- ISO 8601 string (example: `"2022-03-04T18:08:31"`)
+- `datetime` object
+
+## Low-Level Method Call
+
+You can call method objects directly through the client:
+
+```python
+from pywb.methods import Ping
+
+response = await client(Ping())
+```
+
+This is useful when adding new method classes while keeping one transport layer.
+
+## Error Handling
+
+HTTP errors are mapped to dedicated exceptions:
+
+- `BadRequestError` (400)
+- `UnauthorizedError` (401)
+- `PaymentRequiredError` (402)
+- `AccessDeniedError` (403)
+- `NotFoundError` (404)
+- `ConflictError` (409)
+- `PayloadTooLargeError` (413)
+- `UnprocessableEntityError` (422)
+- `TooManyRequestsError` (429)
+- `InternalServerError` (5xx)
+
+Base type: `WBApiError`
+
+Example:
+
+```python
+from pywb.exceptions import BadRequestError
+
+try:
+    await client.get_orders(date_from="2022-03-04T18:08:31")
+except BadRequestError as e:
+    print(e)
+    print(e.payload)
+```
+
+Network/transport failures in the `aiohttp` session are raised as `WBNetworkError`.
+
+## Sandbox and Domains
+
+The client supports domain-based URL routing through `WBDomain` and `WB_ROUTER`.
+
+To enable sandbox mode (only where available for a domain):
+
+```python
+client = WBClient(token="YOUR_TOKEN", is_sandbox=True)
+```
+
+If sandbox is unavailable for a domain, a `ValueError` is raised by the session router.
+
+## Development
+
+Run the example script:
+
+```bash
+python examples/ping.py
+```
+
+## Notes
+
+- Keep your API token secret and do not commit it to git.
+- Respect Wildberries API rate limits for each endpoint.
+- For the statistics orders endpoint, use pagination strategy based on the last record timestamp when handling large datasets.

python_wb-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-wb"
+version = "0.1.0"
+authors = [
+  { name="MistakeTZ", email="mistaketz@gmail.com" },
+]
+description = "Библиотека для работы с API Wildberries на Python."
+readme = "README.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "aiohttp>=3.13.5",
+    "build>=1.4.2",
+    "httpx>=0.28.1",
+    "pydantic>=2.12.5",
+    "setuptools>=82.0.1",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/mistaketz/pywb"
+"Bug Tracker" = "https://github.com/mistaketz/pywb/issues"

python_wb-0.1.0/setup.cfg

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

python_wb-0.1.0/src/python_wb.egg-info/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: python-wb
+Version: 0.1.0
+Summary: Библиотека для работы с API Wildberries на Python.
+Author-email: MistakeTZ <mistaketz@gmail.com>
+Project-URL: Homepage, https://github.com/mistaketz/pywb
+Project-URL: Bug Tracker, https://github.com/mistaketz/pywb/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.13.5
+Requires-Dist: build>=1.4.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: setuptools>=82.0.1
+Dynamic: license-file
+
+## pywb
+
+Asynchronous Python client for working with the Wildberries Seller API.
+
+The library provides:
+
+- async HTTP client based on `aiohttp`
+- typed request/response models via `pydantic`
+- centralized API error mapping to Python exceptions
+- support for multiple Wildberries API domains
+
+## Features
+
+- Easy entry point through `WBClient`
+- Domain routing (`common`, `content`, `statistics`, etc.)
+- Built-in methods:
+  - ping (`client.ping()`)
+  - content ping (`client.ping_content()`)
+  - statistics orders report (`client.get_orders(...)`)
+  - etc.
+- Generic low-level method execution:
+  - `await client(SomeWBMethod(...))`
+- Context manager support:
+  - `async with WBClient(...) as client:`
+
+## Requirements
+
+- Python 3.12+
+
+## Installation
+
+Using `uv`:
+
+```bash
+uv add python-wb
+```
+
+With `pip`:
+
+```bash
+pip install python-wb
+```
+
+## Quick Start
+
+```python
+import asyncio
+from pywb import WBClient
+
+
+async def main() -> None:
+    token = "YOUR_WB_API_TOKEN"
+
+    async with WBClient(token) as client:
+        result = await client.ping()
+        print(result.ts, result.status)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Usage
+
+### 1) Health check
+
+```python
+result = await client.ping()
+print(result.status)
+```
+
+### 2) Content API health check
+
+```python
+result = await client.ping_content()
+print(result.status)
+```
+
+### 3) Get orders from Statistics API
+
+```python
+from datetime import datetime
+
+orders = await client.get_orders(
+    date_from=datetime(2026, 1, 1, 0, 0, 0),
+    flag=0,
+)
+
+if orders:
+    print(orders[0].srid, orders[0].brand)
+```
+
+`date_from` accepts either:
+
+- ISO 8601 string (example: `"2022-03-04T18:08:31"`)
+- `datetime` object
+
+## Low-Level Method Call
+
+You can call method objects directly through the client:
+
+```python
+from pywb.methods import Ping
+
+response = await client(Ping())
+```
+
+This is useful when adding new method classes while keeping one transport layer.
+
+## Error Handling
+
+HTTP errors are mapped to dedicated exceptions:
+
+- `BadRequestError` (400)
+- `UnauthorizedError` (401)
+- `PaymentRequiredError` (402)
+- `AccessDeniedError` (403)
+- `NotFoundError` (404)
+- `ConflictError` (409)
+- `PayloadTooLargeError` (413)
+- `UnprocessableEntityError` (422)
+- `TooManyRequestsError` (429)
+- `InternalServerError` (5xx)
+
+Base type: `WBApiError`
+
+Example:
+
+```python
+from pywb.exceptions import BadRequestError
+
+try:
+    await client.get_orders(date_from="2022-03-04T18:08:31")
+except BadRequestError as e:
+    print(e)
+    print(e.payload)
+```
+
+Network/transport failures in the `aiohttp` session are raised as `WBNetworkError`.
+
+## Sandbox and Domains
+
+The client supports domain-based URL routing through `WBDomain` and `WB_ROUTER`.
+
+To enable sandbox mode (only where available for a domain):
+
+```python
+client = WBClient(token="YOUR_TOKEN", is_sandbox=True)
+```
+
+If sandbox is unavailable for a domain, a `ValueError` is raised by the session router.
+
+## Development
+
+Run the example script:
+
+```bash
+python examples/ping.py
+```
+
+## Notes
+
+- Keep your API token secret and do not commit it to git.
+- Respect Wildberries API rate limits for each endpoint.
+- For the statistics orders endpoint, use pagination strategy based on the last record timestamp when handling large datasets.

python_wb-0.1.0/src/python_wb.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+pyproject.toml
+src/test.py
+src/python_wb.egg-info/PKG-INFO
+src/python_wb.egg-info/SOURCES.txt
+src/python_wb.egg-info/dependency_links.txt
+src/python_wb.egg-info/requires.txt
+src/python_wb.egg-info/top_level.txt
+src/pywb/__init__.py
+src/pywb/__meta__.py
+src/pywb/exceptions.py
+src/pywb/client/__init__.py
+src/pywb/client/wb_client.py
+src/pywb/client/session/__init__.py
+src/pywb/client/session/aiohttp.py
+src/pywb/client/session/base.py
+src/pywb/enums/__init__.py
+src/pywb/enums/urls.py
+src/pywb/methods/__init__.py
+src/pywb/methods/base.py
+src/pywb/methods/ping.py
+src/pywb/methods/statistics.py
+src/pywb/methods/update_product_card.py
+src/pywb/types/__init__.py
+src/pywb/types/order.py
+src/pywb/types/ping_response.py
+src/pywb/utils/errors.py

python_wb-0.1.0/src/python_wb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

python_wb-0.1.0/src/python_wb.egg-info/requires.txt

@@ -0,0 +1,5 @@
+aiohttp>=3.13.5
+build>=1.4.2
+httpx>=0.28.1
+pydantic>=2.12.5
+setuptools>=82.0.1

python_wb-0.1.0/src/python_wb.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+pywb
+test

python_wb-0.1.0/src/pywb/__init__.py

@@ -0,0 +1,12 @@
+from . import enums, methods, types
+from .__meta__ import __version__
+from .client.wb_client import WBClient
+
+
+__all__ = (
+    "WBClient",
+    "enums",
+    "methods",
+    "types",
+    "__version__",
+)

python_wb-0.1.0/src/pywb/__meta__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"