courts.tjpe.client.TJPEScraper

courts.tjpe.client.TJPEScraper()

Scraper for the Tribunal de Justica de Pernambuco.

Methods

Name	Description
cjsg	Busca jurisprudencia no TJPE.
cjsg_download	Baixa as paginas brutas do cjsg do TJPE.
cjsg_parse	Parseia as paginas brutas de :meth:cjsg_download em DataFrame.
cpopg	Stub: first instance case consultation not implemented for TJPE.
cposg	Stub: second instance case consultation not implemented for TJPE.

cjsg

courts.tjpe.client.TJPEScraper.cjsg(
    pesquisa=None,
    paginas=None,
    data_julgamento_inicio=None,
    data_julgamento_fim=None,
    relator=None,
    classe=None,
    assunto=None,
    meio_tramitacao=None,
    tipo_decisao='acordaos',
    **kwargs,
)

Busca jurisprudencia no TJPE.

Wrapper trivial (download → parse) sobre :meth:cjsg_download. O backend e JSF/RichFaces: o fluxo carrega o ViewState da consulta.xhtml e propaga entre requests; a paginacao usa AJAX RichFaces em resultado.xhtml retornando XML envolto em <![CDATA[HTML]]>.

Parameters

Name	Type	Description	Default
pesquisa	str	Termo de busca livre (ementa). Aceita os aliases deprecados query / termo.	None
paginas	int | list | range | None	Paginas 1-based; None baixa todas. Default None.	None
data_julgamento_inicio	str	Data inicial de julgamento (DD/MM/AAAA, DD-MM-AAAA, AAAA-MM-DD, AAAA/MM/DD, :class:datetime.date ou :class:datetime.datetime).	None
data_julgamento_fim	str	Data final de julgamento (mesmos formatos de data_julgamento_inicio).	None
relator	str	Nome do relator (deve bater exatamente com o valor do dropdown do formulario).	None
classe	str	Codigo CNJ da classe. Aceita o alias deprecado classe_cnj.	None
assunto	str	Codigo CNJ do assunto. Aceita o alias deprecado assunto_cnj.	None
meio_tramitacao	str	Filtro de meio de tramitacao (ex.: "ELETRONICO").	None
tipo_decisao	str	"acordaos" (default), "monocraticas" ou "todos". Quando "todos", o backend marca os dois checkboxes e o fluxo passa pela pagina de escolha (escolhaResultado.xhtml).	'acordaos'

Todos os filtros do schema :class:InputCJSGTJPE estao listados acima como parametros nomeados. O **kwargs so e exposto para absorver aliases deprecados (listados abaixo) e qualquer kwarg desconhecido vira TypeError via raise_on_extra_kwargs.

Aliases deprecados (popados com DeprecationWarning antes do pydantic): * query / termo -> pesquisa * classe_cnj -> classe * assunto_cnj -> assunto * data_inicio / data_fim -> data_julgamento_inicio / _fim * data_julgamento_de / _ate -> data_julgamento_inicio / _fim

Raises

Name	Type	Description
	TypeError	Quando um kwarg desconhecido e passado.
	ValueError	Quando um canonico e seu alias deprecado sao passados simultaneamente.
	ValidationError	Quando um filtro tem formato invalido (ex.: data fora dos formatos aceitos, tipo_decisao fora do enum).

Returns

Name	Type	Description
	pd.DataFrame	pd.DataFrame: Uma linha por decisao. Colunas canonicas: processo, classe, assunto, relator, orgao_julgador, data_julgamento, data_publicacao, ementa, acordao, meio_tramitacao, url_inteiro_teor.

Exemplo

import juscraper as jus tjpe = jus.scraper(“tjpe”) df = tjpe.cjsg(“dano moral”, paginas=range(1, 3), … tipo_decisao=“acordaos”)

See also

— schema pydantic e a fonte da verdade dos filtros aceitos.

cjsg_download

courts.tjpe.client.TJPEScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    data_julgamento_inicio=None,
    data_julgamento_fim=None,
    relator=None,
    classe=None,
    assunto=None,
    meio_tramitacao=None,
    tipo_decisao='acordaos',
    **kwargs,
)

Baixa as paginas brutas do cjsg do TJPE.

Aceita os mesmos filtros de :meth:cjsg; veja la a lista completa.

Returns

Name	Type	Description
list	list	Lista de strings HTML brutas, uma por pagina.

cjsg_parse

courts.tjpe.client.TJPEScraper.cjsg_parse(raw_pages)

Parseia as paginas brutas de :meth:cjsg_download em DataFrame.

cpopg

courts.tjpe.client.TJPEScraper.cpopg(id_cnj)

Stub: first instance case consultation not implemented for TJPE.

cposg

courts.tjpe.client.TJPEScraper.cposg(id_cnj)

Stub: second instance case consultation not implemented for TJPE.