courts.tjpb.client.TJPBScraper

courts.tjpb.client.TJPBScraper()

Scraper for the Tribunal de Justica da Paraiba (TJPB).

Uses the PJe jurisprudence search at pje-jurisprudencia.tjpb.jus.br. Built on the same platform developed by TJRN (Laravel + Elasticsearch).

Methods

Name Description
cjsg Busca jurisprudencia no TJPB.
cjsg_download Download raw CJSG JSON responses from TJPB.
cjsg_parse Parse downloaded CJSG JSON responses.
cpopg Stub: first instance case consultation not implemented for TJPB.
cposg Stub: second instance case consultation not implemented for TJPB.

cjsg

courts.tjpb.client.TJPBScraper.cjsg(
    pesquisa=None,
    paginas=None,
    numero_processo=None,
    id_classe=None,
    id_orgao_julgador=None,
    id_relator=None,
    id_origem='8,2',
    decisoes=False,
    **kwargs,
)

Busca jurisprudencia no TJPB.

Parameters

Name Type Description Default
pesquisa str Termo de busca livre (busca na ementa). None
paginas int | list | range | None Paginas 1-based; None baixa todas. Default None. None
numero_processo str Numero CNJ do processo. Aceita o alias deprecado nr_processo. None
id_classe str ID da classe judicial. Aceita o alias deprecado id_classe_judicial (refs #129). None
id_orgao_julgador str ID do orgao julgador. None
id_relator str ID do relator. None
id_origem str Filtro de origem. "8,2" para todos (default), "8" para Turmas Recursais, "2" para Tribunal Pleno/Camaras. '8,2'
decisoes bool Se True, inclui decisoes monocraticas. False
**kwargs Filtros aceitos pelo schema :class:InputCJSGTJPB. Listados abaixo (todos opcionais; None = sem filtro): * data_julgamento_inicio / data_julgamento_fim (str | date | datetime): DD/MM/YYYY, DD-MM-YYYY, YYYY-MM-DD ou YYYY/MM/DD. Convertido para YYYY-MM-DD antes do envio ao backend. O backend filtra por uma data interna de disponibilizacao (nao por dt_ementa); o cliente aplica um post-filter local sobre data_julgamento para garantir que a janela pedida bate com o que e devolvido (refs #195). {}

Aliases deprecados (popados com DeprecationWarning antes do pydantic): * query / termo -> pesquisa * nr_processo -> numero_processo * id_classe_judicial -> id_classe * 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.

Returns

Name Type Description
pd.DataFrame pd.DataFrame: DataFrame com as decisoes.

See also

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

cjsg_download

courts.tjpb.client.TJPBScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    numero_processo=None,
    id_classe=None,
    id_orgao_julgador=None,
    id_relator=None,
    id_origem='8,2',
    decisoes=False,
    **kwargs,
)

Download raw CJSG JSON responses from TJPB.

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

Returns

Name Type Description
list list Lista de respostas JSON cruas (uma por pagina).

cjsg_parse

courts.tjpb.client.TJPBScraper.cjsg_parse(resultados_brutos)

Parse downloaded CJSG JSON responses.

Returns

Name Type Description
pd.DataFrame pd.DataFrame: DataFrame com as decisoes.

cpopg

courts.tjpb.client.TJPBScraper.cpopg(id_cnj)

Stub: first instance case consultation not implemented for TJPB.

cposg

courts.tjpb.client.TJPBScraper.cposg(id_cnj)

Stub: second instance case consultation not implemented for TJPB.