README.md

🐍 365 Dias de Python

O Desafio: Criar, documentar e partilhar um script de Python diferente para cada dia do ano de 2026.

🌐 Explora os scripts interativamente em: https://python365.vercel.app/

---

🎯 Sobre o Projeto

Este repositório é um diário de aprendizagem contínua. O objetivo é explorar toda a versatilidade do Python — desde lógica básica e algoritmos até automação, análise de dados e integrações.

Para tornar a experiência mais rica, os scripts não ficam apenas "escondidos" em pastas; desenvolvi uma Single Page Application (SPA) moderna que serve como um editor de código interativo para navegar por cada dia do desafio.

Destaques do Site:

• Interface Estilo IDE: Visualização de código com syntax highlighting.
• Terminal Integrado: Simulação visual dos resultados dos scripts.
• Documentação Dinâmica: Renderização automática dos ficheiros readme.md de cada exercício.
• Navegação Cronológica: Filtro por meses e dias.

---

📂 Estrutura do Repositório

O projeto está dividido entre o Núcleo de Scripts (Python) e a Plataforma Web (React).

365dias_python/
├── 2026/                 # 🐍 Scripts diários organizados cronologicamente
│   ├── Janeiro/
│   │   ├── 01/
│   │   │   ├── main.py   # Script do dia
│   │   │   └── readme.md # Explicação teórica/documentação
│   │   └── ...
│   └── ... (Todos os meses do ano)
├── src/                  # ⚛️ Código Fonte do Site (React + TypeScript)
│   ├── components/       # UI: Sidebar, EditorArea, TerminalArea, TopBar
│   ├── assets/           # Recursos estáticos (Logos, SVG)
│   ├── types.ts          # Definições de tipos TypeScript
│   └── App.tsx           # Lógica principal da aplicação
├── public/               # 📂 Arquivos Públicos e Base de Dados
│   ├── codes/            # Cópia dos scripts .py para carregamento no site
│   └── data.json         # O "Manifesto" que mapeia todos os dias e títulos
├── build-data.js         # 🛠️ Script de automação para gerar o data.json
├── package.json          # Dependências do ecossistema Node/React
└── vite.config.ts        # Configurações do ambiente de build (Vite)

🚀 Como Executar

# 1. Executar Scripts Python Localmente

Navega até à pasta do dia específico e executa o ficheiro main.py:

python 2026/Janeiro/01/main.py

#2. Executar o Site (Ambiente de Desenvolvimento)

Se quiseres rodar a interface web na tua máquina:

# Instalar dependências
npm install

# Iniciar o servidor de desenvolvimento
npm run dev

📝 Licença

Este projeto está licenciado sob a MIT License.