Skip to main content

A modern Python web framework filled with asynchronous salsa.

Project description

A modern Python web framework filled with asynchronous salsa.


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

NOTE: v0.9 contains breaking API changes compared to 0.8.x and below. Review the changelog to know if you are affected and read about migration tips.

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

To see what has already been implemented for the next release, see the Unreleased section of our changelog.

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.9.0.tar.gz (24.6 kB view details)

Uploaded Source

Built Distribution

bocadillo-0.9.0-py3-none-any.whl (32.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bocadillo-0.9.0.tar.gz
  • Upload date:
  • Size: 24.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.3

File hashes

Hashes for bocadillo-0.9.0.tar.gz
Algorithm Hash digest
SHA256 78ec81691a74488d494d5f875fcf92df8636ee639d899609f6e4dd888a7aea1e
MD5 91e0083981fd4472ce2cef4f898fc00a
BLAKE2b-256 b408dc5086b367cc4dfc7d7be3d7d72ba21d1d7b330ed07339327f7b94cbacf5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bocadillo-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 32.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.3

File hashes

Hashes for bocadillo-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0f69aac325d31f44dbb0e62853c3e11f2b6af92f791172fb32e93eccfe095f75
MD5 b0652819c95c79284988e6120a5d48a5
BLAKE2b-256 3bd1de399269e445f0ce888720f90437c4b5a0617d7a538246194760075f6cd3

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