Browse Source

Fix permalinks conflict with markdown link attributes

pull/15152/head
Yurii Motov 4 months ago
parent
commit
39537c2e69
  1. 32
      docs/ru/docs/alternatives.md

32
docs/ru/docs/alternatives.md

@ -14,7 +14,7 @@
## Предшествующие инструменты { #previous-tools }
### [Django](https://www.djangoproject.com/){ #django }
### [Django](https://www.djangoproject.com/) { #django }
Это самый популярный Python-фреймворк, ему широко доверяют. Он используется для построения систем вроде Instagram.
@ -22,7 +22,7 @@
Он был создан для генерации HTML на бэкенде, а не для создания API, используемых современным фронтендом (например, React, Vue.js и Angular) или другими системами (например, устройствами <abbr title="Internet of Things – Интернет вещей">IoT</abbr>), которые с ним общаются.
### [Django REST Framework](https://www.django-rest-framework.org/){ #django-rest-framework }
### [Django REST Framework](https://www.django-rest-framework.org/) { #django-rest-framework }
Django REST Framework был создан как гибкий набор инструментов для построения веб-API поверх Django, чтобы улучшить его возможности в части API.
@ -42,7 +42,7 @@ Django REST Framework был создан Томом Кристи. Он же с
///
### [Flask](https://flask.palletsprojects.com){ #flask }
### [Flask](https://flask.palletsprojects.com) { #flask }
Flask — это «микрофреймворк», он не включает интеграции с базами данных и многие другие вещи, которые в Django идут «из коробки».
@ -64,7 +64,7 @@ Flask — это «микрофреймворк», он не включает и
///
### [Requests](https://requests.readthedocs.io){ #requests }
### [Requests](https://requests.readthedocs.io) { #requests }
**FastAPI** на самом деле не альтернатива **Requests**. Их области применения очень различны.
@ -106,7 +106,7 @@ def read_url():
///
### [Swagger](https://swagger.io/) / [OpenAPI](https://github.com/OAI/OpenAPI-Specification/){ #swagger-openapi }
### [Swagger](https://swagger.io/) / [OpenAPI](https://github.com/OAI/OpenAPI-Specification/) { #swagger-openapi }
Главной возможностью, которую хотелось взять из Django REST Framework, была автоматическая документация API.
@ -135,7 +135,7 @@ def read_url():
Существует несколько REST-фреймворков для Flask, но, вложив время и усилия в исследование, я обнаружил, что многие из них прекращены или заброшены, с несколькими нерешёнными Issue (тикет\обращение), из-за которых они непригодны.
### [Marshmallow](https://marshmallow.readthedocs.io/en/stable/){ #marshmallow }
### [Marshmallow](https://marshmallow.readthedocs.io/en/stable/) { #marshmallow }
Одна из основных возможностей, нужных системам API, — «<dfn title="также называемая маршаллингом, преобразованием">сериализация</dfn>» данных, то есть преобразование данных из кода (Python) во что-то, что можно отправить по сети. Например, преобразование объекта с данными из базы в JSON-объект. Преобразование объектов `datetime` в строки и т. п.
@ -153,7 +153,7 @@ def read_url():
///
### [Webargs](https://webargs.readthedocs.io/en/latest/){ #webargs }
### [Webargs](https://webargs.readthedocs.io/en/latest/) { #webargs }
Ещё одна важная возможность для API — <dfn title="чтение и преобразование в данные Python">парсинг</dfn> данных из входящих HTTP-запросов.
@ -175,7 +175,7 @@ Webargs был создан теми же разработчиками, что
///
### [APISpec](https://apispec.readthedocs.io/en/stable/){ #apispec }
### [APISpec](https://apispec.readthedocs.io/en/stable/) { #apispec }
Marshmallow и Webargs предоставляют валидацию, парсинг и сериализацию как плагины.
@ -205,7 +205,7 @@ APISpec был создан теми же разработчиками, что
///
### [Flask-apispec](https://flask-apispec.readthedocs.io/en/latest/){ #flask-apispec }
### [Flask-apispec](https://flask-apispec.readthedocs.io/en/latest/) { #flask-apispec }
Это плагин для Flask, который связывает Webargs, Marshmallow и APISpec.
@ -259,7 +259,7 @@ Flask-apispec был создан теми же разработчиками, ч
///
### [Sanic](https://sanic.readthedocs.io/en/latest/){ #sanic }
### [Sanic](https://sanic.readthedocs.io/en/latest/) { #sanic }
Это был один из первых чрезвычайно быстрых Python-фреймворков на основе `asyncio`. Он был сделан очень похожим на Flask.
@ -279,7 +279,7 @@ Flask-apispec был создан теми же разработчиками, ч
///
### [Falcon](https://falconframework.org/){ #falcon }
### [Falcon](https://falconframework.org/) { #falcon }
Falcon — ещё один высокопроизводительный Python-фреймворк, он минималистичен и служит основой для других фреймворков, таких как Hug.
@ -297,7 +297,7 @@ Falcon — ещё один высокопроизводительный Python-
///
### [Molten](https://moltenframework.com/){ #molten }
### [Molten](https://moltenframework.com/) { #molten }
Я обнаружил Molten на ранних этапах создания **FastAPI**. И у него были очень похожие идеи:
@ -321,7 +321,7 @@ Falcon — ещё один высокопроизводительный Python-
///
### [Hug](https://github.com/hugapi/hug){ #hug }
### [Hug](https://github.com/hugapi/hug) { #hug }
Hug был одним из первых фреймворков, реализовавших объявление типов параметров API с использованием аннотаций типов Python. Это была отличная идея, которая вдохновила и другие инструменты.
@ -401,7 +401,7 @@ APIStar был создан Томом Кристи. Тем самым чело
## Что используется в **FastAPI** { #used-by-fastapi }
### [Pydantic](https://docs.pydantic.dev/){ #pydantic }
### [Pydantic](https://docs.pydantic.dev/) { #pydantic }
Pydantic — это библиотека для определения валидации данных, сериализации и документации (с использованием JSON Schema) на основе аннотаций типов Python.
@ -417,7 +417,7 @@ Pydantic — это библиотека для определения вали
///
### [Starlette](https://www.starlette.dev/){ #starlette }
### [Starlette](https://www.starlette.dev/) { #starlette }
Starlette — это лёгкий <dfn title="Новый стандарт построения асинхронных веб-приложений на Python">ASGI</dfn> фреймворк/набор инструментов, идеально подходящий для создания высокопроизводительных asyncio‑сервисов.
@ -462,7 +462,7 @@ ASGI — это новый «стандарт», разрабатываемый
///
### [Uvicorn](https://www.uvicorn.dev/){ #uvicorn }
### [Uvicorn](https://www.uvicorn.dev/) { #uvicorn }
Uvicorn — молниеносный ASGI-сервер, построенный на uvloop и httptools.

Loading…
Cancel
Save