# Getting Started
Sanic Extensions is an officially supported plugin developed, and maintained by the SCO. The primary goal of this project is to add additional features to help Web API and Web application development easier.
- Auto create
- CORS protection
- Predefined, endpoint-specific response serializers
- Argument injection into route handlers
- OpenAPI documentation with Redoc and/or Swagger
- Request query arguments and body input validation
# Minimum requirements
- Python: 3.8+
- Sanic: 21.9+
The best method is to just install Sanic Extensions along with Sanic itself:
pip install sanic[ext]
You can of course also just install it by itself.
pip install sanic-ext
# Extend your application
Out of the box, Sanic Extensions will enable a bunch of features for you.
NEW in v21.12
To setup Sanic Extensions (v21.12+), you need to do: nothing. If it is installed in the environment, it is setup and ready to go.
This code is the Hello, world app in the Sanic Getting Started page without any changes.
from sanic import Sanic from sanic.response import text app = Sanic("MyHelloWorldApp") @app.get("/") async def hello_world(request): return text("Hello, world.")
OLD DEPRECATED SETUP
In v21.9, the easiest way to get started is to instantiate it with
If you look back at the Hello, world app in the Sanic Getting Started page, you will see the only additions here are the two highlighted lines.
from sanic import Sanic from sanic.response import text from sanic_ext import Extend app = Sanic("MyHelloWorldApp") Extend(app) @app.get("/") async def hello_world(request): return text("Hello, world.")
Regardless of how it is setup, you should now be able to view the OpenAPI documentation and see some of the functionality in action: http://localhost:8000/docs (opens new window).