CRUD — Python: Desarrollo web con Flask

• ¿Qué es CRUD y por qué es importante?
• ¿Qué implica construir un CRUD completo?
• Enrutamiento básico para CRUD
• Cómo nombrar las funciones (naming)
• Mostrar Lista de Escuelas (Ruta index)
• Mostrar una Escuela Específica (Ruta show)
  • Manejar errores: página no encontrada

¿Sabías que buena parte de lo que hacemos al desarrollar una app web se reduce a cuatro acciones? Estas son: crear, leer, actualizar y eliminar.

A esto se le conoce como operaciones CRUD (por sus siglas en inglés: Create, Read, Update, Delete).

📚 En esta lección, aprenderás qué es CRUD, para qué sirve y cómo crear tus primeras rutas en Flask para listar recursos (como escuelas de programación) y ver los detalles de uno en específico.

¿Qué es CRUD y por qué es importante?

El término CRUD se usa en programación para describir las acciones básicas que podemos hacer sobre cualquier entidad o recurso, como usuarios, productos, publicaciones, etc.

Vamos a trabajar con un recurso llamado “school” (escuela), para construir un mini catálogo de escuelas de programación.

¿Qué implica construir un CRUD completo?

Un desarrollador debe crear varias partes para que un CRUD funcione correctamente:

• Definir la entidad (por ejemplo, la clase School)
• Crear la tabla en la base de datos
• Codificar los controladores o manejadores
• Diseñar las plantillas HTML
• Crear rutas o endpoints que conecten todo

Aunque más adelante automatizaremos muchas de estas tareas, en este curso lo haremos paso a paso con Flask para entender bien cada parte.

Enrutamiento básico para CRUD

Estos son los endpoints (rutas) más comunes al construir un CRUD. En este caso el recurso es “schools”:

En este primer acercamiento, nos vamos a concentrar solo en dos rutas: listar todas las escuelas (index) y mostrar una escuela específica (show).

Cómo nombrar las funciones (naming)

Flask, al ser un microframework, no impone una estructura rígida para nombrar funciones. Pero, como buenas prácticas, usaremos nombres que indiquen claramente qué entidad y qué acción manejan.

⏬ Por ejemplo:

• Para mostrar la lista de escuelas: schools_index
• Para mostrar una escuela particular: schools_show

Así el código es más legible y fácil de mantener.

Mostrar Lista de Escuelas (Ruta index)

Cuando un usuario visita la página /schools, queremos mostrarle una lista de todas las escuelas disponibles. Aquí hay un esquema básico del proceso:

1. Traer la lista de escuelas desde un repositorio o base de datos.
2. Pasar esos datos a la plantilla HTML.
3. Mostrar los datos en una tabla usando un bucle.

Controlador (en Python)

@app.route('/schools')
def schools_index():
    repo = SchoolRepository()
    schools = repo.content()  # obtenemos la lista de escuelas

    return render_template(
        'schools/index.html',
        schools=schools  # pasamos la lista a la plantilla
    )

Plantilla HTML (schools/index.html)

<table>
    {% for school in schools %}
    <tr>
        <td>{{ school.id }}</td>
        <td>
            <a href="{{ url_for('schools_show', id=school.id) }}">
              {{ school.name }}
            </a>
        </td>
    </tr>
    {% endfor %}
</table>

Mostrar una Escuela Específica (Ruta show)

Cuando alguien visita /schools/3 (por ejemplo), debe ver la información sobre la escuela con ID 3.

Flujo del controlador

1. Tomar el ID desde la URL.
2. Buscar la escuela en nuestro repositorio usando ese ID.
3. Pasar los datos a la plantilla.
4. Mostrarlo de forma clara y atractiva.

Controlador (Python)

@app.route('/schools/<id>')
def schools_show(id):
    repo = SchoolRepository()
    school = repo.find(id)  # buscar escuela por su ID

    if not school:
        abort(404)  # si no se encuentra, lanzar error 404

    return render_template(
        'schools/show.html',
        school=school
    )

Plantilla HTML (schools/show.html)

<div>
  ID: {{ school.id }}<br>
  Nombre: {{ school.name }}
</div>

Manejar errores: página no encontrada

Flask nos permite manejar errores como el 404 cuando algo no existe:

@app.errorhandler(404)
def not_found(error):
    return 'Oops! Página no encontrada', 404

En la próxima lección aprenderemos a crear nuevas escuelas (Create).

Trabajo independiente

1. Ajusta las rutas y sus nombres de acuerdo con el esquema indicado arriba.
2. Modifica la obtención de usuarios para que los datos se tomen desde un archivo.

Aplicación de referencia

Materiales adicionales

1. RESTFull Routing
2. Scaffolding
3. Paginación