Conteúdo do curso Lição 67 de 250 · Código pythônico, testes e projeto final
Código pythônico, testes e projeto final

Projeto final: o ExpenseApp

Este é o grand finale -> o artefato da sua certificação de Python de nível intermediário. A Parte 1 deu a você a camada de dados. Agora você constrói um app de verdade, executável: uma classe ExpenseApp que você controla com comandos de texto, do jeito que uma pequena CLI funciona. Um método, dispatch(command), recebe uma string como "add Coffee 3.50 food" e retorna a linha a mostrar.

Esta única classe exercita o módulo inteiro de uma vez -> uma classe que guarda estado, um decorator que envolve um método, um generator que produz valores sob demanda e persistência em JSON para que o app possa salvar e recarregar. Construa tudo.

Os comandos que dispatch trata

Divida o comando nos espaços; a primeira palavra é o verbo. Retorne exatamente estas strings:

  • add <desc> <amount> <category> -> registra uma despesa e retorna "Added Coffee: 3.50 (food)" (valor com duas casas decimais).
  • total -> retorna "TOTAL: 12.50" (total geral, duas casas decimais).
  • report -> uma linha "category: total" por categoria, em ordem alfabética (duas casas decimais), e depois uma linha final "TOTAL: grand_total", juntadas por quebras de linha. Um livro-caixa vazio retorna "No expenses recorded."
  • budget <category> <amount> -> define um limite de gastos e retorna "Budget for food: 9.00".
  • over -> se alguma categoria estiver acima do orçamento, retorna "Over budget: food, fun" (em ordem alfabética, separadas por vírgula); senão "All categories within budget."

Guarde o livro-caixa e os orçamentos em self, no __init__. Os valores chegam como strings do comando -> converta com float(...). Formate com f"{value:.2f}".

O decorator: @log_calls

Escreva log_calls e aplique-o a dispatch. Cada vez que o método envolvido roda, ele acrescenta o nome da função a self.call_log e depois repassa a chamada. Use @functools.wraps(func) no wrapper interno para que o método decorado mantenha seu __name__ real (os testes verificam ExpenseApp.dispatch.__name__ == "dispatch"). Como o wrapper recebe self primeiro, a assinatura é def wrapper(self, *args, **kwargs):.

O generator: iter_over_budget(self)

Um método generator de verdade -> ele dá yield em cada categoria cujo gasto passa do orçamento, em ordem alfabética. O teste oculto verifica inspect.isgeneratorfunction(ExpenseApp.iter_over_budget), então ele precisa usar yield, não retornar uma lista. O comando over deve consumir esse generator com list(self.iter_over_budget()).

Persistência: to_json / from_json

to_json(self) retorna uma string JSON com o livro-caixa e os orçamentos. from_json(cls, text) é um @classmethod que monta um app novo a partir dessa string. A ida e volta precisa ser sem perdas -> ExpenseApp.from_json(app.to_json()) reproduz o mesmo livro-caixa e os mesmos orçamentos.

Experimente o tutor de IA

Se o seu tutor estiver ligado (o app conecta window._floatiTutor), peça a ele uma dica de orçamento para a sua maior categoria. A avaliação nunca usa a saída do modelo -> só a transcrição determinística dos seus comandos é verificada.

Clique em Run: os testes ocultos montam um app, disparam uma lista roteirizada de comandos em dispatch e verificam a transcrição exata, linha por linha -> depois conferem o generator, a ida e volta em JSON e o nome preservado. Passe neles e você terá entregado um app Python de verdade, testado, de nível intermediário.

Sua vez

Construa uma classe ExpenseApp executável. dispatch(command) trata add <desc> <amount> <category>, total, report, budget <category> <amount> e over, retornando as strings exatas da lição. Escreva um decorator log_calls (usando functools.wraps) aplicado a dispatch, que acrescenta o nome de cada chamada a self.call_log. Escreva iter_over_budget(self) como um GENERATOR que produz as categorias acima do orçamento em ordem alfabética. Acrescente to_json(self) e um classmethod from_json(cls, text) para que o app faça a ida e volta sem perdas. Nunca chame input() -> os comandos chegam só por dispatch.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.