Router¶

Router является главным объектом, который связывает Ravyn с Gateway, WebSocketGateway и handlers.

Класс Router¶

Класс Router состоит из множества атрибутов, которые по умолчанию заполняются в приложении. Однако Ravyn также позволяет добавить дополнительные пользовательские маршрутизаторы или добавить приложение ChildRavyn.

from pydantic import BaseModel

from ravyn import Ravyn, Gateway, post


class User(BaseModel):
    name: str
    email: str


@post("/create")
def create(data: User) -> User: ...


app = Ravyn(routes=[Gateway(handler=create)])

Основной класс Router создается в приложении Ravyn с заданными маршрутами и приложение запускается.

Параметры¶

Все параметры и значения по умолчанию доступны в Router.

Пользовательский маршрутизатор¶

Предположим, что существуют определенные подмодули customer в файле customers, посвященном клиентам. Существует три способа разделения маршрутов в приложении: с использованием Include, ChildRavyn или созданием другого маршрутизатора. Давайте сосредоточимся на последнем варианте.

from pydantic import BaseModel

from ravyn import Gateway, JSONResponse, Router, get, post


class Address(BaseModel):
    address_line: str
    street: str
    post_code: str


class Customer(BaseModel):
    name: str
    email: str
    address: Address


@post("/")
def create(data: Customer) -> JSONResponse:
    return JSONResponse({"created": True})


@get("/{customer_id:int}")
async def get_customer(customer_id: int) -> JSONResponse:
    return JSONResponse({"created": True})


router = Router(
    path="/customers",
    routes=[
        Gateway("/", handler=get_customer),
        Gateway("/create", handler=create),
    ],
)

Выше вы создали /application/apps/routers/customers.py с необходимой информацией. Он не обязательно должен быть в одном файле, вы можете создать совершенно отдельный пакет, только для управления customer.

Теперь вам нужно добавить новый пользовательский маршрутизатор в основное приложение.

from apps.routers.customers import router as customers_router

from ravyn import Ravyn

app = Ravyn()
app.add_router(customers_router)

Ваш маршрутизатор добавлен в основное приложение Ravyn.

Child Ravyn Application¶

Что это такое? Мы называем его ChildRavyn, но на самом деле это просто Ravyn, но под другим именем, в основном для удобства организации.

При организации маршрутов использование самого класса Router может быть немного ограничивающим, поскольку существуют определенные атрибуты, которые при использовании в экземпляре или Router для передачи в add_route не будут учтены.

Пример:

• response_class
• response_cookies
• response_headers
• tags
• include_in_schema

Это не ограничение и не ошибка, на самом деле это сделано намеренно, поскольку мы хотим сохранить целостность приложения.

Как это работает¶

Давайте используем тот же пример, что и в пользовательских маршрутизаторах с маршрутами и правилами, специфичными для клиентов.

from pydantic import BaseModel

from ravyn import ChildRavyn, Gateway, JSONResponse, get, post


class Address(BaseModel):
    address_line: str
    street: str
    post_code: str


class Customer(BaseModel):
    name: str
    email: str
    address: Address


@post("/")
def create(data: Customer) -> JSONResponse:
    return JSONResponse({"created": True})


@get("/{customer_id:int}")
async def get_customer(customer_id: int) -> JSONResponse:
    return JSONResponse({"created": True})


router = ChildRavyn(
    routes=[
        Gateway("/", handler=get_customer),
        Gateway("/create", handler=create),
    ],
    include_in_schema=...,
    response_class=...,
    response_headers=...,
    response_cookies=...,
)

Поскольку ChildRavyn является представлением класса Ravyn, мы можем передать ранее ограниченные параметры в пользовательском маршрутизаторе и все параметры, доступные для Ravyn.

Вы можете добавить столько ChildRavyn, сколько захотите, ограничений нет.

Теперь в основном приложении:

from apps.routers.customers import router as customers_router

from ravyn import Ravyn, Include

app = Ravyn(routes=[Include("/customers", app=customers_router)])

Добавление вложенных приложений

from apps.routers.clients import router as clients_router
from apps.routers.customers import router as customers_router
from apps.routers.restrict import router as restrict_router

from ravyn import Ravyn, Include

app = Ravyn(
    routes=[
        Include("/customers", app=customers_router),
        Include(
            "/api/v1",
            routes=[
                Include("/clients", clients_router),
                Include("/restrict", routes=[Include("/access", restrict_router)]),
            ],
        ),
    ]
)

Приведенный выше пример показывает, что вы даже можете добавить то же самое приложение внутри вложенных includes, и для каждого include вы можете добавить уникальные permissions, middlewares, обработчики исключений и зависимости, которые доступны для каждого экземпляра Include. Вариантов бесконечно много.

Утилиты¶

Объект Router имеет ряд функций, которые могут быть полезны.

add_route¶

from ravyn import Ravyn

app = Ravyn()

app.add_route(
    handler=...,
    dependencies=...,
    exception_handlers=...,
    permissions=...,
    middleware=...,
    name=...,
    interceptors=...,
    include_in_schema=...,
)

Параметры¶

• name - Название маршрута.
• include_in_schema - Добавлять ли маршрут в схему OpenAPI.
• handler - HTTP обработчик.
• permissions - Список permissions для обслуживания входящих запросов приложения (HTTP и WebSockets).
• middleware - Список middleware выполняемых для каждого запроса. Middlewares из Include будут проверяться сверху вниз.
• interceptors - Список interceptors или Lilya Middleware, поскольку они оба внутренне преобразуются. Узнайте больше о Python Protocols.
• dependencies - Словарь строк и экземпляров Inject, позволяющих внедрить зависимости на уровне приложения.
• exception_handlers - Словарь типов исключений (или пользовательских исключений) и функций-обработчиков на верхнем уровне приложения. Вызываемые обработчики исключений должны иметь вид handler(request, exc) -> response и могут быть как синхронными, так и асинхронными функциями.

add_websocket_route¶

from ravyn import Ravyn

app = Ravyn()

app.add_websocket_route(
    handler=...,
    dependencies=...,
    exception_handlers=...,
    permissions=...,
    middleware=...,
    interceptors=...,
    name=...,
)

Параметры¶

• name - Название маршрута.
• Websocket handler - Websocket обработчик.
• permissions - Список permissions для обслуживания входящих запросов приложения (HTTP и WebSockets).
• interceptors - Список interceptors.
• middleware - Список middleware выполняемых для каждого запроса. Middlewares из Include будут проверяться сверху вниз. Или Lilya Middleware, поскольку они оба внутренне преобразуются. Узнайте больше о Python Protocols.
• dependencies - Словарь строк и экземпляров Inject, позволяющих внедрить зависимости на уровне приложения.
• exception_handlers - Словарь типов исключений (или пользовательских исключений) и функций-обработчиков на верхнем уровне приложения. Вызываемые обработчики исключений должны иметь вид handler(request, exc) -> response и могут быть как синхронными, так и асинхронными функциями.

add_child_ravyn¶

from ravyn import ChildRavyn, Ravyn, Gateway, get


@get()
async def home() -> str:
    return "home"


child = ChildRavyn(routes=[Gateway(handler=home, name="my-controller")])

app = Ravyn()
app.add_child_ravyn(
    path="/child",
    child=child,
    name=...,
    middleware=...,
    dependencies=...,
    exception_handlers=...,
    interceptors=...,
    permissions=...,
    include_in_schema=...,
    deprecated=...,
    security=...,
)

Параметры¶

• path - Путь для ChildRavyn.
• child - Экземпляр ChildRavyn.
• name - Название маршрута.
• Websocket handler - Websocket обработчик.
• permissions - Список permissions для обслуживания входящих запросов приложения (HTTP и WebSockets).
• interceptors - Список interceptors.
• middleware - Список middleware выполняемых для каждого запроса. Middlewares из Include будут проверяться сверху вниз. Или Lilya Middleware, поскольку они оба внутренне преобразуются. Узнайте больше о Python Protocols.
• dependencies - Словарь строк и экземпляров Inject, позволяющих внедрить зависимости на уровне приложения.
• exception_handlers - Словарь типов исключений (или пользовательских исключений) и функций-обработчиков на верхнем уровне приложения. Вызываемые обработчики исключений должны иметь вид handler(request, exc) -> response и могут быть как синхронными, так и асинхронными функциями.
• include_in_schema - Флаг, указывающий, следует ли включать ChildRavyn в схему OpenAPI.
• deprecated - Флаг, указывающий, следует ли пометить ChildRavyn как устаревший.