Metadata-Version: 2.4
Name: recraft-sdk
Version: 0.1.0
Summary: Python SDK wrapping the Recraft image generation API
License: MIT
Requires-Python: >=3.12
Requires-Dist: requests>=2.31
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff==0.15.2; extra == 'dev'
Description-Content-Type: text/markdown

# recraft-sdk

Pytest SDK proving the Recraft API. Validates endpoints against `openapi.json` with integration tests hitting the live API.

## Tech Context

- **Language**: Python 3.12+
- **Tests**: pytest
- **API Spec**: `openapi.json` (OpenAPI 3.0.3, sourced from Recraft Swagger UI)
- **Credentials**: `~/secrets/recraft/credentials.env`

## Project Structure

```
recraft-sdk/
  openapi.json       # Recraft external API spec (27 endpoints, 69 schemas)
  tests/             # pytest integration tests
  src/recraft_sdk/   # Thin client wrapping Recraft REST API
```

## Key Endpoints

| Endpoint | Purpose |
|----------|---------|
| `POST /v1/images/generations/vector` | Generate SVG from prompt |
| `POST /v1/images/generations/raster` | Generate PNG from prompt |
| `POST /v1/images/vectorize` | Raster to vector conversion |
| `POST /v1/images/clarityUpscale` | Upscale image |
| `POST /v1/images/removeBackground` | Remove background |
