Metadata-Version: 2.4
Name: maxsciencelib
Version: 0.0.3
Summary: Biblioteca de funções compartilhadas do time de Data Science da Maxpar
Author: Daniel Antunes Cordeiro
Author-email: Daniel Antunes <daniel.cordeiro@maxpar.com.br>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: sys
Requires-Dist: os
Requires-Dist: warnings
Requires-Dist: snowflake.connector
Dynamic: author
Dynamic: license-file

# MaxScienceLib

Biblioteca com funções aplicadas a rotina do cientista de dados na Maxpar

## Como usar

Instale com:

```bash
pip install maxscientelib
```

Use no seu código:

```python
from maxsciencelib import leitura_snowflake
```

## leitura-snowflake

Biblioteca Python para leitura de dados do **Snowflake** de forma simples, segura e performática, retornando os resultados diretamente como **DataFrame Polars**.

A biblioteca abstrai toda a complexidade de conexão, autenticação via `externalbrowser` e execução de queries, permitindo que o usuário execute consultas com apenas **uma função**.

---

### Funcionalidades

- Conexão automática com Snowflake via `externalbrowser`
- Execução de queries SQL
- Retorno direto em **Polars DataFrame**
- Uso nativo de **Apache Arrow** (alta performance)
- Silenciamento de logs e warnings internos
- Fechamento seguro de conexão e cursor


### Requisitos

- Python **3.11+** (recomendado)
- Acesso ao Snowflake configurado no navegador

### Dependências

```bash
pip install snowflake-connector-python polars pyarrow
```

### Uso básico

```python
from leitura_snowflake import leitura_snowflake

query = """
SELECT *
FROM MINHA_TABELA
LIMIT 1000
"""

df = leitura_snowflake(
    email_corporativo="nome.sobrenome@empresa.com",
    token_account="abc123.us-east-1",
    query=query
)

df.head()
```

O retorno será um objeto:

```python
polars.DataFrame
```

| Parâmetro           | Tipo  | Descrição                                         |
| ------------------- | ----- | ------------------------------------------------- |
| `email_corporativo` | `str` | Email corporativo utilizado no login do Snowflake |
| `token_account`     | `str` | Identificador da conta Snowflake                  |
| `query`             | `str` | Query SQL a ser executada                         |


## Licença

MIT

## Autores

Daniel Antunes Cordeiros
