Como usar GitHub Actions para automatizar testes em projetos Python

O GitHub Actions é uma ferramenta poderosa que permite automatizar fluxos de trabalho diretamente no GitHub, facilitando a integração contínua e a entrega contínua (CI/CD). Neste manual, vamos aprender como usar o GitHub Actions para automatizar testes em projetos Python.

Pré-requisitos

• Conta no GitHub.
• Repositório com um projeto Python.
• Testes escritos usando um framework como unittest ou pytest.

Passo a Passo

1. Criar um arquivo de workflow

No seu repositório, crie um diretório chamado .github/workflows. Dentro desse diretório, crie um arquivo YAML, por exemplo, python-tests.yml.

mkdir -p .github/workflows
nano .github/workflows/python-tests.yml

2. Configurar o workflow

Adicione o seguinte conteúdo ao arquivo python-tests.yml:

name: Python Tests

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: '3.8'

    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt

    - name: Run tests
      run: |
        pytest

3. Comitar e enviar para o GitHub

Depois de configurar o arquivo, comite suas alterações e envie para o repositório:

git add .github/workflows/python-tests.yml
git commit -m "Adicionar workflow para testes Python"
git push origin main

Conclusão

Após enviar as alterações, o GitHub Actions irá automaticamente executar os testes sempre que houver um push ou pull request na branch main. Você pode verificar o status dos testes na aba Actions do seu repositório.

Dica: Utilize badges no README do seu projeto para mostrar o status dos testes de maneira visual para os colaboradores.