Introducción a la programación con Python

Entrega y revisión del proyecto

Esta lección cierra el curso. Aquí encuentras qué debes entregar, con qué criterios se revisa tu trabajo y cómo comprobar por tu cuenta que el proyecto está completo antes de darlo por terminado.

Qué debes entregar

El proyecto final es la Calculadora de Datos: un programa que recibe una lista de números y reporta estadísticas básicas. La entrega consiste en un notebook ejecutable que, sin errores, produzca:

• La cantidad de valores procesados.
• La suma, el promedio, el mínimo y el máximo.
• Un conteo de cuántos valores están por encima del promedio.
• Un breve resumen final impreso de forma legible.

El notebook debe correr de principio a fin sin intervención manual y sin depender de archivos externos: los datos de ejemplo van definidos dentro del propio código.

Estructura sugerida

Organiza el programa en funciones pequeñas, cada una con una responsabilidad. Esto facilita la revisión y la reutilización.

def resumen(numeros):
    total = sum(numeros)
    promedio = total / len(numeros)
    sobre_promedio = [n for n in numeros if n > promedio]
    return {
        "cantidad": len(numeros),
        "suma": total,
        "promedio": promedio,
        "minimo": min(numeros),
        "maximo": max(numeros),
        "sobre_promedio": len(sobre_promedio),
    }

datos = [10, 4, 7, 22, 3, 15]
print(resumen(datos))

Criterios de revisión

Tu proyecto se evalúa con una rúbrica simple. Cada punto vale y conviene revisarlo antes de entregar:

• Corrección: los cálculos son correctos para distintas listas de entrada.
• Robustez: el programa maneja el caso de una lista vacía sin romperse.
• Legibilidad: nombres claros, funciones cortas y comentarios donde aportan.
• Reproducibilidad: el notebook corre completo sin errores ni pasos manuales.

Cómo autoevaluar antes de entregar

Prueba con varias entradas: una lista normal, una lista con un solo elemento y una lista vacía. Si la lista vacía provoca una división entre cero, agrega una comprobación al inicio que devuelva un mensaje claro en lugar de fallar. Ejecuta el notebook desde cero (reiniciando el kernel) para confirmar que no dependes de variables definidas fuera de orden.

Cómo organizar el notebook para la entrega

Un notebook ordenado se revisa más rápido y comunica mejor tu trabajo. Empieza con una celda de texto que explique en una o dos frases qué hace el programa. Después, coloca cada función en su propia celda de código, en el orden en que se usan: primero las funciones de cálculo, luego la de presentación y al final una celda que ejecute todo con datos de ejemplo. Agrega comentarios cortos solo donde el código no sea evidente por sí mismo; comentar cada línea estorba más de lo que ayuda. Antes de entregar, usa nombres descriptivos para las funciones y las variables, de modo que quien revise entienda la intención sin tener que ejecutar nada. Un notebook así se lee como una pequeña historia: qué se calcula, cómo se calcula y qué resultado produce.

Errores comunes en la entrega

• Dejar celdas que dependen de resultados calculados manualmente antes.
• No contemplar la lista vacía y provocar un error de división.
• Mezclar el cálculo con la impresión en una sola función difícil de probar.
• Entregar un notebook que no corre de principio a fin.

Cierre

Si tu notebook cumple la rúbrica y corre limpio de principio a fin, el proyecto está listo. Con esto cierras la introducción a la programación con Python y quedas con una base sólida para seguir a temas más avanzados.