dadosabertosdefeira / tcm-ba Goto Github PK

View Code? Open in Web Editor NEW

5.0 2.0 0.0 350 KB

Raspagem de dados do TCM-BA 📄

Home Page: https://tcm.ba.gov.br

License: MIT License

Python 100.00%

dados-abertos bahia tcm-ba hacktoberfest

tcm-ba's Introduction

Dados do TCM-BA

Aqui você encontrará raspadores para o site do Tribunal de Contas dos Municípios da Bahia.

Raspadores disponíveis:

Documentos da consulta pública
Processos

ATENÇÃO: o acesso por máquina é um direito garantido pela Lei de Acesso à Informação. Mas para evitar sobrecarga nos servidores do órgão, certifique-se de baixar os arquivos já disponibilizados ao invés de raspar ou, se possível, disponibilizar os arquivos que você tenha baixado.

Esse repositório está sujeito ao código de conduta e guia de contribuição do Dados Abertos de Feira disponíveis aqui.

Raspadores e Dados

Visite nosso Kaggle para baixar os dados raspados por nós ou a nossa página de buscas de dados.

Para rodar o ambiente de desenvolvimento utilize o Poetry.

Processos

O Tribunal lista todos os processos na página de jurisdicação. Veja mais detalhes sobre os processos listados lá e os detalhes da consulta processual.

Desenvolvimento

Para rodar o spider:

scrapy crawl processos -o processos-tcmba.json

Documentos da consulta pública

O Tribunal de Contas dos Municípios da Bahia tem uma consulta pública para todos os documentos submetidos pelas prefeituras através do SIGA.

Os municípios podem submeter esses dados até 40 dias depois do final do mês.

Passo a passo para acesso aos documentos

Passo 1: filtros

Para carregar a tabela "Prestações de Contas" você precisa selecionar alguns filtros:

Periodicidade PCO:
- Anual
- Mensal
Competência: filtro de mês ou ano
Tipo: pode deixar em branco (?)
Munícipio: Feira de Santana (podemos pensar em criar um pacote para raspar por município, assim outras cidades podem se beneficiar da solução)
Unidade Jurisdicionada: todas (teremos que selecionar uma por uma no próximo passo)
Status: pode deixar em branco (esperamos que venham todas)

Passo 2: Prestações de Contas

Aqui irão aparecer os resultados das opções selecionadas no Passo 1. Geralmente uma lista com as unidades jurisdicionadas e a competência (mês/ano).

Passo 3: Resultados

Ao clicar em uma unidade jurisdicionada (do passo anterior), temos acesso a lista de documentos, paginada a cada 10 resultados:

É interessante utilizar os filtros para coletar a categoria de um grupo de documentos:

Essas categorias não estão disponíveis na tabela de resultados mas são interessantes como filtros para o cidadão.

Desenvolvimento

Para rodar o spider:

scrapy crawl consulta_publica -a periodicidade=mensal -a competencia=08/2018 -a cidade="feira de santana"
scrapy crawl consulta_publica -a periodicidade=anual -a competencia=2018 -a cidade="são gonçalo"

tcm-ba's People

Contributors

Stargazers

Watchers

tcm-ba's Issues

Publicar pacote no Pypi

Assim nós e outras pessoas poderão utilizar os spiders em outros projetos. :)

Permitir filtragem por unidade no raspador de documentos

Atualmente recebemos o argumento porém ao tentar escolher uma unidade recebemos o erro:

Traceback (most recent call last):
  File "/usr/local/lib/python3.8/site-packages/scrapy/utils/defer.py", line 120, in iter_errback
    yield next(it)
  File "/usr/local/lib/python3.8/site-packages/scrapy/utils/python.py", line 353, in __next__
    return next(self.data)
  File "/usr/local/lib/python3.8/site-packages/scrapy/utils/python.py", line 353, in __next__
    return next(self.data)
  File "/usr/local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 56, in _evaluate_iterable
    for r in iterable:
  File "/usr/local/lib/python3.8/site-packages/scrapy/spidermiddlewares/offsite.py", line 29, in process_spider_output
    for x in result:
  File "/usr/local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 56, in _evaluate_iterable
    for r in iterable:
  File "/usr/local/lib/python3.8/site-packages/scrapy/spidermiddlewares/referer.py", line 342, in <genexpr>
    return (_set_referer(r) for r in result or ())
  File "/usr/local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 56, in _evaluate_iterable
    for r in iterable:
  File "/usr/local/lib/python3.8/site-packages/scrapy/spidermiddlewares/urllength.py", line 40, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/usr/local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 56, in _evaluate_iterable
    for r in iterable:
  File "/usr/local/lib/python3.8/site-packages/scrapy/spidermiddlewares/depth.py", line 58, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/usr/local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 56, in _evaluate_iterable
    for r in iterable:
  File "/usr/local/lib/python3.8/site-packages/tcmba/spiders/consulta_publica.py", line 184, in get_search_results
    unit_payload = unit_payloads.pop(0)
IndexError: pop from empty list

Coletar remuneração dos servidores públicos

Página: https://www.tcm.ba.gov.br/portal-da-cidadania/pessoal/

Coletar obras de um município

Página: https://www.tcm.ba.gov.br/portal-da-cidadania/obras/?municipio=2910800

WIP aqui.

Paginação

Salvar valores normalizados no item

Unidades, categorias e nomes de arquivos são normalizados na hora da criação das pastas e dos arquivos mas não nos itens, deixando o valor que está nos itens ligeiramente diferente dos que está no disco. Pra facilitar a criação de scripts combinando os dois (e reduzir inconsistências no código) podemos salvar os valores nos itens já normalizados e utilizá-los normalmente na criação dos arquivos.

Publicar pacote no pypi

Dessa forma outros projetos poderão utilizar os spiders.

Critérios de aceitação:

Ao criar uma release o pacote deve ser publicado no pypi

Salvar os arquivos em pastas de acordo com os campos utilizados

Dessa forma as pastas não terão tantos arquivos e a buscar ficará facilitada. Exemplo:

files/
    feira-de-santana/
        08.2018/
            prefeitura/

Erro ao buscar valor anual de uma cidade com acento no nome

Traceback (most recent call last):
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/utils/defer.py", line 120, in iter_errback
    yield next(it)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/utils/python.py", line 353, in __next__
    return next(self.data)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/utils/python.py", line 353, in __next__
    return next(self.data)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/offsite.py", line 29, in process_spider_output
    for x in result:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/referer.py", line 340, in <genexpr>
    return (_set_referer(r) for r in result or ())
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/urllength.py", line 37, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/depth.py", line 58, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/workspace/documentos-tcmba/tcmba/spiders/consulta_publica.py", line 297, in get_detailed_results
    filename=f"{uuid4()}-{self.normalize_text(texts[1])}",
IndexError: list index out of range

Ao printar os valores:

[<Selector xpath='./td' data='<td colspan="5">No records found.</td>'>]  # columns
['No records found.']  # texts

Desconfio que seja por causa do acento. Ao inspecionar o elemento encontro SÃO GONÇALO DOS CAMPOS mas no nosso crawler é exibido o parâmetro SAO GONCALO DOS CAMPOS .

Adicionar informações dos argumentos ao item do documento

Atualmente temos as informações de periodicidade, mês e ano dos argumentos e no filepath mas não no JSON gerado a partir do item. Seria bom ter essas informações lá pra evitar o parseamento do filepath.

Erro ao buscar por dados indisponíveis

Ao tentar fazer uma consulta anual que não possui dados ainda o seguinte erro é retornado:

    return next(self.data)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/offsite.py", line 29, in process_spider_output
    for x in result:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/referer.py", line 340, in <genexpr>
    return (_set_referer(r) for r in result or ())
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/urllength.py", line 37, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/spidermiddlewares/depth.py", line 58, in <genexpr>
    return (r for r in result or () if _filter(r))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/core/spidermw.py", line 62, in _evaluate_iterable
    for r in iterable:
  File "/home/ana/workspace/documentos-tcmba/tcmba/spiders/consulta_publica.py", line 180, in get_search_results
    yield FormRequest(**unit_payload)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/http/request/form.py", line 31, in __init__
    querystr = _urlencode(items, self.encoding)
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/http/request/form.py", line 71, in _urlencode
    values = [(to_bytes(k, enc), to_bytes(v, enc))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/http/request/form.py", line 71, in <listcomp>
    values = [(to_bytes(k, enc), to_bytes(v, enc))
  File "/home/ana/.local/lib/python3.8/site-packages/scrapy/utils/python.py", line 106, in to_bytes
    raise TypeError('to_bytes must receive a str or bytes '
TypeError: to_bytes must receive a str or bytes object, got NoneType
2021-03-11 17:47:27 [scrapy.core.engine] INFO: Closing spider (finished)
2021-03-11 17:47:27 [scrapy.statscollectors] INFO: Dumping Scrapy stats:
{'downloader/request_bytes': 3268,
 'downloader/request_count': 2,
 'downloader/request_method_count/GET': 1,
 'downloader/request_method_count/POST': 1,
 'downloader/response_bytes': 1016725,
 'downloader/response_count': 2,
 'downloader/response_status_count/200': 2,
 'elapsed_time_seconds': 15.951255,
 'finish_reason': 'finished',

Para reproduzir basta executar o comando com periodicidade anual e ano 2020.

Adicionar filtros

O usuário poderá filtrar pelos mesmos campos da interface:

Periodicidade (anual ou mensal - deverá informar ano ou mês/ano)
Cidade
Órgão (opcional - o padrão seria "todos")

Exemplo: TERMO DE APOSTILAMENTO 023-2020-1123-3.pdf

Existem apenas um desse no portal (seguindo os parâmetros):

Itens duplicados:

{
    "category": "Documentos Adicionais",
    "filename": "abfd75c5-f600-4176-985d-5da0fa0e7ee0-TERMO DE APOSTILAMENTO 023-2020-1123-3.pdf",
    "original_filename": "TERMO DE APOSTILAMENTO 023-2020-1123-3.pdf",
    "inserted_by": "FLORIEDNA DA SILVA GOMES",
    "inserted_at": "20/10/2020",
    "unit": "Funda\u00e7\u00e3o Hospitalar de Feira de Santana",
    "crawled_at": "2021-04-09 03:42:49",
    "month": "09",
    "year": "2020",
    "period": "Mensal",
    "filepath": "/files/feira-de-santana/2020/mensal/09/Funda\u00e7\u00e3o Hospitalar de Feira de Santana/Documentos Adicionais/"
}

{
    "category": "Documentos Adicionais",
    "filename": "ff815183-b82c-49d6-84de-aef10b8968a9-TERMO DE APOSTILAMENTO 023-2020-1123-3.pdf",
    "original_filename": "TERMO DE APOSTILAMENTO 023-2020-1123-3.pdf",
    "inserted_by": "FLORIEDNA DA SILVA GOMES", 
    "inserted_at": "20/10/2020", 
    "unit": "Funda\u00e7\u00e3o Hospitalar de Feira de Santana", 
    "crawled_at": "2021-04-09 03:43:18", 
    "month": "09", 
    "year": "2020", 
    "period": "Mensal", 
    "filepath": "/files/feira-de-santana/2020/mensal/09/Funda\u00e7\u00e3o Hospitalar de Feira de Santana/Documentos Adicionais/"
}

dadosabertosdefeira / tcm-ba Goto Github PK

tcm-ba's Introduction

Dados do TCM-BA

Raspadores e Dados

Processos

Desenvolvimento

Documentos da consulta pública

Passo a passo para acesso aos documentos

Passo 1: filtros

Passo 2: Prestações de Contas

Passo 3: Resultados

Desenvolvimento

tcm-ba's People

Contributors

Stargazers

Watchers

tcm-ba's Issues

Recommend Projects

Recommend Topics

Recommend Org