for con rangos

# =============================================================================
# BUCLES FOR CON RANGE() EN PYTHON
# =============================================================================
# Hasta ahora hemos usado el bucle "for" para recorrer listas y cadenas.
# En este programa aprenderemos a usarlo con range(), que nos permite repetir
# algo un número exacto de veces o recorrer rangos de números.
#
# range() genera una secuencia de números. Sus formas principales son:
#
#   range(n)          → genera: 0, 1, 2, ..., n-1        (n números desde 0)
#   range(a, b)       → genera: a, a+1, ..., b-1         (sin incluir b)
#   range(a, b, paso) → genera: a, a+paso, a+paso*2, ... (de a en a saltos)
#
# En este archivo veremos:
#   1. range() básico para contar y sumar
#   2. range() para recorrer cadenas
#   3. Funciones que usan range() para calcular sumas
#   4. Dibujar figuras con emojis usando bucles
#   5. Árboles de Navidad cada vez más elaborados
# =============================================================================

import random
# Importamos el módulo "random" que usaremos al final para generar números
# aleatorios. Un módulo es una colección de funciones ya escritas que podemos
# usar directamente. "random" viene incluido con Python, no hay que instalarlo.


# =============================================================================
# EJEMPLO 1: range() BÁSICO — CONTAR DEL 0 AL 6
# =============================================================================

for i in range(7):
    # range(7) genera los números: 0, 1, 2, 3, 4, 5, 6
    # OJO: genera 7 números pero el último es 6, no 7. Nunca incluye el límite.
    # En cada vuelta, "i" toma el siguiente valor de la secuencia.
    # "i" es el nombre más habitual para un contador en programación.

    print(i)
    # Imprime el valor actual de i.
    # Salida:
    #   0
    #   1
    #   2
    #   3
    #   4
    #   5
    #   6


# =============================================================================
# EJEMPLO 2: SUMAR TODOS LOS NÚMEROS DEL 0 AL 100
# =============================================================================

suma = 0
# Acumulador: empezamos en 0 y vamos añadiendo números.
# Siempre se inicializa a 0 ANTES del bucle.

for i in range(101):
    # range(101) genera: 0, 1, 2, 3, ..., 100
    # Necesitamos 101 (no 100) porque range() no incluye el número final.
    # PREGUNTA FRECUENTE: ¿por qué no range(100)?
    #   range(100) → llega hasta 99. range(101) → llega hasta 100. ✓

    suma = suma + i
    # Añadimos el valor actual de i a la suma acumulada.
    # ALTERNATIVA más corta: suma += i
    # Paso a paso: suma=0 → 0+0=0 → 0+1=1 → 1+2=3 → 3+3=6 → ... → 5050

print(suma)
# Imprime 5050. Es la suma de los números del 0 al 100.
# Existe una fórmula matemática directa: n*(n+1)/2 → 100*101/2 = 5050


# =============================================================================
# EJEMPLO 3: range() PARA RECORRER UNA CADENA POR POSICIÓN
# =============================================================================

cadena = "hola"

for i in range(len(cadena)):
    # len(cadena) → devuelve 4 (la cadena "hola" tiene 4 caracteres)
    # range(4)    → genera: 0, 1, 2, 3
    # Así recorremos los índices válidos de la cadena.

    print(i, cadena[i])
    # cadena[i] → accede a la letra en la posición i
    # cadena[0] → "h"
    # cadena[1] → "o"
    # cadena[2] → "l"
    # cadena[3] → "a"
    #
    # Salida:
    #   0 h
    #   1 o
    #   2 l
    #   3 a
    #
    # RECUERDA: esta es la "Manera 2" del tema anterior. La manera más pythónica
    # es con enumerate(), pero esta es útil cuando necesitas el índice para
    # acceder a posiciones vecinas (cadena[i-1], cadena[i+1]...).


# =============================================================================
# FUNCIÓN suma_hasta() — SUMAR DEL 0 HASTA UN LÍMITE
# =============================================================================
# Generalizamos el ejemplo 2: en lugar de sumar siempre hasta 100,
# dejamos que el usuario elija el límite.
#
# suma_hasta(10)  → 0+1+2+...+10  = 55
# suma_hasta(100) → 0+1+2+...+100 = 5050
# =============================================================================

def suma_hasta(limite):
    # Parámetro "limite": el número hasta el que queremos sumar.

    suma = 0
    # Acumulador LOCAL a la función. Se reinicia a 0 en cada llamada.

    for i in range(limite + 1):
        # limite + 1 porque range() no incluye el último número.
        # Si limite=10 → range(11) → genera 0, 1, 2, ..., 10 ✓
        # Sin el +1 → range(10) → llegaríamos solo hasta 9 ✗

        suma = suma + i
        # Acumulamos cada número en la suma.

    return suma
    # Devolvemos el resultado al lugar donde se llamó la función.

print(suma_hasta(10))   # → 55
print(suma_hasta(100))  # → 5050


# =============================================================================
# FUNCIÓN suma_entre() — SUMAR ENTRE DOS NÚMEROS
# =============================================================================
# Ahora también elegimos desde dónde empezamos a sumar.
# Usamos la forma range(inicio, final) que empieza en "inicio".
#
# suma_entre(10, 20) → 10+11+12+...+20 = 165
# suma_entre(2, 5)   → 2+3+4+5         = 14
# =============================================================================

def suma_entre(inicio, final):
    # Dos parámetros: "inicio" (desde dónde) y "final" (hasta dónde).

    suma = 0

    for i in range(inicio, final + 1):
        # range(inicio, final+1) genera: inicio, inicio+1, ..., final
        # El +1 sigue siendo necesario para incluir "final".
        # Ejemplo: range(10, 21) → 10, 11, 12, ..., 20 ✓
        # Sin +1: range(10, 20) → 10, 11, ..., 19 — nos falta el 20 ✗

        suma = suma + i

    return suma

print(suma_entre(10, 20))  # → 165
print(suma_entre(2, 5))    # → 14


# =============================================================================
# TRIÁNGULO DE EMOJIS
# =============================================================================
# Usamos range() para controlar cuántos emojis imprimimos en cada línea.
# En la línea 0 → 0 emojis, línea 1 → 1 emoji, ..., línea n → n emojis.
# =============================================================================

tamanyo = 6

for i in range(tamanyo + 1):
    # range(tamanyo+1) → range(7) → genera 0, 1, 2, 3, 4, 5, 6
    # Con tamanyo+1 incluimos la última fila completa.

    print("🟢" * i)
    # "🟢" * i repite el emoji i veces.
    # "🟢" * 0 → ""      (línea vacía)
    # "🟢" * 1 → "🟢"
    # "🟢" * 2 → "🟢🟢"
    # "🟢" * 6 → "🟢🟢🟢🟢🟢🟢"
    # Salida:
    #
    # 🟢
    # 🟢🟢
    # 🟢🟢🟢
    # 🟢🟢🟢🟢
    # 🟢🟢🟢🟢🟢
    # 🟢🟢🟢🟢🟢🟢


# =============================================================================
# FUNCIÓN arbolito() — TRIÁNGULO COMO FUNCIÓN REUTILIZABLE
# =============================================================================

def arbolito(tamanyo):
    # Exactamente el mismo código que arriba, pero dentro de una función.
    # Así podemos llamarla con cualquier tamaño sin reescribir el bucle.

    for i in range(tamanyo + 1):
        print("🟢" * i)

arbolito(10)   # Dibuja un triángulo de 10 filas
# RETO: ¿qué pasa si llamas a arbolito(0)? ¿Y a arbolito(1)?


# =============================================================================
# FUNCIÓN arbolito_puro() — DEVUELVE EL ÁRBOL COMO TEXTO (SIN IMPRIMIR)
# =============================================================================
# Diferencia clave respecto a arbolito():
#   arbolito()      → imprime directamente (no devuelve nada útil)
#   arbolito_puro() → construye el texto y lo devuelve con return
#
# ¿Por qué es mejor devolver el texto?
# Porque podemos guardarlo, modificarlo, enviarlo por email, guardarlo
# en un archivo... En cambio, lo que se imprime con print() se pierde.
# =============================================================================

def arbolito_puro(tamanyo):
    resultado = ""
    # Cadena vacía donde iremos construyendo el árbol línea a línea.

    for i in range(tamanyo + 1):
        resultado += "🟢" * i + "\n"
        # Añadimos los emojis de esta fila MÁS "\n" (salto de línea).
        # "\n" es el carácter especial que representa "pulsar Enter".
        # Sin "\n" todo saldría en una sola línea.
        # ALTERNATIVA: resultado = resultado + "🟢" * i + "\n"

    return resultado
    # Devolvemos todo el árbol como una sola cadena con saltos de línea.

print(arbolito_puro(4))
# Al hacer print() de una cadena con "\n", cada "\n" se convierte en
# un salto de línea visible en pantalla.
# Salida:
#
# 🟢
# 🟢🟢
# 🟢🟢🟢
# 🟢🟢🟢🟢


# =============================================================================
# FUNCIÓN arbol_guay() — ÁRBOL CENTRADO CON FORMA DE TRIÁNGULO INVERTIDO
# =============================================================================
# Ahora mejoramos el árbol:
#   - Empieza en 1 (no en 0) para que la primera fila tenga 1 bola
#   - La primera fila tiene una bola roja (la estrella de la cima)
#   - Cada fila tiene un número IMPAR de bolas: 1, 3, 5, 7...
#   - Añadimos espacios a la izquierda para que quede centrado
#
# Con tamanyo=4, fila por fila:
#   i=1: espacios=3, bolas=1  →  "      🔴"
#   i=2: espacios=2, bolas=3  →  "    🟢🟢🟢"
#   i=3: espacios=1, bolas=5  →  "  🟢🟢🟢🟢🟢"
#   i=4: espacios=0, bolas=7  →  "🟢🟢🟢🟢🟢🟢🟢"
# =============================================================================

def arbol_guay(tamanyo):

    for i in range(1, tamanyo + 1):
        # range(1, tamanyo+1) → empieza en 1, no en 0.
        # Con tamanyo=6 → genera: 1, 2, 3, 4, 5, 6
        # Empezamos en 1 para que la primera fila tenga al menos 1 bola.

        bola = "🟢"
        # Por defecto, todas las bolas son verdes.

        if i == 1:
            bola = "🔴"
            # La primera fila (i=1) es la cima del árbol → bola roja (estrella).

        espacios = tamanyo - i
        # Cuántos espacios dobles ponemos a la izquierda para centrar.
        # Cuanto más arriba (i pequeño), más espacios → la cima queda centrada.
        # i=1 → espacios=5 (muchos, está en la cima)
        # i=6 → espacios=0 (ninguno, es la base)

        bolas = 2 * i - 1
        # Fórmula para obtener números impares: 1, 3, 5, 7, 9, 11...
        # i=1 → 2*1-1=1   i=2 → 2*2-1=3   i=3 → 2*3-1=5
        # Los árboles de Navidad tienen filas con número impar de bolas
        # para que queden simétricas.

        print("  " * espacios + bola * bolas)
        # "  " * espacios → espacios dobles para el centrado (2 espacios cada uno)
        # bola * bolas    → repite la bola el número de veces calculado
        # Los concatenamos con + para formar la línea completa.


# =============================================================================
# FUNCIÓN arbol_decorado() — ÁRBOL CON DECORACIONES ALEATORIAS
# =============================================================================
# La versión más completa. Añade decoraciones aleatorias entre las bolas verdes.
# Novedad: usa un BUCLE ANIDADO (un for dentro de otro for) para pintar
# cada bola de la fila una a una, pudiendo cambiar el emoji en cada posición.
# =============================================================================

def arbol_decorado(tamanyo):
    decoracion = "🟠🟡🔵🎄🎅🤶"
    # Cadena con los emojis de decoración disponibles.
    # decoracion[0] → "🟠"
    # decoracion[1] → "🟡"
    # decoracion[5] → "🤶"
    # len(decoracion) → 6

    for i in range(1, tamanyo + 1):
        # Bucle EXTERIOR: recorre las filas del árbol (igual que arbol_guay).

        bola = "🟢"
        # Bola por defecto para esta fila.

        if i == 1:
            bola = "🔴"
            # La cima sigue siendo roja.

        espacios = tamanyo - i
        bolas = 2 * i - 1
        # Mismas fórmulas de centrado que en arbol_guay().

        print("  " * espacios, end="")
        # Imprimimos los espacios de centrado.
        # end="" evita el salto de línea automático del print().
        # Sin end="" cada print() saltaría de línea y el árbol quedaría roto.

        for j in range(bolas):
            # Bucle INTERIOR: recorre cada posición de bola en esta fila.
            # "j" va de 0 a bolas-1. En cada posición decidimos qué emoji poner.

            bola = "🟢"
            # Reiniciamos la bola a verde para cada posición.

            if random.randint(0, 3) == 0:
                # random.randint(0, 3) genera un número aleatorio: 0, 1, 2 o 3.
                # Solo si sale 0 (probabilidad 1 de cada 4 = 25%), ponemos decoración.
                # Así la mayoría de bolas son verdes y las decoraciones son escasas.

                bola = decoracion[random.randint(0, len(decoracion) - 1)]
                # Elegimos un emoji aleatorio de la cadena "decoracion".
                # random.randint(0, 5) → número entre 0 y 5 (los 6 índices válidos).
                # len(decoracion)-1 = 5, así nunca nos salimos de rango.
                # ALTERNATIVA más corta: bola = random.choice(decoracion)

            print(bola, end="")
            # Imprimimos la bola (verde o decoración) SIN salto de línea,
            # para que todas las bolas de la misma fila queden juntas.

        print()
        # print() sin argumentos imprime solo un salto de línea.
        # Lo necesitamos al final de cada fila para pasar a la siguiente.
        # Es el "Enter" que falta porque usamos end="" en los print anteriores.

arbol_guay(6)
# Llamamos a arbol_guay para probarlo con tamaño 6.
# RETO: llama también a arbol_decorado(10) y observa que cada ejecución
# produce un árbol diferente gracias a random.

Repaso iteración de listas

# =============================================================================
# RECORRIDO DE CADENAS EN PYTHON
# =============================================================================
# Una cadena (string) es una secuencia de caracteres: letras, espacios, comas...
# Python nos permite recorrer esa secuencia carácter a carácter de varias formas.
#
# En este programa veremos:
#   1. Tres maneras distintas de recorrer una cadena con su posición
#   2. Cómo usar esa posición para hacer cosas distintas según sea par o impar
#   3. Cómo meter todo eso en una función reutilizable
#   4. Cómo aplicar esa función a una lista de textos
#
# ¿Qué es la posición (índice)?
#   Cada carácter de una cadena tiene un número de posición que empieza en 0.
#
#   Cadena:    H  o  l  a     q  u  e ...
#   Posición:  0  1  2  3  4  5  6  7 ...
#
#   IMPORTANTE: en Python los índices empiezan en 0, no en 1.
# =============================================================================


cadena = "Hola que tal, Python es genial"
# Declaramos la cadena con la que vamos a trabajar en los tres primeros ejemplos.
# Podría ser cualquier texto: cadena = input("Escribe algo: ")

resultado = ""
# Variable donde iremos construyendo la cadena transformada.
# Empieza vacía y le iremos añadiendo letras una a una.
# NUNCA la inicialices con otro valor o aparecerá texto extra al inicio.


# =============================================================================
# MANERA 1: CONTADOR MANUAL
# =============================================================================
# La forma más intuitiva para un principiante.
# Usamos una variable "posicion" que aumentamos nosotros a mano en cada vuelta.
# =============================================================================

posicion = 1
# Empezamos en 1 porque queremos mostrar posiciones "humanas" (del 1 en adelante).
# Nota: internamente Python usa 0, pero aquí lo mostramos desde 1 para el usuario.

for letra in cadena:
    # El bucle for recorre la cadena carácter a carácter.
    # En cada vuelta, "letra" toma el valor del siguiente carácter.
    # Ejemplo: vuelta 1 → letra="H", vuelta 2 → letra="o", etc.

    print(posicion, letra)
    # Imprime la posición actual y la letra correspondiente.
    # Salida ejemplo:
    #   1 H
    #   2 o
    #   3 l
    #   4 a
    #   5   (el espacio también es un carácter)

    posicion = posicion + 1
    # Incrementamos el contador manualmente para que en la próxima vuelta
    # indique la siguiente posición.
    # ALTERNATIVA más corta: posicion += 1
    # SIN esta línea, "posicion" siempre valdría 1 → mostraría siempre "1"


# =============================================================================
# MANERA 2: CON range() Y len()
# =============================================================================
# En lugar de recorrer las letras directamente, recorremos los números
# de posición (0, 1, 2, ...) y accedemos a cada letra por su índice.
#
# len(cadena) → devuelve el número total de caracteres de la cadena
# range(n)    → genera los números 0, 1, 2, ..., n-1
# cadena[i]   → accede a la letra que está en la posición i
# =============================================================================

for posicion in range(len(cadena)):
    # range(len(cadena)) con nuestra cadena genera: 0, 1, 2, ..., 29
    # (porque "Hola que tal, Python es genial" tiene 30 caracteres)
    # En cada vuelta, "posicion" vale el índice actual (empieza en 0).

    print(posicion + 1, cadena[posicion])
    # cadena[posicion] → accede a la letra en esa posición.
    #   cadena[0]  →  "H"
    #   cadena[1]  →  "o"
    #   cadena[4]  →  " " (espacio)
    # Sumamos +1 al mostrar para que el usuario vea 1, 2, 3... en lugar de 0, 1, 2...
    #
    # VENTAJA de esta manera sobre la 1: con "posicion" podemos acceder a
    # la letra anterior (cadena[posicion-1]) o siguiente (cadena[posicion+1])


# =============================================================================
# MANERA 3: CON enumerate() ← LA MÁS USADA EN PYTHON
# =============================================================================
# enumerate() nos da automáticamente DOS cosas en cada vuelta:
#   - La posición (índice, empezando en 0)
#   - El carácter en esa posición
# Es la manera más "pythónica" (la preferida por los programadores Python).
# =============================================================================

for posicion, letra in enumerate(cadena):
    # enumerate() devuelve pares (posición, carácter) en cada vuelta.
    # Desglosamos ese par en dos variables: "posicion" y "letra".
    # Equivale a hacer las maneras 1 y 2 a la vez, sin código extra.
    # Ejemplo: vuelta 1 → posicion=0, letra="H"
    #          vuelta 2 → posicion=1, letra="o"

    print(posicion + 1, letra)
    # Mostramos posición (desde 1) y letra, igual que en las maneras anteriores.

    if posicion % 2 == 0:
        # El operador % calcula el RESTO de la división.
        # posicion % 2 → si el resto es 0, la posición es PAR; si es 1, es IMPAR.
        # Posiciones pares:   0, 2, 4, 6, 8, ...  (H, l, ' ', u, ' ', t, ...)
        # Posiciones impares: 1, 3, 5, 7, 9, ...  (o, a, q, e, a, ...)
        # RECUERDA: la posición 0 (la primera) es PAR en Python.

        resultado = resultado + letra.lower()
        # .lower() convierte la letra a minúscula.
        # Si ya era minúscula, no cambia nada.
        # La añadimos al final de "resultado".
        # ALTERNATIVA más corta: resultado += letra.lower()

    else:
        # Si la posición es impar (resto 1)

        resultado = resultado + letra.upper()
        # .upper() convierte la letra a mayúscula.
        # Los espacios y comas no cambian con upper() ni lower().

print(resultado)
# Muestra la cadena transformada al estilo "camello alternado":
# "Hola que tal, Python es genial"
#  ↓
# "hOlA QuE TaL, pYtHoN Es gEnIaL"
# (posiciones pares en minúscula, impares en mayúscula)


# =============================================================================
# FUNCIÓN texto_camello()
# =============================================================================
# Metemos todo el proceso en una función para poder reutilizarlo con
# cualquier texto sin tener que reescribir el código.
#
# Entrada:  una cadena de texto cualquiera
# Salida:   la misma cadena con letras alternadas mayúscula/minúscula
#
# Ejemplo: texto_camello("hola") → "hOlA"
# =============================================================================

def texto_camello(cadena):
    # "def" define la función. "cadena" es el parámetro:
    # el texto que recibirá la función cuando la llamemos.
    # Este "cadena" es LOCAL a la función, no tiene nada que ver
    # con la variable "cadena" que declaramos arriba.

    resultado = ""
    # IMPORTANTE: declaramos resultado DENTRO de la función.
    # Cada vez que llamemos a la función, resultado empieza vacío desde cero.
    # Si estuviera fuera, las llamadas anteriores acumularían texto sobrante.

    for posicion, letra in enumerate(cadena):
        # Recorremos la cadena que nos han pasado como parámetro,
        # obteniendo posición y letra en cada vuelta.

        print(posicion + 1, letra)
        # Muestra el progreso por pantalla mientras trabaja.
        # En un programa real probablemente quitaríamos este print,
        # ya que solo nos interesa el resultado final.

        if posicion % 2 == 0:
            resultado = resultado + letra.lower()
            # Posición par → minúscula
        else:
            resultado = resultado + letra.upper()
            # Posición impar → mayúscula

    return resultado
    # Devuelve la cadena transformada al lugar donde se llamó la función.
    # Sin "return" la función haría todo el trabajo pero no compartiría el resultado.


# =============================================================================
# LLAMADAS A LA FUNCIÓN
# =============================================================================

cadena = "Hola que tal, Python es genial"
# Reasignamos la variable cadena (la anterior también valía, pero así
# queda claro con qué texto trabajamos en esta sección).

print(texto_camello("hola que tal"))
# Llamada con texto directo (literal de cadena).
# La función recibe "hola que tal" como parámetro.
# Imprime: "hOlA QuE TaL"

print(texto_camello(cadena))
# Llamada pasando una variable como argumento.
# La función recibe el contenido de "cadena": "Hola que tal, Python es genial"
# Imprime: "hOlA QuE TaL, pYtHoN Es gEnIaL"

versos = ["Vi un gato muerto", "espanzurrado en la carretera", "una gaviota acechaba", "y la tormenta tronaba"]
# Lista de cadenas. Cada elemento es una línea de un poema.
# Podría ser cualquier colección de textos: nombres, frases, párrafos...

for verso in versos:
    # Recorremos la lista. En cada vuelta "verso" toma el valor de la siguiente línea.
    # Vuelta 1: verso = "Vi un gato muerto"
    # Vuelta 2: verso = "espanzurrado en la carretera"
    # ...

    print(texto_camello(verso))
    # Aplicamos la función a cada verso y mostramos el resultado.
    # Salida:
    #   "vI Un gAtO MuErTo"
    #   "eSpAnZuRrAdO En lA CaRrEtErA"
    #   "uNa gAvIoTa aCeChAbA"
    #   "y lA ToRmEnTa tRoNaBa"
    #
    # ALTERNATIVA con comprensión de listas:
    #   transformados = [texto_camello(v) for v in versos]
    #   print('\n'.join(transformados))

Más repaso while

# =============================================================================
# CALCULAR LA MEDIA DE UNA SERIE DE NÚMEROS
# =============================================================================
# Este programa pide números al usuario uno a uno y los va sumando.
# Cuando el usuario introduce un 0, el programa para y calcula la media.
#
# La media es la suma de todos los números dividida entre cuántos hay.
# Ejemplo: si introduces 4, 8 y 6 → media = (4+8+6) / 3 = 6.0
#
# Interacción esperada:
#   Digite un numero: 4
#   Digite un numero: 8
#   Digite un numero: 6
#   Digite un numero: 0   ← el 0 para el bucle, no se suma
#   6.0
# =============================================================================


def calcular_media():
    # Definimos la función. No recibe parámetros porque los datos
    # los pedirá ella misma al usuario con input().
    # Devolverá un número decimal (float) con la media calculada.

    numero = float(input("Digite un numero: "))
    # Pedimos el PRIMER número antes del bucle.
    # Necesitamos hacerlo aquí para poder comprobar la condición del while.
    # float() convierte el texto que escribe el usuario a número decimal.
    # Usamos float en lugar de int para aceptar números como 3.5 o 7.8.
    # PRUEBA: cambia float() por int() e intenta introducir 3.5 para ver el error.

    suma = 0
    # Variable acumuladora: irá sumando todos los números que introduzca el usuario.
    # Siempre se inicializa a 0 antes del bucle.
    # Ejemplo paso a paso con 4, 8, 6:
    #   Antes del bucle: suma = 0
    #   Tras el 4:       suma = 4
    #   Tras el 8:       suma = 12
    #   Tras el 6:       suma = 18

    contador = 0
    # Variable contadora: cuenta cuántos números ha introducido el usuario.
    # También se inicializa a 0. La necesitamos para dividir al calcular la media.
    # Ejemplo: con 4, 8 y 6 → contador llegará a 3.
    # ¡IMPORTANTE! El 0 final NO se cuenta porque para el bucle antes de sumarlo.

    while numero != 0:
        # El bucle se repite MIENTRAS el número introducido sea distinto de 0.
        # En cuanto el usuario escribe 0, el bucle termina sin sumar ni contar ese 0.
        # "!=" significa "distinto de".
        # ALTERNATIVA equivalente: while not numero == 0:

        # ↓ Aquí estaba el comentario "????" en el código original.
        # Lo que hace este bloque es acumular el número en la suma
        # y aumentar el contador en 1 por cada número válido introducido.

        suma = suma + numero
        # Añadimos el número actual a la suma acumulada.
        # Es lo mismo que escribir: suma += numero
        # Solo llegamos aquí si numero != 0, así que el 0 nunca se suma.

        contador = contador + 1
        # Contamos este número como válido.
        # Es lo mismo que escribir: contador += 1

        numero = float(input("Digite un numero: "))
        # Pedimos el SIGUIENTE número al final del bucle.
        # Esto sobreescribe el valor anterior de "numero".
        # En la próxima comprobación del while se usará este nuevo valor.
        # Si el usuario escribe 0 aquí, el while parará en su próxima vuelta.

    # Cuando llegamos aquí, el bucle ya ha terminado.
    # En este punto sabemos que:
    #   - "suma" tiene la suma de todos los números introducidos (sin el 0)
    #   - "contador" tiene cuántos números se introdujeron (sin el 0)

    return suma / contador
    # Calculamos y devolvemos la media: suma total dividida entre cuántos números hay.
    # CUIDADO: si el usuario introduce 0 como primer número, contador valdrá 0
    # y dividir entre 0 causará un error (ZeroDivisionError).
    # MEJORA para evitar ese error:
    #   if contador == 0:
    #       return 0
    #   return suma / contador


# =============================================================================
# PROGRAMA PRINCIPAL
# =============================================================================

media = calcular_media()
# Llamamos a la función. Esta ejecuta todo el proceso de pedir números
# y calcular la media. El resultado que devuelve "return" se guarda aquí.

print(media)
# Mostramos la media por pantalla.
# MEJORA para que quede más claro:
#   print(f"La media de los números introducidos es: {media:.2f}")
#   El :.2f muestra solo 2 decimales. Ejemplo: 6.333333 → 6.33

Repaso while

# =============================================================================
# FUNCIONES CON VALIDACIÓN Y LISTAS EN PYTHON
# =============================================================================
# En este programa vamos a ver cómo crear una función que:
#   1. Pide un dato al usuario
#   2. Comprueba que el dato sea correcto (validación)
#   3. Devuelve el dato para usarlo desde fuera
#
# Después veremos TRES formas distintas de usar esa función:
#   - Imprimir el resultado directamente
#   - Guardarlo en una variable
#   - Añadirlo a una lista
#
# Y por último, un ejemplo real: recoger las notas de un grupo de alumnos.
# =============================================================================


# =============================================================================
# DEFINICIÓN DE LA FUNCIÓN pedir_nota()
# =============================================================================
# Una función es un bloque de código con nombre que podemos reutilizar
# tantas veces como queramos sin tener que reescribirlo.
#
# Esta función:
#   - No recibe ningún parámetro (los paréntesis están vacíos)
#   - Se encarga de pedir una nota válida al usuario
#   - Devuelve la nota una vez validada
# =============================================================================

def pedir_nota():
    # "def" le dice a Python que vamos a definir una función.
    # "pedir_nota" es el nombre que le damos (debe ser descriptivo).
    # Los "():" al final son obligatorios aunque no haya parámetros.
    # Todo lo que esté indentado (con sangría) pertenece a la función.

    print("Introduce una nota entre 1 y 10")
    # Mensaje informativo para que el usuario sepa qué se espera de él.

    nota = int(input("Introduce la nota (1 y 10): "))
    # input() pide texto al usuario. int() lo convierte a número entero.
    # Si el usuario escribe "7", sin int() tendríamos la cadena "7", no el número.
    # PRUEBA: quita el int() y verás que la comparación nota < 1 da error.

    while nota < 1 or nota > 10:
        # Bucle de validación: se repite MIENTRAS la nota sea incorrecta.
        # "or" significa que basta con que UNA de las dos condiciones sea True
        # para que el bucle continúe.
        # Ejemplos de notas incorrectas: 0, -5, 11, 100
        # ALTERNATIVA equivalente: while not (1 <= nota <= 10):

        print("Nota incorrecta, mendrugo")
        # Mensaje de error. En un programa real usaríamos algo más amable,
        # como: print("Nota incorrecta. Debe estar entre 1 y 10.")

        nota = int(input("Introduce la nota (1 y 10): "))
        # Volvemos a pedir la nota para que el usuario pueda corregirla.
        # Esto SOBREESCRIBE el valor anterior de "nota".
        # En la siguiente vuelta del while, se comprobará este nuevo valor.

    return nota
    # "return" devuelve el valor de "nota" al lugar donde se llamó la función.
    # Solo llegamos aquí cuando la nota ES válida (el while ha terminado).
    # Sin "return", la función haría todo el proceso pero no nos daría el resultado.
    # Sería como una máquina expendedora que acepta el dinero pero no da el producto.


# =============================================================================
# CASOS DE USO: TRES FORMAS DE USAR LA FUNCIÓN
# =============================================================================
# Una función puede usarse de varias maneras según lo que necesitemos hacer
# con el valor que devuelve. Aquí vemos las tres más habituales.
# =============================================================================

# --- CASO 1: Imprimir el resultado directamente ---
print(pedir_nota())
# Python ejecuta pedir_nota(), obtiene la nota válida y la pasa a print().
# El valor devuelto por la función se usa al momento y no se guarda en ningún sitio.
# Útil cuando solo queremos mostrar el resultado una vez.

# --- CASO 2: Guardar el resultado en una variable ---
nota_alumno = pedir_nota()
# El valor que devuelve pedir_nota() se guarda en la variable "nota_alumno".
# A partir de aquí podemos usar "nota_alumno" tantas veces como queramos.
# VENTAJA respecto al caso 1: podemos usar el valor varias veces sin pedir
# la nota de nuevo. Por ejemplo: print(nota_alumno), calcular media, etc.

# --- CASO 3: Añadir el resultado a una lista ---
lista_notas = []
# Creamos una lista vacía con []. Aquí iremos acumulando notas.

lista_notas.append(nota_alumno)
# .append() añade un elemento AL FINAL de la lista.
# Aquí añadimos la nota que ya teníamos guardada en la variable del caso 2.
# lista_notas pasa de [] a [nota_alumno], por ejemplo: [7]

lista_notas.append(pedir_nota())
# Llamamos a pedir_nota() y el valor que devuelve se añade directamente a la lista.
# Es lo mismo que hacer:
#   nueva_nota = pedir_nota()
#   lista_notas.append(nueva_nota)
# pero en una sola línea.

print(lista_notas)
# Imprime la lista completa con los dos valores acumulados.
# Ejemplo de salida: [7, 9]


# =============================================================================
# EJEMPLO REAL: RECOGER LAS NOTAS DE UN GRUPO DE ALUMNOS
# =============================================================================
# Ahora combinamos todo lo anterior con un bucle for para recorrer
# una lista de nombres y pedir la nota de cada alumno.
# Este es el patrón más habitual en programas reales.
# =============================================================================

alumnos = ["Monica", "Ermengol", "Jordi", "Marisol"]
# Lista con los nombres de los alumnos del grupo.
# ALTERNATIVA: pedir los nombres por teclado con un bucle while.

notas = []
# Lista vacía donde iremos guardando las notas según las vayamos pidiendo.
# Es importante crearla ANTES del bucle para no borrarla en cada vuelta.

for alumno in alumnos:
    # El bucle recorre la lista "alumnos" de principio a fin.
    # En cada vuelta, "alumno" toma el valor del siguiente nombre:
    #   Vuelta 1: alumno = "Monica"
    #   Vuelta 2: alumno = "Ermengol"
    #   Vuelta 3: alumno = "Jordi"
    #   Vuelta 4: alumno = "Marisol"

    print("Dime la nota del alumno", alumno)
    # Informamos de qué alumno estamos introduciendo.
    # Ejemplo de salida: "Dime la nota del alumno Monica"
    # ALTERNATIVA con f-string: print(f"Dime la nota de {alumno}")

    notas.append(pedir_nota())
    # Llamamos a pedir_nota() para obtener una nota válida
    # y la añadimos al final de la lista "notas".
    # Al terminar el bucle, "notas" tendrá una nota por cada alumno.
    # Ejemplo: [8, 6, 9, 7]

# Al salir del bucle tenemos dos listas relacionadas:
#   alumnos = ["Monica", "Ermengol", "Jordi",  "Marisol"]
#   notas   = [8,        6,          9,         7       ]
# El alumno de la posición 0 tiene la nota de la posición 0, etc.
#
# RETO 1: imprime cada alumno con su nota usando un bucle for y range().
# RETO 2: calcula la nota media del grupo con sum(notas) / len(notas).
# RETO 3: encuentra al alumno con la nota más alta.