A modern Python web framework filled with asynchronous salsa.
Project description
Documentation / CLI / Twitter / Blog / Mentions / FAQ
Bocadillo is a modern Python web framework that aims at making async web apps and services fun to build and accessible to everyone. We ultimately believe that web frameworks should be fun and easy to use while empowering the developer to make good decisions and ship high-quality applications.
It is designed to be:
-
Productive: a carefully chosen set of included batteries* helps you solve common and more advanced problems.
-
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.
*The bucket list: HTTP, WebSocket, SSE, CORS, HSTS, GZip, Jinja2 templates, dependency injection, background tasks, streaming, middleware, redirection, error handling, class-based views, view hooks, media responses, file responses, attachments, static files serving, test client, event handlers…
Quick start
We all love delicious "Hello, world!" examples, don't we? Here's ours:
- Install Bocadillo:
pip install bocadillo
- Write the app:
from bocadillo import App
app = app()
@app.route("/")
async def index(req, res):
res.text = "Hello, world!"
if __name__ == "__main__":
app.run()
- Start the server:
python app.py
- Say hello!
$ curl http://localhost:8000
Hello, world!
Tastes good! 🥪
Hungry for more? Head to the docs.
Changelog
Changes made to Bocadillo across releases are recorded in the Changelog. Be sure to check it out to see where we're coming from!
Roadmap
For a list of short, mid and long-term feature ideas currently in our scope, see the Roadmap.
To see what has already been implemented for the next release, see the Unreleased section of the changelog.
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 for more information.
By the way, here's our Contributor Hall of Fame:
Credits
Logo designed by Florimond Manca. Sandwich icon designed by macrovector.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file bocadillo-0.13.0.tar.gz.
File metadata
- Download URL: bocadillo-0.13.0.tar.gz
- Upload date:
- Size: 33.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | be3349621023958212dd9e7adc98846fc6888e5150b67ee0ee62a35df1ddaaf0 |
|
| MD5 | fb5eee083744f8d9bc63825bec6f98aa |
|
| BLAKE2b-256 | 2c1def00571f24dfd3bb3888dccc838356875571620358b20399f90236008169 |
File details
Details for the file bocadillo-0.13.0-py3-none-any.whl.
File metadata
- Download URL: bocadillo-0.13.0-py3-none-any.whl
- Upload date:
- Size: 41.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 17d02424861cbd6efd36e9efbf6fea9bceb916c0ed4aaf34152436c76d77f2c0 |
|
| MD5 | 0a9400b7bbd1edee837746b14adf9cbe |
|
| BLAKE2b-256 | 988cdb7e17cb9161a88326cd7f9873e7711bc6c7285738cceaea2a52c740a04e |
