Definición

Una función es la forma de agrupar expresiones y sentencias (algoritmos) que realizan determinadas acciones, pero que estas solo se ejecutan cuando son llamadas.

Definiendo funciones

Para definir funciones en Python se usa la palabra reservada def seguida del nombre de la función y la listas de parámetros formales entre paréntesis:

def saludar():
    print("Hola")

Un función con parámetros

def saludar(nombre):
    print(f"Hola {nombre}!")

Documentación

La primera línea debe ser siempre un resumen corto y conciso del propósito del objeto.

def saludar(nombre):
    """Muestra en pantalla un mensaje de saludo.

    :param nombre: Nombre de la persona a saludar
    :nombre type: str
    """
    print(f"Hola {nombre}!")

Anotaciones

Las anotaciones de funciones son información completamente opcional sobre los tipos usadas en funciones definidas por el usuario (PEP 484 1)

def saludar(nombre: str) -> None:
    print(f"Hola {nombre}!")

En progreso…


Actualizado: