100 Días de Código en Python — Día 17: Crear Clases Propias y el Proyecto Quiz

📖 Explicación conceptual#

class User:
    pass

user_1 = User()     # construir un objeto a partir de la clase

• class + el nombre + dos puntos :. Todo lo que va dentro de la clase lleva sangría.
• Una clase (o función) vacía produce un error de sangría. La palabra clave pass significa "no hago nada por ahora; sigue".

🛠️ Nota técnica: la transcripción dice que la declaración termina con "un punto y coma". Es un error de traducción: se trata de dos puntos (:). En Python, el punto y coma (;) casi nunca se usa.

Convenciones de nombres:

El nombre PascalCase viene de Blaise Pascal: como en el nombre de una persona, cada palabra empieza con mayúscula.

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: crea las clases vacías Estudiante, Curso y Materia y construye un objeto de cada una.
• 🟡 Reto 2: escribe cada identificador con la convención correcta: "número de lista", "calcular promedio", "boletín académico", "nota final" (clase o variable, según el caso).
• 🟠 Reto 3: imprime un objeto de tu clase vacía. ¿Qué ves? Compáralo con print(timmy) del Día 16.
• 🔴 Reto 4: busca en la guía de estilo PEP 8 (se abre en otra pestaña) la sección de convenciones de nombres y resume en 5 líneas qué dice sobre las clases, las funciones y las constantes (Día 12).

🎯 Objetivo de aprendizaje#

• Definir atributos al construir el objeto, usando __init__.
• Dar valores por defecto a los atributos que no se reciben como parámetro.

📖 Explicación conceptual#

Forma 1: agregar atributos "desde fuera" (funciona, pero es propensa a errores):

user_1 = User()
user_1.id = "001"
user_1.username = "angela"
user_2 = User()
user_2.id = "002"
user_2.usernme = "jack"    # ¡error de tipeo! Crea un atributo distinto y Python no avisa

Forma 2: el constructor __init__ (recomendada):

class User:
    def __init__(self, user_id, username):
        print("Nuevo usuario creado...")
        self.id = user_id
        self.username = username
        self.followers = 0          # valor por defecto: no se recibe como parámetro

user_1 = User("001", "angela")      # 1 línea en lugar de 3
print(user_1.username)              # angela
print(user_1.followers)             # 0

• __init__ (con dos guiones bajos a cada lado) es un método especial que Python ejecuta automáticamente cada vez que se construye un objeto. Se le llama constructor, y el proceso se llama inicializar.
• self es el objeto que se está construyendo. self.id = user_id significa "el atributo id de este objeto toma el valor recibido".
• El parámetro (user_id) y el atributo (self.id) pueden llamarse distinto, aunque la convención es que se llamen igual.
• Valores por defecto: un atributo como followers empieza en 0 para todos los usuarios. No tiene sentido pedirlo al construir el objeto.

Si la clase pide parámetros, hay que darlos:

User()   # ❌ TypeError: User.__init__() missing 2 required positional arguments: 'user_id' and 'username' (verificado)

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: clase Estudiante con nombre y curso recibidos como parámetros, y notas = [] por defecto.
• 🟡 Reto 2: clase Carro con marca y asientos (el curso usa seats = 5). Crea dos carros y verifica que sus atributos son independientes.
• 🟠 Reto 3: demuestra con código el problema de la "Forma 1": crea un atributo con un error de tipeo y explica por qué Python no avisa.
• 🔴 Reto 4: investiga cómo dar un valor por defecto a un parámetro del constructor (def __init__(self, nombre, curso="10A"):). ¿En qué se diferencia de un atributo con valor por defecto?

📖 Explicación conceptual#

Un método es una función definida dentro de la clase. Siempre recibe self como primer parámetro, para saber qué objeto lo está llamando.

Ejemplo del curso: modo carreras. Los autos de carreras quitan asientos para pesar menos:

class Car:
    def __init__(self):
        self.seats = 5

    def enter_race_mode(self):
        self.seats = 2

Ejemplo del curso: seguir usuarios en una red social:

class User:
    def __init__(self, user_id, username):
        self.id = user_id
        self.username = username
        self.followers = 0
        self.following = 0

    def follow(self, user):
        user.followers += 1      # el OTRO usuario gana un seguidor
        self.following += 1      # YO sigo a una persona más

user_1 = User("001", "angela")
user_2 = User("002", "jack")
user_1.follow(user_2)
print(user_1.followers, user_1.following)   # 0 1
print(user_2.followers, user_2.following)   # 1 0

(Resultados verificados.)

Sobre self: "Nunca verás self cuando usas objetos, pero lo verás mucho cuando escribes tus clases." Al llamar user_1.follow(user_2), Python pasa user_1 como self automáticamente.

⚠️ Errores frecuentes#

• Olvidar self en la definición: def follow(user): produce TypeError: follow() takes 1 positional argument but 2 were given.
• Olvidar self. al usar un atributo: followers += 1 dentro del método produce un UnboundLocalError o un NameError, porque crea o busca una variable local, no el atributo (Día 12).
• Confundir el objeto con la clase: User.follow(user_2) no funciona como se espera, porque falta el objeto que sigue.

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: agrega a Estudiante el método agregar_nota(nota) y el método promedio(), que devuelva el promedio (Día 10).
• 🟡 Reto 2: agrega a User el método unfollow(user). ¿Qué validación necesita?
• 🟠 Reto 3: crea una clase CuentaAhorro con los métodos depositar, retirar (sin permitir saldo negativo) y consultar.
• 🔴 Reto 4: en tu User, ¿qué pasa si un usuario se sigue a sí mismo, o sigue dos veces al mismo usuario? Diseña atributos (por ejemplo, una lista seguidos) y validaciones para evitarlo.

Problema#

Construir un cuestionario de Verdadero o Falso que muestre las preguntas numeradas, revise cada respuesta, informe la respuesta correcta y el puntaje acumulado, y al final muestre el puntaje final.

Estructura del proyecto (4 archivos)#

El código inicial del curso (quiz-game-start, con 12 preguntas en inglés) no está incluido entre los materiales suministrados. Este tutorial usa un banco de preguntas en español creado para esta adaptación:

123456

question_data = [
    {"text": "En Python, el primer índice de una lista es 0.", "answer": "True"},
    {"text": "El operador % de Python calcula porcentajes.", "answer": "False"},
    {"text": "len('Python') es igual a 6.", "answer": "True"},
    {"text": "Un byte está formado por 8 bits.", "answer": "True"},
]

classDiagram
    class Question {
        text
        answer
    }
    class QuizBrain {
        question_number = 0
        score = 0
        question_list
        still_has_questions()
        next_question()
        check_answer(user_answer, correct_answer)
    }
    QuizBrain --> Question : usa una lista de

📝 Parte 1: la clase Question#

Enunciado: en question_model.py, crea Question con un __init__ que reciba el texto y la respuesta y los guarde en los atributos text y answer. Prueba: new_q = Question("2 + 3 = 5", "True") y luego print(new_q.text).

📝 Parte 2: el banco de preguntas#

Enunciado: en main.py, convierte la lista de diccionarios en una lista de objetos Question llamada question_bank.

🔍 Antes de programar#

• ¿Cómo recorres question_data? ¿Qué clave usas para obtener el texto y cuál para la respuesta?
• ¿Por qué conviene tener objetos en lugar de diccionarios? (El curso lo explica: con claves de texto es fácil cometer errores de tipeo; con atributos, el editor autocompleta y avisa.)

Estructura de la solución: una lista vacía → un for → construir Question(texto, respuesta) → append. Con los datos del curso quedan 12 objetos.

Consejo de formato del curso: en PyCharm, Code → Auto-Indent Lines organiza la sangría de los datos, y las líneas de más de 120 caracteres se pueden dividir presionando Enter dentro del string.

📝 Parte 3: QuizBrain y next_question()#

Enunciado:

1. Crea QuizBrain con question_number = 0 (valor por defecto) y question_list, que se recibe al construir el objeto.
2. Crea next_question(): toma la pregunta en la posición question_number, suma 1 al número y pide la respuesta con el formato P.1: texto (True/False):.

Detalle que resuelve el curso: question_number empieza en 0 para acceder al índice 0 de la lista, pero el usuario debe ver "P.1". La solución es sumar 1 justo después de tomar la pregunta y antes de mostrarla.

📝 Parte 4: repetir con still_has_questions()#

Enunciado: crea still_has_questions(), que devuelve True mientras queden preguntas, y úsalo en main.py con while quiz.still_has_questions():.

Simplificación que muestra el curso:

# Versión larga
if self.question_number < len(self.question_list):
    return True
else:
    return False

# Versión corta: la comparación YA ES True o False
return self.question_number < len(self.question_list)

📝 Parte 5: revisar las respuestas y el puntaje#

Enunciado:

1. Agrega el atributo score = 0.
2. Crea check_answer(user_answer, correct_answer). Compara en minúsculas (.lower()), suma un punto si acierta, muestra "¡Correcto!" o "Incorrecto" y, en ambos casos, la respuesta correcta y el puntaje score/question_number.
3. Al terminar, main.py muestra "Completaste el cuestionario" y el puntaje final.

Pruebas (con el banco de preguntas en español)#

🛠️ Nota técnica (verificada): la prueba 4 muestra un problema de la versión en español: un estudiante que responde "verdadero" recibe "Incorrecto", porque la respuesta guardada es "True". Mejoras: (a) aceptar v/f y verdadero/falso traduciéndolos antes de comparar, o (b) guardar las respuestas como True/False (booleanos) y convertir la entrada. Además, una entrada distinta de verdadero o falso debería volver a preguntarse, no contar como error (kit del Día 13).

🧪 Prueba y depuración#

Este QuizBrain tiene cuatro errores:

class QuizBrain:
    def __init__(self, q_list):
        self.question_number = 0
        self.question_list = q_list

    def still_has_questions(self):
        return self.question_number <= len(self.question_list)

    def next_question(self):
        current_question = self.question_list[self.question_number]
        user_answer = input(f"P.{self.question_number}: {current_question.text}: ")
        self.check_answer(user_answer, current_question.answer)

    def check_answer(user_answer, correct_answer):
        if user_answer.lower() == correct_answer.lower():
            self.score += 1

(Pistas: un <= que produce IndexError, un número que nunca aumenta, un método sin self y un atributo que no se inicializó.)

⭐ Extensión del proyecto#

• Mezclar las preguntas al inicio con random.shuffle (Día 5).
• Mostrar el porcentaje de aciertos al final.
• Aceptar las respuestas en español (ver la nota técnica).

📖 Explicación conceptual#

El curso cambia todas las preguntas por otras de Open Trivia DB (se abre en otra pestaña), una base de datos gratuita con miles de preguntas de trivia aportadas y verificadas por su comunidad. Allí se genera una URL con el número de preguntas, la categoría, la dificultad y el tipo (verdadero o falso), y el resultado viene en formato JSON (JavaScript Object Notation), que se parece mucho a un diccionario de Python.

Lo que cambió en el código: solo dos claves en main.py, porque los nuevos datos usan "question" y "correct_answer" en lugar de "text" y "answer". QuizBrain no se tocó.

"Esto es modularidad en su máxima expresión." Podrías cambiar los datos a otro idioma, tema o formato, y a QuizBrain no le importaría: solo sabe llevar el número de pregunta, mostrar la siguiente y revisar la respuesta. Un compañero podría trabajar en QuizBrain mientras otro consigue los datos, sin estorbarse.

🛠️ Nota técnica: las preguntas de Open Trivia DB suelen incluir entidades HTML, como " en lugar de " y ' en lugar de '. Si se pegan tal cual, el cuestionario las muestra así. Solución: import html y html.unescape(texto). Verificado: html.unescape("The "Windows" OS's logo") → The "Windows" OS's logo. Además, las preguntas están en inglés.

📝 Ejercicio original del curso: nuevos datos#

Enunciado: genera 10 preguntas de Verdadero o Falso en Open Trivia DB (el curso usa la categoría de computación, dificultad fácil), reemplaza question_data con la lista "results" y ajusta main.py para que funcione sin tocar QuizBrain.

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: genera preguntas de otra categoría y verifica que el cuestionario funciona cambiando solo los datos.
• 🟡 Reto 2: aplica html.unescape al construir cada Question.
• 🟠 Reto 3: agrega a Question el atributo category, llénalo con los datos de Open Trivia DB y muéstralo antes de cada pregunta. ¿Tuviste que tocar QuizBrain?
• 🔴 Reto 4: escribe un párrafo que explique, con este proyecto como ejemplo, dos ventajas de la POO frente a la programación procedimental del Día 15.

Situación#

Los docentes de distintas áreas quieren usar el Quiz para repasar antes de las evaluaciones.

Requisitos#

1. Cada estudiante escribe 5 preguntas de Verdadero o Falso de una materia (Ciencias, Sociales, Matemáticas…), verificando las respuestas en una fuente confiable, y las agrega a un data.py común.
2. Agregar a cada pregunta las claves "materia" y "autor".
3. Ampliar Question con esos atributos.
4. Al inicio, el usuario elige la materia (o "todas") y solo se construyen los objetos Question de esa materia.
5. Sin modificar la lógica de QuizBrain, salvo lo estrictamente necesario. Documenta qué cambiaste y por qué.

Revisión por pares#

Cada pregunta la revisa otro estudiante, que confirma la respuesta con una fuente. Registra en un comentario quién la revisó.

Situación problema#

El Verdadero o Falso tiene un 50 % de probabilidad de acertar al azar. Para estudiar de verdad, los estudiantes quieren preguntas de selección múltiple y un informe de las preguntas en las que fallaron.

Pregunta orientadora#

¿Cómo diseñar tus propias clases para un problema nuevo, repartiendo bien las responsabilidades entre ellas?

Requerimientos#

1. Datos en data.py como lista de diccionarios; main.py los convierte en objetos.
2. Validar que la respuesta sea A, B, C o D (en mayúscula o minúscula) sin gastar la pregunta.
3. Al final, el informe lista las preguntas falladas agrupadas por tema.
4. Ninguna clase usa variables globales; todo viaja por atributos, parámetros y return.

Entregables#

• Un diagrama de clases (puede ser en Mermaid, como el de la Sección 4, o en papel).
• El código en 4 archivos o más.
• Una tabla de pruebas.
• Una explicación de por qué repartiste así las responsabilidades.

Criterios técnicos#

• PreguntaMultiple sigue siendo correcta aunque se mezclen las opciones: la letra correcta cambia, pero la validación funciona.
• Cambiar el archivo de datos no requiere tocar ninguna clase.
• Todas las clases y métodos tienen docstring.