🎨 Tkinter Hub

Tkinter Hub es una colección de ejemplos, guías y proyectos prácticos desarrollados con Tkinter, la biblioteca estándar de Python para crear interfaces gráficas.
Este repositorio está diseñado para aprender desde lo más básico hasta proyectos aplicados al mundo real.

🧠 Nota para contribuidores:
Todo el código, nombres de archivos, funciones, variables y clases deben estar en inglés,
pero toda la documentación (README, comentarios y descripciones) estará en español.

---

🚀 Objetivos del proyecto

• Mostrar ejemplos claros de cada widget disponible en Tkinter.
• Enseñar diferentes formas de posicionar y organizar elementos (pack, grid, place).
• Explorar opciones de personalización, estilos y temas (ttk).
• Incluir ejemplos integradores que combinen múltiples widgets.
• Presentar ejercicios aplicados a la vida real.
• Servir como punto de partida para nuevos proyectos o prácticas de aprendizaje.

---

🧱 Estructura del repositorio

tkinter-hub/
│
├── README.md
├── pyproject.toml
├── LICENSE
│
├── 01_basics/
│   └── README.md
│
├── 02_widgets/
│   └── README.md
│
├── 03_layouts/
│   └── README.md
│
├── 04_styles/
│   └── README.md
│
├── 05_integrated_examples/
│   └── README.md
│
├── 06_real_world_exercises/
│   └── README.md
│
├── 07_advanced/
│   └── README.md
│
└── utils/
    ├── assets/
    │   ├── icons/
    │   ├── images/
    │   └── sounds/
    └── helpers.py

---

🧩 Instalación y uso con UV

Este proyecto utiliza UV como herramienta de gestión de entornos y dependencias.

🛠️ Configuración inicial

# Clonar el repositorio
git clone https://github.com/tu-usuario/tkinter-hub.git
cd tkinter-hub

# Crear entorno e instalar dependencias
uv sync

▶️ Ejecutar un ejemplo

Para ejecutar un archivo directamente:

uv run python 01_basics/01_basic_window.py

---

📚 Contribuciones

¡Las contribuciones son bienvenidas! 🎉
Puedes aportar nuevos ejemplos, mejorar la documentación o proponer ejercicios.

Antes de enviar un PR, por favor asegúrate de:

• Mantener el código en inglés (nombres, variables, clases, archivos, etc.).
• Mantener los comentarios, explicaciones y documentación en español.
• Probar que los ejemplos funcionan correctamente.
• Seguir la estructura del repositorio.

---

🧑‍💻 Autor

JCEspitia
📘 Repositorio educativo de ejemplos de Tkinter
✉️ Abierto a contribuciones y mejoras

---

📜 Licencia

Este proyecto está bajo la licencia MIT.
Consulta el archivo LICENSE para más detalles.