Carregando
0x180Lição 25 de 25

Projeto final: relatório de alimentação do santuário

Combine importação de CSV, agrupamento, hashtables, funções avançadas e formatação em uma ferramenta real de relatórios.

45 min Questionário com 6 perguntas 3 exercícios de código
Ao final desta lição, você saberá
  • Transforme um log CSV bruto em objetos tipados e resumidos
  • Compare os resultados com os limites armazenados em uma tabela hash
  • Empacote a lógica como uma função avançada que retorna um objeto e formate-o na borda

Uma nota fixada na porta da sala de alimentação:

Quem quer que seja o novo guardião da automação: todas as noites eu adiciono o registro de alimentação com um lápis para ver quem foi superalimentado. Vesper continua ganhando segundos. Por favor, faça o computador fazer isso. - Guardiã-chefe Ada

O log é um arquivo CSV com uma linha por refeição:

1Time,Dragon,Food,Kg
207:00,Ember,goats,20
307:30,Glim,moths,1
4...

e todo dragão tem um limite diário em quilogramas. No final, seu script imprime:

1=== EMBERFALL FEEDING REPORT ===
2Meals: 9 (07:00-18:30)
3Total: 155 kg
4Hungriest: Vesper (54 kg)
5Over limit: Ember, Vesper
6Status: ALERT

Passo 1: carregue-o e verifique os tipos

ConvertFrom-Csv (ou Import-Csv para um arquivo) fornece objetos - mas cada propriedade é uma string. Verifique com Get-Member antes de confiar em qualquer aritmética:

step1.ps1
1$log = @'
2Time,Dragon,Food,Kg
307:00,Ember,goats,20
411:00,Ember,goats,22
507:30,Glim,moths,1
6'@ | ConvertFrom-Csv
7$log.Count
8($log | Get-Member -Name Kg).Definition
9($log | Measure-Object -Property Kg -Sum).Sum
Saída
3
string Kg=20
43

Measure-Object converte strings em números quando as adiciona, portanto as somas são seguras. Classificar e comparar não são - converta primeiro com [int] ou uma propriedade calculada.

Etapa 2: uma linha por dragão

Group-Object Dragon coleta as refeições de cada dragão na propriedade Group do grupo. Transforme cada grupo em um objeto de resumo organizado com [pscustomobject] - os objetos mantêm os dados utilizáveis ​​para a próxima etapa, enquanto o texto formatado seria um beco sem saída.

step2.ps1
1$log = @'
2Time,Dragon,Food,Kg
307:00,Ember,goats,20
411:00,Ember,goats,22
507:30,Glim,moths,1
6'@ | ConvertFrom-Csv
7$perDragon = $log | Group-Object Dragon | ForEach-Object {
8  [pscustomobject]@{
9    Dragon = $_.Name
10    Meals  = $_.Count
11    Kg     = ($_.Group | Measure-Object -Property Kg -Sum).Sum
12  }
13}
14$perDragon | Sort-Object Kg -Descending | ForEach-Object { '{0}: {1} kg in {2}' -f $_.Dragon, $_.Kg, $_.Meals }
Saída
Ember: 42 kg in 2
Glim: 1 kg in 1

Etapa 3: compare com os limites

Uma tabela hash é o local natural para limites por dragão: $limits[$dragon] procura um instantaneamente. Proteja-se contra dragões que ainda não têm limite com .ContainsKey() - visitantes chegam o tempo todo.

step3.ps1
1$limits = @{ Ember = 45; Glim = 2 }
2$totals = @{ Ember = 52; Glim = 1; Nimbus = 70 }
3foreach ($dragon in $totals.Keys | Sort-Object) {
4  if (-not $limits.ContainsKey($dragon)) {
5    "$dragon has no limit yet"
6  } elseif ($totals[$dragon] -gt $limits[$dragon]) {
7    '{0} is {1} kg over' -f $dragon, ($totals[$dragon] - $limits[$dragon])
8  } else {
9    "$dragon is fine"
10  }
11}
Saída
Ember is 7 kg over
Glim is fine
Nimbus has no limit yet

Etapa 4: objetos entram, objetos saem

A ferramenta final é uma função avançada que retira refeições do pipeline e retorna um objeto de relatório. A formatação em texto acontece fora da função. Essa separação compensa: a mesma função pode alimentar um relatório de console hoje, ConvertTo-Json para um painel amanhã e um teste Pester no dia seguinte.

Import-Csv feeding.csv | Get-FeedingReport -Limit $limits | ConvertTo-Json

Colete os objetos do pipeline em process e faça todo o resumo em end, assim que tudo chegar.

Para onde ir a seguir

  • Agende: registre o script no Agendador de Tarefas (ou cron) para ser executado todas as noites às 20h.
  • Envie: publique o relatório em um canal de bate-papo com Invoke-RestMethod -Method Post e uma URL de webhook (consulte Web APIs, JSON e XML) ou salve-o como JSON para um painel.
  • Teste: escreva testes Pester para Get-FeedingReport com pequenos logs falsos em TestDrive: (consulte Testando com Pester e depuração).
  • Vá além: os módulos Az e Microsoft.Graph trazem as mesmas habilidades para Azure e Microsoft 365; Invoke-Command os leva para todos os servidores que você gerencia.

Principais conclusões

  • Verifique os tipos com Get-Member; converta texto em números antes de classificar ou comparar.

  • Group-Object mais [pscustomobject] transforma linhas brutas em um resumo por coisa.

  • Hashtables mantêm pesquisas como limites; proteja chaves perdidas com .ContainsKey().

  • Retorne objetos de funções e formate na borda - os mesmos dados podem então ir para qualquer lugar.

Quiz da aula

6 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: escreva código em scripts PowerShell

Escreva um script no editor e execute-o de verdade com entradas de exemplo, que chegam ao script como $input. Os scripts rodam no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então estes exercícios evitam sintaxe exclusiva do PowerShell 7; seu script e a entrada de teste são enviados para lá.

Exercício 1

Refeições por dragão

+25 XP

A entrada é o log CSV de alimentação. Imprima uma linha por dragão, a maioria dos quilogramas primeiro: Vesper: 54 kg (2 meals) - e (1 meal), singular, quando havia apenas um.

  • Um dia agitado
  • Um dia tranquilo
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Exercício 2

Acima do limite

+25 XP

A entrada é o log CSV de alimentação; o starter define $limits. Para cada dragão que comeu mais do que seu limite, em ordem alfabética, imprima Ember ate 52 kg - 7 kg over the limit of 45. Dragões sem limite nunca acabam. Se não tiver ninguém, imprima Everyone ate sensibly.

  • Um dia agitado
  • Um dia tranquilo
  • Um visitante
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Exercício 3

O relatório de alimentação

+25 XP

Escreva a função avançada Get-FeedingReport. Ele pega refeições do pipeline (-Meal) e uma tabela hash -Limit e retorna um objeto com estas propriedades:

  • Meals (a contagem), First e Last (os horários da primeira e da última refeição, em ordem de registro)
  • TotalKg e Hungriest - um objeto com o Dragon e Kg do dragão que mais comeu
  • OverLimit - os nomes alfabéticos dos dragões acima do seu limite (uma array vazia se não houver)

O iniciador formata seu objeto no relatório - mantenha essa parte como está:

1=== EMBERFALL FEEDING REPORT ===
2Meals: 9 (07:00-18:30)
3Total: 155 kg
4Hungriest: Vesper (54 kg)
5Over limit: Ember, Vesper
6Status: ALERT
  • Um dia agitado
  • Um dia tranquilo
  • Um visitante
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…