CherryPy 'Hola Mundo'

1 Introducción a CherryPy

CherryPy es un framework web de Python que se siente más como una biblioteca que como un framework. Defines una clase, mapeas URLs a métodos, y maneja HTTP en segundo plano. Es pequeño, rápido y poco opinado, ideal para servicios pequeños, herramientas internas o cualquier proyecto que no necesite la formalidad de una pila más pesada.

Puntos clave:

Configuración mínima: No hay ceremonia ASGI/WSGI para aplicaciones básicas.
Pythonic: Clases simples + métodos para rutas.
Extensible: Añade plugins y herramientas según sea necesario.
Probado en batalla: Proyecto de larga data con una historia sólida.

Haz clic en "Siguiente" para configurar tu entorno y escribir un "Hola Mundo" funcional.

2 Prerrequisitos

Necesitarás Python 3.8 o superior y pip. Verifica tu versión:

python --version

Si no tienes Python instalado, descárgalo desde python.org.

3 Instalar CherryPy

Crea un entorno virtual e instala CherryPy.

python -m venv .venv
# Actívalo:
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

Instala CherryPy:

pip install cherrypy

4 Crear app.py

Crea un archivo llamado app.py con el siguiente código:

import cherrypy

class HelloWorld:
    @cherrypy.expose
    def index(self):
        return "Hola, mundo! Esto es CherryPy."

if __name__ == "__main__":
    cherrypy.tree.mount(HelloWorld(), "/")
    # Opcional: configuración rápida de desarrollo; elimina o adapta para producción
    cherrypy.config.update({
        "engine.autoreload.on": True,
        "log.screen": True,
        "server.socket_host": "127.0.0.1",
        "server.socket_port": 8080
    })
    cherrypy.engine.start()
    cherrypy.engine.block()

Guarda el archivo. Luego, lo ejecutarás localmente.

5 Ejecutar Localmente

Inicia el servidor:

python app.py

Visita http://127.0.0.1:8080/. Deberías ver el saludo.

6 Ruta Adicional y un Parámetro de Consulta

Añade un nuevo método a app.py y exponlo. Esto muestra el manejo de parámetros de consulta:

import cherrypy

class HelloWorld:
    @cherrypy.expose
    def index(self):
        return "Hola, mundo! Esto es CherryPy."

    @cherrypy.expose
    def greet(self, name="amigo"):
        return f"Hola, {name}!"

if __name__ == "__main__":
    cherrypy.tree.mount(HelloWorld(), "/")
    cherrypy.config.update({
        "engine.autoreload.on": True,
        "log.screen": True,
        "server.socket_host": "127.0.0.1",
        "server.socket_port": 8080
    })
    cherrypy.engine.start()
    cherrypy.engine.block()

Reinicia el servidor. Prueba /greet?name=world o /greet?name=April.

7 Cierre y Próximos Pasos

Ahora tienes un servicio CherryPy funcional: pequeño, legible y rápido de iterar. A partir de aquí, puedes añadir recursos estáticos, sesiones, endpoints JSON o integrar un servidor listo para producción.

Archivos estáticos con tools.staticdir.root y tools.staticdir.dir.
Respuestas JSON devolviendo un diccionario desde un método y habilitando cherrypy.tools.json_out.
Servidor de producción: despliega detrás de un proxy inverso (nginx) y ejecuta mediante systemd o un gestor de procesos.

A continuación, intenta construir una API pequeña o emparejar CherryPy con un frontend para una experiencia simple similar a una aplicación.

Progreso del Tutorial