biatoolkit 1.2.3__tar.gz → 1.2.4__tar.gz

{biatoolkit-1.2.3 → biatoolkit-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: biatoolkit
-Version: 1.2.3
+Version: 1.2.4
 Summary: Biblioteca para desenvolvedores que utilizam o BiaAgentBuilder
 Author: Bia Platform Team
 Author-email: data.platform@sankhya.com.br
@@ -37,7 +37,6 @@ A classe `BiaClient` encapsula um cliente HTTP assíncrono para comunicação co
 (Model Context Protocol).
 
 Ela esconde toda a complexidade de:
-- Conexão HTTP streamable
 - Inicialização de sessões MCP
 - Execução de tools
 
@@ -49,7 +48,6 @@ Ela esconde toda a complexidade de:
 - **call_tool(tool_name, params=None)**
   - Executa uma ferramenta específica disponível no servidor MCP.
 
----
 
 ### BiaUtil
 
@@ -64,7 +62,6 @@ permitindo acesso fácil a:
   - Recebe uma instância de `FastMCP` para acessar o contexto da requisição atual.
 
 - **get_header()**
-  - Extrai e retorna os headers customizados do runtime.
   - Retorna um objeto `Header` com os campos:
     - `current_host`: Host do ERP no qual o copilot está em execução.
     - `user_email`: Email do usuário autenticado.
@@ -75,7 +72,6 @@ permitindo acesso fácil a:
     - `iam_user_id`: ID do usuário do BIA IAM.
     - `gateway_token`: Token primário do Sankhya API Gateway.
 
-- **get_parameter(parameter_name)**
   - Recupera parâmetros sensíveis seguindo a ordem:
     1. Variáveis de ambiente do sistema
     2. AWS SSM Parameter Store (fallback)
@@ -84,7 +80,6 @@ permitindo acesso fácil a:
   - O SSM só é consultado se o parâmetro **não existir** nas variáveis de ambiente.
   - Em produção, a busca no SSM depende do header  
     `X-Amzn-Bedrock-AgentCore-Runtime-Custom-prefix`.
-  - Se esse header não estiver presente, o método retorna `None`.
 
 ---
 
@@ -95,7 +90,6 @@ Nesta seção você encontrará uma breve descrição de como utilizar os princi
 ### **Criando um MCP Server**
 
 Primeiro, instale os pacotes **MCP** e **Bia Toolkit**.
-
 ```bash
 pip install mcp biatoolkit
 ```
@@ -108,9 +102,107 @@ import json
 
 mcp = FastMCP(host="0.0.0.0", stateless_http=True)
 
-@mcp.tool()
 def listar() -> str:
-    """Retorna uma lista de exemplo"""
+
+O Bia Toolkit oferece integração pronta para consumo de serviços HTTP da plataforma Sankhya (ou gateway), com autenticação via JSESSIONID e configuração de timeouts/retries via variáveis de ambiente.
+
+### Objetivo
+
+- Facilitar chamadas autenticadas a serviços Sankhya sem que o desenvolvedor precise lidar com autenticação, headers ou gerenciamento de sessão HTTP.
+- Fornecer métodos prontos para chamadas genéricas (`call_json`) e para consultas a views (`load_view`).
+- Permitir uso estático compatível com scaffolds legados via `Sankhya.Call(...)`.
+
+### Configuração
+
+- O caminho do serviço (`/mge/service.sbr`) é fixo no toolkit.
+- O parâmetro `base_url` é obrigatório e pode ser passado explicitamente ou extraído automaticamente do header do runtime (`current_host` via `BiaUtil`).
+- Não existe mais configuração via variável de ambiente para base_url ou service_path.
+- As variáveis de ambiente opcionais são apenas para timeout, retries e SSL:
+        - `SANKHYA_TIMEOUT_CONNECT`: timeout de conexão (default: 3.05)
+        - `SANKHYA_TIMEOUT_READ`: timeout de leitura (default: 12)
+        - `SANKHYA_RETRIES_TOTAL`: número de tentativas em falha (default: 3)
+        - `SANKHYA_RETRY_BACKOFF`: backoff entre tentativas (default: 0.5)
+        - `SANKHYA_VERIFY_SSL`: se valida SSL (default: "1")
+
+### Principais classes e métodos
+
+- **SankhyaSettings**: Dataclass de configuração de timeouts/retries/SSL. Use `SankhyaSettings.from_env()` para obter as configurações do ambiente.
+- **Sankhya**: Classe principal de integração. Permite instanciar com contexto MCP (`FastMCP`) ou usar métodos estáticos.
+        - `call_json(...)`: Realiza chamada HTTP autenticada, retorna JSON. Veja detalhes dos parâmetros abaixo.
+        - `load_view(...)`: Helper para consultas a views Sankhya (`CRUDServiceProvider.loadView`). Veja detalhes dos parâmetros abaixo.
+        - `Call(...)`: Método estático compatível com scaffolds legados. Veja detalhes dos parâmetros abaixo.
+### Parâmetros dos métodos principais
+
+#### `call_json`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| payload           | Não         | Dicionário enviado como corpo da requisição (POST). Pode ser None. |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa para chamada. Se informado, ignora base_url. |
+| base_url          | Sim*        | Base URL do serviço Sankhya (ex: https://meu.sankhya.com.br). Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (ex: serviceName=...&outputType=json). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+| timeout           | Não         | Tupla (connect, read) para sobrescrever timeout padrão. |
+| raise_for_http_error | Não      | Se True (default), lança SankhyaHTTPError em erro HTTP. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+#### `load_view`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| view_name         | Sim         | Nome da view no Sankhya. |
+| where_sql         | Sim         | Cláusula WHERE (string). |
+| fields            | Não         | Campos a retornar (string). Default: "*". |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa opcional (override). |
+| base_url          | Não*        | Base URL do serviço Sankhya. Se não informado, tenta extrair do header do runtime (current_host). |
+| output_type       | Não         | "json" (default). |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) via BiaUtil. Caso não consiga, lança erro.
+
+#### `Call`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| jsessionID        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| payload           | Não         | Dicionário enviado como corpo da requisição. |
+| mcp               | Não         | Instância opcional do FastMCP para contexto do runtime. |
+| url               | Não         | URL completa (opcional). |
+| base_url          | Sim*        | Base URL do serviço Sankhya. Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (opcional). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+**Resumo:** Sempre que possível, o toolkit resolve automaticamente base_url e jsessionid do contexto MCP (headers). Se não estiver rodando em MCP, passe base_url explicitamente.
+- **SankhyaHTTPError**: Exceção lançada em caso de erro HTTP (status != 200), contendo status_code e response_text.
+
+### Exemplo de uso (instanciado)
+
+```python
+from biatoolkit.sankhya_call import Sankhya
+sk = Sankhya(mcp=mcp)
+result = sk.load_view("BIA_VW_MB_RULES", "CODPROD_A = 123", fields="*")
+# O base_url será extraído automaticamente do header do runtime (current_host)
+```
+
+### Exemplo de uso (estático)
+
+```python
+from biatoolkit.sankhya_call import Sankhya
+result = Sankhya.Call(jsessionID="...", payload={...}, base_url="https://meu.sankhya.com.br", query="serviceName=...&outputType=json")
+```
+
+### Observações
+
+- O JSESSIONID pode ser passado explicitamente ou extraído automaticamente do header do runtime (se rodando em MCP Server).
+- O método `load_view` facilita consultas a views Sankhya, montando o payload e a querystring automaticamente, e resolve o base_url do header se não for passado.
+- O método `call_json` permite chamadas genéricas a qualquer serviço Sankhya, com controle total sobre headers, método HTTP, payload e querystring, mas exige base_url explícito se não estiver em contexto MCP.
     exemplo = {
         "itens": [
             {"id": 1, "nome": "Item 1"},
@@ -348,91 +440,6 @@ O método `get_parameter(parameter_name: str)` busca o parâmetro informado em d
 - Um arquivo `.env` para testes locais.
 - No cofre de segredos do Bia Agent Builder para usar em ambiente produtivo. 
 
-
----
-
-## Validação e Coerção de Dados
-
-O Bia Toolkit oferece funções utilitárias para normalização, sanitização e coerção de dados, facilitando o consumo seguro de entradas vindas de APIs, headers, payloads e integrações legadas.
-
-
-### Validação de Dados (`biatoolkit.validation.validation`)
-
-Utilize a classe **BiaValidation** para acessar as funções de validação de forma padronizada:
-
-- **BiaValidation.parse_int_list(value, dedupe=True, keep_order=True)**
-    - Normaliza um valor arbitrário em uma lista de inteiros.
-    - Suporta: None, int, str (extrai números), list/tuple (recursivo).
-    - Ignora valores inválidos.
-    - Deduplica e mantém ordem por padrão.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.validation import BiaValidation
-        BiaValidation.parse_int_list("SKU=300231 x2")  # [300231, 2]
-        BiaValidation.parse_int_list([1, 2, 1, 3], dedupe=False)  # [1, 2, 1, 3]
-        ```
-
-- **BiaValidation.sanitize_like(value, max_len=80, upper=True)**
-    - Sanitiza texto para uso seguro em filtros LIKE/search SQL.
-    - Remove caracteres fora da allowlist, limita tamanho, escapa aspas simples, %, _ e normaliza espaços.
-    - Converte para maiúsculas por padrão.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.validation import BiaValidation
-        BiaValidation.sanitize_like("O'Reilly")  # "O''REILLY"
-        BiaValidation.sanitize_like("100%_OK")   # "100\\%\\_OK"
-        ```
-
-
-### Coerção de Dados (`biatoolkit.validation.coercion`)
-
-Utilize a classe **BiaCoercion** para acessar as funções de coerção de forma padronizada:
-
-- **BiaCoercion.ensure_list(value)**
-    - Garante que o valor seja retornado como lista.
-    - None → [], list → list, tuple/set → list, dict → [dict], outro → [valor].
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.ensure_list(None)  # []
-        BiaCoercion.ensure_list({"a": 1})  # [{"a": 1}]
-        BiaCoercion.ensure_list(5)  # [5]
-        ```
-
-- **BiaCoercion.unwrap_dollar_value(value)**
-    - Desembrulha valores no formato {"$": ...} (comum em integrações legadas).
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.unwrap_dollar_value({"$": 123})  # 123
-        BiaCoercion.unwrap_dollar_value("abc")  # "abc"
-        ```
-
-- **BiaCoercion.to_int(value, default=0)**
-    - Converte valor para int de forma segura.
-    - None, "", bool, NaN/inf → default.
-    - Aceita strings numéricas, floats (trunca), etc.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.to_int(" 42 ")  # 42
-        BiaCoercion.to_int(None, default=-1)  # -1
-        ```
-
-- **BiaCoercion.to_float(value, default=0.0)**
-    - Converte valor para float de forma segura.
-    - None, "", bool, NaN/inf → default.
-    - Aceita strings com vírgula decimal.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.to_float("12,34")  # 12.34
-        BiaCoercion.to_float("abc", default=-1.0)  # -1.0
-        ```
-
-
-Essas funções são úteis para garantir robustez e previsibilidade ao tratar dados vindos de múltiplas fontes, reduzindo erros e if/else espalhados pelo código.
-
 ---
 
 ## Integração com Sankhya (`biatoolkit.sankhya_call`)

{biatoolkit-1.2.3 → biatoolkit-1.2.4}/biatoolkit/sankhya_call.py

@@ -271,6 +271,7 @@ class Sankhya:
 
         # Resolve o token de sessão (JSESSIONID)
         sid = self._resolve_jsessionid(jsessionid)
+
         # Para mgeSession na query, usar só a primeira parte antes do ponto
         sid_query = sid.split(".", 1)[0] if "." in sid else sid
 
@@ -281,6 +282,7 @@ class Sankhya:
         query_parts.append(f"mgeSession={sid_query}")
         final_query = "&".join(query_parts)
 
+
         # Monta a URL final da requisição
         final_url = build_url(url=url, query=final_query, base_url=base_url)
         print("FINAL URL:", final_url)

{biatoolkit-1.2.3 → biatoolkit-1.2.4}/biatoolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: biatoolkit
-Version: 1.2.3
+Version: 1.2.4
 Summary: Biblioteca para desenvolvedores que utilizam o BiaAgentBuilder
 Author: Bia Platform Team
 Author-email: data.platform@sankhya.com.br
@@ -37,7 +37,6 @@ A classe `BiaClient` encapsula um cliente HTTP assíncrono para comunicação co
 (Model Context Protocol).
 
 Ela esconde toda a complexidade de:
-- Conexão HTTP streamable
 - Inicialização de sessões MCP
 - Execução de tools
 
@@ -49,7 +48,6 @@ Ela esconde toda a complexidade de:
 - **call_tool(tool_name, params=None)**
   - Executa uma ferramenta específica disponível no servidor MCP.
 
----
 
 ### BiaUtil
 
@@ -64,7 +62,6 @@ permitindo acesso fácil a:
   - Recebe uma instância de `FastMCP` para acessar o contexto da requisição atual.
 
 - **get_header()**
-  - Extrai e retorna os headers customizados do runtime.
   - Retorna um objeto `Header` com os campos:
     - `current_host`: Host do ERP no qual o copilot está em execução.
     - `user_email`: Email do usuário autenticado.
@@ -75,7 +72,6 @@ permitindo acesso fácil a:
     - `iam_user_id`: ID do usuário do BIA IAM.
     - `gateway_token`: Token primário do Sankhya API Gateway.
 
-- **get_parameter(parameter_name)**
   - Recupera parâmetros sensíveis seguindo a ordem:
     1. Variáveis de ambiente do sistema
     2. AWS SSM Parameter Store (fallback)
@@ -84,7 +80,6 @@ permitindo acesso fácil a:
   - O SSM só é consultado se o parâmetro **não existir** nas variáveis de ambiente.
   - Em produção, a busca no SSM depende do header  
     `X-Amzn-Bedrock-AgentCore-Runtime-Custom-prefix`.
-  - Se esse header não estiver presente, o método retorna `None`.
 
 ---
 
@@ -95,7 +90,6 @@ Nesta seção você encontrará uma breve descrição de como utilizar os princi
 ### **Criando um MCP Server**
 
 Primeiro, instale os pacotes **MCP** e **Bia Toolkit**.
-
 ```bash
 pip install mcp biatoolkit
 ```
@@ -108,9 +102,107 @@ import json
 
 mcp = FastMCP(host="0.0.0.0", stateless_http=True)
 
-@mcp.tool()
 def listar() -> str:
-    """Retorna uma lista de exemplo"""
+
+O Bia Toolkit oferece integração pronta para consumo de serviços HTTP da plataforma Sankhya (ou gateway), com autenticação via JSESSIONID e configuração de timeouts/retries via variáveis de ambiente.
+
+### Objetivo
+
+- Facilitar chamadas autenticadas a serviços Sankhya sem que o desenvolvedor precise lidar com autenticação, headers ou gerenciamento de sessão HTTP.
+- Fornecer métodos prontos para chamadas genéricas (`call_json`) e para consultas a views (`load_view`).
+- Permitir uso estático compatível com scaffolds legados via `Sankhya.Call(...)`.
+
+### Configuração
+
+- O caminho do serviço (`/mge/service.sbr`) é fixo no toolkit.
+- O parâmetro `base_url` é obrigatório e pode ser passado explicitamente ou extraído automaticamente do header do runtime (`current_host` via `BiaUtil`).
+- Não existe mais configuração via variável de ambiente para base_url ou service_path.
+- As variáveis de ambiente opcionais são apenas para timeout, retries e SSL:
+        - `SANKHYA_TIMEOUT_CONNECT`: timeout de conexão (default: 3.05)
+        - `SANKHYA_TIMEOUT_READ`: timeout de leitura (default: 12)
+        - `SANKHYA_RETRIES_TOTAL`: número de tentativas em falha (default: 3)
+        - `SANKHYA_RETRY_BACKOFF`: backoff entre tentativas (default: 0.5)
+        - `SANKHYA_VERIFY_SSL`: se valida SSL (default: "1")
+
+### Principais classes e métodos
+
+- **SankhyaSettings**: Dataclass de configuração de timeouts/retries/SSL. Use `SankhyaSettings.from_env()` para obter as configurações do ambiente.
+- **Sankhya**: Classe principal de integração. Permite instanciar com contexto MCP (`FastMCP`) ou usar métodos estáticos.
+        - `call_json(...)`: Realiza chamada HTTP autenticada, retorna JSON. Veja detalhes dos parâmetros abaixo.
+        - `load_view(...)`: Helper para consultas a views Sankhya (`CRUDServiceProvider.loadView`). Veja detalhes dos parâmetros abaixo.
+        - `Call(...)`: Método estático compatível com scaffolds legados. Veja detalhes dos parâmetros abaixo.
+### Parâmetros dos métodos principais
+
+#### `call_json`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| payload           | Não         | Dicionário enviado como corpo da requisição (POST). Pode ser None. |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa para chamada. Se informado, ignora base_url. |
+| base_url          | Sim*        | Base URL do serviço Sankhya (ex: https://meu.sankhya.com.br). Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (ex: serviceName=...&outputType=json). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+| timeout           | Não         | Tupla (connect, read) para sobrescrever timeout padrão. |
+| raise_for_http_error | Não      | Se True (default), lança SankhyaHTTPError em erro HTTP. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+#### `load_view`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| view_name         | Sim         | Nome da view no Sankhya. |
+| where_sql         | Sim         | Cláusula WHERE (string). |
+| fields            | Não         | Campos a retornar (string). Default: "*". |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa opcional (override). |
+| base_url          | Não*        | Base URL do serviço Sankhya. Se não informado, tenta extrair do header do runtime (current_host). |
+| output_type       | Não         | "json" (default). |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) via BiaUtil. Caso não consiga, lança erro.
+
+#### `Call`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| jsessionID        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| payload           | Não         | Dicionário enviado como corpo da requisição. |
+| mcp               | Não         | Instância opcional do FastMCP para contexto do runtime. |
+| url               | Não         | URL completa (opcional). |
+| base_url          | Sim*        | Base URL do serviço Sankhya. Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (opcional). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+**Resumo:** Sempre que possível, o toolkit resolve automaticamente base_url e jsessionid do contexto MCP (headers). Se não estiver rodando em MCP, passe base_url explicitamente.
+- **SankhyaHTTPError**: Exceção lançada em caso de erro HTTP (status != 200), contendo status_code e response_text.
+
+### Exemplo de uso (instanciado)
+
+```python
+from biatoolkit.sankhya_call import Sankhya
+sk = Sankhya(mcp=mcp)
+result = sk.load_view("BIA_VW_MB_RULES", "CODPROD_A = 123", fields="*")
+# O base_url será extraído automaticamente do header do runtime (current_host)
+```
+
+### Exemplo de uso (estático)
+
+```python
+from biatoolkit.sankhya_call import Sankhya
+result = Sankhya.Call(jsessionID="...", payload={...}, base_url="https://meu.sankhya.com.br", query="serviceName=...&outputType=json")
+```
+
+### Observações
+
+- O JSESSIONID pode ser passado explicitamente ou extraído automaticamente do header do runtime (se rodando em MCP Server).
+- O método `load_view` facilita consultas a views Sankhya, montando o payload e a querystring automaticamente, e resolve o base_url do header se não for passado.
+- O método `call_json` permite chamadas genéricas a qualquer serviço Sankhya, com controle total sobre headers, método HTTP, payload e querystring, mas exige base_url explícito se não estiver em contexto MCP.
     exemplo = {
         "itens": [
             {"id": 1, "nome": "Item 1"},
@@ -348,91 +440,6 @@ O método `get_parameter(parameter_name: str)` busca o parâmetro informado em d
 - Um arquivo `.env` para testes locais.
 - No cofre de segredos do Bia Agent Builder para usar em ambiente produtivo. 
 
-
----
-
-## Validação e Coerção de Dados
-
-O Bia Toolkit oferece funções utilitárias para normalização, sanitização e coerção de dados, facilitando o consumo seguro de entradas vindas de APIs, headers, payloads e integrações legadas.
-
-
-### Validação de Dados (`biatoolkit.validation.validation`)
-
-Utilize a classe **BiaValidation** para acessar as funções de validação de forma padronizada:
-
-- **BiaValidation.parse_int_list(value, dedupe=True, keep_order=True)**
-    - Normaliza um valor arbitrário em uma lista de inteiros.
-    - Suporta: None, int, str (extrai números), list/tuple (recursivo).
-    - Ignora valores inválidos.
-    - Deduplica e mantém ordem por padrão.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.validation import BiaValidation
-        BiaValidation.parse_int_list("SKU=300231 x2")  # [300231, 2]
-        BiaValidation.parse_int_list([1, 2, 1, 3], dedupe=False)  # [1, 2, 1, 3]
-        ```
-
-- **BiaValidation.sanitize_like(value, max_len=80, upper=True)**
-    - Sanitiza texto para uso seguro em filtros LIKE/search SQL.
-    - Remove caracteres fora da allowlist, limita tamanho, escapa aspas simples, %, _ e normaliza espaços.
-    - Converte para maiúsculas por padrão.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.validation import BiaValidation
-        BiaValidation.sanitize_like("O'Reilly")  # "O''REILLY"
-        BiaValidation.sanitize_like("100%_OK")   # "100\\%\\_OK"
-        ```
-
-
-### Coerção de Dados (`biatoolkit.validation.coercion`)
-
-Utilize a classe **BiaCoercion** para acessar as funções de coerção de forma padronizada:
-
-- **BiaCoercion.ensure_list(value)**
-    - Garante que o valor seja retornado como lista.
-    - None → [], list → list, tuple/set → list, dict → [dict], outro → [valor].
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.ensure_list(None)  # []
-        BiaCoercion.ensure_list({"a": 1})  # [{"a": 1}]
-        BiaCoercion.ensure_list(5)  # [5]
-        ```
-
-- **BiaCoercion.unwrap_dollar_value(value)**
-    - Desembrulha valores no formato {"$": ...} (comum em integrações legadas).
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.unwrap_dollar_value({"$": 123})  # 123
-        BiaCoercion.unwrap_dollar_value("abc")  # "abc"
-        ```
-
-- **BiaCoercion.to_int(value, default=0)**
-    - Converte valor para int de forma segura.
-    - None, "", bool, NaN/inf → default.
-    - Aceita strings numéricas, floats (trunca), etc.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.to_int(" 42 ")  # 42
-        BiaCoercion.to_int(None, default=-1)  # -1
-        ```
-
-- **BiaCoercion.to_float(value, default=0.0)**
-    - Converte valor para float de forma segura.
-    - None, "", bool, NaN/inf → default.
-    - Aceita strings com vírgula decimal.
-    - Exemplo:
-        ```python
-        from biatoolkit.validation.coercion import BiaCoercion
-        BiaCoercion.to_float("12,34")  # 12.34
-        BiaCoercion.to_float("abc", default=-1.0)  # -1.0
-        ```
-
-
-Essas funções são úteis para garantir robustez e previsibilidade ao tratar dados vindos de múltiplas fontes, reduzindo erros e if/else espalhados pelo código.
-
 ---
 
 ## Integração com Sankhya (`biatoolkit.sankhya_call`)

{biatoolkit-1.2.3 → biatoolkit-1.2.4}/biatoolkit.egg-info/SOURCES.txt

@@ -11,7 +11,4 @@ biatoolkit.egg-info/SOURCES.txt
 biatoolkit.egg-info/dependency_links.txt
 biatoolkit.egg-info/top_level.txt
 biatoolkit/schema/__init__.py
-biatoolkit/schema/header.py
-biatoolkit/validation/__init__.py
-biatoolkit/validation/coercion.py
-biatoolkit/validation/validation.py
+biatoolkit/schema/header.py

{biatoolkit-1.2.3 → biatoolkit-1.2.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='biatoolkit',
-    version='1.2.3',
+    version='1.2.4',
     packages=find_packages(),
     install_requires=[],
     author='Bia Platform Team',  

biatoolkit-1.2.3/biatoolkit/validation/coercion.py

@@ -1,175 +0,0 @@
-# biatoolkit/validation/coercion.py
-
-from __future__ import annotations
-
-from typing import Any, Iterable, Mapping, Optional
-import math
-
-
-def ensure_list(value: Any) -> list:
-    """
-    Normaliza um valor para sempre retornar uma lista.
-
-    Regras:
-    - None -> []
-    - list -> a própria lista
-    - tuple/set -> list(value)
-    - dict (ou Mapping) -> [value]  (não "explode" dict em chaves)
-    - qualquer outro -> [value]
-
-    Por que existe:
-    - Muitas APIs retornam ora um item único (dict), ora uma lista.
-    - Este helper padroniza o consumo e reduz if/else espalhado.
-
-    Args:
-        value: qualquer valor.
-
-    Returns:
-        list: lista normalizada.
-    """
-    if value is None:
-        return []
-
-    if isinstance(value, list):
-        return value
-
-    if isinstance(value, (tuple, set)):
-        return list(value)
-
-    # Dict/Mapping deve ser tratado como item único, não iterável de chaves.
-    if isinstance(value, Mapping):
-        return [value]
-
-    return [value]
-
-
-def unwrap_dollar_value(value: Any) -> Any:
-    """
-    "Desembrulha" valores no formato {"$": "..."} (comum em integrações legadas).
-
-    Exemplo:
-        {"$": "123"} -> "123"
-        {"$": 123} -> 123
-
-    Se não for dict com a chave "$", retorna o valor original.
-
-    Args:
-        value: valor de entrada.
-
-    Returns:
-        Any: valor desembrulhado ou original.
-    """
-    if isinstance(value, dict) and "$" in value:
-        return value.get("$")
-    return value
-
-
-def to_int(value: Any, default: int = 0) -> int:
-    """
-    Converte um valor para int de forma segura.
-
-    Regras:
-    - None / "" -> default
-    - strings com espaços são aceitas (" 12 ")
-    - strings numéricas com sinal são aceitas ("-3")
-    - floats numéricos -> int(value) (trunca)
-    - NaN/inf -> default
-
-    Obs:
-    - Não tenta "extrair número do meio do texto" (isso é responsabilidade
-      de parse específico, ex: parse_int_list).
-
-    Args:
-        value: valor a converter.
-        default: fallback.
-
-    Returns:
-        int: convertido ou default.
-    """
-    try:
-        if value is None:
-            return default
-
-        if isinstance(value, bool):
-            # Evita True->1 / False->0 de forma "surpresa"
-            return default
-
-        if isinstance(value, str):
-            s = value.strip()
-            if s == "":
-                return default
-            return int(s)
-
-        if isinstance(value, float):
-            if math.isnan(value) or math.isinf(value):
-                return default
-            return int(value)
-
-        return int(value)
-    except (TypeError, ValueError):
-        return default
-
-
-def to_float(value: Any, default: float = 0.0) -> float:
-    """
-    Converte um valor para float de forma segura.
-
-    Regras:
-    - None / "" -> default
-    - aceita strings com vírgula decimal ("12,34")
-    - NaN/inf -> default
-
-    Args:
-        value: valor a converter.
-        default: fallback.
-
-    Returns:
-        float: convertido ou default.
-    """
-    try:
-        if value is None:
-            return default
-
-        if isinstance(value, bool):
-            return default
-
-        if isinstance(value, str):
-            s = value.strip()
-            if s == "":
-                return default
-            s = s.replace(",", ".")
-            v = float(s)
-        else:
-            v = float(value)
-
-        if math.isnan(v) or math.isinf(v):
-            return default
-
-        return v
-    except (TypeError, ValueError):
-        return default
-
-
-
-
-# Classe fachada para coerção
-class BiaCoercion:
-    """
-    Fachada estática para funções de coerção do Bia Toolkit.
-    Permite referenciar e utilizar as utilidades de coerção de forma padronizada.
-    """
-    @staticmethod
-    def ensure_list(*args, **kwargs):
-        return ensure_list(*args, **kwargs)
-
-    @staticmethod
-    def unwrap_dollar_value(*args, **kwargs):
-        return unwrap_dollar_value(*args, **kwargs)
-
-    @staticmethod
-    def to_int(*args, **kwargs):
-        return to_int(*args, **kwargs)
-
-    @staticmethod
-    def to_float(*args, **kwargs):
-        return to_float(*args, **kwargs)

biatoolkit-1.2.3/biatoolkit/validation/validation.py

@@ -1,135 +0,0 @@
-# biatoolkit/validation.py
-
-from typing import Any, Iterable
-import re
-
-
-def parse_int_list(
-    value: Any,
-    *,
-    dedupe: bool = True,
-    keep_order: bool = True,
-) -> list[int]:
-    """
-    Normaliza um valor arbitrário em uma lista de inteiros.
-
-    Casos suportados:
-    - None -> []
-    - int -> [int]
-    - str -> extrai números (ex: "100, 200" / "SKU=300231 x2")
-    - list/tuple -> processa cada item recursivamente
-
-    Comportamento:
-    - Ignora valores inválidos
-    - Deduplica por padrão
-    - Mantém a ordem de aparição por padrão
-
-    Args:
-        value: Valor de entrada (None, int, str, list, etc.)
-        dedupe: Remove valores duplicados.
-        keep_order: Mantém a ordem original dos valores.
-
-    Returns:
-        list[int]: Lista normalizada de inteiros.
-    """
-    if value is None:
-        return []
-
-    # Normaliza para iterável
-    if isinstance(value, (list, tuple, set)):
-        raw: Iterable[Any] = value
-    else:
-        raw = [value]
-
-    numbers: list[int] = []
-
-    for item in raw:
-        if item is None:
-            continue
-
-        # Inteiro direto
-        if isinstance(item, int):
-            numbers.append(item)
-            continue
-
-        # String ou outros tipos
-        text = str(item)
-        matches = re.findall(r"\d+", text)
-        for m in matches:
-            try:
-                numbers.append(int(m))
-            except ValueError:
-                continue
-
-    if not dedupe:
-        return numbers
-
-    if keep_order:
-        seen = set()
-        ordered: list[int] = []
-        for n in numbers:
-            if n not in seen:
-                seen.add(n)
-                ordered.append(n)
-        return ordered
-
-    return list(set(numbers))
-
-def sanitize_like(
-    value: str,
-    *,
-    max_len: int = 80,
-    upper: bool = True,
-) -> str:
-    """
-    Sanitiza um texto para uso seguro em filtros do tipo LIKE/search.
-
-    Regras aplicadas:
-    - Remove caracteres fora de uma allowlist básica
-    - Limita o tamanho do texto
-    - Escapa aspas simples
-    - Escapa curingas comuns (% e _)
-    - Converte para UPPER por padrão
-
-    Args:
-        value: Texto de entrada.
-        max_len: Tamanho máximo permitido.
-        upper: Converte o texto final para maiúsculas.
-
-    Returns:
-        str: Texto sanitizado.
-    """
-    if not value:
-        return ""
-
-    # Normaliza e corta tamanho
-    text = str(value).strip()[:max_len]
-
-    # Allowlist simples (letras, números, acentos, espaço e alguns símbolos, incluindo ', %, _)
-    # Mantém ', %, _ para escapá-los depois
-    text = re.sub(r"[^0-9A-Za-zÀ-ÿ\s\-\(\)\./'_%]", " ", text)
-
-    # Escapes básicos
-    text = text.replace("'", "''")
-    text = text.replace("%", r"\%" ).replace("_", r"\_")
-
-    # Normaliza espaços
-    text = re.sub(r"\s+", " ", text).strip()
-
-
-    return text.upper() if upper else text
-
-
-# Classe fachada para validação
-class BiaValidation:
-    """
-    Fachada estática para funções de validação do Bia Toolkit.
-    Permite referenciar e utilizar as utilidades de validação de forma padronizada.
-    """
-    @staticmethod
-    def parse_int_list(*args, **kwargs):
-        return parse_int_list(*args, **kwargs)
-
-    @staticmethod
-    def sanitize_like(*args, **kwargs):
-        return sanitize_like(*args, **kwargs)