maxsciencelib 0.0.5__py3-none-any.whl

maxsciencelib/__init__.py

@@ -0,0 +1 @@
+from .leitura import *

maxsciencelib/leitura.py

@@ -0,0 +1,136 @@
+import os
+import sys
+import warnings
+import snowflake.connector
+import pandas as pd
+import polars as pl
+import tableauserverclient as TSC
+import io
+
+
+def leitura_snowflake(
+    email_corporativo: str,
+    token_account: str,
+    query: str
+) -> pl.DataFrame:
+    """
+    Executa uma query no Snowflake e retorna um DataFrame Polars.
+
+    Parâmetros
+    ----------
+    email_corporativo : str
+        Email corporativo usado no login (externalbrowser)
+    token_account : str
+        Account do Snowflake
+    query : str
+        Query SQL a ser executada
+
+    Retorno
+    -------
+    pl.DataFrame
+    """
+
+    warnings.filterwarnings("ignore", message=".*keyring.*")
+
+    sys_stdout, sys_stderr = sys.stdout, sys.stderr
+
+    try:
+        sys.stdout = open(os.devnull, 'w')
+        sys.stderr = open(os.devnull, 'w')
+
+        conn = snowflake.connector.connect(
+            user=email_corporativo,
+            account=token_account,
+            database='MAXPAR',
+            schema='ESTATISTICA',
+            role='GL_SNOWFLAKE_ACESSO_MAX_CED_DADOS',
+            warehouse='WH_USE_CED',
+            authenticator='externalbrowser',
+            network_timeout=600
+        )
+
+        cursor = conn.cursor()
+        try:
+            cursor.execute(query)
+
+            # 🔥 Snowflake -> Arrow -> Polars
+            arrow_table = cursor.fetch_arrow_all()
+            df = pl.from_arrow(arrow_table)
+
+        finally:
+            cursor.close()
+
+    finally:
+        sys.stdout.close()
+        sys.stderr.close()
+        sys.stdout, sys.stderr = sys_stdout, sys_stderr
+
+        try:
+            conn.close()
+        except Exception:
+            pass
+
+    return df
+
+
+
+def leitura_tableau(
+    nome_token: str,
+    token_acesso: str,
+    view_id: str
+) -> pl.DataFrame:
+    """
+    Lê uma view do Tableau Server e retorna um DataFrame Polars.
+
+    Parâmetros
+    ----------
+    nome_token : str
+        Nome do Personal Access Token do Tableau
+    token_acesso : str
+        Token de acesso pessoal do Tableau
+    view_id : str
+        ID da view no Tableau Server
+
+    Retorno
+    -------
+    pl.DataFrame
+    """
+
+    warnings.filterwarnings("ignore")
+
+    def tentar_conectar(url: str):
+        tableau_auth = TSC.PersonalAccessTokenAuth(
+            token_name=nome_token,
+            personal_access_token=token_acesso,
+            site_id=""
+        )
+        server = TSC.Server(url, use_server_version=True)
+        server.auth.sign_in(tableau_auth)
+        return server
+
+    server = None
+    try:
+        try:
+            server = tentar_conectar("http://tableau.autoglass.com.br/")
+        except Exception:
+            server = tentar_conectar("https://tableau.autoglass.com.br/")
+
+        if server is None:
+            raise ConnectionError("Não foi possível conectar ao Tableau Server.")
+
+        # Obter view
+        view_item = server.views.get_by_id(view_id)
+
+        # Exportar CSV da view
+        server.views.populate_csv(view_item)
+
+        csv_bytes = b"".join(view_item.csv)
+
+        # CSV → Polars (via Arrow)
+        df = pl.read_csv(io.BytesIO(csv_bytes))
+
+        return df
+
+    finally:
+        if server:
+            server.auth.sign_out()

maxsciencelib-0.0.5.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: maxsciencelib
+Version: 0.0.5
+Summary: Biblioteca de funções compartilhadas do time de Data Science da Maxpar
+Author-email: Daniel Antunes <daniel.ant.cord@gmail.com>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Requires-Dist: pandas>=1.5
+Requires-Dist: numpy>=1.23
+Requires-Dist: polars>=0.20.0
+Requires-Dist: pyarrow>=14.0.0
+Requires-Dist: snowflake-connector-python>=3.5.0
+Requires-Dist: io
+Requires-Dist: tableauserverclient
+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                         |
+
+
+---
+
+## leitura-tableau
+
+Biblioteca Python para leitura de dados do **Tableau Server** de forma simples, segura e performática, retornando os resultados diretamente como **DataFrame Polars**.
+
+A biblioteca abstrai toda a complexidade de autenticação via **Personal Access Token**, conexão com o Tableau Server (HTTP/HTTPS) e download da view, permitindo que o usuário consuma dados com apenas **uma função**.
+
+---
+
+### Funcionalidades
+
+* Autenticação via **Personal Access Token (PAT)**
+* Conexão automática com Tableau Server (fallback HTTP → HTTPS)
+* Download de views diretamente do Tableau
+* Retorno direto em **Polars DataFrame**
+* Leitura eficiente de CSV em memória
+* Silenciamento de warnings internos
+* Encerramento seguro da sessão (`sign_out`)
+
+---
+
+### Requisitos
+
+* Python **3.10+** (recomendado)
+* Acesso ao Tableau Server
+* Personal Access Token ativo no Tableau
+
+---
+
+### Dependências
+
+```bash
+pip install tableauserverclient polars pyarrow
+```
+
+---
+
+### Uso básico
+
+```python
+from maxsciencelib.leitura_tableau import leitura_tableau
+
+df = leitura_tableau(
+    nome_token="meu_token_tableau",
+    token_acesso="XXXXXXXXXXXXXXXXXXXXXXXX",
+    view_id="abcd1234-efgh-5678"
+)
+
+df.head()
+```
+
+---
+
+### Retorno
+
+O retorno da função será um objeto:
+
+```python
+polars.DataFrame
+```
+
+---
+
+### Parâmetros
+
+| Parâmetro      | Tipo  | Descrição                                           |
+| -------------- | ----- | --------------------------------------------------- |
+| `nome_token`   | `str` | Nome do Personal Access Token cadastrado no Tableau |
+| `token_acesso` | `str` | Token de acesso pessoal do Tableau                  |
+| `view_id`      | `str` | Identificador da view no Tableau Server             |
+
+
+
+## Licença
+
+The MIT License (MIT)
+
+## Autores
+
+Daniel Antunes Cordeiros

maxsciencelib-0.0.5.dist-info/RECORD

@@ -0,0 +1,8 @@
+maxsciencelib/__init__.py,sha256=HfJvK0jrb39Ffvn7Ec5e6mD2Swd_R03jpmQSC27Cskc,22
+maxsciencelib/leitura.py,sha256=Mr06_eK98A9ext7pXeRt3RrnuF1VBCGUjMJ_Xs7f-bU,3310
+maxsciencelib-0.0.5.dist-info/licenses/LICENCE,sha256=Z5CpyxPhHkk2b1S2ujxWq0lod5yZrU0umM5yQCSmVac,1112
+tests/teste.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+maxsciencelib-0.0.5.dist-info/METADATA,sha256=NNKc0zQUvogWhdWp8nh4ercNCPxvWopnIWe-7PSbUvc,4375
+maxsciencelib-0.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+maxsciencelib-0.0.5.dist-info/top_level.txt,sha256=H6bvY4js2feOB4Ar9q_kingsRlv4zr0mKv9gF2UAdA0,20
+maxsciencelib-0.0.5.dist-info/RECORD,,

maxsciencelib-0.0.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

maxsciencelib-0.0.5.dist-info/licenses/LICENCE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) [2026] [Daniel Antunes Cordeiro]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

maxsciencelib-0.0.5.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+maxsciencelib
+tests