Awesome
NOTICE
Bocadillo is now UNMAINTAINED. This repository should be archived soon. We recommend users to migrate to other well-supported alternatives, such as Starlette or FastAPI. Please see #334 for more information.
<p align="center"> <img src="https://github.com/bocadilloproject/bocadillo/blob/master/.github/banner.png?raw=true"> </p> <p align="center"> <a href="https://travis-ci.org/bocadilloproject/bocadillo"> <img src="https://travis-ci.org/bocadilloproject/bocadillo.svg?branch=master" alt="Build status"/> </a> <a href="https://codecov.io/gh/bocadilloproject/bocadillo"> <img src="https://codecov.io/gh/bocadilloproject/bocadillo/branch/master/graph/badge.svg" alt="Test coverage"/> </a> <a href="https://pypi.org/project/bocadillo"> <img src="https://badge.fury.io/py/bocadillo.svg" alt="pypi version"> </a> <a href="https://github.com/ambv/black"> <img src="https://img.shields.io/badge/code_style-black-000000.svg" alt="code style"> </a> </p>
Documentation: https://bocadilloproject.github.io
Bocadillo is a Python async web framework that makes building performant and highly concurrent web APIs fun and accessible to everyone.
Requirements
Python 3.6+
Installation
pip install bocadillo
Example
from bocadillo import App, configure
app = App()
configure(app)
@app.route("/")
async def index(req, res):
res.json = {"hello": "world"}
Save this as app.py, then start a uvicorn server (hot reload enabled!):
uvicorn app:app --reload
Say hello!
$ curl http://localhost:8000
{"hello": "world"}
Ready to dive in? Visit the documentation site.
Changelog
All changes to Bocadillo are recorded in the changelog. To see what's coming in the next release, read the Unreleased section.
Release notes may also be published as blog posts on Bocadillo News.
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 the Contributing guide to get started.
By the way, here is the Bocadillo Contributor Hall of Fame. 👨💻👩💻
Credits
Logo designed by Florimond Manca. Sandwich icon designed by macrovector.