CherryPy 'Olá Mundo'

1 Introdução ao CherryPy

CherryPy é um framework web Python que se parece mais com uma biblioteca do que com um framework. Você define uma classe, mapeia URLs para métodos, e ele lida com o HTTP por baixo dos panos. É pequeno, rápido e sem opiniões — ideal para pequenos serviços, ferramentas internas ou qualquer projeto que não precise da cerimônia de uma pilha mais pesada.

Pontos chave:

Configuração mínima: Sem cerimônia ASGI/WSGI para aplicativos básicos.
Pythonic: Classes simples + métodos para rotas.
Extensível: Adicione plugins e ferramentas conforme necessário.
Testado em batalha: Projeto de longa data com um histórico sólido.

Clique em "Próximo" para configurar seu ambiente e escrever um "Olá Mundo" funcional.

2 Pré-requisitos

Você precisará do Python 3.8 ou mais recente e do pip. Verifique sua versão:

python --version

Se você não tiver o Python instalado, baixe-o em python.org.

3 Instalar CherryPy

Crie um ambiente virtual e instale o CherryPy.

python -m venv .venv
# Ative-o:
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

Instale o CherryPy:

pip install cherrypy

4 Criar app.py

Crie um arquivo chamado app.py com o seguinte código:

import cherrypy

class HelloWorld:
    @cherrypy.expose
    def index(self):
        return "Olá, mundo! Isso é CherryPy."

if __name__ == "__main__":
    cherrypy.tree.mount(HelloWorld(), "/")
    # Opcional: configuração rápida de desenvolvimento; remova ou adapte para produção
    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()

Salve o arquivo. Em seguida, você o executará localmente.

5 Executar Localmente

Inicie o servidor:

python app.py

Visite http://127.0.0.1:8080/. Você deverá ver a saudação.

6 Rota Extra e um Parâmetro de Consulta

Adicione um novo método ao app.py e exponha-o. Isso mostra o manuseio de parâmetros de consulta:

import cherrypy

class HelloWorld:
    @cherrypy.expose
    def index(self):
        return "Olá, mundo! Isso é CherryPy."

    @cherrypy.expose
    def greet(self, name="friend"):
        return f"Olá, {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()

Reinicie o servidor. Tente /greet?name=world ou /greet?name=April.

7 Conclusão e Próximos Passos

Agora você tem um serviço CherryPy funcional — pequeno, legível e rápido para iterar. A partir daqui, você pode adicionar ativos estáticos, sessões, endpoints JSON ou integrar um servidor pronto para produção.

Arquivos estáticos com tools.staticdir.root e tools.staticdir.dir.
Respostas JSON retornando um dicionário de um método e ativando cherrypy.tools.json_out.
Servidor de produção: implante atrás de um proxy reverso (nginx) e execute via systemd ou um gerenciador de processos.

Em seguida, tente construir uma pequena API ou emparelhar CherryPy com um frontend para uma experiência simples semelhante a um aplicativo.

Progresso do Tutorial