Metadata-Version: 2.4
Name: shelfshift
Version: 1.0.2
Summary: Developer toolkit for ecommerce catalog translation across URL/CSV sources and platform CSV targets.
License-Expression: MIT
Keywords: ecommerce,csv,catalog,shopify,woocommerce
Classifier: Development Status :: 5 - Production/Stable
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: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-dotenv<2.0.0,>=1.1.0
Requires-Dist: python-slugify<9.0.0,>=8.0.0
Requires-Dist: requests<3.0.0,>=2.32.0
Dynamic: license-file

# Shelfshift

Shelfshift is a Python toolkit for translating ecommerce catalogs across platforms.
It detects/imports product data from URL or CSV inputs, normalizes into a canonical model, and exports platform-specific CSV files.

## Installation

```bash
pip install shelfshift
```

Or with `uv`:

```bash
uv add shelfshift
uv sync
```

Quick smoke test:

```bash
python -c "import shelfshift; print(shelfshift.__version__)"
shelfshift --help
```

## Quick Start (CLI)

```bash
shelfshift convert ./source.csv --to shopify --out ./shopify.csv --report ./convert_report.json
```

Detect input kind/platform:

```bash
shelfshift detect ./source.csv
shelfshift detect "https://example.myshopify.com/products/demo-item"
```

## Quick Start (Library)

```python
from shelfshift import convert_csv

csv_bytes, report = convert_csv("./source.csv", target="shopify")
with open("./shopify.csv", "wb") as f:
    f.write(csv_bytes)
```

## Support

- Python: `>=3.10`
- URL detection: `shopify`, `woocommerce`, `squarespace`, `amazon`, `aliexpress`
- URL import: `shopify`, `woocommerce`, `squarespace`
- CSV import/export: `shopify`, `bigcommerce`, `wix`, `squarespace`, `woocommerce`

## Documentation

- Start here: [Guides Index](https://github.com/walkidni/shelfshift/blob/main/guides/INDEX.md)
- Library guides: [Library Index](https://github.com/walkidni/shelfshift/blob/main/guides/library/INDEX.md)
- CLI guides: [CLI Index](https://github.com/walkidni/shelfshift/blob/main/guides/cli/INDEX.md)

## Development Note

For repeated local CLI work, activate `.venv` and run commands directly:

```bash
source .venv/bin/activate
shelfshift --help
```

## License

MIT. See `LICENSE`.
