You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> Ejercicios guiados y prácticos para aprender los fundamentos de **Python** — incluye guía paso a paso, flujo GitHub real *(fork → rama → PR)* y comprobaciones automáticas con lint y tests.
3
+
Repositorio pedagógico de ejercicios de Python pensado para estudiantes con base en bases de datos y experiencia previa con GitHub (forks, ramas y PRs). Incluye estructura clara, ejercicios graduados, ejemplos, CI, linting y una guía de contribución precisa.
4
4
5
5
---
6
6
7
-
## 🎯 Objetivo
8
-
Este repositorio te acompaña en tus primeros pasos con Python, siguiendo un enfoque **profesional y pedagógico**. Aprenderás a escribir código limpio, estructurado y probado mientras practicas el flujo de trabajo real de un desarrollador con Git y GitHub.
7
+
## 📑 Índice
8
+
9
+
-[🎯 Requisitos](#-requisitos)
10
+
-[👤 Flujo de trabajo del alumno](#-flujo-de-trabajo-del-alumno)
11
+
-[📝 Normas de commits](#-normas-de-commits)
12
+
-[🧪 Cómo ejecutar tests y lint](#-cómo-ejecutar-tests-y-lint)
13
+
-[📚 Documentación del repositorio](#-documentación-del-repositorio)
14
+
-[📖 Cheat Sheets de Python](#-cheat-sheets-de-python)
15
+
-[📋 Guías del curso](#-guías-del-curso)
16
+
-[📂 Estructura del repositorio](#-estructura-del-repositorio)
17
+
-[🗺️ Módulos de aprendizaje](#️-módulos-de-aprendizaje)
9
18
10
19
---
11
20
12
-
## 🧭 Flujo de trabajo
13
-
14
-
1.**Fork** de este repositorio a tu cuenta.
15
-
2.**Clona** tu fork y crea una rama para tus ejercicios:
16
-
```bash
17
-
git clone <tu-fork>
18
-
cd python-fundamentos
19
-
git switch -c ejercicios-TuNombre
20
-
```
21
-
3. Activa tu entorno y prepara las dependencias:
22
-
```bash
23
-
python -m venv .venv
24
-
source .venv/bin/activate # macOS/Linux
25
-
.venv\Scripts\activate # Windows
26
-
pip install -U pip pytest ruff
27
-
```
28
-
4. Trabaja por bloques (01 → 06) y haz commits pequeños y descriptivos.
29
-
5. Abre una Pull Request hacia la rama `revision` del repo original.
30
-
6. Espera el ✅ del CI antes de solicitar revisión.
21
+
## 🎯 Requisitos
22
+
- Python 3.12 o superior
23
+
- Git
24
+
- make (opcional pero recomendado para ejecutar tareas locales)
31
25
32
-
---
26
+
> 💡 **Importante sobre entornos virtuales**: Este proyecto utiliza entornos virtuales (`.venv`) para aislar dependencias. Es una práctica profesional estándar que evita conflictos entre proyectos. Consulta [`cheatsheets/01_intro.md`](./cheatsheets/01_intro.md#-entornos-virtuales-venv) para aprender qué son y por qué son importantes.
33
27
34
-
## 🧰 Requisitos técnicos
28
+
## 👤 Flujo de trabajo del alumno
29
+
1. Haz un fork de este repositorio en tu cuenta.
30
+
2. Clona tu fork localmente.
31
+
3. Crea una rama para tus ejercicios: `ejercicios-Nombre` (usa tu nombre o alias).
32
+
4. Trabaja con commits pequeños y descriptivos.
33
+
5. Abre un Pull Request (PR) desde tu rama `ejercicios-Nombre` hacia la rama `revision` de este repo.
34
+
6. Participa en la revisión por pares y atiende comentarios de la formadora.
35
35
36
-
-**Python 3.12 o superior**
37
-
-**Git**
38
-
-**make** (opcional, pero recomendado para automatizar tareas locales)
36
+
## 📝 Normas de commits
37
+
Prefijos recomendados:
38
+
-`feat:` nueva funcionalidad/ejercicio
39
+
-`fix:` correcciones
40
+
-`refactor:` reestructuración sin cambiar comportamiento
41
+
-`test:` pruebas
42
+
-`docs:` documentación
39
43
40
-
### Comandos disponibles si tienes `make`:
41
-
```bash
42
-
make setup # crea entorno e instala dependencias
43
-
make lint # revisión de estilo con Ruff
44
-
make test# ejecuta tests automáticos con Pytest
45
-
```
44
+
Ejemplo: `feat: agregar ejercicios guiados de 01_intro`
46
45
47
-
### Alternativa manual:
48
-
```bash
49
-
python -m venv .venv
50
-
source .venv/bin/activate # o .venv\Scripts\activate en Windows
51
-
pip install -U pip ruff pytest
52
-
pytest -q
53
-
ruff check .
54
-
```
46
+
## 🧪 Cómo ejecutar tests y lint
47
+
Con make:
48
+
-`make setup` (crea el entorno y instala dependencias mínimas)
1. ✅ Lee el [roadmap](./docs/roadmap.md) para entender la estructura del curso
149
+
2. ✅ Configura tu entorno según [`cheatsheets/01_intro.md`](./cheatsheets/01_intro.md)
150
+
3. ✅ Haz un fork del repositorio
151
+
4. ✅ Empieza con [`01_intro/ejercicios.md`](./01_intro/ejercicios.md)
152
+
5. ✅ Mantén abierta la [referencia rápida](./cheatsheets/python_quick_reference.md)
97
153
98
-
Ejemplo:
99
-
```bash
100
-
git commit -m "feat(intro): completar ejercicio 3 sobre variables"
101
-
```
154
+
**¡Feliz aprendizaje! 🚀**
102
155
103
156
---
104
157
105
-
## 🧩 Verificación rápida
158
+
## 👥 Créditos
106
159
107
-
Antes de subir tu código, asegúrate de que todo pasa correctamente:
108
-
```bash
109
-
ruff check .
110
-
pytest -q
111
-
```
112
-
Si ambos comandos terminan sin errores, el CI aprobará tu PR automáticamente.
160
+
**Autoría y diseño pedagógico**: Anaïs Rodríguez Villanueva
113
161
114
-
---
115
-
116
-
## 🪶 Licencia
162
+
Este material ha sido desarrollado con fines educativos como parte de un programa de formación en desarrollo web e inteligencia artificial.
117
163
118
-
📄 MIT License — este material puede reutilizarse con fines educativos citando la autoría de la desarrolladora: Anaïs Rodríguez Villanueva.
164
+
### 📄 Licencia
119
165
120
-
---
166
+
Este proyecto está bajo licencia MIT. Puedes reutilizar y adaptar el material citando la autoría original.
121
167
122
-
##💡 Créditos
168
+
### 🤝 Contribuciones
123
169
124
-
Desarrollado con fines pedagógicos y vocación docente por **Anaïs Rodríguez Villanueva**, en tiempo personal, como recurso abierto para el aprendizaje de Python.
125
-
El contenido se ofrece bajo licencia **MIT**, permitiendo su uso educativo libre con el debido reconocimiento de autoría.
170
+
Las contribuciones son bienvenidas. Por favor, consulta [CONTRIBUTING.md](./CONTRIBUTING.md) para más detalles sobre cómo participar en el proyecto.
0 commit comments