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!

1
resposta

[Projeto] Re. Faça como eu fiz: documentando funções

Código:
def media(lista: list = [0]) -> float:
'''
Função para calcular a média de notas passadas por uma lista.

Parâmetros:
lista: list (default [0])
    Lista contendo os valores que serão usados no cálculo da média.

Retorno:
float
    Retorna o valor da média dos elementos da lista.
'''

calculo = sum(lista) / len(lista)
return calculo
1 resposta

Oii Daniel, tudo bem?

Obrigada por compartilhar seu avanço no fórum! A docstring ficou bem estruturada: você documentou os parâmetros, o tipo de retorno e o comportamento padrão de forma clara, o que facilita muito a leitura do código por outras pessoas.

Vale só uma observação sobre o valor padrão lista: list = [0]: usar uma lista mutável como argumento padrão em Python pode causar comportamentos inesperados em alguns casos. Uma alternativa mais segura é usar None como padrão e criar a lista dentro da função:

def media(lista: list = None) -> float:
    if lista is None:
        lista = [0]
    ...

Isso evita que a lista padrão seja compartilhada entre chamadas da função. Mas é um detalhe sutil, e o raciocínio da sua solução está correto!

Conte com a Alura para evoluir seus estudos. Em caso de dúvidas, fico à disposição.

Bons estudos!

Sucesso

Imagem da comunidade