Skip to main content

A modern Python web framework filled with asynchronous salsa.

Project description


python pypi downloads travis black codecov license Join the chat at https://gitter.im/bocadilloproject/bocadillo

Bocadillo

Bocadillo is a Python web framework that provides a sane toolkit for quickly building performant web applications and services, while encouraging best practices and keeping developer experience in mind.

Under the hood, it uses the Starlette ASGI toolkit and the lightning-fast uvicorn ASGI server.

Read the documentation

Quick start

Install it:

pip install bocadillo

Build something:

# api.py
import bocadillo

api = bocadillo.API()

@api.route("/")
async def index(req, res):
    # Use a template from the ./templates directory 
    res.html = await api.template("index.html")

@api.route("/greet/{person}")
async def greet(req, res, person):
    res.media = {"message": f"Hi, {person}!"}

if __name__ == "__main__":
    api.run()

Launch:

python api.py

Make requests!

curl http://localhost:8000/greet/Bocadillo
{"message": "Hi, Bocadillo!"}

Hungry for more? Head to the docs.

Contributing

See CONTRIBUTING for contribution guidelines.

Changelog

See CHANGELOG for a chronological log of changes to Bocadillo.

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 our changelog.

Credits

Logo:

  • Designed by Florimond Manca.
  • Sandwich icon designed by macrovector.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bocadillo-0.11.0.tar.gz (24.1 kB view details)

Uploaded Source

Built Distribution

bocadillo-0.11.0-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file bocadillo-0.11.0.tar.gz.

File metadata

  • Download URL: bocadillo-0.11.0.tar.gz
  • Upload date:
  • Size: 24.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 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

Hashes for bocadillo-0.11.0.tar.gz
Algorithm Hash digest
SHA256 55f3f503d809b29af065e4c95d16bb17931ad0af23f062099d20b46ea5e0b085
MD5 90062d4fbd2e0de8e9154976c8556d3b
BLAKE2b-256 73da8b02450833ea642ef0e772940d3f0b538e0af0f5427db687b21acc9516a7

See more details on using hashes here.

File details

Details for the file bocadillo-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: bocadillo-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 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

Hashes for bocadillo-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9277118be934775bfb5c5bc3769bc230c34ed2f37a8d3dffb6ca90afea47dfb2
MD5 93286e168e6d25a138c7bd21a29810cd
BLAKE2b-256 47b657620a9861dcd6a3d439ab35f4cf3da3dd463c04c0304a62b96bc041ae3c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page