1
resposta

[Sugestão] engenharia

Nesta aula aprendi :

Revise os conceitos de código limpo e a PEP8.
Relembre as principais diretrizes que tornam o código mais legível e padronizado.

Corrija problemas de indentação e nomenclatura.
Nomes de variáveis e funções devem ser claros, objetivos e seguir o padrão snake_case.

Use comentários e docstrings.
Documente suas funções explicando o propósito, os parâmetros e o valor de retorno.

Organize as importações.
Todas as bibliotecas devem ser importadas no início do arquivo, seguindo a ordem padrão (bibliotecas padrão, de terceiros e locais).

Utilize ferramentas de validação.
Rode PyCodeStyle ou Flake8 para verificar se o seu código está de acordo com a PEP8.

Refatore funções grandes.
Quebre funções muito longas ou complexas em partes menores e mais simples de entender.

Configure o ambiente de desenvolvimento no Google Colab.
Certifique-se de que tudo roda corretamente nesse ambiente.

Estruture seu projeto.
Organize os arquivos em pastas específicas: data/, notebooks/, tests/, src/, models/, doc/.

Crie os arquivos de configuração.
Use requirements.txt para listar dependências e setup.py para facilitar a instalação e distribuição do projeto.

Implemente testes unitários.
Garanta que suas funções refatoradas estão funcionando corretamente com testes automatizados.

Documente seu projeto.
Descreva a estrutura, decisões tomadas e instruções para uso e manutenção.

1 resposta

Olá, Ubirajara! Como vai?

Que aprendizado completo e bem estruturado!

Sua revisão mostra atenção aos princípios fundamentais de código limpo, organização prática ao abordar a estrutura de projetos e maturidade técnica ao destacar ferramentas de validação e testes automatizados como parte essencial do processo.

Uma sugestão de melhoria seria incluir exemplos curtos de boas práticas aplicadas, como uma função com docstring bem escrita ou um trecho de código refatorado, para ilustrar ainda mais os conceitos abordados.

Fico à disposição! E se precisar, conte sempre com o apoio do fórum.

Abraço e bons estudos!

AluraConte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!