Conteúdo do curso Lição 211 de 250 · Projetos: Construa Coisas Reais
Projetos: Construa Coisas Reais

Projete Você Mesmo: Um Relatório Diário

Cada lição até agora te entregou um andaime: uma function meio escrita, um comentário para cada passo, espaços em branco para preencher. O trabalho real raramente chega assim. Alguém te entrega uma frase -> "você pode me dar um resumo diário desses eventos?" -> e o arquivo vazio é seu para preencher. Esta lição é esse momento de propósito. O inicial está quase em branco: uma assinatura e uma docstring, nada mais. A habilidade sendo avaliada não é um novo pedaço de sintaxe, é transformar um pedido vago em um programa funcional.

O contrato

Escreva daily_report(events). A entrada events é uma lista de dicts, cada um no formato {"day": str, "type": str, "amount": number}. Retorne um dict que mapeia cada dia para um pequeno resumo daquele dia:

  • Cada dia que aparece na entrada é uma chave no resultado, exatamente uma vez.
  • Cada dia mapeia para {"count": int, "total": number} onde count é quantos eventos caíram naquele dia e total é a soma dos valores de amount deles.
  • Uma lista de entrada vazia retorna um dicionário vazio {}.
  • Se qualquer evento estiver sem uma das chaves obrigatórias (day, type, ou amount), lance ValueError.

A ordem das chaves no dicionário retornado não importa. O que importa é que as contagens e totais estejam corretos e cada dia de entrada apareça uma vez.

Três exemplos práticos

daily_report([
    {"day": "Mon", "type": "coffee", "amount": 3},
    {"day": "Mon", "type": "lunch",  "amount": 12},
    {"day": "Tue", "type": "coffee", "amount": 4},
])
# -> {"Mon": {"count": 2, "total": 15},
#     "Tue": {"count": 1, "total": 4}}

daily_report([{"day": "Sat", "type": "movie", "amount": 20}])
# -> {"Sat": {"count": 1, "total": 20}}

daily_report([])
# -> {}

Como atacar uma página em branco

Quando não houver um scaffold, crie um na sua cabeça antes de digitar. Uma ordem confiável:

  • Nomeie o formato da saída. Aqui está um dicionário com chaves por dia, cada valor é um dicionário de dois campos. Imagine uma entrada finalizada: "Mon": {"count": 2, "total": 15}. Esse único exemplo mostra para o que cada linha de código está trabalhando.
  • Escolha a estrutura que constrói isso. Você está agrupando linhas por uma chave e acumulando dois números por grupo. Um dictionary que você atualiza enquanto percorre a list é o ajuste natural: a primeira vez que você vê um dia, comece em {"count": 0, "total": 0}; cada vez depois, adicione a ele.
  • Lide com as bordas antes de comemorar. A lista vazia deve cair de graça se você começar com um dict vazio e nunca tratá-la como um caso especial. O evento malformado é o que você tem que escolher tratar: verifique se as chaves estão presentes e lance ValueError se não estiverem, em vez de deixar um KeyError vazar.

Note que não há um comentário linha a linha dizendo quando começar um dia ou como adicioná-lo. Essa decisão é o exercício. Construa a menor coisa que satisfaça o contrato, depois leia de volta comparando com os três exemplos acima antes de executá-lo.

Sua vez

Escreva daily_report(events) do contrato, sem nenhum suporte para se apoiar. events é uma lista de dicionários cada um com o formato {"day": str, "type": str, "amount": number}. Retorne um dicionário mapeando cada dia para {"count": int, "total": number}: count é quantos eventos caíram naquele dia, total soma os valores deles, e cada dia de entrada aparece exatamente uma vez. Uma lista vazia retorna {}. Se qualquer evento estiver sem day, type, ou amount, lance ValueError. Projete o formato dos dados e o laço você mesmo.

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.