courts.tjrn.client.TJRNScraper

courts.tjrn.client.TJRNScraper(
    verbose=0,
    download_path=None,
    sleep_time=1.0,
    **kwargs,
)

Scraper for the Tribunal de Justica do Rio Grande do Norte (TJRN).

Uses the TJRN Elasticsearch-based JSON API at jurisprudencia.tjrn.jus.br.

Methods

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

cjsg

courts.tjrn.client.TJRNScraper.cjsg(
    pesquisa=None,
    paginas=None,
    numero_processo=None,
    id_classe=None,
    id_orgao_julgador=None,
    id_relator=None,
    id_colegiado=None,
    sistema=None,
    decisoes=None,
    jurisdicoes=None,
    grau=None,
    **kwargs,
)

Busca jurisprudencia no TJRN.

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_colegiado	str	ID do colegiado.	None
sistema	str	"PJE", "SAJ" ou vazio para todos.	None
decisoes	str	"Monocraticas", "Colegiadas", "Sentencas" ou vazio para todos.	None
jurisdicoes	str	"Tribunal de Justica", "Turmas Recursais" ou vazio para todos.	None
grau	str	"1" (primeiro), "2" (segundo) ou vazio para todos.	None
**kwargs		Filtros aceitos pelo schema :class:InputCJSGTJRN. Listados abaixo (todos opcionais; None = sem filtro): * data_julgamento_inicio / data_julgamento_fim (str): YYYY-MM-DD. Convertido para DD-MM-YYYY antes do envio ao backend.	{}

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.tjrn.client.TJRNScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    numero_processo=None,
    id_classe=None,
    id_orgao_julgador=None,
    id_relator=None,
    id_colegiado=None,
    sistema=None,
    decisoes=None,
    jurisdicoes=None,
    grau=None,
    **kwargs,
)

Download raw CJSG JSON responses from TJRN.

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

Returns

list List of raw JSON responses (one per page).

cjsg_parse

courts.tjrn.client.TJRNScraper.cjsg_parse(resultados_brutos)

Parse downloaded CJSG JSON responses.

Parameters

resultados_brutos : list List of raw JSON responses from the TJRN API.

Returns

pd.DataFrame

cpopg

courts.tjrn.client.TJRNScraper.cpopg(id_cnj)

Stub: first instance case consultation not implemented for TJRN.

cposg

courts.tjrn.client.TJRNScraper.cposg(id_cnj)

Stub: second instance case consultation not implemented for TJRN.