Cursus — Python Module 07 pendiente

«DataDeck»: un juego de cartas de criaturas al estilo de los de coleccionar monstruos que sirve de excusa para tres patrones de diseño — factoría abstracta, capacidades separadas y estrategia —. Módulo del rank 02.

Pensar como arquitecto — Hasta aquí los módulos de Python enseñaban herramientas del lenguaje: clases, herencia, clases abstractas, polimorfismo, imports. DataDeck da el salto a cómo se combinan esas piezas para que un sistema aguante miles de tipos distintos sin volverse inmantenible. Los patrones que usa vienen de Design Patterns: Elements of Reusable Object-Oriented Software (1994), el libro de la llamada «Banda de los Cuatro» (Gamma, Helm, Johnson y Vlissides), que puso nombre a soluciones que los programadores ya repetían una y otra vez. El enunciado lo resume en su prólogo con un guiño: «Gotta catch ’em all; but sometimes, the real treasure is the skills we made along the way». Como prerrequisito pide dominar herencia, clases abstractas, polimorfismo e imports, y recomienda hacer antes los proyectos correspondientes. Ojo: el Module 06 bis incluye una versión reducida de estos mismos ejercicios.

Qué pide

Rank: 02Python: 3.10 o posteriorObligatorio: flake8, mypy (anotaciones de tipo completas)Prohibido: eval(), exec(), librerías externas

Tres ejercicios, cada uno en su carpeta ex0/, ex1/ y ex2/, que deben ser paquetes: el __init__.py es obligatorio en cada una. Los scripts de prueba (battle.py, capacitor.py, tournament.py) van en la raíz del repositorio. En todos se pueden usar las funciones integradas, los tipos estándar, typing y abc. Las funciones deben manejar las excepciones con cuidado para no provocar cierres inesperados.

Los ejercicios se construyen uno sobre otro: el ex1 usa el paquete del ex0 y el ex2 usa los dos.

ex0Creature Factory

Entrega: battle.py, ex0/ como paqueteAutorizado: builtins, tipos estándar, typing, abc

Las cartas básicas. En ex0/:

battle.py instancia las dos factorías, usa una única función que recibe una factoría y comprueba que crea la base y la evolucionada y que ambas se describen y atacan, y otra función que recibe las dos factorías y hace pelear a sus criaturas base. Se pueden usar otras criaturas siempre que se mantengan las familias y las factorías abstractas.

Qué te obliga a aprender — El patrón factoría abstracta: una interfaz para crear familias de objetos relacionados sin nombrar sus clases concretas. El código cliente recibe «una factoría» y le pide «la base» o «la evolucionada»; no sabe ni le importa si son de fuego o de agua. Cambiar de familia es cambiar de factoría, sin tocar una línea del resto. El requisito de que el paquete solo exponga las factorías es lo que lo hace real: si el cliente pudiera importar Flameling directamente, nada le impediría saltarse el patrón. Ahí entra lo aprendido sobre __init__.py como interfaz pública del paquete.

ex1Capabilities

Entrega: capacitor.py, ex1/ como paqueteAutorizado: builtins, tipos estándar, typing, abc

Capacidades extra que «quizá algún día» no se apliquen solo a criaturas, así que se mantienen aparte: las clases de capacidad no heredan de Creature. En ex1/, construido sobre el paquete del ex0:

capacitor.py crea la factoría curativa y, con la base y la evolucionada: describir, atacar, curar. Luego la de transformación: describir, atacar, transformar, atacar de nuevo y revertir. El segundo ataque debe notar la transformación.

La herencia múltiple en Python, en general:

class Pato(Animal, Volador, Nadador):
    ...   # hereda de las tres; el orden importa para resolver métodos
Qué te obliga a aprender — A separar lo que algo es de lo que algo sabe hacer. Si heal estuviera en Creature, todas las criaturas tendrían que implementarla aunque no curen, y ninguna otra cosa que no sea criatura podría curar. Una capacidad como clase abstracta independiente es lo que en Java se llamaría una interfaz y en Python suele llamarse mixin. También introduce la herencia múltiple y el MRO (orden de resolución de métodos), que Python calcula con el algoritmo C3 para decidir de qué padre sale cada método, y el estado interno que cambia el comportamiento de un objeto (un atributo que hace que el mismo attack devuelva otra cosa).

ex2Abstract Strategy

Entrega: tournament.py, ex2/ como paqueteAutorizado: builtins, tipos estándar, typing, abc

Cada familia actúa distinto: la curativa cura después de atacar, la transformable se transforma, ataca y revierte. Un torneo con cartas de varias familias necesitaría un código de combate que conozca cada capacidad… o no. En ex2/:

tournament.py crea factorías de ex0 y ex1 y las tres estrategias, y define una única función de combate que recibe la lista de rivales —cada uno, una tupla de CreatureFactory y BattleStrategy—, hace que cada rival luche una vez contra todos los demás, organiza cada pelea según la estrategia de cada criatura y gestiona bien las parejas inválidas. El ejemplo del enunciado muestra tres torneos: uno básico, uno que se aborta por una pareja inválida y uno con tres rivales (tres combates).

Qué te obliga a aprender — El patrón estrategia: encapsular cada forma de comportarse en un objeto intercambiable con una interfaz común. El torneo solo sabe llamar a act; quién cura, quién se transforma o quién solo ataca lo decide la estrategia asociada. Añadir una capacidad nueva significa añadir una estrategia, no reescribir el torneo. También obliga a comprobar capacidades en tiempo de ejecución (isinstance contra la clase abstracta de la capacidad, no contra la familia concreta), a definir tu propia excepción y a generar todos los emparejamientos de una lista sin repetir ninguno.

Puntos delicados

Fuente

«DataDeck — Abstract Card Architecture», versión 3.0: packs/cursus/M2/209_Python_Module_07/en.subject.pdf (texto en subject.txt). Solo existe en inglés. Slug de la intra: python-module-07.