🐍 Python Backend - Curso Completo

Curso completo de Python do zero ao avançado, com foco em desenvolvimento backend.

🎯 Sobre o Curso

Este curso oferece uma trilha completa de aprendizado em Python, desde os conceitos básicos até tópicos avançados de backend development.

✨ Destaques

✅ Aulas Completas - Material didático detalhado
✅ Slides Profissionais - Apresentações com Marp
✅ Quizzes Interativos - Teste seus conhecimentos
✅ Exercícios Práticos - Mão na massa
✅ Projetos Reais - Construa seu portfólio

🚀 Começando

Pré-requisitos

Python 3.11+
Poetry
Node.js (para Marp CLI)

Instalação

# Clonar repositório
git clone https://github.com/ricardotecpro/ads_spec_backend_com_python.git
cd ads_spec_backend_com_python

# Instalar Poetry (se não tiver)
pip install poetry

# Instalar dependências
poetry install

# Instalar Marp CLI (opcional, para slides)
npm install -g @marp-team/marp-cli

📚 Comandos Disponíveis

Com Poetry/Taskipy

# Servidor local
poetry run task serve

# Build do site
poetry run task build

# Gerar slides
poetry run task slides

# Executar testes
poetry run task test

# Deploy (com Mike)
poetry run task deploy

Com Invoke

# Limpar arquivos gerados
invoke clean

# Build completo (slides + site)
invoke build-all

# Servidor local
invoke serve-all

# Atualizar dependências
invoke update-deps

# Ver todos os comandos
invoke help-tasks

📁 Estrutura do Projeto

ads_spec_backend_com_python/
├── aulas/                      # Conteúdo das aulas
│   ├── assets/                # Imagens, CSS, JS
│   ├── aulas/                 # Aulas (Python Básico, Avançado)
│   ├── quiz/                  # Quizzes interativos
│   ├── setup/                 # Guias de instalação
│   └── index.md               # Homepage
├── slides/                    # Slides Marp
│   ├── brutos/               # Slides fonte (.md)
│   │   ├── python-theme.css # Tema customizado
│   │   └── *.md             # Slides
│   └── html/                 # Slides gerados (.html)
├── hooks/                     # Hooks customizados MkDocs
│   ├── copy_slides.py        # Copia slides para site
│   └── quiz_hook.py          # Processa quizzes
├── .github/workflows/         # CI/CD
│   ├── deploy.yml            # Deploy automático
│   └── test.yml              # Testes automáticos
├── pyproject.toml            # Poetry + Taskipy
├── tasks.py                  # Invoke tasks
└── mkdocs.yml                # Configuração MkDocs

🎨 Tecnologias

Documentação

MkDocs - Gerador de sites estáticos
Material for MkDocs - Tema moderno
Mike - Versionamento de docs

Slides

Marp - Slides profissionais em Markdown
Tema Python - Cores oficiais Python.org

Automação

Poetry - Gerenciamento de dependências
Taskipy - Tasks simples
Invoke - Tasks complexas

Plugins

mkdocs-quiz - Quizzes interativos
git-authors - Autores por arquivo
git-revision-date - Data de modificação
glightbox - Lightbox para imagens
macros - Variáveis e macros

CI/CD

GitHub Actions - Deploy e testes automáticos

🎓 Conteúdo

Instalação

Windows Setup
VSCode Configuration

Python Básico

Sintaxe
Tipos de dados
Estruturas de controle
Funções
Módulos

Python Avançado

Ambientes virtuais
Gerenciamento de pacotes (Poetry)
POO avançada
Decoradores
Context managers

Projetos

API REST com FastAPI
CRUD completo
Autenticação
Deploy

🧪 Testes

# Executar testes
poetry run task test

# Testar links
invoke test-links

🚀 Deploy

GitHub Pages (Automático)

O deploy é automático via GitHub Actions quando você faz push para main.

Manual

# Deploy com Mike
poetry run task deploy

# Ou
poetry run mike deploy estavel --push

🎨 Slides

Gerar Slides

# Com Taskipy
poetry run task slides

# Com Marp diretamente
marp -I slides/brutos --html --theme slides/brutos/python-theme.css -o slides/html

Visualizar Slides

Após gerar, abra os arquivos em slides/html/ no navegador.

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

Fork o projeto
Crie uma branch (git checkout -b feature/nova-feature)
Commit suas mudanças (git commit -m 'Add nova feature')
Push para a branch (git push origin feature/nova-feature)
Abra um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👤 Autor

Ricardo

GitHub: @ricardotecpro
LinkedIn: ricardotecpro

🙏 Agradecimentos

FastAPI do Zero - Inspiração para estrutura e automação
MkDocs Material - Tema incrível
Marp - Slides profissionais
Comunidade Python Brasil

⭐ Se este projeto te ajudou, considere dar uma estrela!