Solucionado (ver solução)

Importante

Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!

Solucionado
(ver solução)
2
respostas

[Sugestão] (EXERCÍCIO) Faça como eu fiz: documentando funções

Olá colegas!
Pedi a LURI para criar um exercício pertinente ao meu dia a dia!

Exercício: Função de Controle de Temperatura da Rede de Frio

Preciso criar uma função para calcular a temperatura média de uma Câmara Fria ao longo do dia, para garantir que os imunobiológicos estejam armazenados corretamente (entre 2°C e 8°C).

Desafio: Crie uma função chamada temperatura_media_equipamento() que:

  1. Receba uma lista com as temperaturas coletadas durante o dia
  2. Calcule a média dessas temperaturas
  3. Retorne essa média

Aplique os 3 conceitos da aula:

  1. Type Hint: Indique que recebe uma list e retorna um float
  2. Default Value: Se ninguém passar dados, use uma temperatura padrão de [5.0] (temperatura ideal)
  3. Docstring: Documente explicando que é para monitorar a temperatura do equipamento de frio

Resolução: no https://colab.research.google.com

Vamos a uma solução que atende aos três requisitos (Type Hint, Default Value e Docstring):

def temperatura_media_equipamento(temperaturas: list[float] = [5.0]) -> float:
    """
    Calcula a temperatura média do equipamento da Rede de Frio.

    Recebe uma lista de temperaturas coletadas durante o dia e
    retorna a média das medições para auxiliar no monitoramento
    do armazenamento adequado dos imunobiológicos.
    """
    return sum(temperaturas) / len(temperaturas)

Exemplo:

temperaturas_dia = [4.8, 5.2, 5.0, 4.9, 5.1]

media = temperatura_media_equipamento(temperaturas_dia)

print(f"Temperatura média: {media:.1f}°C")

Saída:

Temperatura média: 5.0°C

Conceitos pedidos:

Type Hint

temperaturas: list[float]

Indica que a função recebe uma lista de números decimais.

-> float

Indica que a função retorna um numero decimal.

Defaut Value

temperaturas: list[float] = [5.0]

Se nenhum valor for informado, a função utilizará a temperatura padrão de 5,0C.

Docstring

"""
Calcula a temperatura média do equipamento da Rede de Frio...
"""

Documenta a finalidade da função e facilita a manutenção do código.

É isso! tenho pedido ajuda da Luri que ela monte exercícios fazendo analogias com meu dia a dia na Rede de Frio.

2 respostas
solução!

Oii, Vanelice! Como vai?

Gostei bastante da forma como você conectou os conceitos da aula com uma situação real do seu dia a dia na Rede de Frio. A função temperatura_media_equipamento() ficou clara e aplicou bem os três pontos trabalhados: type hint, valor padrão e docstring, além de trazer um exemplo bem contextualizado para monitoramento de temperaturas.

Qual outro processo da Rede de Frio você acha que poderia virar um exercício com funções em Python?

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!

Olá, Lorena! Que bom que gostou.

Bom, respondendo a sua pergunta, acho que no Controle de Estoque de Vacinas, criando funções para calcular :

  1. Saldo disponível
  2. Identificar imunobiológicos próximos do vencimento
  3. Estimar a necessidade de reposição com base no consumo mensal.

Acho que outro exemplo seria o de Controle de Validade que envolve uma lógica de programação bastante didática.

Obrigado pela indicação de artigos! By