Skip to content

Latest commit

 

History

History
148 lines (115 loc) · 4.94 KB

File metadata and controls

148 lines (115 loc) · 4.94 KB

Roadmap do Python Study Guide

🇺🇸 English · 🇧🇷 Português · 🇪🇸 Español

Este roadmap acompanha tanto a trilha educacional quanto a fundação do repositório que a sustenta. A numeração das fases representa a sequência de aprendizagem pretendida, mas o trabalho no repositório pode antecipar a preparação de seções posteriores quando isso ajudar a estabelecer padrões úteis para todo o projeto.

Legenda de status

  • Concluída: o escopo planejado está disponível e revisado.
  • Em andamento: já existe material útil, mas o escopo planejado ainda não foi encerrado.
  • Planejada: a fase ainda não começou como uma seção completa de aprendizagem.

Progresso atual

Fase Status Resultado atual
0. Fundação do projeto Concluída Fundação disponível, auditada e oficialmente concluída
1. Fundamentos Planejada Conteúdo ainda não iniciado
2. Textos e números Planejada Conteúdo ainda não iniciado
3. Coleções Planejada Conteúdo ainda não iniciado
4. Fluxo do programa Planejada Conteúdo ainda não iniciado
5. Funções Planejada Conteúdo ainda não iniciado
6. Comentários, documentação e código limpo Em andamento O capítulo de comentários está completo e a trilha da seção está organizada
7. Erros, arquivos e módulos Planejada Conteúdo ainda não iniciado
8. Biblioteca padrão Planejada Conteúdo ainda não iniciado
9. Bibliotecas externas Planejada Conteúdo ainda não iniciado
10. Projetos práticos Planejada Conteúdo ainda não iniciado

A Fase 0 está concluída, portanto o desenvolvimento da trilha pode continuar pela Fase 1 sem perder os padrões já estabelecidos na seção-piloto da Fase 6. A Fase 6 permanece em andamento e poderá continuar em paralelo à sequência principal quando for apropriado.

Fase 0: Fundação do projeto

Itens concluídos

  • READMEs principais multilíngues
  • Estrutura inicial escalável
  • Guias de contribuição multilíngues
  • Templates de pull request e issues no GitHub
  • Padrões da comunidade e orientações para relatos
  • Formato editorial consistente para os capítulos
  • Licença MIT
  • Registros de autoria e manutenção
  • Fluxo baseado em pull requests e branch main protegida
  • Instruções do repositório para colaboradores e agentes de IA
  • Guia de desenvolvimento responsável assistido por IA
  • Roadmap e documentação da estrutura em três idiomas
  • Validações automáticas para arquivos Python, exemplos aprovados, links internos e estrutura do repositório
  • Identidade visual original e recursos do repositório
  • Auditoria final de navegação, terminologia, acessibilidade e status
  • Marcação oficial da Fase 0 como concluída

Acompanhamento planejado e não bloqueante

  • Refinar e substituir os recursos visuais por exportações de alta qualidade após a conclusão do enquadramento final da logomarca.

Fase 1: Fundamentos

  • Como o Python executa um programa
  • print() e input()
  • Variáveis e nomes
  • Tipos de dados nativos
  • type() e isinstance()
  • Conversão de tipos

Fase 2: Textos e números

  • Criação e indexação de strings
  • Métodos comuns de strings
  • int, float e bool
  • round(), abs(), min(), max() e sum()

Fase 3: Coleções

  • Listas
  • Tuplas
  • Dicionários
  • Conjuntos
  • Indexação, fatiamento, inclusão, atualização e remoção de valores

Fase 4: Fluxo do programa

  • if, elif e else
  • for e while
  • range(), enumerate() e zip()
  • break, continue e desenho de loops

Fase 5: Funções

  • def
  • Parâmetros e argumentos
  • Valores de retorno
  • Escopo
  • Type hints
  • Valores padrão
  • *args e **kwargs
  • Funções trabalhando juntas
  • Fluxo de dados entre funções

Fase 6: Comentários, documentação e código limpo

Consulte a trilha de aprendizagem da seção.

  • Quando e por que comentar
  • Quando não comentar
  • Comentários úteis e prejudiciais
  • Docstrings
  • Nomes significativos e código autoexplicativo
  • TODO, FIXME, NOTE e marcadores relacionados
  • Comentários versus logging
  • PEP 8 e legibilidade

Fase 7: Erros, arquivos e módulos

  • try, except, else e finally
  • raise e exceções personalizadas
  • open() e with
  • TXT, CSV e JSON
  • Imports, módulos e pacotes

Fase 8: Biblioteca padrão

  • pathlib
  • datetime
  • json
  • csv
  • logging
  • collections
  • itertools
  • decimal
  • os e shutil

Fase 9: Bibliotecas externas

  • pandas
  • openpyxl
  • requests
  • pytest

Fase 10: Projetos práticos

  • Calculadora de médias
  • Cadastro de usuários
  • Controle de despesas
  • Analisador de CSV
  • Gerador de relatórios
  • Organizador de arquivos
  • Fluxo fictício de conciliação
  • Fluxo simulado de automação