positiva-consultas-python-sdk 1.0.0__py3-none-any.whl

positiva/consultas/dtos/serde.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+"""Helpers de serialização DTO ↔ wire JSON (compartilhados entre endpoints)."""
+from __future__ import annotations
+
+from dataclasses import asdict, fields, is_dataclass
+from enum import Enum
+from typing import Any, Type, TypeVar
+
+T = TypeVar('T')
+
+
+def omit_none(data: dict) -> dict:
+  return {k: v for k, v in data.items() if v is not None}
+
+
+def to_wire(value: Any) -> Any:
+  if value is None:
+    return None
+  if isinstance(value, Enum):
+    return value.value
+  if is_dataclass(value) and not isinstance(value, type):
+    if hasattr(value, 'to_dict'):
+      return value.to_dict()
+    return omit_none({k: to_wire(v) for k, v in asdict(value).items()})
+  if isinstance(value, list):
+    return [to_wire(i) for i in value]
+  if isinstance(value, dict):
+    return {k: to_wire(v) for k, v in value.items() if v is not None}
+  return value
+
+
+def as_wire_dict(instance: Any) -> dict:
+  return omit_none({k: to_wire(v) for k, v in asdict(instance).items()})
+
+
+def from_dataclass(
+  cls: Type[T],
+  data: dict | T | None,
+  *,
+  field_aliases: dict[str, str] | None = None,
+) -> T | None:
+  """Instancia dataclass a partir de dict; ``field_aliases`` mapeia attr→wire."""
+  if data is None:
+    return None
+  if isinstance(data, cls):
+    return data
+  if not isinstance(data, dict):
+    raise TypeError(f'{cls.__name__}.from_dict espera dict, recebeu {type(data)!r}')
+  aliases = field_aliases or {}
+  kwargs: dict[str, Any] = {}
+  for f in fields(cls):
+    raw = data.get(f.name)
+    if raw is None and f.name in aliases:
+      raw = data.get(aliases[f.name])
+    kwargs[f.name] = raw
+  return cls(**kwargs)
+
+
+def digits_only(value: str | None) -> str:
+  if value is None:
+    return ''
+  return ''.join(ch for ch in str(value) if ch.isdigit())

positiva_consultas_python_sdk-1.0.0.dist-info/METADATA

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: positiva-consultas-python-sdk
+Version: 1.0.0
+Summary: Client HTTP de comunicacao com a API da Positiva Consultas (PositivaConnect)
+Author-email: Filipe Coelho <filipe@fmconsult.com.br>
+License: MIT License
+        
+        Copyright (c) 2026 Seu Nome
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy...
+        
+Project-URL: Homepage, https://github.com/FMConsult/positiva-consultas-python-sdk
+Project-URL: Bug Tracker, https://github.com/FMConsult/positiva-consultas-python-sdk/issues
+Project-URL: Documentation, https://positivaconnect.positivaconsultas.com.br/developers/documentation
+Keywords: sdk,api,positiva,consultas,juridico360
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# positiva-consultas-python-sdk
+
+Client HTTP Python para a [API Positiva Consultas (PositivaConnect)](https://positivaconnect.positivaconsultas.com.br/developers/documentation).
+
+Escopo inicial:
+
+- Autenticacao OAuth 2.0 Client Credentials (`POST /client/token`)
+- Positiva Juridico 360 (`POST /api/client/provider/juridico360` e `/pdf`)
+
+## Instalacao
+
+```bash
+pip install positiva-consultas-python-sdk
+```
+
+Requer Python >= 3.11 e o ecossistema `fmconsult` (`ApiBase`).
+
+## Credenciais
+
+Configure as variaveis de ambiente:
+
+```bash
+export positiva.consultas.api.client_id="seu_client_id"
+export positiva.consultas.api.client_secret="seu_client_secret"
+```
+
+## Uso
+
+```python
+from positiva.consultas import Juridico360Api, Juridico360ProductCode
+from positiva.consultas.dtos.juridico360 import Juridico360Request
+
+api = Juridico360Api()  # autentica automaticamente via /client/token
+
+# Consulta processual (um ou mais produtos)
+response = api.consultar(
+  Juridico360Request(
+    document="11111111111",
+    product_code=[
+      Juridico360ProductCode.CRIMINAL,
+      Juridico360ProductCode.CIVIL,
+    ],
+  )
+)
+
+print(response.success, response.query_date)
+criminal = response.results.get("CRIMINAL")
+if criminal and criminal.success and criminal.data:
+  print(criminal.data.nome, len(criminal.data.processos or []))
+
+# PDF do relatorio (Base64)
+pdf = api.gerar_pdf(
+  document="11111111111",
+  product_code=["CRIMINAL", "CIVIL"],
+)
+print(pdf.mime_type, len(pdf.pdf_base64 or ""))
+```
+
+### Autenticacao utilitaria
+
+```python
+from positiva.consultas import PositivaConsultasApi
+
+api = PositivaConsultasApi()
+me = api.me()
+print(me.client.name, me.client.cnpj)
+
+api.refresh()   # renova o Bearer
+api.logout()    # invalida o token atual
+```
+
+## Produtos Juridico 360
+
+| Codigo | Descricao |
+| ------ | --------- |
+| `CRIMINAL` | Processos criminais |
+| `CIVIL` | Processos civis |
+| `TRABALHISTA` | Processos trabalhistas |
+| `MP` | Registros do Ministerio Publico |
+| `BNMP` | Banco Nacional de Mandados de Prisao |
+| `EMPREGADOR_IRREGULAR` | Empregadores irregulares |
+
+Homologacao (credencial em ambiente `homolog`): use documentos de teste `11111111111` … `55555555555` — a API devolve dados ficticios determinísticos.
+
+## Documentacao oficial
+
+- [Visao geral](https://positivaconnect.positivaconsultas.com.br/developers/documentation)
+- [Authentication](https://positivaconnect.positivaconsultas.com.br/developers/docs/authentication)
+- [Juridico 360](https://positivaconnect.positivaconsultas.com.br/developers/docs/providers/juridico360)

positiva_consultas_python_sdk-1.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+positiva/consultas/__init__.py,sha256=iuBHI5BUUHtolrdtluwIhtgQLaJAT29n9edX6AthmWk,383
+positiva/consultas/api.py,sha256=SWOAHF2P-aoaVO1Zdw7ErOcGH4yb8f2lt1ddp3U05uw,3919
+positiva/consultas/apis/__init__.py,sha256=bL1FYqSlQP_MPExb1_d0RxvOYBipFVwdaoPw-ujQwc8,117
+positiva/consultas/apis/juridico360.py,sha256=CbCZBBV3N4QfifFkQvBM2wVUMSHuA-3VPs954P_wUZQ,5191
+positiva/consultas/dtos/__init__.py,sha256=POVABXOZc-gw9m951Lqa9V1WWV1OsV3bsiSNFHAjJ-8,887
+positiva/consultas/dtos/auth.py,sha256=fizdxWy2q6OWKpYorGjt8Ux4b1ydLR76SYRDhZv0370,5202
+positiva/consultas/dtos/enums.py,sha256=_moUPCbd9iCgCSZeYHzZuM-g6FlXOpuHjbZIg4-rfeU,572
+positiva/consultas/dtos/juridico360.py,sha256=mCtlgYetRRAE8T61is9QyBKVGfyw0sy7VhTQGNo-t3o,20619
+positiva/consultas/dtos/serde.py,sha256=v3yxSD5ED3GVH9guWWPCU9kR2BlXQKoPJxuG_6_ajV0,1775
+positiva_consultas_python_sdk-1.0.0.dist-info/licenses/LICENSE,sha256=o7bMpHmYZ2W4kMfLkotLUyabpLvBUznnJEJ_HIpT4SM,122
+positiva_consultas_python_sdk-1.0.0.dist-info/METADATA,sha256=_OAjdBLaKqZ9RM_gFnrYsQf11dxPKcLXABSMf91Ghes,3573
+positiva_consultas_python_sdk-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+positiva_consultas_python_sdk-1.0.0.dist-info/top_level.txt,sha256=pFUeLZto40ufALf6UXpULcExwVHDGXp-QanGTb3PUps,9
+positiva_consultas_python_sdk-1.0.0.dist-info/RECORD,,

positiva_consultas_python_sdk-1.0.0.dist-info/WHEEL

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

positiva_consultas_python_sdk-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2026 Seu Nome
+
+Permission is hereby granted, free of charge, to any person obtaining a copy...

positiva_consultas_python_sdk-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+positiva