Metadata-Version: 2.4
Name: pokegamblers
Version: 0.1.0
Summary: Cross-platform Python API accessor library
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# pokegamblers

## Quickstart

```
pip install pokegamblers
```

```python
import pokegamblers as pg

pc = pg.Accessor("https://example.com", "Bearer YOUR_TOKEN")
results = pc.search("eevee")
```

## Setup

**uv**

```
git clone <repo-url>
cd pokegamblers
uv sync
```

**pip**

```
pip install .
```

### Constructor

```python
pc = pg.Accessor(
    "https://example.com",
    "Bearer YOUR_TOKEN",
    min_interval=0.5,
    max_retries=3,
    timeout=20.0,
)
```

## API Reference

### search

```python
pc.search("prismatic")
pc.search("prismatic", cursor="abc123")
pc.search("prismatic", category="pokemon-cards")
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `query` | `str` | required | Search query |
| `cursor` | `str \| None` | `None` | Pagination cursor |
| `**filters` | `Any` | | Additional query parameters |

### item

```python
pc.item("8244610")
pc.item("8244610", all_sales=False)
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `item_id` | `str` | required | Item ID |
| `all_sales` | `bool` | `True` | Include full sales history across conditions, be careful |