Metadata-Version: 2.4
Name: altis-fipe
Version: 0.1.0
Summary: Cliente oficial da Altis FIPE API — consulte a Tabela FIPE (carros, motos, caminhões) com uma chave de API.
Project-URL: Homepage, https://fipe.altis.online/docs
Project-URL: Repository, https://github.com/altis/altisfipeapi
Author: Altis
License: Proprietary
Keywords: altis,api,brasil,carros,fipe,tabela-fipe,veiculos
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == 'dev'
Requires-Dist: respx>=0.20; extra == 'dev'
Description-Content-Type: text/markdown

# altis-fipe

Cliente oficial **Python** da [Altis FIPE API](https://fipe.altis.online). Consulte a Tabela FIPE (carros, motos e caminhões).

## Instalação

```bash
pip install altis-fipe
```

## Pegue sua chave (grátis)

1. Crie a conta em **https://fipe.altis.online/cadastro** — você ganha **1.000 créditos de cortesia**.
2. Copie a chave `fpk_live_...`.
3. Exporte:

```bash
export ALTIS_FIPE_KEY="fpk_live_xxxxxxxxxxxx"
```

## Uso

```python
import os
from altis_fipe import AltisFipe

fipe = AltisFipe(api_key=os.environ["ALTIS_FIPE_KEY"])

brands = fipe.cars.brands()                       # 0 créditos
models = fipe.cars.models(56)
years = fipe.cars.years(56, 9984)
quote = fipe.cars.quote(brand_id=56, model_id=9984, year_id="2025-6")

print(quote["model"], quote["price"], quote["referenceMonth"])
```

Como context manager (fecha a conexão automaticamente):

```python
with AltisFipe(api_key=os.environ["ALTIS_FIPE_KEY"]) as fipe:
    print(fipe.motorcycles.brands())
```

## Tratamento de erros

```python
from altis_fipe import AltisFipe, AltisFipeError

try:
    fipe.cars.quote(brand_id=56, model_id=9984, year_id="2025-6")
except AltisFipeError as err:
    if err.is_out_of_credits:
        print("Sem créditos.")
    elif err.is_rate_limited:
        print("Rate limit.")
    elif err.is_auth_error:
        print("Chave inválida.")
    else:
        print(err.code, err.message, err.details)
```

## Combustível (`year_id`)

`year_id` segue o padrão `YYYY-F`: `1`=Gasolina, `2`=Álcool, `3`=Diesel, `4`=Flex, `5`=Elétrico, `6`=Híbrido.

## Licença

Proprietária — Altis 2026.
