Selenium Lab — Caderno de Automação Web

Coleção de mini-projetos de Selenium WebDriver · Estudos pessoais

Repositório vivo com mini-projetos de automação web usando Selenium WebDriver, organizados em ordem crescente de complexidade. Cada pasta documenta um problema, uma solução comentada e o que aprendi no processo — uma espécie de caderno de laboratório do meu estudo da ferramenta, mantido fora da sala de aula como projeto pessoal.

---

Índice

• Visão Geral
• Estrutura do Repositório
• Stack Técnica
• Projetos
• Como Rodar
• Padrões e Convenções
• Roadmap
• Autor

---

Visão Geral

O Selenium Lab reúne pequenas automações web independentes, cada uma resolvendo um problema concreto e introduzindo um ou dois conceitos novos da biblioteca. A proposta é registrar a curva de aprendizado de forma pública e auditável — em vez de uma lista solta de scripts, há uma progressão clara, do "abrir o navegador e extrair dados" até suítes de teste rodando em CI.

Cada projeto entrega:

Item	Descrição
README.md	Contexto, objetivo, abordagem e o que foi aprendido
demo.gif	Demonstração curta da automação em execução
Código-fonte	Scripts comentados, com responsabilidades separadas
requirements.txt	Dependências específicas do projeto

Nota: Este repositório é estritamente acadêmico. Nenhuma automação aqui presente coleta dados sensíveis, viola termos de uso ou opera em escala que possa sobrecarregar serviços de terceiros. Sites usados como alvo são páginas didáticas de domínio público (ex.: realpython.github.io/fake-jobs).

---

Estrutura do Repositório

selenium-lab/
├── README.md                       ← Índice geral (este arquivo)
├── requirements.txt                ← Dependências comuns
├── .gitignore
├── LICENSE
│
└── 01-coletor-manchetes/               ← Extração e filtragem de vagas em página estática
    ├── README.md
    ├── ColetorManchetes.py
    ├── demo.gif
    └── requirements.txt

Conforme novos projetos forem concluídos, esta árvore cresce — seguindo a numeração 02-, 03-, e assim por diante.

---

Stack Técnica

Categoria	Ferramenta
Linguagem	Python 3.11+
Automação	Selenium WebDriver 4.x
Driver	ChromeDriver
Ambiente	venv

Outras ferramentas (pytest, Page Object Model, GitHub Actions) serão incorporadas conforme o roadmap avança.

---

Projetos

Legenda — ✓ concluído · ~ em andamento · · planejado

#	Projeto	Conceitos Centrais	Status
01	coletor-Manchetes	Localizadores CSS, find_elements, modelagem com classe, extração e filtragem de dados	✓
02	coletor-vagas	Localizadores CSS, find_elements, modelagem com classe, extração e filtragem de dados	✓

Cada pasta é independente e possui seu próprio README.md com instruções específicas, capturas de tela e GIF demonstrativo. Os próximos projetos previstos estão listados na seção Roadmap.

---

Como Rodar

Pré-requisitos: Python 3.11+ e Google Chrome instalados.

Clone o repositório e acesse a pasta do projeto desejado:

git clone https://github.com/AugustoEng/selenium-lab.git
cd selenium-lab/01-coletor-vagas

Crie um ambiente virtual e instale as dependências:

python -m venv .venv
source .venv/bin/activate          # Linux/macOS
.venv\Scripts\activate             # Windows

pip install -r requirements.txt

Execute o script principal:

python ColetorVagas.py

Cada projeto pode ter dependências e formas de execução próprias — sempre consulte o README.md da pasta antes de rodar.

---

Padrões e Convenções

• Commits: seguem o padrão Conventional Commits (feat:, fix:, docs:, refactor:)

---

Autor

Nome
Guilherme Augusto dos Santos

Curso: Engenharia de Software · Universidade Católica de Brasília
Foco de estudo: Automação web, qualidade de software e desenvolvimento back-end

---

Caderno mantido por curiosidade e teimosia — Universidade Católica de Brasília · 2026