Despacho según el nombre del archivo — Python: Polimorfismo

• ¿Qué es la dispatchig por nombre de archivo?
• Ejemplo: configuración por entorno
• Opción 1: Usar un diccionario para escoger el archivo adecuado
• Opción 2: Dispatchig por nombre de archivo con plantillas
• Otros usos de la dispatchig por nombre
• ¿Y qué pasa si no encontramos el archivo?

Cada entorno — desarrollo, pruebas o producción — necesita su propia configuración. Editar archivos cada vez es riesgoso y poco práctico.

Con el dispatchig por nombre de archivo, puedes cargar automáticamente la configuración adecuada según el entorno. En esta lección verás cómo hacerlo en Python, de forma sencilla y segura.

¿Qué es la dispatchig por nombre de archivo?

Por ejemplo, según el entorno donde estemos ejecutando nuestra aplicación, podemos cargar el archivo de configuración correcto simplemente usando una parte del nombre del archivo.

Ejemplo: configuración por entorno

Supongamos que estamos trabajando en una aplicación y tenemos tres entornos:

💻 Desarrollo (development)

🔍 Pruebas (test)

• Producción (production)

Tenemos tres archivos de configuración distintos, uno para cada entorno. Su estructura está organizada así:

configs/
  database.development.json
  database.production.json
  database.test.json

Cada uno de estos archivos contiene los datos necesarios para conectarse a la base de datos en ese entorno específico.

Opción 1: Usar un diccionario para escoger el archivo adecuado

Podemos usar un dict de Python para relacionar cada entorno con su archivo de configuración:

import json

# Diccionario con los nombres de archivos por entorno
config_file_by_env_name = {
    "development" : "database.development.json",
    "production"  : "database.production.json",
    "test"        : "database.test.json"
}

config = None
env_name = "production"  # Aquí indicamos en qué entorno estamos

# Buscamos el nombre del archivo de configuración correspondiente
filename = config_file_by_env_name.get(env_name)

if filename is not None:
    with open(filename, "r") as fd:
        config = json.load(fd)
else:
    raise Exception("Configuración no válida: el entorno no existe")

✅  Este método funciona y es fácil de entender.

❌  Pero tiene dos problemas:

• Si agregamos un nuevo entorno, tenemos que modificar el diccionario.
• Si cometemos un error al escribir el nombre del archivo, Python lanzará un error al no encontrar el archivo.

Opción 2: Dispatchig por nombre de archivo con plantillas

Una forma más elegante y práctica es construir el nombre del archivo automáticamente usando una plantilla. En Python podemos hacerlo con una f-string:

import json

env_name = "production"  # El entorno actual

filename = f"database.{env_name}.json"  # Construimos el nombre del archivo

with open(filename, "r") as fd:
    config = json.load(fd)

¿Qué hicimos aquí?

• Creamos el nombre del archivo como una cadena dinámica.
• No necesitamos un diccionario.
• Podemos añadir entornos nuevos sin tocar el código, solo creando un nuevo archivo con el nombre adecuado.

Otros usos de la dispatchig por nombre

Este método no solo sirve para configuraciones. También lo podemos usar en:

Básicamente, siempre que podamos identificar algo diferenciador en el nombre del archivo, podemos usar este patrón.

¿Y qué pasa si no encontramos el archivo?

Como buena práctica, deberíamos verificar si el archivo realmente existe antes de intentar abrirlo. Podríamos usar el módulo os.path para eso:

import os
import json

env_name = "production"
filename = f"database.{env_name}.json"

if os.path.exists(filename):
    with open(filename, "r") as fd:
        config = json.load(fd)
else:
    raise FileNotFoundError(f"No se encontró el archivo: {filename}")

Esto nos ayuda a detectar errores con anticipacion y mostrar mensajes claros si falta algún archivo.