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!

0
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.