Sanic | Build fast. Run fast.ο
Build |
|
---|---|
Docs |
|
Package |
|
Support |
|
Stats |
Sanic is a Python 3.8+ web server and web framework thatβs written to go fast. It allows the usage of the async/await
syntax added in Python 3.5, which makes your code non-blocking and speedy.
Sanic is also ASGI compliant, so you can deploy it with an alternative ASGI webserver.
Source code on GitHub | Help and discussion board | User Guide | Chat on Discord
The project is maintained by the community, for the community. Contributions are welcome!
The goal of the project is to provide a simple way to get up and running a highly performant HTTP server that is easy to build, to expand, and ultimately to scale.
Sponsorο
Check out open collective to learn more about helping to fund Sanic.
Installationο
pip3 install sanic
Sanic makes use of
uvloop
andujson
to help with performance. If you do not want to use those packages, simply add an environmental variableSANIC_NO_UVLOOP=true
orSANIC_NO_UJSON=true
at install time.$ export SANIC_NO_UVLOOP=true $ export SANIC_NO_UJSON=true $ pip3 install --no-binary :all: sanic
Note
If you are running on a clean install of Fedora 28 or above, please make sure you have the redhat-rpm-config
package installed in case if you want to
use sanic
with ujson
dependency.
Hello World Exampleο
from sanic import Sanic
from sanic.response import json
app = Sanic("my-hello-world-app")
@app.route('/')
async def test(request):
return json({'hello': 'world'})
if __name__ == '__main__':
app.run()
Sanic can now be easily run using sanic hello.app
.
[2018-12-30 11:37:41 +0200] [13564] [INFO] Goin' Fast @ http://127.0.0.1:8000
[2018-12-30 11:37:41 +0200] [13564] [INFO] Starting worker [13564]
And, we can verify it is working: curl localhost:8000 -i
HTTP/1.1 200 OK
Connection: keep-alive
Keep-Alive: 5
Content-Length: 17
Content-Type: application/json
{"hello":"world"}
Now, letβs go build something fast!
Minimum Python version is 3.8. If you need Python 3.7 support, please use v22.12LTS.
Documentationο
User Guide, Changelog, and API Documentation can be found at sanic.dev.
Questions and Discussionο
Contributionο
We are always happy to have new contributions. We have marked issues good for anyone looking to get started, and welcome questions on the forums. Please take a look at our Contribution guidelines.
User Guideο
To learn about using Sanic, checkout the User Guide.
APIο
- π₯ User Guide
- π API Reference
- π» Source code
- π Changelog
- β₯οΈ Contributing
- β Support
- π¬ Chat