seigov 0.1.0__tar.gz

seigov-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# venv / build
+.venv/
+venv/
+build/
+dist/
+*.whl
+*.tar.gz
+
+# Claude Code / planning (não versionar)
+PLAN.md
+CLAUDE.md
+.claude/
+
+# OS
+.DS_Store

seigov-0.1.0/LICENSE

@@ -0,0 +1,14 @@
+seigov — cliente Python para os Web Services do SEI/SIP
+Copyright (C) 2026 Andre Leite e colaboradores
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with
+this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.

seigov-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: seigov
+Version: 0.1.0
+Summary: Cliente Python para os Web Services SOAP do SEI (Sistema Eletronico de Informacoes) e do SIP
+Project-URL: Homepage, https://github.com/StrategicProjects/seigov
+Project-URL: Issues, https://github.com/StrategicProjects/seigov/issues
+Author-email: Andre Leite <leite@castlab.org>, Marcos Wasilew <marcos.wasilew@gmail.com>, Hugo Vasconcelos <hugo.vasconcelos@ufpe.br>, Carlos Amorin <carlos.agaf@ufpe.br>, Diogo Bezerra <diogo.bezerra@ufpe.br>, Julia Nascimento Barreto <juliabarreto@gd.seplag.pe.gov.br>
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: govbr,processo-eletronico,sei,sip,soap,zeep
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.9
+Requires-Dist: pandas>=1.5
+Requires-Dist: zeep>=4.2
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest-mock>=3; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# seigov
+
+Cliente Python para os **Web Services SOAP do SEI** (Sistema Eletrônico de
+Informações) e do **SIP** (Sistema de Permissões). Construído sobre
+[`zeep`](https://docs.python-zeep.org/), devolve os resultados como
+`pandas.DataFrame`. É a porta Python do pacote R
+[`rsei`](https://github.com/StrategicProjects/rsei).
+
+> **⚠️ Acesso restrito por IP.** Os Web Services do SEI só respondem a
+> requisições vindas de IPs/servidores previamente autorizados no cadastro do
+> serviço. As funções só retornam dados a partir de um host autorizado.
+
+> **Genérico.** O pacote não é amarrado a nenhum órgão: informe o endpoint do
+> Web Service do **seu** SEI em `SeiClient(url=...)`.
+
+## Instalação
+
+```bash
+pip install seigov            # (após publicação no PyPI)
+# ou, do código-fonte:
+pip install -e ".[dev]"
+```
+
+## Uso
+
+```python
+from seigov import SeiClient
+
+sei = SeiClient(
+    url="https://sei.<seu-orgao>.gov.br/sei/ws/SeiWS.php",
+    sigla_sistema="MEU_SISTEMA",
+    identificacao_servico="minha-chave",   # chave de acesso
+)
+
+# Consultar um processo (retorna um DataFrame)
+df = sei.consultar_procedimento("12.1.000000077-4")
+
+# Vários de uma vez (empilha; coluna 'erro' isola falhas por linha)
+lote = sei.consultar_procedimentos(["12.1.000000077-4", "12.1.000000078-2"])
+
+# Listagens
+unidades = sei.listar_unidades()
+series   = sei.listar_series()
+```
+
+Configuração também por variáveis de ambiente: `SEIGOV_URL`,
+`SEIGOV_SIGLA_SISTEMA`, `SEIGOV_IDENTIFICACAO_SERVICO`, `SEIGOV_ID_UNIDADE`.
+
+SIP (permissões):
+
+```python
+from seigov import SipClient
+sip = SipClient(url="https://sei.<seu-orgao>.gov.br/sip/controlador_ws.php?servico=sip",
+                chave_acesso="...", id_sistema="...")
+perms = sip.listar_permissao(id_unidade="110000001")
+```
+
+## Estado
+
+Em desenvolvimento (Fase 0/1: core + consultas/listagens iniciais). Veja
+`PLAN.md` para o roteiro completo (escrita, SIP, helpers em lote/por-processo).
+
+## Licença
+
+GPL-3.0-or-later.

seigov-0.1.0/README.md

@@ -0,0 +1,65 @@
+# seigov
+
+Cliente Python para os **Web Services SOAP do SEI** (Sistema Eletrônico de
+Informações) e do **SIP** (Sistema de Permissões). Construído sobre
+[`zeep`](https://docs.python-zeep.org/), devolve os resultados como
+`pandas.DataFrame`. É a porta Python do pacote R
+[`rsei`](https://github.com/StrategicProjects/rsei).
+
+> **⚠️ Acesso restrito por IP.** Os Web Services do SEI só respondem a
+> requisições vindas de IPs/servidores previamente autorizados no cadastro do
+> serviço. As funções só retornam dados a partir de um host autorizado.
+
+> **Genérico.** O pacote não é amarrado a nenhum órgão: informe o endpoint do
+> Web Service do **seu** SEI em `SeiClient(url=...)`.
+
+## Instalação
+
+```bash
+pip install seigov            # (após publicação no PyPI)
+# ou, do código-fonte:
+pip install -e ".[dev]"
+```
+
+## Uso
+
+```python
+from seigov import SeiClient
+
+sei = SeiClient(
+    url="https://sei.<seu-orgao>.gov.br/sei/ws/SeiWS.php",
+    sigla_sistema="MEU_SISTEMA",
+    identificacao_servico="minha-chave",   # chave de acesso
+)
+
+# Consultar um processo (retorna um DataFrame)
+df = sei.consultar_procedimento("12.1.000000077-4")
+
+# Vários de uma vez (empilha; coluna 'erro' isola falhas por linha)
+lote = sei.consultar_procedimentos(["12.1.000000077-4", "12.1.000000078-2"])
+
+# Listagens
+unidades = sei.listar_unidades()
+series   = sei.listar_series()
+```
+
+Configuração também por variáveis de ambiente: `SEIGOV_URL`,
+`SEIGOV_SIGLA_SISTEMA`, `SEIGOV_IDENTIFICACAO_SERVICO`, `SEIGOV_ID_UNIDADE`.
+
+SIP (permissões):
+
+```python
+from seigov import SipClient
+sip = SipClient(url="https://sei.<seu-orgao>.gov.br/sip/controlador_ws.php?servico=sip",
+                chave_acesso="...", id_sistema="...")
+perms = sip.listar_permissao(id_unidade="110000001")
+```
+
+## Estado
+
+Em desenvolvimento (Fase 0/1: core + consultas/listagens iniciais). Veja
+`PLAN.md` para o roteiro completo (escrita, SIP, helpers em lote/por-processo).
+
+## Licença
+
+GPL-3.0-or-later.

seigov-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "seigov"
+version = "0.1.0"
+description = "Cliente Python para os Web Services SOAP do SEI (Sistema Eletronico de Informacoes) e do SIP"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "GPL-3.0-or-later"
+authors = [
+  { name = "Andre Leite", email = "leite@castlab.org" },
+  { name = "Marcos Wasilew", email = "marcos.wasilew@gmail.com" },
+  { name = "Hugo Vasconcelos", email = "hugo.vasconcelos@ufpe.br" },
+  { name = "Carlos Amorin", email = "carlos.agaf@ufpe.br" },
+  { name = "Diogo Bezerra", email = "diogo.bezerra@ufpe.br" },
+  { name = "Julia Nascimento Barreto", email = "juliabarreto@gd.seplag.pe.gov.br" },
+]
+keywords = ["sei", "sip", "soap", "zeep", "govbr", "processo-eletronico"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business",
+]
+dependencies = [
+  "zeep>=4.2",
+  "pandas>=1.5",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "pytest-mock>=3", "build", "ruff"]
+
+[project.urls]
+Homepage = "https://github.com/StrategicProjects/seigov"
+Issues = "https://github.com/StrategicProjects/seigov/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/seigov"]
+# Os arquivos .wsdl dentro de src/seigov/ são incluídos automaticamente.
+
+[tool.hatch.build.targets.sdist]
+include = ["src/seigov", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+ignore = ["E731"]  # permite lambdas atribuidas a nomes (helpers curtos)

seigov-0.1.0/src/seigov/__init__.py

@@ -0,0 +1,40 @@
+"""seigov — cliente Python para os Web Services SOAP do SEI e do SIP.
+
+Genérico: funciona com qualquer instalação do SEI; informe o endpoint do seu
+servidor em :class:`SeiConfig` (ou via ``SEIGOV_URL``).
+
+Exemplo
+-------
+>>> from seigov import SeiClient
+>>> sei = SeiClient(
+...     url="https://sei.<seu-orgao>.gov.br/sei/ws/SeiWS.php",
+...     sigla_sistema="MEU_SISTEMA",
+...     identificacao_servico="minha-chave",
+... )
+>>> df = sei.consultar_procedimento("12.1.000000077-4")  # doctest: +SKIP
+
+Aviso: os Web Services do SEI são restritos por IP — só respondem de hosts
+autorizados.
+"""
+
+from __future__ import annotations
+
+from .client import SeiClient, encode_sin
+from .config import SeiConfig, SipConfig
+from .exceptions import SeiError, SeiFault
+from .parse import to_dataframe
+from .sip import SipClient
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "SeiClient",
+    "SipClient",
+    "SeiConfig",
+    "SipConfig",
+    "SeiError",
+    "SeiFault",
+    "to_dataframe",
+    "encode_sin",
+    "__version__",
+]