100 Días de Código en Python — Día 90: Proyecto de portafolio — La app de escritura "más peligrosa"

📝 Contenido original del curso#

Para la mayoría de los escritores, un gran problema es el bloqueo del escritor: no se te ocurre qué escribir y no escribes nada.

Una de las soluciones más interesantes es una aplicación web llamada The Most Dangerous Writing App: un editor de texto en línea donde, si dejas de escribir, pierdes todo tu progreso.

Un temporizador cuenta hacia atrás y, cuando el sitio detecta que el usuario no ha escrito nada en los últimos 5 o 10 segundos, borra todo el texto escrito hasta ese momento. (El enunciado enlaza una versión en squibler.io.)

Vas a construir una aplicación de escritorio con una funcionalidad similar. El diseño es tuyo, pero debe permitir al usuario escribir y, si se detiene más de 5 segundos, debe borrar todo lo que ha escrito.

Pregunta de la tarea — Momento de reflexión: cómo abordaste el proyecto; qué fue difícil y qué fácil; cómo mejorarías; tu mayor aprendizaje; qué harías distinto.

Prerequisitos: Tkinter y after (Días 27–28); eventos de teclado con bind (Día 86); manejo de archivos (Día 24).

🔍 Antes de programar#

Programación orientada a eventos#

Hasta el Día 14, tus programas seguían un camino de arriba a abajo. En una GUI, el programa espera (mainloop) y reacciona a eventos: una tecla, un clic, un temporizador que se cumple. Este proyecto tiene dos fuentes de eventos que "compiten":

  tecla pulsada ──────► reiniciar el conteo de 5 s
  pasan 5 s sin teclas ─► borrar todo

🎯 Objetivo de aprendizaje#

Programar una acción que ocurre solo si no sucede otro evento durante cierto tiempo.

📖 Explicación conceptual#

ventana.after(ms, funcion) programa funcion y devuelve un identificador. Con ese identificador, ventana.after_cancel(identificador) la cancela antes de que ocurra. Idea: en cada tecla, cancelar el borrado pendiente y programar uno nuevo.

Es como el temporizador de una luz de pasillo con sensor: cada vez que alguien pasa, vuelve a contar desde cero; solo se apaga si nadie pasa en un rato. (En programación, a este patrón se le llama a veces debounce.)

🔎 Ejemplo explicado#

import tkinter as tk

LIMITE_MS = 5000

ventana = tk.Tk()
ventana.title("Escribe o pierde")
texto = tk.Text(ventana, font=("Georgia", 14), wrap="word")
texto.pack(fill="both", expand=True)

temporizador = None

def borrar_todo():
    texto.delete("1.0", "end")

def reiniciar_temporizador(evento=None):
    global temporizador
    if temporizador is not None:
        ventana.after_cancel(temporizador)
    temporizador = ventana.after(LIMITE_MS, borrar_todo)

texto.bind("<KeyPress>", reiniciar_temporizador)
ventana.mainloop()

Cómo funciona:

1. Al pulsar la primera tecla, temporizador es None: no hay nada que cancelar; se programa el borrado para dentro de 5 s.
2. En cada tecla siguiente, se cancela el borrado anterior y se programa uno nuevo.
3. Si pasan 5 s sin teclas, borrar_todo se ejecuta: texto.delete("1.0", "end") borra desde la línea 1, carácter 0, hasta el final.

Verificado: con el límite en 300 ms y una letra cada 100 ms, el texto se conservó; 300 ms después de la última letra, se borró.

Alternativa sin cancelar: guardar la hora de la última tecla (time.monotonic()) y tener un único after que se repite cada 100 ms y comprueba ahora - ultima_tecla > 5. Ventaja: el mismo ciclo sirve para actualizar la barra de peligro (sección 4). Compara ambos enfoques y elige.

⚠️ Errores frecuentes#

Problema#

Construir una aplicación de escritorio que borre todo el texto si el usuario deja de escribir más de 5 segundos.

Contexto#

En la clase de lenguaje se practica escritura libre para vencer el miedo a la hoja en blanco: 10 minutos escribiendo sin detenerse ni corregir.

Objetivo#

Una app Tkinter con la regla de los 5 s, aviso visual, meta de sesión y opción de guardar al cumplirla.

Requisitos funcionales#

1. Área de texto; si pasan 5 s sin teclas, se borra todo.
2. Aviso visual del tiempo restante.
3. Una meta (tiempo o palabras) elegida al inicio; al cumplirla, el texto deja de estar en peligro.
4. Guardar el texto en un archivo .txt al cumplir la meta.

Restricciones técnicas#

• Temporizadores con after, nunca sleep.
• Constantes para los tiempos (LIMITE_MS), no números sueltos.
• Organización en una clase (AppEscritura) con atributos en lugar de global.

Planificación#

1. Comprender (prueba la versión web del enunciado). 2. Entradas: teclas. 3. Procesos: reiniciar/borrar/avisar/cumplir meta. 4. Salidas: texto, aviso, archivo. 5. Dividir en funciones o métodos. 6. Bocetar la ventana. 7. Implementar. 8. Probar. 9. Corregir. 10. Mejorar.

Construcción paso a paso#

• Versión 1 — Núcleo: el ejemplo de la sección 3 funcionando.
• Versión 2 — Clase: reorganiza en AppEscritura con self.temporizador.
• Versión 3 — Aviso visual: barra o color según el tiempo restante.
• Versión 4 — Meta: pantalla inicial con reglas y meta; contador de palabras y tiempo.
• Versión 5 — Guardar: al cumplir la meta, habilitar "Guardar" (filedialog.asksaveasfilename).
• Versión final: README.md con capturas y diario.

Pruebas#

💡 Probar sin esperar 5 s cada vez: usa una constante LIMITE_MS y bájala a 1000 mientras desarrollas. Así se verificó el patrón de este tutorial.

🧪 Prueba y depuración#

def al_escribir(evento):
    ventana.after(5, borrar_todo)

texto.bind("<KeyPress>", al_escribir)

Encuentra dos problemas: nunca cancela los borrados anteriores (se borra 5 s después de la primera tecla, siempre), y 5 son milisegundos, no segundos.

⭐ Extensión del proyecto#

• 🟢 Reto 1 — Aplicación: el usuario elige el límite (5, 10 o 15 s) en la pantalla inicial.
• 🟡 Reto 2 — Ampliación: "modo difícil": el texto se desvanece progresivamente en lugar de borrarse de golpe, y se recupera si vuelves a escribir a tiempo.
• 🟠 Reto 3 — Desafío: consignas aleatorias (prompts) desde un archivo JSON al empezar ("Describe tu lugar favorito del colegio…").
• 🔴 Reto 4 — Pensamiento computacional: estadísticas de sesiones (palabras por minuto, pausas más largas, sesiones completadas). Diseña qué datos guardar, cómo mostrar el progreso a lo largo de semanas y cómo hacerlo sin guardar el contenido de los textos (privacidad).

Situación#

Un estudiante se distrae con el celular mientras estudia. Quiere una app de escritorio que registre sesiones de concentración: si durante la sesión no hay actividad en la app (por ejemplo, tomando apuntes) en 2 minutos, la sesión se marca como "interrumpida".

Requisitos#

1. Sesiones de duración elegida (25, 45 minutos), inspiradas en el Pomodoro del Día 28.
2. Área de apuntes; el mismo patrón de temporizador reiniciable detecta la inactividad, pero en vez de borrar, registra la interrupción.
3. Historial en JSON y resumen semanal.

Decisiones que debes tomar (y justificar)#

• ¿Qué cuenta como "actividad"? ¿Solo teclas? ¿Mover el ratón sobre la ventana?
• ¿Cómo evitar que la app se sienta como un "vigilante" y no como una ayuda?

Casos de prueba#

• Una sesión sin pausas largas queda como "completa".
• El historial sobrevive al cerrar la app.

Conceptuales#

1. ¿Qué significa "programación orientada a eventos"?
2. ¿Qué devuelve after y para qué sirve ese valor?
3. ¿Por qué el borrado ocurre aunque escribas si no usas after_cancel?
4. Menciona dos decisiones de diseño responsable para esta app.

Análisis de código#

temporizador = ventana.after(5000, borrar_todo)
ventana.after_cancel(temporizador)

¿Se ejecuta borrar_todo? ¿Por qué?

Predicción#

Con el ejemplo de la sección 3, escribes "hola" en 2 segundos y luego esperas. ¿Cuántos segundos después de abrir la app se borra el texto? (Suponiendo que empezaste a escribir al segundo 0.)

Depuración#

"Mi app funciona, pero a veces el texto se borra mientras mantengo presionada la tecla Retroceso." ¿Es un error o una característica? ¿Cómo lo investigarías?

Modificación#

Cambia el ejemplo para que, en vez de borrar todo, borre solo la última palabra cada 5 s de inactividad.

Creación#

Escribe color_peligro(fraccion) que reciba un número entre 0 (sin peligro) y 1 (a punto de borrar) y devuelva un color hexadecimal entre blanco y rojo claro.