Mis apuntes · Aprende Python desde PHP

Se guardan solos en este navegador mientras escribes. Puedes usar Markdown. Al descargarlos, la primera línea es tu enlace personal al curso.

Lección 23 de 47 · De clases a clases ✦ WebMCP implementado

Enum frente a enum de PHP 8.1

9 min de lectura 4 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.

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 import Enum


class Prioridad(Enum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3


alta = Prioridad.ALTA
print(alta.name, alta.value)
print(alta)
print(repr(alta))
print(alta is Prioridad.ALTA, alta == Prioridad(3))
print(alta == 3)
PHP 8.5Prioridad.php
<?php
declare(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 import Enum


class Prioridad(Enum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3


alta = Prioridad.ALTA
print(alta.name, alta.value)
print(alta is Prioridad(3))
print(alta.value == 3)
  1. Los miembros se escriben en MAYÚSCULAS por convención (son constantes). En PHP los case van en PascalCase.
  2. Cada miembro es un objeto único: Prioridad.ALTA is Prioridad.ALTA siempre es True. Se comparan con is o con ==.
  3. 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.
  4. 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…PythonPHPSi no existe
el valor (3)Prioridad(3)Prioridad::from(3)ValueError
el nombre ("ALTA")Prioridad["ALTA"]constant("Prioridad::Alta")KeyError
el valor, sin que explotetry / except ValueErrorPrioridad::tryFrom(9)devuelve null
Pythonmain.py
from enum import Enum


class Prioridad(Enum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3


print(Prioridad(2))
print(Prioridad["ALTA"])

try:
    Prioridad(9)
except ValueError as error:
    print("ValueError:", error)

try:
    Prioridad["URGENTE"]
except KeyError as error:
    print("KeyError:", error)


def prioridad_o_none(valor):
    # En PHP: return Prioridad::tryFrom($valor);
    try:
        return Prioridad(valor)
    except ValueError:
        return None


print(prioridad_o_none(1), prioridad_o_none(9))

# Un Enum se recorre con for, en el orden en que lo escribiste.
for prioridad in Prioridad:
    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:

Pythonmain.py
from enum import Enum, IntEnum


class PrioridadSimple(Enum):
    BAJA = 1
    ALTA = 3


class Prioridad(IntEnum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3


try:
    PrioridadSimple.ALTA > PrioridadSimple.BAJA
except TypeError as error:
    print("TypeError:", error)

print(Prioridad.ALTA > Prioridad.BAJA)
print(Prioridad.MEDIA == 2)
print(sorted([Prioridad.ALTA, Prioridad.BAJA, Prioridad.MEDIA]))
print(Prioridad.ALTA + 1)
print(f"{Prioridad.ALTA}")

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 import StrEnum, auto


class Estado(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):

Pythonmain.py
from enum import IntEnum


class Prioridad(IntEnum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3

    def etiqueta(self):
        match self:
            case Prioridad.BAJA:
                return "Baja"
            case Prioridad.MEDIA:
                return "Media"
            case Prioridad.ALTA:
                return "Alta"

    @classmethod
    def desde_texto(cls, texto):
        try:
            return cls[texto.strip().upper()]
        except KeyError:
            raise ValueError(f"Prioridad desconocida: {texto}") from None


print(Prioridad.ALTA.etiqueta())
print(Prioridad.desde_texto(" media ").value)

try:
    Prioridad.desde_texto("urgente")
except ValueError as error:
    print("ValueError:", error)
PHP 8.5Prioridad.php
<?php
declare(strict_types=1);

enum Prioridad: int
{
    case Baja = 1;
    case Media = 2;
    case Alta = 3;

    public function etiqueta(): string
    {
        return match ($this) {
            self::Baja => "Baja",
            self::Media => "Media",
            self::Alta => "Alta",
        };
    }

    public static function desdeTexto(string $texto): self
    {
        foreach (self::cases() as $caso) {
            if (strtoupper($caso->name) === strtoupper(trim($texto))) {
                return $caso;
            }
        }
        throw new ValueError("Prioridad desconocida: $texto");
    }
}

echo Prioridad::Alta->etiqueta() . PHP_EOL;
echo Prioridad::desdeTexto(" media ")->value . PHP_EOL;
Pythonmain.py
from enum import IntEnum


class Prioridad(IntEnum):
    BAJA = 1
    MEDIA = 2
    ALTA = 3

    def etiqueta(self):
        match self:
            case Prioridad.BAJA:
                return "Baja"
            case Prioridad.MEDIA:
                return "Media"
            case Prioridad.ALTA:
                return "Alta"

    @classmethod
    def desde_texto(cls, texto):
        try:
            return cls[texto.strip().upper()]
        except KeyError:
            raise ValueError(f"Prioridad desconocida: {texto}") from None


print(Prioridad.ALTA.etiqueta())
print(Prioridad.desde_texto(" media ").value)

5 · Equivalencia POO: PHP frente a Python

Equivalencia POO · PHP → Python

El enum de PHP 8.1+ frente al enum de Python, caso a caso.

PHPPythonQuién lo ve
enum Prioridad: int { case Baja = 1; }class Prioridad(IntEnum): BAJA = 1Una 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::AltaPrioridad.ALTAEl miembro, un objeto único
->name, ->value.name, .valueEl nombre del miembro y su dato
Prioridad::from(3)Prioridad(3)Lanza ValueError si no existe
Prioridad::tryFrom(9)No existe: try / except ValueErrorQuien llama decide qué hacer
Prioridad::cases()list(Prioridad) o for p in PrioridadEn el orden de definición
enum Estado: stringclass Estado(StrEnum)El miembro es un str
->value obligatorio para usar el datoIntEnum / StrEnum: el miembro es el datoSe 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 enummétodos, @classmethod y atributos de claseEs una clase normal

Hora de practicar

Retos · 0/4 resueltos

Reto 1 de 4

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

Resumen

Lo que te llevas de esta lección

  1. class Prioridad(Enum): BAJA = 1 es el backed enum de PHP (enum Prioridad: int), con = y sin case.
  2. Por valor Prioridad(3) (el from() de PHP, ValueError) y por nombre Prioridad["ALTA"] (KeyError). No hay tryFrom(): se usa try/except.
  3. 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.
  4. Con un Enum normal, Prioridad.ALTA == 3 es False; con IntEnum, True. Elige según quieras o no que se mezcle.
  5. 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.