Metadata-Version: 2.1
Name: gameflip-api
Version: 1.0.1
Summary: Uma API wrapper em Python para utilização com a plataforma Gameflip.
Author-email: Gustavo Pedroso Bernardes <gpedrosobernardes@gmail.com>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: validators
Requires-Dist: pydantic
Requires-Dist: pyotp
Requires-Dist: requests

# Gameflip API

Uma **API wrapper em Python** para utilização com a plataforma Gameflip.
Facilita a integração via script, para automatizar operações, consultar dados e interagir com a Gameflip de forma programática.

## 🧰 Funcionalidades

* Conexão autenticada com a Gameflip via chave e segredo (`API_KEY`, `API_SECRET`)
* Métodos para executar operações comuns (por exemplo: listagem de produtos, criação de ofertas, consulta de histórico)
* Interface simples em Python para agilizar automações
* Código open-source, fácil de estender para necessidades específicas

## 🚀 Começando

### Pré-requisitos

* Python (versão compatível — idealmente 3.8+)
* Conta na Gameflip e acesso à API (chave + segredo)
* Variáveis de ambiente configuradas:

  ```bash
  export GFAPI_KEY=<sua_chave_aqui>
  export GFAPI_SECRET=<seu_segredo_aqui>
  ```

  (No Windows: `set GFAPI_KEY=<…>`, `set GFAPI_SECRET=<…>`)

### Instalação

```bash
pip install gameflip-api
```

### Uso básico

Exemplo no arquivo `example.py` (ajuste conforme a sua necessidade):

```python
import os
from pprint import pprint
from dotenv import load_dotenv
from gameflip_api.api import GameflipAPI

load_dotenv()

print("Listing results:")

listing_response = GameflipAPI.listing_search(digital=True, limit=1)
pprint(listing_response.json())

gameflip_api = GameflipAPI(os.getenv('GFAPI_KEY'), os.getenv('GFAPI_SECRET'))

print("My profile info:")

pprint(gameflip_api.profile().json())
```

## 📦 Estrutura do Projeto

* `src/gameflip_api/` — código-fonte da biblioteca
* `example.py` — script de demonstração de uso
* `test.py` — arquivo para testes rápidos
* `requirements.txt` — dependências do Python

## 🤝 Contato

Se tiver dúvidas, sugestões ou quiser colaborar:

* Crie uma *issue* no próprio repositório
* Envie um pull request com descrições claras das alterações
