Lección 23 de 47 · De clases a clases✦ WebMCP implementado
Enum frente a enum de PHP 8.1
9 min de lectura4 retos
La prioridad de una tarea no puede ser cualquier número: solo baja, media o alta. Para eso sirve un enum. Python lo tiene desde hace años (enum.Enum) y se parece mucho a los backed enums de PHP 8.1, pero es una clase normal con superpoderes. Aquí nace el Prioridad de nuestra app de tareas.
¿De dónde vienen los nombres?
Enum = inglés enumeration (enumeración)
Una lista cerrada de valores con nombre. Cada miembro es un objeto único.
IntEnum = Int (entero) + Enum
Un enum cuyos miembros son números enteros de verdad: se pueden comparar y ordenar con < y >.
StrEnum = Str (string, texto) + Enum
Un enum cuyos miembros son textos de verdad. Existe desde Python 3.11.
auto = inglés automatic (automático)
auto() elige el valor del miembro por ti: números 1, 2, 3… en un Enum, o el nombre en minúsculas en un StrEnum.
name y value = inglés name (nombre) y value (valor)
El nombre con el que escribes el miembro (ALTA) y el dato que guarda (3). Son el ->name y el ->value de PHP.
En 4 ideas
1/4
class Prioridad(Enum): BAJA = 1 crea una lista cerrada de miembros únicos. Es el backed enum de PHP (enum Prioridad: int { case Baja = 1; }), pero con = y sin la palabra case.
Se accede por nombre (Prioridad.ALTA o Prioridad["ALTA"]) y por valor (Prioridad(3), el from() de PHP). Un valor que no existe lanza ValueError; un nombre que no existe, KeyError.
IntEnum y StrEnum hacen que los miembros seanint o str: Prioridad.ALTA > Prioridad.BAJA funciona y Prioridad.ALTA == 3 es True. Con un Enum normal, no.
Un enum de Python es una clase: se puede recorrer con for, tiene métodos y funciona con match. A diferencia de PHP, tryFrom() no existe: se escribe con try/except.
1 · Tu primer Enum
Un enum es como el semáforo: solo tiene tres luces posibles, y no te inventas una cuarta. Nuestra Prioridad tiene tres miembros, cada uno con un nombre y un valor guardado.
Pythonmain.py
from enum importEnumclassPrioridad(Enum):
BAJA = 1MEDIA = 2ALTA = 3
alta = Prioridad.ALTAprint(alta.name, alta.value)
print(alta)
print(repr(alta))
print(alta isPrioridad.ALTA, alta == Prioridad(3))
print(alta == 3)
PHP 8.5Prioridad.php
<?phpdeclare(strict_types=1);
enum Prioridad: int
{
case Baja = 1;
case Media = 2;
case Alta = 3;
}
$alta = Prioridad::Alta;
echo$alta->name . " " . $alta->value . PHP_EOL;
var_dump($alta === Prioridad::from(3));
var_dump($alta->value === 3);
Pythonmain.py
from enum importEnumclassPrioridad(Enum):
BAJA = 1MEDIA = 2ALTA = 3
alta = Prioridad.ALTAprint(alta.name, alta.value)
print(alta isPrioridad(3))
print(alta.value == 3)
Los miembros se escriben en MAYÚSCULAS por convención (son constantes). En PHP los case van en PascalCase.
Cada miembro es un objeto único: Prioridad.ALTA is Prioridad.ALTA siempre es True. Se comparan con is o con ==.
Prioridad.ALTA == 3 es False: el miembro y su valor son cosas distintas. En PHP también (Prioridad::Alta === 3 da false). Para el dato, .value.
No se puede cambiar un miembro ni crear uno nuevo después de definirlo: la lista está cerrada.
¿Por qué? · En PHP no existe
¿Por qué un Enum y no tres constantes sueltas? En PHP ya tenías enum
Si guardas la prioridad como un número suelto (prioridad = 3), nada te impide escribir prioridad = 7 o prioridad = "alta". El programa funciona y el fallo aparece lejos, cuando algo no entiende el 7.
Con Prioridad solo existen tres valores válidos y el resto ni se pueden crear (Prioridad(7) da ValueError). Es lo mismo que te dio el enum de PHP 8.1 frente a las constantes de clase, con la misma ganancia: el error salta donde se comete.
2 · Buscar un miembro por nombre o por valor
Para convertir un dato que llega de fuera (un número de la base de datos, un texto de un formulario) en un miembro, tienes dos puertas:
Tengo…
Python
PHP
Si no existe
el valor (3)
Prioridad(3)
Prioridad::from(3)
ValueError
el nombre ("ALTA")
Prioridad["ALTA"]
constant("Prioridad::Alta")
KeyError
el valor, sin que explote
try / except ValueError
Prioridad::tryFrom(9)
devuelve null
Pythonmain.py
from enum importEnumclassPrioridad(Enum):
BAJA = 1MEDIA = 2ALTA = 3print(Prioridad(2))
print(Prioridad["ALTA"])
try:
Prioridad(9)
exceptValueErroras error:
print("ValueError:", error)
try:
Prioridad["URGENTE"]
exceptKeyErroras error:
print("KeyError:", error)
defprioridad_o_none(valor):
# En PHP: return Prioridad::tryFrom($valor);try:
returnPrioridad(valor)
exceptValueError:
returnNoneprint(prioridad_o_none(1), prioridad_o_none(9))
# Un Enum se recorre con for, en el orden en que lo escribiste.for prioridad inPrioridad:
print(prioridad.value, prioridad.name)
print(len(Prioridad), list(Prioridad)[0])
3 · IntEnum y StrEnum: el miembro ES el número o el texto
Con un Enum normal, Prioridad.ALTA > Prioridad.BAJA da TypeError: Python no sabe ordenar «objetos semáforo». A veces te interesa justo lo contrario: que el miembro sea el número. Para eso existe IntEnum:
Y si el dato que guardas es un texto (por ejemplo, el estado de una tarea), StrEnum hace que el miembro sea un str. Con auto(), el valor es el nombre en minúsculas:
Pythonmain.py
from enum importStrEnum, auto
classEstado(StrEnum):
PENDIENTE = auto()
HECHA = auto()
print(Estado.HECHA.value)
print(Estado.HECHA == "hecha")
print(Estado("pendiente"))
print(f"Estado de la tarea: {Estado.HECHA}")
print(Estado.HECHA.upper())
¿Por qué? · En PHP no existe
¿Por qué tres tipos de enum? En PHP solo hay uno
Un enum de PHP nunca es un int ni un string: tienes que escribir ->value cada vez. Python te deja elegir. Un Enum normal es el más estricto: no se mezcla con números. IntEnum y StrEnum son más cómodos (se ordenan, se escriben en una f-string, se guardan en JSON o en una BD sin convertir), pero se mezclan con los números o los textos: Prioridad.ALTA == 3 es True.
En nuestra app usaremos IntEnum para Prioridad porque en SQLite se guarda un INTEGER y queremos ordenar de más a menos urgente.
4 · Métodos, match y miembros con datos
Un enum de Python es una clase, así que puede tener métodos, igual que los de PHP. Y se lleva muy bien con match (módulo 01):
El enum de PHP 8.1+ frente al enum de Python, caso a caso.
PHP
Python
Quién lo ve
enum Prioridad: int { case Baja = 1; }
class Prioridad(IntEnum): BAJA = 1
Una clase, no una palabra clave nueva
enum puro, sin valor (enum Estado { case A; })
class Estado(Enum): A = auto()
auto() elige el valor por ti
Prioridad::Alta
Prioridad.ALTA
El miembro, un objeto único
->name, ->value
.name, .value
El nombre del miembro y su dato
Prioridad::from(3)
Prioridad(3)
Lanza ValueError si no existe
Prioridad::tryFrom(9)
No existe: try / except ValueError
Quien llama decide qué hacer
Prioridad::cases()
list(Prioridad) o for p in Prioridad
En el orden de definición
enum Estado: string
class Estado(StrEnum)
El miembro es un str
->value obligatorio para usar el dato
IntEnum / StrEnum: el miembro es el dato
Se ordena, se imprime, se serializa sin .value
match ($this) { self::Baja => ... }
match self: case Prioridad.BAJA: ...
Con el punto: sin él, capturaría
métodos y const dentro del enum
métodos, @classmethod y atributos de clase
Es una clase normal
Hora de practicar
Retos · 0/4 resueltos
Reto 1 de 4 · ✓ Resuelto
Tu primer Enum
Arregla el enum Prioridad para que BAJA valga 1, MEDIA 2 y ALTA 3, y que el programa imprima ALTA 3. Es el enum Prioridad: int de PHP.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista. Cambia los números a 1, 2 y 3: .value devuelve justo lo que escribes a la derecha del =.
Reto 2 de 4 · ✓ Resuelto
De texto a Prioridad
Escribe prioridad_desde_texto(texto): convierte "alta" (en cualquier combinación de mayúsculas y con espacios alrededor) en Prioridad.ALTA. Si no existe, lanza ValueError, no KeyError. Es tu tryFrom() de PHP, pero lanzando el error.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista.Prioridad[...] busca por nombre y lanza KeyError si no existe: atrápalo con except KeyError y lanza ValueError.
Reto 3 de 4 · ✓ Resuelto
Las más urgentes primero
Prioridad es un IntEnum. Escribe por_urgencia(tareas): recibe una lista de tuplas (titulo, prioridad) y devuelve solo los títulos, de la prioridad más alta a la más baja (las que empatan, en su orden original). Es un usort por prioridad descendente de PHP.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista.sorted(tareas, key=lambda t: t[1], reverse=True) ordena sin tocar la lista original, y sorted es estable (respeta el orden de los empates).
Reto 4 de 4 · ✓ Resuelto
El estado como StrEnum
Define el StrEnumEstado con los miembros PENDIENTE y HECHA, con auto() para que sus valores sean "pendiente" y "hecha". Escribe además es_final(estado): True solo si es Estado.HECHA, usando match. Es el enum Estado: string de PHP.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista.PENDIENTE = auto() en un StrEnum vale el nombre en minúsculas. En match, case Estado.HECHA: (con punto) y case _: para el resto.
Resumen
Lo que te llevas de esta lección
class Prioridad(Enum): BAJA = 1 es el backed enum de PHP (enum Prioridad: int), con = y sin case.
Por valor Prioridad(3) (el from() de PHP, ValueError) y por nombre Prioridad["ALTA"] (KeyError). No hay tryFrom(): se usa try/except.
IntEnum y StrEnum hacen que el miembro sea un número o un texto: se ordena y se imprime sin .value; en PHP siempre hay que escribir ->value.
Con un Enum normal, Prioridad.ALTA == 3 es False; con IntEnum, True. Elige según quieras o no que se mezcle.
for p in Prioridad recorre los miembros (el cases() de PHP) y match con case Prioridad.ALTA: (con punto) los distingue.
Para recordarlo: «Valor entre paréntesis, nombre entre corchetes»
Prioridad(3) busca por valor (paréntesis, como llamar a una función) y Prioridad["ALTA"] busca por nombre (corchetes, como una clave de diccionario). Y si el miembro debe ser el número, Int: IntEnum.