«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.
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.
Las cartas básicas. En ex0/:
Creature con atributos para el nombre y el tipo, un
método abstracto attack y un método concreto genérico
describe que devuelve un mensaje estándar con nombre y tipo («Flameling is a
Fire type Creature»).Flameling, Pyrodon,
Aquabub y Torragon, cada una con su mensaje de ataque.CreatureFactory con los métodos abstractos
create_base y create_evolved.FlameFactory (Flameling y Pyrodon) y
AquaFactory (Aquabub y Torragon).ex0 no puede exponer las criaturas concretas: solo
las factorías.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.
Flameling directamente, nada le impediría saltarse el patrón. Ahí entra lo
aprendido sobre __init__.py como interfaz pública del paquete.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:
HealCapability, abstracta, con el método abstracto heal (que
puede recibir un objetivo si quieres).TransformCapability, abstracta, con transform y
revert. Un atributo guarda el estado de forma persistente y afecta a lo que
hace attack en las criaturas que la tienen.attack.Sproutling y Bloomelle heredan de Creature y de
HealCapability, y forman una familia que se obtiene con
HealingCreatureFactory.Shiftling y Morphagon heredan de Creature y de
TransformCapability, con su TransformCreatureFactory.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
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).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/:
BattleStrategy, abstracta, con act e
is_valid. is_valid devuelve un bool que dice si una
criatura es adecuada para la estrategia; act es lo que llama el torneo.NormalStrategy (cualquier criatura, solo
ataca), AggressiveStrategy (criaturas que se transforman: transformar, atacar,
revertir) y DefensiveStrategy (criaturas que curan: atacar y curar).is_valid devuelve False; si aun
así se llama a act, se lanza una excepción propia con un mensaje claro.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).
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.Creature. Es un requisito
explícito, no una sugerencia, y la evaluación preguntará por qué.ex0 como
ex1; lo que pongas en cada __init__.py se mira.ex0 y construir sobre él; si lo importas, son imports entre paquetes
hermanos que funcionan porque los scripts se ejecutan desde la raíz.transform y vuelva a la normalidad tras
revert.is_valid dice la verdad sin lanzar
nada; act con una pareja inválida lanza la excepción propia, y el torneo la
gestiona sin estrellarse (el ejemplo aborta el torneo con un mensaje).«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.