Metadata-Version: 2.4
Name: siigo_connector
Version: 0.2.2
Summary: Python client for the Siigo API
Project-URL: Homepage, https://github.com/arendondiosa/siigo-connector-py
Project-URL: Repository, https://github.com/arendondiosa/siigo-connector-py
Author-email: "Alejandro E. Rendon" <arendondiosa@gmail.com>
License: MIT
Requires-Python: >=3.9
Requires-Dist: httpx<0.29.0,>=0.28.1
Requires-Dist: pydantic[email]<3.0.0,>=2.11.7
Requires-Dist: tenacity>=9.1.2
Description-Content-Type: text/markdown

# siigo_connector — Python client for the Siigo API

> [!WARNING]
> **Status:** Under development (alpha). Breaking changes may occur.

A small, typed client for [Siigo](https://api.siigo.com). It handles auth (JWT with `username` + `access_key` + `Partner-Id`), retries, and pagination so you can call Python methods instead of crafting HTTP requests.

> Requires Python 3.9+

## Install

Create and activate a virtual environment and then install FastAPI:

```bash
pip install siigo-connector
```

## Usage

Create the Client instance

```python
from src.siigo_connector import client as siigo

c = siigo.Client(
    username="siigoapi@pruebas.com",
    access_key="<access_token>",
    partner_id="myapp",  # short, no spaces
)
```

### Customers

```python
for cust in c.customers.list(created_start="2024-08-30"):
    print(cust)
```

Close the connection after at the end

```python
c.close()
```
