Filtro de BibTeX para Mapeamento Sistemático

Este é um utilitário Python para automatizar o processo de triagem de artigos em um Mapeamento Sistemático da Literatura (MSL).

O script lê um arquivo .bib mestre (exportado de ferramentas como Zotero ou Mendeley) e o divide automaticamente em três arquivos distintos, com base em tags emoji inseridas no campo keywords de cada referência.

Objetivo

O objetivo é criar um fluxo de trabalho rastreável para a seleção de estudos, separando artigos que passaram pelos Critérios de Inclusão (CI) daqueles que foram excluídos.

Recursos Principais

• Leitura Única: Processa um único arquivo .bib como fonte da verdade.
• Filtragem por Tags: Separa as referências com base em tags específicas no campo keywords:
  • ✅ (Incluído): Artigo que passou nos critérios de inclusão.
  • ❌ (Excluído): Artigo que falhou nos critérios de inclusão.
  • (Nenhum): Artigo pendente, que ainda precisa ser analisado.
• Saída Organizada: Gera três arquivos .bib limpos e separados na pasta data/processed/.
• Ambiente Gerenciado: Utiliza o Poetry para gerenciamento de dependências e ambiente virtual.

Estrutura do Projeto

projeto_revisao_sistematica/
│
├── data/
│   ├── raw/
│   │   ├── my_library_completa.bib  <-- soloque seu .bib mestre aqui
│   │   └── .gitkeep                 <-- (Arquivo vazio para o Git)
│   │
│   └── processed/
│       ├── artigos_incluidos.bib    <-- (Gerado)
│       ├── artigos_excluidos_ci.bib <-- (Gerado)
│       ├── artigos_pendentes.bib    <-- (Gerado)
│       └── .gitkeep
│
├── src/
│   ├── __init__.py
│   ├── bib_filter.py              <-- Módulo com a lógica de filtragem
│   └── main.py                    <-- Script principal para executar
│
├── .gitignore
├── poetry.lock                    <-- "Trava" as versões das bibliotecas
├── pyproject.toml                 <-- Configuração do projeto e dependências

Instalação e Configuração

1. Clonar o Repositório

git clone <url-do-seu-repositorio>
cd projeto_revisao_sistematica

2. Instalar Dependências

Este projeto usa o Poetry. Primeiro, instale o Poetry se ainda não o tiver.

Depois, na pasta raiz do projeto, instale as dependências:

poetry install

3. Configurar os Dados

Este é o passo mais importante.

Exporte sua biblioteca completa do Zotero/Mendeley como um arquivo .bib.

Coloque esse arquivo dentro da pasta data/raw/.

Renomeie o arquivo para my_library_completa.bib.

Nota: Se você preferir usar um nome de arquivo diferente, basta alterar a variável NOME_BIB_ENTRADA no topo do arquivo src/main.py.

4. Como Executar

Com o arquivo .bib no lugar, você pode rodar o script. O Poetry facilita isso:

• Abra seu terminal na pasta raiz do projeto.

• Execute o script main.py usando o poetry run:

poetry run python src/main.py