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)
1
resposta

Faça como eu fiz: documentando funções

def calcular_media_dicionario(notas: dict = {"default": 0.0}) -> float:
    """Calcula a média aritmética dos valores contidos em um dicionário de notas.

    Parameters
    ----------
    notas : dict, default {"default": 0.0}
        Dicionário onde as chaves são os identificadores (ex: nomes) 
        e os valores são as notas numéricas (int ou float).

    Returns
    -------
    float
        O valor da média aritmética calculado a partir dos dados fornecidos.
    """
    valores = notas.values()
    calculo = sum(valores) / len(valores)
    return calculo


# Exemplo de uso prático aplicando a formatação de 1 casa decimal na exibição:
notas_turma = {"Ana": 8.5, "Bruno": 7.0, "Carlos": 9.2}

media_final = calcular_media_dicionario(notas_turma)
print(f"Média: {media_final:.1f}")
1 resposta
solução!

Olá, Julia! Como vai?

Gostei da forma como você documentou a função utilizando a estrutura da docstring com Parameters e Returns. Isso torna a função mais fácil de entender e manter, além de deixar o código mais organizado para outras pessoas que forem utilizá-lo.

Uma dica interessante para o futuro é utilizar type hints mais específicos com o módulo typing, deixando ainda mais claro o tipo esperado. Veja este exemplo:

from typing import Dict

def calcular_media(notas: Dict[str, float]) -> float:
    return sum(notas.values()) / len(notas)

Esse código informa que o dicionário possui str como chave e float como valor, facilitando a leitura e o uso da função.

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