Temario Lección 67 de 250 · Código Pythonic, Pruebas y Proyecto Final
Código Pythonic, Pruebas y Proyecto Final

Proyecto final: la aplicación ExpenseApp

Este es el final -> la pieza de tu certificación de Python de nivel intermedio. La parte 1 te dio la capa de datos. Ahora construyes una aplicación real y ejecutable: una clase ExpenseApp que manejas con comandos de texto, como funciona una pequeña CLI. Un método, dispatch(command), recibe una cadena como "add Coffee 3.50 food" y devuelve la línea que hay que mostrar.

Esta única clase pone en práctica todo el módulo a la vez -> una clase que guarda estado, un decorador que envuelve un método, un generador que produce valores bajo demanda y persistencia en JSON para que la aplicación pueda guardar y volver a cargar. Constrúyelo todo.

Los comandos que gestiona dispatch

Separa el comando por los espacios; la primera palabra es el verbo. Devuelve exactamente estas cadenas (siguen en inglés, porque las pruebas las comprueban tal cual):

  • add <desc> <amount> <category> -> registra un gasto y devuelve "Added Coffee: 3.50 (food)" (importe con dos decimales).
  • total -> devuelve "TOTAL: 12.50" (total general, dos decimales).
  • report -> una línea "category: total" por categoría, en orden alfabético (dos decimales), y al final una línea "TOTAL: grand_total", todo unido con saltos de línea. Un libro de cuentas vacío devuelve "No expenses recorded."
  • budget <category> <amount> -> fija un límite de gasto y devuelve "Budget for food: 9.00".
  • over -> si alguna categoría supera su presupuesto, devuelve "Over budget: food, fun" (en orden alfabético, unidas con comas); si no, "All categories within budget."

Guarda el libro de cuentas y los presupuestos en self dentro de __init__. Los importes llegan del comando como cadenas -> conviértelos con float(...). Dales formato con f"{value:.2f}".

El decorador: @log_calls

Escribe log_calls y aplícalo a dispatch. Cada vez que se ejecuta el método envuelto, añade el nombre de la función a self.call_log y luego hace la llamada. Usa @functools.wraps(func) en el wrapper interior para que el método decorado conserve su __name__ real (las pruebas comprueban ExpenseApp.dispatch.__name__ == "dispatch"). Como el wrapper recibe primero self, la firma es def wrapper(self, *args, **kwargs):.

El generador: iter_over_budget(self)

Un método generador de verdad -> hace yield de cada categoría cuyo gasto supera su presupuesto, en orden alfabético. La prueba oculta comprueba inspect.isgeneratorfunction(ExpenseApp.iter_over_budget), así que debe usar yield, no devolver una lista. El comando over debe consumir este generador con list(self.iter_over_budget()).

Persistencia: to_json / from_json

to_json(self) devuelve una cadena JSON con el libro de cuentas y los presupuestos. from_json(cls, text) es un @classmethod que construye una aplicación nueva a partir de esa cadena. El viaje de ida y vuelta no debe perder nada -> ExpenseApp.from_json(app.to_json()) reproduce el mismo libro de cuentas y los mismos presupuestos.

Prueba el tutor de IA

Si tu tutor está activado (la aplicación conecta window._floatiTutor), pídele un consejo de presupuesto para tu categoría más grande. La corrección nunca usa la respuesta del modelo -> solo se comprueba tu registro de comandos, que es determinista.

Pulsa Run: las pruebas ocultas construyen una aplicación, lanzan a dispatch una lista de comandos preparada y comprueban el registro exacto línea por línea -> luego comprueban el generador, el viaje de ida y vuelta en JSON y el nombre conservado. Si las pasas, habrás publicado una aplicación de Python real, probada y de nivel intermedio.

Tu turno

Crea una clase ExpenseApp ejecutable. dispatch(command) maneja add <desc> <amount> <category>, total, report, budget <category> <amount> y over, devolviendo las cadenas exactas de la lección. Escribe un decorador log_calls (usando functools.wraps) aplicado a dispatch que añade el nombre de cada llamada a self.call_log. Escribe iter_over_budget(self) como un GENERATOR que entrega las categorías sobre el presupuesto en orden alfabético. Añade to_json(self) y un classmethod from_json(cls, text) para que la aplicación funcione en ambos sentidos sin pérdida. Nunca llames a input(), los comandos llegan solo a través de dispatch.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.