bocadillo

Documentation / CLI / Twitter / Blog / Mentions / FAQ

Migrating from v0.13.x? Read the v0.14 release notes.

Bocadillo is a Python async web framework that makes server-side async web apps fun to build and accessible to everyone.

It is designed to be:

Productive: a carefully chosen set of included batteries helps you solve common and more advanced problems — request routing, app configuration, static files, data validation, and more!
Real-time capable: embrace asynchronous programming and the baked-in WebSocket and SSE support to build real-time, highly-concurrent systems.
Flexible: inject resources into web views using providers, an explicit, modular and easy-to-use mechanism inspired by pytest fixtures.
Performant: squeeze the juice out of Starlette and uvicorn, the lightning-fast ASGI toolkit and web server.
Empowering: use tailored testing and command line tools to build delicious, high-quality applications.
Transparent: every single feature is documented front to back and has optimal editor support thanks to a 100% type-annotated code base.

Quick start

We all love delicious "Hello, world!" examples, don't we? Here's ours:

Install Bocadillo and the Bocadillo CLI:

pip install bocadillo bocadillo-cli

Generate the project and cd into it:

bocadillo create hello
cd hello/

Edit the application script:

# hello/app.py
from bocadillo import App

app = App()

@app.route("/")
async def index(req, res):
    res.text = "Hello, world!"

Start a uvicorn server (hot reload enabled!):

uvicorn hello.asgi:app --reload

Say hello!

$ curl http://localhost:8000
Hello, world!

Edit app.py to send "Hello, Bocadillo!" instead, then hit save. Uvicorn will pick up the changes and restart the application. Try it out again:

$ curl http://localhost:8000
Hello, Bocadillo!

Tastes good! 🥪

Hungry for more? Head to the docs.

Changelog

We record changes to Bocadillo in the changelog. In particular, check out the Unreleased section to see what's coming in the next release.

Contributing

Found a bug? A typo? Want to help build a new feature? We'd love to see your contributions! There are also many ways to contribute that don't include code: helping with issues, laying out new ideas, improving docs, etc.

Check out our Contributing guide to get started.

By the way, here's our Contributor Hall of Fame. 👨‍💻👩‍💻

Credits

Logo designed by Florimond Manca. Sandwich icon designed by macrovector.

Metadata

Release files for bocadillo 0.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bocadillo 0.14.0
File	Size	Uploaded
bocadillo-0.14.0.tar.gz	45.1 kB	Apr 21, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for bocadillo 0.14.0
File	Interpreter	ABI	Platform	Reset
bocadillo-0.14.0-py3-none-any.whl 68.9 kB Apr 21, 2019	Python 3	none	any	Details

Total release size: 114.0 kB

Release files / bocadillo-0.14.0.tar.gz

Download URL	bocadillo-0.14.0.tar.gz
Size	45.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`27950def12b5e60411d46ac2faadfd1919bf2d809e9b51c0882d25c4940d8360`
BLAKE2b-256 checksum How to use checksums	`32e704b25ab49ae8db9efe3e67623d26f9177ab6140da6c0e38a04cd094f1c50`
Upload date	Apr 21, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7`

Release files / bocadillo-0.14.0-py3-none-any.whl

Download URL	bocadillo-0.14.0-py3-none-any.whl
Size	68.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cf32d058d8f5cb405666216b69b5b6f67a468813c454e27f6debab7a37b690d8`
BLAKE2b-256 checksum How to use checksums	`f1b5d62cdab33f7e5e611b92e25031458bd5aee45b5175d2f1e7135aaf796024`
Upload date	Apr 21, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7`