Metadata-Version: 2.4
Name: s-shot
Version: 0.1.0
Summary: Official Python SDK for the S-SHOT Templates API.
Project-URL: Homepage, https://www.s-shot.ru
Project-URL: Documentation, https://www.s-shot.ru/api-documentation/templates
Author: S-SHOT
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# S-SHOT Python SDK

Official Python SDK for the S-SHOT Templates API.

The package distribution is `s-shot` and the import namespace is `sshot`.

```python
from sshot import SShot

client = SShot(api_key="ws_your_api_key")
```

Public release and install documentation are gated by the OpenSpec rollout checks. Do not publish stable install instructions until the exact CI-built artifact passes production sandbox smoke and the production PyPI gate passes.

## Development checks

```bash
cd web-ui/libs/python-sdk
.venv/bin/python -m ruff check .
.venv/bin/python -m mypy src
.venv/bin/python -m pytest -q
.venv/bin/python -m build
.venv/bin/python -m twine check dist/*
```

## Local facade smoke

```bash
cd web-ui/libs/python-sdk
TEMPLATES_API_BASE_URL="http://localhost:3000/v1" \
S_SHOT_API_KEY="ws_..." \
TEMPLATES_API_TEMPLATE_ID="ozon-search-listings" \
TEMPLATES_API_TEMPLATE_PARAMETER_NAME="search_or_url" \
TEMPLATES_API_TEMPLATE_URL="https://www.ozon.ru/search/?text=coffee" \
TEMPLATES_API_EXPORT_PATH="/tmp/s-shot-smoke.csv" \
.venv/bin/python scripts/smoke_local_facade.py
```
