Metadata-Version: 2.4
Name: luxorasap
Version: 0.2.6
Summary: Toolbox da Luxor para ingestão, análise e automação de dados financeiros.
Author-email: Luxor Group <backoffice@luxor.com.br>
License: Proprietary – All rights reserved
Project-URL: Homepage, https://github.com/luxorinvestimentos/luxor-asap
Project-URL: Documentation, https://luxorinvestimentos.github.io/luxorasap-docs/
Classifier: Programming Language :: Python :: 3
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.2
Requires-Dist: numpy>=1.25
Requires-Dist: loguru>=0.7
Requires-Dist: python-dotenv>=1.0
Requires-Dist: azure-storage-blob>=12.19
Requires-Dist: pyarrow>=15.0
Requires-Dist: requests>=2.32
Requires-Dist: pydantic>=2.7
Requires-Dist: scipy>=1.13
Requires-Dist: openpyxl
Provides-Extra: storage
Requires-Dist: azure-storage-blob>=12.19; extra == "storage"
Requires-Dist: pyarrow>=15.0; extra == "storage"
Provides-Extra: dataframe
Requires-Dist: pandas>=2.2; extra == "dataframe"
Provides-Extra: datareader
Requires-Dist: luxorasap[dataframe,storage]; extra == "datareader"
Requires-Dist: numpy>=1.25; extra == "datareader"
Requires-Dist: scipy>=1.13; extra == "datareader"
Provides-Extra: ingest
Requires-Dist: luxorasap[dataframe,storage]; extra == "ingest"
Requires-Dist: pandas>=2.2; extra == "ingest"
Provides-Extra: btgapi
Requires-Dist: requests>=2.32; extra == "btgapi"
Requires-Dist: pydantic>=2.7; extra == "btgapi"
Provides-Extra: dev
Requires-Dist: pytest>=8.2; extra == "dev"
Requires-Dist: requests-mock>=1.11; extra == "dev"
Requires-Dist: black>=24.4.0; extra == "dev"
Requires-Dist: isort>=5.13; extra == "dev"
Requires-Dist: bumpver>=2024.3; extra == "dev"
Requires-Dist: pre-commit>=3.7; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"

# 🧠 LuxorASAP

**Luxor Automatic System for Assets and Portfolios** é o toolbox oficial da Luxor para automação de pipelines de dados, integração com APIs financeiras e gerenciamento eficiente de dados patrimoniais no Azure.

Projetado para ser rápido, reutilizável e seguro, este pacote unifica a ingestão, leitura e transformação de dados utilizados nas análises e marcações do time de investimentos.

---

## 🚀 Funcionalidades

- 📡 Integração com a API de relatórios e boletas do BTG Pactual
- 🗂️ Carregamento padronizado de arquivos (Excel, Parquet, Blob)
- 💾 Escrita incremental e segura no ADLS (Azure Blob Storage)
- 📊 Análises de preço, retorno e risco com API de consulta (`LuxorQuery`)
- 🔗 Modularidade entre `btgapi`, `datareader`, `ingest`, `utils`

---

## 🧩 Estrutura do Projeto

```
luxor-asap/
├── src/luxorasap/
│   ├── btgapi/          # Integração com BTG Pactual
│   ├── datareader/      # Interface de leitura e análise de dados
│   ├── ingest/          # Carga de dados no ADLS
│   └── utils/           # Funções auxiliares (parquet, dataframe)
└── tests/               # Testes automatizados com Pytest
```

---

## 📚 Documentação

A documentação externa completa está disponível em:

[![Docs](https://img.shields.io/badge/docs-online-blue)](https://luxorinvestimentos.github.io/luxorasap-docs/)

---

## 🔧 Requisitos

- Python 3.9+
- Azure Blob Storage configurado
- Variáveis de ambiente via `.env` (ou passadas manualmente):

```bash
AZURE_STORAGE_CONNECTION_STRING=...
BTG_CLIENT_ID=...
BTG_CLIENT_SECRET=...
```

---

## 📦 Instalação

Para instalar localmente:

```bash
pip install -e .
```

Ou via PyPI:

```bash
pip install luxor-asap
```

---

## 🧪 Testes

```bash
pytest -v
```

---

## 📄 Licença

Projeto de uso interno do Luxor Group. Todos os direitos reservados.
