README.adoc

Shattered

STOMP meets bottle.py

Table of Contents

• Getting Started
  • Installation
  • CLI
  • Echo Server
    • Running the Echo Demo
  • Chat Server

Getting Started

Installation

pip install shattered

CLI

shattered run will run a Shattered app, using one of the following (in order):

1. The --app flag.

2. The SHATTERED_APP environment variable.

3. app.py as the application module name.

Use shattered config to see the current configuration (same app resolution as run command).

Echo Server

app.py

import logging

from shattered import Shattered


logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

app = Shattered(host="rabbitmq")


@app.subscribe("/queue/echo")
def echo(headers, body, conn):
    logger.info("%s %s", headers, body)


@app.subscribe("/queue/echo")
def echo_fancy(headers, body, conn):
    logger.info("✨✨✨%s %s✨✨✨", headers, body)


app.run()

Running the Echo Demo

Start up RabbitMQ using docker-compose up

In another shell, run docker-compose run shattered python examples/echo/echo.py

In another shell, run docker-compose run shattered python examples/echo/send.py

Chat Server

A simple chat server is included at examples/chat

User docker-compose up

Visit http://localhost:5000 in several tabs to chat.