Curso Python para QA

Bem-vindo ao repositório oficial do curso Python para QA! Aqui você encontrará todos os códigos, exemplos práticos e exercícios desenvolvidos ao longo das aulas.

Este repositório também serve como ponto central para os alunos colaborarem, compartilha rem melhorias e submeterem suas próprias soluções e contribuições.

📁 Estrutura do Repositório

contribuicoes/: Diretório para armazenar códigos enviados pelos alunos via Pull Requests (PRs).

Nessa pasta deverá conter os códigos de todos os alunos que estão participando do curso. Ex: o aluno João silva terá uma pasta dentro da pasta contribuicoes chamada: contribuicoes/joao-silva com todos os códigos e contribuições do João separados por módulos.

Ao termino de cada exercicio, o aluno deverá subir o seu código para uma branch remota com o seu nome e a soluçao do exercicio proposto conforme o decorrer das aulas. Ao final de cada aula, os alunos deverão submeter um pull request para a branch master com as suas consideraçẽs.

aulas/: Contém os códigos, slides e exemplos apresentados em cada aula separadas por módulos. Ex.: aulas/modulo-1/codigos/aula-1

exercicios/: Códigos de referência e soluções para os exercícios propostos.

docs/: Documentação complementar, como slides e materiais de referência.

🛠 Pré-requisitos

Antes de começar a usar este repositório, certifique-se de ter as seguintes ferramentas instaladas:

• Git: Para clonar o repositório e versionar o código.
• Python 3.8+: A versão utilizada durante o curso.
• Docker (Opcional): Para quem deseja usar contêineres como ambiente de desenvolvimento.

🚀 Como Contribuir

Adoraríamos ver sua participação! Siga os passos abaixo para submeter um código, solução de exercício ou melhoria.

1️⃣ Clone o Repositório

$ git clone git@github.com:apsferreira/curso-python-para-qa.git
$ cd curso-python-para-qa

2️⃣ Crie uma Branch Sempre crie uma branch para sua contribuição, com um nome que descreva sua mudança:

$ git checkout -b meu-nome

3️⃣ Adicione Seu Código Submeta novos exercícios em contribuicoes/. Melhore códigos existentes ou adicione comentários para facilitar o aprendizado.

4️⃣ Faça um Commit Certifique-se de escrever uma mensagem de commit clara e descritiva:

$ git add .
$ git commit -m "Adiciona solução para o exercício de operadores lógicos"

5️⃣ Abra um Pull Request Envie sua contribuição para revisão:

Faça o push para o repositório remoto:

$ git push origin meu-nome

No GitHub, vá até a seção de Pull Requests e crie uma nova solicitação para a branch main.

📜 Regras para Contribuição

Para manter o repositório organizado, pedimos que você siga estas regras:

Padronização de Nomes: Nomeie arquivos e pastas de maneira descritiva, por exemplo: exercicio_tipos_dados.py

Qualidade do Código:

Siga as boas práticas do Python, como:

• Identação de 4 espaços.
• Uso de nomes descritivos para variáveis e funções.
• Comentários e Docstrings:
  • Adicione comentários explicativos para facilitar o entendimento de quem for estudar o código.
    • Exemplo:

        def soma(a, b):
            """Retorna a soma de dois números."""
            return a + b

🌟 Desafios Extras

Se quiser praticar ainda mais, confira a seção exercicios/ para desafios adicionais. Você pode submeter suas soluções ou propor novos desafios para os colegas.

Vamos construir juntos uma experiência de aprendizado incrível? 🎉