Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luiisp/enem-extractor
Um utilitário que extrai questões de provas do ENEM (ou similares).
https://github.com/luiisp/enem-extractor
Last synced: 13 days ago
JSON representation
Um utilitário que extrai questões de provas do ENEM (ou similares).
- Host: GitHub
- URL: https://github.com/luiisp/enem-extractor
- Owner: luiisp
- License: mit
- Created: 2024-11-16T02:19:43.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2024-11-21T03:01:39.000Z (about 2 months ago)
- Last Synced: 2024-12-18T23:45:41.519Z (17 days ago)
- Language: Python
- Homepage: https://pypi.org/project/enem/
- Size: 10.8 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Enem Extractor
[](https://github.com/luiisp/enem-extractor/blob/master/README.en.md)
[English version](https://github.com/luiisp/enem-extractor/blob/master/README.en.md)
> ⭐ Star this project to support!
**Enem Extractor** é uma ferramenta que extrai automaticamente questões de provas do ENEM (ou de provas semelhantes) e as converte em formatos como JSON.
🏓 [Veja uma prova extraida pelo Enem Extractor no mundo real aqui](https://luiisp.github.io/enem-extractor/)
## 🚀 Rodando
> Para rodar esse projeto você precisa ter o Python e o pip instalados. [Você pode baixar o Python aqui](https://www.python.org/downloads/).
### 1. Instale o Enem Extractor
> Para rodar o **Enem Extractor** via `pip`, execute o seguinte comando no terminal:
```bash
pip install enem
```
### 2. Extraia uma prova
Após a instalação, você pode extrair questões de uma prova em formato PDF. Supondo que você tenha um arquivo de prova do ENEM chamado `prova.pdf` no mesmo diretório, basta rodar:
```bash
enem prova.pdf
```
O script irá analisar a prova e extrair as questões, gerando uma pasta com um arquivo de saída em JSON com os dados extraídos e outros assets da prova. [Veja mais detalhes da saída do comando aqui](#saida).
### 3. Parâmetros adicionais
Você pode fornecer parâmetros adicionais para personalizar o processo de extração:
- `-f` ou `--file`: Caminho para o arquivo PDF da prova. (obrigatório)
- `-k` ou `--key`: Caminho para o arquivo PDF do gabarito. (opcional)
- `-o` ou `--output`: Caminho onde a pasta dos arquivos extraídos será criada. (opcional)
Exemplo de uso com parâmetros:
```bash
enem -f prova.pdf -k gabarito.pdf -o C:\documents
```
Este comando irá extrair as questões da prova `prova.pdf`, corrigir com o gabarito `gabarito.pdf` e salvar a pasta dos resultados em `C:\documents`.
## Saída
**[Aprenda sobre as saídas que da extração clicando aqui.](examples/output_example/readme.md)**
## 🔧 Como Contribuir
1. Faça um fork deste repositório.
2. Crie uma branch para a sua modificação (`git checkout -b feature/nova-funcionalidade`).
3. Faça suas alterações e commit (`git commit -am 'Adiciona nova funcionalidade'`).
4. Envie para o repositório original (`git push origin feature/nova-funcionalidade`).
5. Crie um novo Pull Request.
## 📜 Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para mais detalhes.
## 📚 Links Úteis
- [Documentação do PyMuPDF](https://pypi.org/project/PyMuPDF/)
- [Repositório](https://github.com/luiisp/enem-extractor)
- [English version of README](https://github.com/luiisp/enem-extractor/blob/master/README.en.md)
---
### 📢 Issues
Caso você tenha alguma dúvida, queira sugerir melhorias ou encontre problemas, fique à vontade para [abrir um issue](https://github.com/luiisp/enem-extractor/issues).
### 🌀 Subdependências
- [PyMuPDF](https://pypi.org/project/PyMuPDF/) - PDF parsing
- [Pillow](https://pypi.org/project/Pillow/) - Image processing
- [Colorama](https://pypi.org/project/colorama/) - Terminal colors
Created with ❤️ by [Pedro L. Dias](https://github.com/luiisp)