Vasanko/sanic
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

blueprints and compat docs

Browse Source
This commit is contained in:
Adam Hopkins 2021-01-18 22:10:47 +02:00
parent 2f48e81e0b
commit 95b5260b27
5 changed files with 269 additions and 146 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/sanic/api_reference.rst
View File

@ -12,14 +12,20 @@ sanic.blueprints
.. automodule:: sanic.blueprints .. automodule:: sanic.blueprints
:members: :members:
:undoc-members:
sanic.blueprint_group sanic.blueprint_group
--------------------- ---------------------
.. automodule:: sanic.blueprint_group .. automodule:: sanic.blueprint_group
:members: :members:
:undoc-members: :special-members:
sanic.compat
------------
.. automodule:: sanic.compat
:members:
sanic.config sanic.config

142
sanic/app.py
View File

@ -36,7 +36,7 @@ from sanic.handlers import ErrorHandler, ListenerType, MiddlewareType
from sanic.log import LOGGING_CONFIG_DEFAULTS, error_logger, logger from sanic.log import LOGGING_CONFIG_DEFAULTS, error_logger, logger
from sanic.request import Request from sanic.request import Request
from sanic.response import BaseHTTPResponse, HTTPResponse from sanic.response import BaseHTTPResponse, HTTPResponse
from sanic.router import Route, Router from sanic.router import Router
from sanic.server import ( from sanic.server import (
AsyncioServer, AsyncioServer,
HttpProtocol, HttpProtocol,
@ -138,6 +138,8 @@ class Sanic:
also return a future, and the actual ensure_future call also return a future, and the actual ensure_future call
is delayed until before server start. is delayed until before server start.
`See user guide <https://sanicframework.org/guide/basics/tasks.html#background-tasks>`__
:param task: future, couroutine or awaitable :param task: future, couroutine or awaitable
""" """
try: try:
@ -161,6 +163,8 @@ class Sanic:
async def before_server_start(app, loop): async def before_server_start(app, loop):
... ...
`See user guide <https://sanicframework.org/guide/basics/listeners.html#listeners>`__
:param event: event to listen to :param event: event to listen to
""" """
@ -189,7 +193,7 @@ class Sanic:
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
stream: bool = False, stream: bool = False,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
ignore_body: bool = False, ignore_body: bool = False,
): ):
@ -258,7 +262,7 @@ class Sanic:
uri: str, uri: str,
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
ignore_body: bool = True, ignore_body: bool = True,
): ):
@ -289,7 +293,7 @@ class Sanic:
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
stream: bool = False, stream: bool = False,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
): ):
""" """
@ -319,9 +323,9 @@ class Sanic:
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
stream: bool = False, stream: bool = False,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
) -> HTTPResponse: ):
""" """
Add an API URL under the **PUT** *HTTP* method Add an API URL under the **PUT** *HTTP* method
@ -348,7 +352,7 @@ class Sanic:
uri: str, uri: str,
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
ignore_body: bool = True, ignore_body: bool = True,
): ):
@ -386,7 +390,7 @@ class Sanic:
uri: str, uri: str,
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
ignore_body: bool = True, ignore_body: bool = True,
): ):
@ -425,7 +429,7 @@ class Sanic:
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
stream=False, stream=False,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
): ):
""" """
@ -464,7 +468,7 @@ class Sanic:
uri: str, uri: str,
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
ignore_body: bool = True, ignore_body: bool = True,
): ):
@ -493,12 +497,12 @@ class Sanic:
self, self,
handler, handler,
uri: str, uri: str,
methods=frozenset({"GET"}), methods: Iterable[str] = frozenset({"GET"}),
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
stream=False, stream: bool = False,
): ):
"""A helper method to register class instance or """A helper method to register class instance or
functions as a handler to the application url functions as a handler to the application url
@ -548,14 +552,13 @@ class Sanic:
)(handler) )(handler)
return handler return handler
# Decorator
def websocket( def websocket(
self, self,
uri: str, uri: str,
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
subprotocols=None, subprotocols=None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
): ):
""" """
@ -616,7 +619,7 @@ class Sanic:
host: Optional[str] = None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
subprotocols=None, subprotocols=None,
version: Optional[str] = None, version: Optional[int] = None,
name: Optional[str] = None, name: Optional[str] = None,
): ):
""" """
@ -648,8 +651,9 @@ class Sanic:
name=name, name=name,
)(handler) )(handler)
def enable_websocket(self, enable=True): def enable_websocket(self, enable: bool = True):
"""Enable or disable the support for websocket. """
Enable or disable the support for websocket.
Websocket is enabled automatically if websocket routes are Websocket is enabled automatically if websocket routes are
added to the application. added to the application.
@ -661,9 +665,9 @@ class Sanic:
self.websocket_enabled = enable self.websocket_enabled = enable
# Decorator
def exception(self, *exceptions): def exception(self, *exceptions):
"""Decorate a function to be registered as a handler for exceptions """
Decorate a function to be registered as a handler for exceptions
:param exceptions: exceptions :param exceptions: exceptions
:return: decorated function :return: decorated function
@ -680,7 +684,7 @@ class Sanic:
return response return response
def register_middleware(self, middleware, attach_to="request"): def register_middleware(self, middleware, attach_to: str = "request"):
""" """
Register an application level middleware that will be attached Register an application level middleware that will be attached
to all the API URLs registered under this application. to all the API URLs registered under this application.
@ -705,8 +709,22 @@ class Sanic:
return middleware return middleware
def register_named_middleware( def register_named_middleware(
self, middleware, route_names, attach_to="request" self,
middleware,
route_names: Iterable[str],
attach_to: str = "request",
): ):
"""
Method for attaching middleware to specific routes. This is mainly an
internal tool for use by Blueprints to attach middleware to only its
specfic routes. But, it could be used in a more generalized fashion.
:param middleware: the middleware to execute
:param route_names: a list of the names of the endpoints
:type route_names: Iterable[str]
:param attach_to: whether to attach to request or response, defaults to "request"
:type attach_to: str, optional
"""
if attach_to == "request": if attach_to == "request":
for _rn in route_names: for _rn in route_names:
if _rn not in self.named_request_middleware: if _rn not in self.named_request_middleware:
@ -720,13 +738,14 @@ class Sanic:
if middleware not in self.named_response_middleware[_rn]: if middleware not in self.named_response_middleware[_rn]:
self.named_response_middleware[_rn].appendleft(middleware) self.named_response_middleware[_rn].appendleft(middleware)
# Decorator
def middleware(self, middleware_or_request): def middleware(self, middleware_or_request):
""" """
Decorate and register middleware to be called before a request. Decorate and register middleware to be called before a request.
Can either be called as *@app.middleware* or Can either be called as *@app.middleware* or
*@app.middleware('request')* *@app.middleware('request')*
`See user guide <https://sanicframework.org/guide/basics/middleware.html>`__
:param: middleware_or_request: Optional parameter to use for :param: middleware_or_request: Optional parameter to use for
identifying which type of middleware is being registered. identifying which type of middleware is being registered.
""" """
@ -739,19 +758,18 @@ class Sanic:
self.register_middleware, attach_to=middleware_or_request self.register_middleware, attach_to=middleware_or_request
) )
# Static Files
def static( def static(
self, self,
uri, uri: str,
file_or_directory, file_or_directory: str,
pattern=r"/?.+", pattern=r"/?.+",
use_modified_since=True, use_modified_since: bool = True,
use_content_range=False, use_content_range: bool = False,
stream_large_files=False, stream_large_files: bool = False,
name="static", name: str = "static",
host=None, host: Optional[str] = None,
strict_slashes: Optional[bool] = None, strict_slashes: Optional[bool] = None,
content_type=None, content_type: str = None,
): ):
""" """
Register a root to serve files from. The input can either be a Register a root to serve files from. The input can either be a
@ -825,6 +843,8 @@ class Sanic:
Keyword arguments that are not request parameters will be included in Keyword arguments that are not request parameters will be included in
the output URL's query string. the output URL's query string.
`See user guide <https://sanicframework.org/guide/basics/routing.html#generating-a-url>`__
:param view_name: string referencing the view name :param view_name: string referencing the view name
:param \**kwargs: keys and values that are used to build request :param \**kwargs: keys and values that are used to build request
parameters and query string arguments. parameters and query string arguments.
@ -952,21 +972,17 @@ class Sanic:
# Request Handling # Request Handling
# -------------------------------------------------------------------- # # -------------------------------------------------------------------- #
def converted_response_type(self, response): async def handle_exception(
self, request: Request, exception: BaseException
):
""" """
No implementation provided. A handler that catches specific exceptions and outputs a response.
"""
pass
async def handle_exception(self, request, exception): :param request: The current request object
""" :type request: :class:`SanicASGITestClient`
[summary] :param exception: The exception that was raised
:type exception: BaseException
:param request: [description] :raises ServerError: response 500
:type request: [type]
:param exception: [description]
:type exception: [type]
:raises ServerError: [description]
""" """
# -------------------------------------------- # # -------------------------------------------- #
# Request Middleware # Request Middleware
@ -1012,7 +1028,7 @@ class Sanic:
f"Invalid response type {response!r} (need HTTPResponse)" f"Invalid response type {response!r} (need HTTPResponse)"
) )
async def handle_request(self, request): async def handle_request(self, request: Request):
"""Take a request from the HTTP Server and return a response object """Take a request from the HTTP Server and return a response object
to be sent back The HTTP Server only expects a response object, so to be sent back The HTTP Server only expects a response object, so
exception handling must be done here exception handling must be done here
@ -1143,7 +1159,8 @@ class Sanic:
unix: Optional[str] = None, unix: Optional[str] = None,
loop: None = None, loop: None = None,
) -> None: ) -> None:
"""Run the HTTP Server and listen until keyboard interrupt or term """
Run the HTTP Server and listen until keyboard interrupt or term
signal. On termination, drain connections before closing. signal. On termination, drain connections before closing.
:param host: Address to host on :param host: Address to host on
@ -1235,7 +1252,9 @@ class Sanic:
logger.info("Server Stopped") logger.info("Server Stopped")
def stop(self): def stop(self):
"""This kills the Sanic""" """
This kills the Sanic
"""
if not self.is_stopping: if not self.is_stopping:
self.is_stopping = True self.is_stopping = True
get_event_loop().stop() get_event_loop().stop()
@ -1252,8 +1271,8 @@ class Sanic:
backlog: int = 100, backlog: int = 100,
access_log: Optional[bool] = None, access_log: Optional[bool] = None,
unix: Optional[str] = None, unix: Optional[str] = None,
return_asyncio_server=False, return_asyncio_server: bool = False,
asyncio_server_kwargs=None, asyncio_server_kwargs: Dict[str, Any] = None,
) -> Optional[AsyncioServer]: ) -> Optional[AsyncioServer]:
""" """
Asynchronous version of :func:`run`. Asynchronous version of :func:`run`.
@ -1329,7 +1348,8 @@ class Sanic:
) )
async def trigger_events(self, events, loop): async def trigger_events(self, events, loop):
"""Trigger events (functions or async) """
Trigger events (functions or async)
:param events: one or more sync or async functions to execute :param events: one or more sync or async functions to execute
:param loop: event loop :param loop: event loop
""" """
@ -1530,9 +1550,11 @@ class Sanic:
# -------------------------------------------------------------------- # # -------------------------------------------------------------------- #
async def __call__(self, scope, receive, send): async def __call__(self, scope, receive, send):
"""To be ASGI compliant, our instance must be a callable that accepts """
To be ASGI compliant, our instance must be a callable that accepts
three arguments: scope, receive, send. See the ASGI reference for more three arguments: scope, receive, send. See the ASGI reference for more
details: https://asgi.readthedocs.io/en/latest/""" details: https://asgi.readthedocs.io/en/latest
/"""
self.asgi = True self.asgi = True
asgi_app = await ASGIApp.create(self, scope, receive, send) asgi_app = await ASGIApp.create(self, scope, receive, send)
await asgi_app() await asgi_app()
@ -1544,9 +1566,11 @@ class Sanic:
# -------------------------------------------------------------------- # # -------------------------------------------------------------------- #
def update_config(self, config: Union[bytes, str, dict, Any]): def update_config(self, config: Union[bytes, str, dict, Any]):
"""Update app.config. """
Update app.config. Full implementation can be found in the user guide.
Please refer to config.py::Config.update_config for documentation.""" `See user guide <https://sanicframework.org/guide/deployment/configuration.html#basics>`__
"""
self.config.update_config(config) self.config.update_config(config)
@ -1556,7 +1580,9 @@ class Sanic:
@classmethod @classmethod
def register_app(cls, app: "Sanic") -> None: def register_app(cls, app: "Sanic") -> None:
"""Register a Sanic instance""" """
Register a Sanic instance
"""
if not isinstance(app, cls): if not isinstance(app, cls):
raise SanicException("Registered app must be an instance of Sanic") raise SanicException("Registered app must be an instance of Sanic")
@ -1568,7 +1594,9 @@ class Sanic:
@classmethod @classmethod
def get_app(cls, name: str, *, force_create: bool = False) -> "Sanic": def get_app(cls, name: str, *, force_create: bool = False) -> "Sanic":
"""Retrieve an instantiated Sanic instance""" """
Retrieve an instantiated Sanic instance
"""
try: try:
return cls._app_registry[name] return cls._app_registry[name]
except KeyError: except KeyError:

38
sanic/blueprint_group.py
View File

@ -1,4 +1,5 @@
from collections.abc import MutableSequence from collections.abc import MutableSequence
from typing import List
class BlueprintGroup(MutableSequence): class BlueprintGroup(MutableSequence):
@ -9,6 +10,32 @@ class BlueprintGroup(MutableSequence):
some of the existing implementation, this class provides a custom some of the existing implementation, this class provides a custom
iterator implementation that will let you use the object of this iterator implementation that will let you use the object of this
class as a list/tuple inside the existing implementation. class as a list/tuple inside the existing implementation.
.. code-block:: python
bp1 = Blueprint('bp1', url_prefix='/bp1')
bp2 = Blueprint('bp2', url_prefix='/bp2')
@bp1.middleware('request')
async def bp1_only_middleware(request):
print('applied on Blueprint : bp1 Only')
@bp1.route('/')
async def bp1_route(request):
return text('bp1')
@bp2.route('/<param>')
async def bp2_route(request, param):
return text(param)
group = Blueprint.group(bp1, bp2)
@group.middleware('request')
async def group_middleware(request):
print('common middleware applied for both bp1 and bp2')
# Register Blueprint group under the app
app.blueprint(group)
""" """
__slots__ = ("_blueprints", "_url_prefix") __slots__ = ("_blueprints", "_url_prefix")
@ -23,23 +50,27 @@ class BlueprintGroup(MutableSequence):
self._url_prefix = url_prefix self._url_prefix = url_prefix
@property @property
def url_prefix(self): def url_prefix(self) -> str:
""" """
Retrieve the URL prefix being used for the Current Blueprint Group Retrieve the URL prefix being used for the Current Blueprint Group
:return: string with url prefix :return: string with url prefix
""" """
return self._url_prefix return self._url_prefix
@property @property
def blueprints(self): def blueprints(self) -> List:
""" """
Retrieve a list of all the available blueprints under this group. Retrieve a list of all the available blueprints under this group.
:return: List of Blueprint instance :return: List of Blueprint instance
""" """
return self._blueprints return self._blueprints
def __iter__(self): def __iter__(self):
"""Tun the class Blueprint Group into an Iterable item""" """
Tun the class Blueprint Group into an Iterable item
"""
return iter(self._blueprints) return iter(self._blueprints)
def __getitem__(self, item): def __getitem__(self, item):
@ -85,6 +116,7 @@ class BlueprintGroup(MutableSequence):
def __len__(self) -> int: def __len__(self) -> int:
""" """
Get the Length of the blueprint group object. Get the Length of the blueprint group object.
:return: Length of Blueprint group object :return: Length of Blueprint group object
""" """
return len(self._blueprints) return len(self._blueprints)

206
sanic/blueprints.py
View File

@ -1,56 +1,38 @@
from collections import defaultdict, namedtuple from collections import defaultdict, namedtuple
from typing import Iterable, Optional
from sanic.blueprint_group import BlueprintGroup from sanic.blueprint_group import BlueprintGroup
from sanic.constants import HTTP_METHODS from sanic.constants import HTTP_METHODS
from sanic.views import CompositionView from sanic.views import CompositionView
FutureRoute = namedtuple(
"FutureRoute",
[
"handler",
"uri",
"methods",
"host",
"strict_slashes",
"stream",
"version",
"name",
],
)
FutureListener = namedtuple(
"FutureListener", ["handler", "uri", "methods", "host"]
)
FutureMiddleware = namedtuple(
"FutureMiddleware", ["middleware", "args", "kwargs"]
)
FutureException = namedtuple("FutureException", ["handler", "args", "kwargs"])
FutureStatic = namedtuple(
"FutureStatic", ["uri", "file_or_directory", "args", "kwargs"]
)
class Blueprint: class Blueprint:
"""
In *Sanic* terminology, a **Blueprint** is a logical collection of
URLs that perform a specific set of tasks which can be identified by
a unique name.
It is the main tool for grouping functionality and similar endpoints.
`See user guide
<https://sanicframework.org/guide/best-practices/blueprints.html>`__
:param name: unique name of the blueprint
:param url_prefix: URL to be prefixed before all route URLs
:param host: IP Address of FQDN for the sanic server to use.
:param version: Blueprint Version
:param strict_slashes: Enforce the API urls are requested with a
training */*
"""
def __init__( def __init__(
self, self,
name, name: str,
url_prefix=None, url_prefix: Optional[str] = None,
host=None, host: Optional[str] = None,
version=None, version: Optional[int] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
): ):
"""
In *Sanic* terminology, a **Blueprint** is a logical collection of
URLs that perform a specific set of tasks which can be identified by
a unique name.
:param name: unique name of the blueprint
:param url_prefix: URL to be prefixed before all route URLs
:param host: IP Address of FQDN for the sanic server to use.
:param version: Blueprint Version
:param strict_slashes: Enforce the API urls are requested with a
training */*
"""
self.name = name self.name = name
self.url_prefix = url_prefix self.url_prefix = url_prefix
self.host = host self.host = host
@ -178,15 +160,16 @@ class Blueprint:
def route( def route(
self, self,
uri, uri: str,
methods=frozenset({"GET"}), methods: Iterable[str] = frozenset({"GET"}),
host=None, host: Optional[str] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
stream=False, stream: bool = False,
version=None, version: Optional[int] = None,
name=None, name: Optional[str] = None,
): ):
"""Create a blueprint route from a decorated function. """
Create a blueprint route from a decorated function.
:param uri: endpoint at which the route will be accessible. :param uri: endpoint at which the route will be accessible.
:param methods: list of acceptable HTTP methods. :param methods: list of acceptable HTTP methods.
@ -222,15 +205,16 @@ class Blueprint:
def add_route( def add_route(
self, self,
handler, handler,
uri, uri: str,
methods=frozenset({"GET"}), methods: Iterable[str] = frozenset({"GET"}),
host=None, host: Optional[str] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
version=None, version: Optional[int] = None,
name=None, name: Optional[str] = None,
stream=False, stream: bool = False,
): ):
"""Create a blueprint route from a function. """
Create a blueprint route from a function.
:param handler: function for handling uri requests. Accepts function, :param handler: function for handling uri requests. Accepts function,
or class instance with a view_class method. or class instance with a view_class method.
@ -271,9 +255,15 @@ class Blueprint:
return handler return handler
def websocket( def websocket(
self, uri, host=None, strict_slashes=None, version=None, name=None self,
uri: str,
host: Optional[str] = None,
strict_slashes: Optional[bool] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
"""Create a blueprint websocket route from a decorated function. """
Create a blueprint websocket route from a decorated function.
:param uri: endpoint at which the route will be accessible. :param uri: endpoint at which the route will be accessible.
:param host: IP Address of FQDN for the sanic server to use. :param host: IP Address of FQDN for the sanic server to use.
@ -302,7 +292,12 @@ class Blueprint:
return decorator return decorator
def add_websocket_route( def add_websocket_route(
self, handler, uri, host=None, version=None, name=None self,
handler,
uri: str,
host: Optional[str] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
"""Create a blueprint websocket route from a function. """Create a blueprint websocket route from a function.
@ -378,7 +373,7 @@ class Blueprint:
return decorator return decorator
def static(self, uri, file_or_directory, *args, **kwargs): def static(self, uri: str, file_or_directory: str, *args, **kwargs):
"""Create a blueprint static route from a decorated function. """Create a blueprint static route from a decorated function.
:param uri: endpoint at which the route will be accessible. :param uri: endpoint at which the route will be accessible.
@ -398,7 +393,12 @@ class Blueprint:
# Shorthand method decorators # Shorthand method decorators
def get( def get(
self, uri, host=None, strict_slashes=None, version=None, name=None self,
uri: str,
host: Optional[str] = None,
strict_slashes: Optional[bool] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
""" """
Add an API URL under the **GET** *HTTP* method Add an API URL under the **GET** *HTTP* method
@ -422,12 +422,12 @@ class Blueprint:
def post( def post(
self, self,
uri, uri: str,
host=None, host: Optional[str] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
stream=False, stream: bool = False,
version=None, version: Optional[int] = None,
name=None, name: Optional[str] = None,
): ):
""" """
Add an API URL under the **POST** *HTTP* method Add an API URL under the **POST** *HTTP* method
@ -452,12 +452,12 @@ class Blueprint:
def put( def put(
self, self,
uri, uri: str,
host=None, host: Optional[str] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
stream=False, stream: bool = False,
version=None, version: Optional[int] = None,
name=None, name: Optional[str] = None,
): ):
""" """
Add an API URL under the **PUT** *HTTP* method Add an API URL under the **PUT** *HTTP* method
@ -481,7 +481,12 @@ class Blueprint:
) )
def head( def head(
self, uri, host=None, strict_slashes=None, version=None, name=None self,
uri: str,
host: Optional[str] = None,
strict_slashes: Optional[bool] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
""" """
Add an API URL under the **HEAD** *HTTP* method Add an API URL under the **HEAD** *HTTP* method
@ -504,7 +509,12 @@ class Blueprint:
) )
def options( def options(
self, uri, host=None, strict_slashes=None, version=None, name=None self,
uri: str,
host: Optional[str] = None,
strict_slashes: Optional[bool] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
""" """
Add an API URL under the **OPTIONS** *HTTP* method Add an API URL under the **OPTIONS** *HTTP* method
@ -528,12 +538,12 @@ class Blueprint:
def patch( def patch(
self, self,
uri, uri: str,
host=None, host: Optional[str] = None,
strict_slashes=None, strict_slashes: Optional[bool] = None,
stream=False, stream=False,
version=None, version: Optional[int] = None,
name=None, name: Optional[str] = None,
): ):
""" """
Add an API URL under the **PATCH** *HTTP* method Add an API URL under the **PATCH** *HTTP* method
@ -557,7 +567,12 @@ class Blueprint:
) )
def delete( def delete(
self, uri, host=None, strict_slashes=None, version=None, name=None self,
uri: str,
host: Optional[str] = None,
strict_slashes: Optional[bool] = None,
version: Optional[int] = None,
name: Optional[str] = None,
): ):
""" """
Add an API URL under the **DELETE** *HTTP* method Add an API URL under the **DELETE** *HTTP* method
@ -578,3 +593,28 @@ class Blueprint:
version=version, version=version,
name=name, name=name,
) )
FutureRoute = namedtuple(
"FutureRoute",
[
"handler",
"uri",
"methods",
"host",
"strict_slashes",
"stream",
"version",
"name",
],
)
FutureListener = namedtuple(
"FutureListener", ["handler", "uri", "methods", "host"]
)
FutureMiddleware = namedtuple(
"FutureMiddleware", ["middleware", "args", "kwargs"]
)
FutureException = namedtuple("FutureException", ["handler", "args", "kwargs"])
FutureStatic = namedtuple(
"FutureStatic", ["uri", "file_or_directory", "args", "kwargs"]
)

19
sanic/compat.py
View File

@ -11,7 +11,24 @@ OS_IS_WINDOWS = os.name == "nt"
class Header(CIMultiDict): class Header(CIMultiDict):
def get_all(self, key): """
Container used for both request and response headers. It is a subclass of
`CIMultiDict
<https://multidict.readthedocs.io/en/stable/multidict.html#cimultidictproxy>`__.
It allows for multiple values for a single key in keeping with the HTTP
spec. Also, all keys are *case in-sensitive*.
Please checkout `the MultiDict documentation
<https://multidict.readthedocs.io/en/stable/multidict.html#multidict>`__
for more details about how to use the object. In general, it should work
very similar to a regular dictionary.
"""
def get_all(self, key: str):
"""
Convenience method mapped to ``getall()``.
"""
return self.getall(key, default=[]) return self.getall(key, default=[])