wildberries-cli 0.1.0__tar.gz

wildberries_cli-0.1.0/LICENSE

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

wildberries_cli-0.1.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.3
+Name: wildberries-cli
+Version: 0.1.0
+Summary: Wildberries seller platform CLI powered by wildberries-sdk
+Keywords: wildberries,cli,marketplace
+Author: OpenAI Codex
+License: MIT License
+         
+         Copyright (c) 2026
+         
+         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.
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomlkit>=0.13.0
+Requires-Dist: wildberries-sdk>=0.1.47
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/jzakirov/wildberries-cli
+Project-URL: Source, https://github.com/jzakirov/wildberries-cli
+Project-URL: Issues, https://github.com/jzakirov/wildberries-cli/issues
+Description-Content-Type: text/markdown
+
+# wildberries-cli
+
+Wildberries seller platform CLI built on top of [`wildberries-sdk`](https://github.com/eslazarev/wildberries-sdk).
+
+The executable name is `wb`.
+
+```bash
+wb general seller-info
+wb tariffs commission --locale en
+wb reports sales --date-from 2026-01-01T00:00:00+03:00
+wb communications feedbacks list --unanswered --take 100 --skip 0
+wb orders-fbs orders new --pretty
+wb raw methods reports
+```
+
+## Installation
+
+```bash
+pip install wildberries-cli
+```
+
+Or with uv:
+
+```bash
+uv tool install wildberries-cli
+```
+
+## Configuration
+
+Run the interactive setup wizard:
+
+```bash
+wb config init
+```
+
+Config is stored in `~/.config/wildberries-cli/config.toml`.
+
+Example:
+
+```toml
+[core]
+api_token = "your_wb_api_token"
+timeout_seconds = 30.0
+retries = 3
+
+[defaults]
+locale = "ru" # optional (ru|en|zh)
+```
+
+### Environment Variables
+
+| Environment variable | Config key |
+|---|---|
+| `WB_API_TOKEN` | `core.api_token` |
+| `WB_TIMEOUT` | `core.timeout_seconds` |
+| `WB_RETRIES` | `core.retries` |
+| `WB_LOCALE` | `defaults.locale` |
+
+CLI flags override both config and env values.
+
+## Command Overview
+
+### `config`
+
+```bash
+wb config init
+wb config show
+wb config show --reveal
+wb config set core.retries 5
+```
+
+### `general`
+
+```bash
+wb general ping
+wb general seller-info
+wb general users --limit 50 --offset 0
+wb general users --invited-only
+```
+
+### `tariffs`
+
+```bash
+wb tariffs commission [--locale ru|en|zh]
+wb tariffs box --date YYYY-MM-DD
+wb tariffs pallet --date YYYY-MM-DD
+wb tariffs return --date YYYY-MM-DD
+wb tariffs acceptance-coefficients [--warehouse-ids "1,2,3"]
+```
+
+### `reports`
+
+```bash
+wb reports orders   --date-from 2026-01-01T00:00:00+03:00 [--flag 0|1]
+wb reports sales    --date-from 2026-01-01T00:00:00+03:00 [--flag 0|1]
+wb reports stocks   --date-from 2026-01-01T00:00:00+03:00
+wb reports incomes  --date-from 2026-01-01T00:00:00+03:00
+```
+
+### `communications`
+
+```bash
+wb communications feedbacks list --unanswered --take 100 --skip 0
+wb communications feedbacks get <feedback-id>
+wb communications feedbacks answer <feedback-id> --text "Thanks for your feedback"
+wb communications feedbacks answer <feedback-id> --text -
+
+wb communications questions list --unanswered --take 100 --skip 0
+wb communications questions get <question-id>
+wb communications questions answer <question-id> --text "Yes, this fits..." [--state wbRu]
+```
+
+### `products`
+
+```bash
+wb products cards limits
+wb products cards list --body-file cards-query.json [--locale ru|en|zh]
+wb products objects list [--name socks] [--parent-id 123]
+wb products directories colors [--locale en]
+wb products tags list
+```
+
+`wb products cards list` expects the WB SDK request JSON for `content_v2_get_cards_list_post`.
+
+### `orders-fbs`
+
+```bash
+wb orders-fbs orders new
+wb orders-fbs orders list --limit 100 --next 0
+wb orders-fbs orders status --order 123 --order 456
+wb orders-fbs orders stickers --order 123 --type zplv --width 58 --height 40
+
+wb orders-fbs supplies list --limit 100 --next 0
+wb orders-fbs supplies create --name "Batch 2026-02-23"
+```
+
+### `raw` (direct SDK fallback)
+
+Use `raw` for any `wildberries-sdk` `DefaultApi` method that does not yet have a curated command.
+
+```bash
+wb raw modules
+wb raw methods reports
+wb raw signature reports api_v1_supplier_sales_get
+wb raw call general api_v1_seller_info_get
+wb raw call tariffs api_v1_tariffs_commission_get --arg locale=ru
+wb raw call reports api_v1_supplier_sales_get --arg-json date_from='"2026-01-01T00:00:00+03:00"'
+```
+
+Notes:
+- `--arg` passes values as strings.
+- `--arg-json` passes parsed JSON values (numbers, booleans, arrays, objects, quoted strings).
+- `--kwargs-json` accepts a full JSON object for method kwargs.
+
+## Output
+
+- Default output is JSON to stdout.
+- Errors are structured JSON to stderr.
+- `--pretty` renders Rich tables for selected list endpoints (and pretty JSON otherwise).
+
+Example error shape:
+
+```json
+{"error":{"type":"auth_error","message":"Authentication failed. Check WB_API_TOKEN.","status_code":401}}
+```
+
+## Publishing to PyPI
+
+This repository includes GitHub Actions trusted publishing (`.github/workflows/publish.yml`):
+
+- Push a tag like `v0.1.0`
+- Workflow runs `uv build`
+- Workflow runs `uv publish` with OIDC (PyPI trusted publisher)
+
+## Scope (v1)
+
+The curated command surface is intentionally narrow. Wildberries SDK exposes many modules and hundreds of methods, so `wb raw` is included to provide immediate access to the full SDK while curated commands are expanded over time.
+
+## License
+
+MIT (see `LICENSE`).

wildberries_cli-0.1.0/README.md

@@ -0,0 +1,181 @@
+# wildberries-cli
+
+Wildberries seller platform CLI built on top of [`wildberries-sdk`](https://github.com/eslazarev/wildberries-sdk).
+
+The executable name is `wb`.
+
+```bash
+wb general seller-info
+wb tariffs commission --locale en
+wb reports sales --date-from 2026-01-01T00:00:00+03:00
+wb communications feedbacks list --unanswered --take 100 --skip 0
+wb orders-fbs orders new --pretty
+wb raw methods reports
+```
+
+## Installation
+
+```bash
+pip install wildberries-cli
+```
+
+Or with uv:
+
+```bash
+uv tool install wildberries-cli
+```
+
+## Configuration
+
+Run the interactive setup wizard:
+
+```bash
+wb config init
+```
+
+Config is stored in `~/.config/wildberries-cli/config.toml`.
+
+Example:
+
+```toml
+[core]
+api_token = "your_wb_api_token"
+timeout_seconds = 30.0
+retries = 3
+
+[defaults]
+locale = "ru" # optional (ru|en|zh)
+```
+
+### Environment Variables
+
+| Environment variable | Config key |
+|---|---|
+| `WB_API_TOKEN` | `core.api_token` |
+| `WB_TIMEOUT` | `core.timeout_seconds` |
+| `WB_RETRIES` | `core.retries` |
+| `WB_LOCALE` | `defaults.locale` |
+
+CLI flags override both config and env values.
+
+## Command Overview
+
+### `config`
+
+```bash
+wb config init
+wb config show
+wb config show --reveal
+wb config set core.retries 5
+```
+
+### `general`
+
+```bash
+wb general ping
+wb general seller-info
+wb general users --limit 50 --offset 0
+wb general users --invited-only
+```
+
+### `tariffs`
+
+```bash
+wb tariffs commission [--locale ru|en|zh]
+wb tariffs box --date YYYY-MM-DD
+wb tariffs pallet --date YYYY-MM-DD
+wb tariffs return --date YYYY-MM-DD
+wb tariffs acceptance-coefficients [--warehouse-ids "1,2,3"]
+```
+
+### `reports`
+
+```bash
+wb reports orders   --date-from 2026-01-01T00:00:00+03:00 [--flag 0|1]
+wb reports sales    --date-from 2026-01-01T00:00:00+03:00 [--flag 0|1]
+wb reports stocks   --date-from 2026-01-01T00:00:00+03:00
+wb reports incomes  --date-from 2026-01-01T00:00:00+03:00
+```
+
+### `communications`
+
+```bash
+wb communications feedbacks list --unanswered --take 100 --skip 0
+wb communications feedbacks get <feedback-id>
+wb communications feedbacks answer <feedback-id> --text "Thanks for your feedback"
+wb communications feedbacks answer <feedback-id> --text -
+
+wb communications questions list --unanswered --take 100 --skip 0
+wb communications questions get <question-id>
+wb communications questions answer <question-id> --text "Yes, this fits..." [--state wbRu]
+```
+
+### `products`
+
+```bash
+wb products cards limits
+wb products cards list --body-file cards-query.json [--locale ru|en|zh]
+wb products objects list [--name socks] [--parent-id 123]
+wb products directories colors [--locale en]
+wb products tags list
+```
+
+`wb products cards list` expects the WB SDK request JSON for `content_v2_get_cards_list_post`.
+
+### `orders-fbs`
+
+```bash
+wb orders-fbs orders new
+wb orders-fbs orders list --limit 100 --next 0
+wb orders-fbs orders status --order 123 --order 456
+wb orders-fbs orders stickers --order 123 --type zplv --width 58 --height 40
+
+wb orders-fbs supplies list --limit 100 --next 0
+wb orders-fbs supplies create --name "Batch 2026-02-23"
+```
+
+### `raw` (direct SDK fallback)
+
+Use `raw` for any `wildberries-sdk` `DefaultApi` method that does not yet have a curated command.
+
+```bash
+wb raw modules
+wb raw methods reports
+wb raw signature reports api_v1_supplier_sales_get
+wb raw call general api_v1_seller_info_get
+wb raw call tariffs api_v1_tariffs_commission_get --arg locale=ru
+wb raw call reports api_v1_supplier_sales_get --arg-json date_from='"2026-01-01T00:00:00+03:00"'
+```
+
+Notes:
+- `--arg` passes values as strings.
+- `--arg-json` passes parsed JSON values (numbers, booleans, arrays, objects, quoted strings).
+- `--kwargs-json` accepts a full JSON object for method kwargs.
+
+## Output
+
+- Default output is JSON to stdout.
+- Errors are structured JSON to stderr.
+- `--pretty` renders Rich tables for selected list endpoints (and pretty JSON otherwise).
+
+Example error shape:
+
+```json
+{"error":{"type":"auth_error","message":"Authentication failed. Check WB_API_TOKEN.","status_code":401}}
+```
+
+## Publishing to PyPI
+
+This repository includes GitHub Actions trusted publishing (`.github/workflows/publish.yml`):
+
+- Push a tag like `v0.1.0`
+- Workflow runs `uv build`
+- Workflow runs `uv publish` with OIDC (PyPI trusted publisher)
+
+## Scope (v1)
+
+The curated command surface is intentionally narrow. Wildberries SDK exposes many modules and hundreds of methods, so `wb raw` is included to provide immediate access to the full SDK while curated commands are expanded over time.
+
+## License
+
+MIT (see `LICENSE`).

wildberries_cli-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["uv_build>=0.10.4,<0.11.0"]
+build-backend = "uv_build"
+
+[project]
+name = "wildberries-cli"
+version = "0.1.0"
+description = "Wildberries seller platform CLI powered by wildberries-sdk"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [{ name = "OpenAI Codex" }]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "tomlkit>=0.13.0",
+    "wildberries-sdk>=0.1.47",
+]
+keywords = ["wildberries", "cli", "marketplace"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/jzakirov/wildberries-cli"
+Source = "https://github.com/jzakirov/wildberries-cli"
+Issues = "https://github.com/jzakirov/wildberries-cli/issues"
+
+[project.scripts]
+wb = "wildberries_cli.main:app"
+
+[tool.uv.build-backend]
+module-name = "wildberries_cli"
+module-root = ""
+
+[dependency-groups]
+dev = ["ruff>=0.9.0"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

wildberries_cli-0.1.0/wildberries_cli/__init__.py

@@ -0,0 +1 @@
+"""wildberries-cli package."""

wildberries_cli-0.1.0/wildberries_cli/args.py

@@ -0,0 +1,65 @@
+"""CLI argument parsing helpers."""
+
+from __future__ import annotations
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Iterable
+
+from wildberries_cli.output import read_text_arg
+
+
+def load_json_input(body_json: str | None = None, body_file: str | None = None) -> Any:
+    """Load JSON from one source (`--body-json` or `--body-file`)."""
+    if body_json and body_file:
+        raise ValueError("Use only one of --body-json or --body-file")
+    if body_json is None and body_file is None:
+        raise ValueError("Body JSON is required")
+
+    if body_json is not None:
+        text = read_text_arg(body_json)
+    else:
+        if body_file == "-":
+            text = read_text_arg("-")
+        else:
+            text = Path(str(body_file)).read_text()
+
+    return json.loads(text)
+
+
+def parse_rfc3339ish(value: str) -> datetime:
+    """Parse an RFC3339-ish datetime/date string accepted by the SDK."""
+    text = value.strip()
+    if text.endswith("Z"):
+        text = text[:-1] + "+00:00"
+    try:
+        return datetime.fromisoformat(text)
+    except ValueError as exc:
+        raise ValueError(f"Invalid datetime '{value}'. Use ISO/RFC3339 (e.g. 2024-01-01 or 2024-01-01T12:00:00+03:00).") from exc
+
+
+def parse_kv_pairs(items: Iterable[str]) -> dict[str, str]:
+    out: dict[str, str] = {}
+    for item in items:
+        key, value = _split_kv(item)
+        out[key] = value
+    return out
+
+
+def parse_json_kv_pairs(items: Iterable[str]) -> dict[str, Any]:
+    out: dict[str, Any] = {}
+    for item in items:
+        key, value = _split_kv(item)
+        out[key] = json.loads(value)
+    return out
+
+
+def _split_kv(item: str) -> tuple[str, str]:
+    if "=" not in item:
+        raise ValueError(f"Expected KEY=VALUE, got '{item}'")
+    key, value = item.split("=", 1)
+    key = key.strip()
+    if not key:
+        raise ValueError(f"Expected KEY=VALUE, got '{item}'")
+    return key, value

wildberries_cli-0.1.0/wildberries_cli/client.py

@@ -0,0 +1,159 @@
+"""Dynamic Wildberries SDK client factory and API invocation helpers."""
+
+from __future__ import annotations
+
+import importlib
+import inspect
+import pkgutil
+import time
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any
+
+import typer
+import wildberries_sdk
+
+from wildberries_cli.output import print_error
+
+if TYPE_CHECKING:
+    from wildberries_cli.config import Config
+
+
+@dataclass
+class ModuleClient:
+    module_name: str
+    sdk_module: Any
+    api: Any
+
+
+def list_sdk_modules() -> list[str]:
+    return sorted(m.name for m in pkgutil.iter_modules(wildberries_sdk.__path__))
+
+
+def list_methods(module_name: str) -> list[str]:
+    cls = _get_default_api_class(normalize_module_name(module_name))
+    methods = []
+    for name, fn in inspect.getmembers(cls, inspect.isfunction):
+        if name.startswith("_"):
+            continue
+        methods.append(name)
+    return sorted(methods)
+
+
+def method_signature(module_name: str, method_name: str) -> str:
+    cls = _get_default_api_class(normalize_module_name(module_name))
+    fn = getattr(cls, method_name, None)
+    if fn is None or not callable(fn):
+        raise AttributeError(f"Method '{method_name}' not found in module '{module_name}'")
+    return f"{method_name}{inspect.signature(fn)}"
+
+
+def get_module_client(module_name: str, cfg: "Config", *, require_token: bool = True) -> ModuleClient:
+    module_name = normalize_module_name(module_name)
+    if require_token:
+        _require_token(cfg)
+
+    sdk_module = importlib.import_module(f"wildberries_sdk.{module_name}")
+    Configuration = getattr(sdk_module, "Configuration")
+    ApiClient = getattr(sdk_module, "ApiClient")
+    DefaultApi = getattr(sdk_module, "DefaultApi")
+
+    conf_kwargs: dict[str, Any] = {}
+    if cfg.api_token:
+        conf_kwargs["api_key"] = {"HeaderApiKey": cfg.api_token}
+    if cfg.retries:
+        conf_kwargs["retries"] = cfg.retries
+    conf = Configuration(**conf_kwargs)
+    api_client = ApiClient(conf)
+    api = DefaultApi(api_client)
+    return ModuleClient(module_name=module_name, sdk_module=sdk_module, api=api)
+
+
+def call_api(
+    module_name: str,
+    method_name: str,
+    cfg: "Config",
+    *,
+    require_token: bool = True,
+    **kwargs: Any,
+) -> Any:
+    client = get_module_client(module_name, cfg, require_token=require_token)
+    fn = getattr(client.api, method_name, None)
+    if fn is None or not callable(fn):
+        print_error("validation_error", f"Unknown method '{method_name}' for module '{client.module_name}'")
+        raise typer.Exit(1)
+    return call_with_retry(fn, cfg, **kwargs)
+
+
+def call_with_retry(fn: Any, cfg: "Config", **kwargs: Any) -> Any:
+    sig = inspect.signature(fn)
+    if "_request_timeout" in sig.parameters and "_request_timeout" not in kwargs:
+        kwargs["_request_timeout"] = cfg.timeout_seconds
+
+    max_attempts = max(1, int(cfg.retries))
+    for attempt in range(max_attempts):
+        try:
+            return fn(**kwargs)
+        except Exception as exc:
+            status = getattr(exc, "status", None)
+            if status in {429, 500, 502, 503, 504} and attempt < max_attempts - 1:
+                delay = _retry_after_seconds(exc) or min(2 ** attempt, 10)
+                time.sleep(delay)
+                continue
+            _handle_exception(exc)
+            raise typer.Exit(1)
+
+    raise typer.Exit(1)
+
+
+def normalize_module_name(value: str) -> str:
+    return value.replace("-", "_").strip()
+
+
+def _require_token(cfg: "Config") -> None:
+    if not cfg.api_token:
+        print_error(
+            "auth_error",
+            "No WB API token configured. Set WB_API_TOKEN, use --api-token, or run `wb config init`.",
+        )
+        raise typer.Exit(1)
+
+
+def _get_default_api_class(module_name: str) -> Any:
+    sdk_module = importlib.import_module(f"wildberries_sdk.{module_name}")
+    return getattr(sdk_module, "DefaultApi")
+
+
+def _retry_after_seconds(exc: Exception) -> int | None:
+    headers = getattr(exc, "headers", None)
+    if not headers:
+        return None
+    try:
+        value = headers.get("Retry-After")  # type: ignore[union-attr]
+        if value is None:
+            return None
+        return max(1, int(value))
+    except Exception:
+        return None
+
+
+def _handle_exception(exc: Exception) -> None:
+    status = getattr(exc, "status", None)
+    message = str(exc)
+    detail = getattr(exc, "body", None)
+
+    if status == 401:
+        print_error("auth_error", "Authentication failed. Check WB_API_TOKEN.", status_code=status, detail=detail)
+        return
+    if status == 403:
+        print_error("forbidden", "Permission denied or token lacks required scope.", status_code=status, detail=detail)
+        return
+    if status == 404:
+        print_error("not_found", "Resource not found.", status_code=status, detail=detail)
+        return
+    if status == 429:
+        print_error("rate_limit", "Rate limit exceeded.", status_code=status, detail=detail)
+        return
+    if status is not None:
+        print_error("api_error", message, status_code=status, detail=detail)
+        return
+    print_error("cli_error", message)

wildberries_cli-0.1.0/wildberries_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""wb command modules."""