Skip to content

Latest commit

 

History

History
56 lines (42 loc) · 2.5 KB

README.md

File metadata and controls

56 lines (42 loc) · 2.5 KB
Raw

Projeto de resolução de exercício Python Brasil

Objetivo desse repositório é ajudar alunos aprendendo lógica de programação imperativa com Python a praticarem a validarem seu conhecimento. Esse repositório contém testes para os exercícios da wiki da Python Brasil

Instruções para quem vai apenas resolver os exercícios

Como o projeto está organizado?

Os pacotes do projeto possuem o mesmo nome de cada uma das sessões da lista de exercícios. Dentro de cada se encontra um arquivo python com um doctest que valida a correta implementação do problema.

Como fazer os exercícios?

Você deve forkar esse repositório e resolver cada exercício. Ao enviar para o seu repositório, o servidor de integração do Github (Github Action) vai corrigir seu exercício, informando se há falhas. Assim você consegue evoluir com a certeza de entender os conceitos ;)

Instruções para quem quer acrescentar exercícios no projeto

Como contribuir para o projeto?

  1. Forke o esse projeto;
  2. Crie um script para cada exercício, dentro da pasta referente a seção de exercícios da Python Brasil. Use o arquivo estrutura_sequencial/ex_01.py como modelo.
  3. Use o padrão de nomenclatura para os scritps ex_dd_nome_do_arquivo. Ou seja, comece sempre com o sufixo "ex_" seguindo do número do exercício. Assim a ordem alfabética dos arquivos ficará na mesma sequência que os exercícios da lista.
  4. Crie um doctest para o exercício;

Criar um ambiente virtual python e ativá-lo

python -m venv .venv --upgrade-deps && source .venv/bin/activate

Instalar as bibliotecas (libs) necessárias para o ambiente virtual recém criado

pip install -r requirements.txt

Exemplo de código para testar o exercício Olá Mundo ex_01.py:

    - name: Correção do Exercício 01 da seção de Estrutura Sequencial
      if: always()
      run: |
        python -m doctest -f estrutura_sequencial/ex_01.py

A seção nome é um texto livre. Já o final da última linha aponta para o endereço completo do script, incluindo o pacote (pasta) em que ele se encontra.

Testando localmente

Para rodar os testes de um módulo em sua máquina, rode:

python -m doctest -f <nome_do_pacote>/<nome_do_script>

Basta substituir o <nome_do_pacote> pelo nome do pacote e <nome_do_script> pelo nome do escript. Exemplo para rodar os testes do primeiro exercício:

python -m doctest -f estrutura_sequencial/ex_01.py