New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
🌐 Add Russian translation for docs/ru/docs/deployment/versions.md
#4985
Changes from 4 commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,87 @@ | ||
# О версиях FastAPI | ||
|
||
**FastAPI** уже используется в продакшене во многих приложениях и системах. Покрытие тестами поддерживается на уровне 100%. Однако его разработка все еще продолжается. | ||
|
||
Часто добавляются новые функции, регулярно исправляются баги, код продолжает постоянно совершенствоваться. | ||
|
||
По указанным причинам текущие версии до сих пор `0.x.x`. Это говорит о том, что каждая версия может содержать обратно несовместимые изменения, следуя <a href="https://semver.org/" class="external-link" target="_blank">соглашению о Семантическом Версионировании</a>. | ||
|
||
Уже сейчас вы можете создавать приложения в продакшене, используя **FastAPI** (и скорее всего так и делаете), главное убедиться в том, что вы используете версию, которая корректно работает с вашим кодом. | ||
|
||
## Закрепите вашу версию `fastapi` | ||
|
||
Первым делом вам следует "закрепить" конкретную последнюю используемую версию **FastAPI**, которая корректно работает с вашим приложением. | ||
|
||
Например, вы используете версию `0.45.0` в приложении. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Например, в своём приложении.вы используете версию |
||
|
||
Если вы используете файл `requirements.txt`, вы можете указать версию следующим способом: | ||
|
||
```txt | ||
fastapi==0.45.0 | ||
``` | ||
|
||
что значит, что вы будете использовать именно версию `0.45.0`. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
не очень красиво с такими повторами...
|
||
|
||
Или вы можете закрепить версию следующим способом: | ||
|
||
```txt | ||
fastapi>=0.45.0,<0.46.0 | ||
``` | ||
|
||
что значит, что вы используете версии `0.45.0` или выше, но меньше чем `0.46.0`. Например, версия `0.45.2` все еще будет подходить. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
не очень красиво с такими повторами...
|
||
|
||
Если вы используете любой другой инструмент для организации установки, например Poetry, Pipenv или др., у них у всех имеется способ определения специфической версии для ваших пакетов. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Мне чаще встречается - "управление зависимостями". |
||
|
||
## Доступные версии | ||
|
||
Вы можете увидеть доступные версии (например, проверить последнюю на данный момент) в [Release Notes](../release-notes.md){.internal-link target=_blank}. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Посмотреть |
||
|
||
## О версиях | ||
|
||
Следуя соглашению о Семантическом Версионировании, любые версии ниже `1.0.0` потенциально могут добавить обратно несовместимые изменения. | ||
|
||
FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и внесения обратно совместимых изменений. | ||
|
||
!!! tip | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Не переведено. Подсказка/уточнение There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @Xewus если я правильно помню, There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Возможно, Вы правы, завтра постараюсь пощупать этот случай. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Завтра проверю. Если локально проблем не будет, сделаю необходимые изменения. |
||
"ПАТЧ" - это последнее число. Например, в `0.2.3`, ПАТЧ-версия - это `3`. | ||
|
||
Итак, вы можете закрепить версию следующим образом: | ||
|
||
```txt | ||
fastapi>=0.45.0,<0.46.0 | ||
``` | ||
|
||
Обратно несовместимые изменения и новые функции добавляются в "МИНОРНЫЕ" версии. | ||
|
||
!!! tip | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Не переведено. Подсказка/уточнение |
||
"МИНОРНАЯ" версия - это число в середине. Например, в `0.2.3` МИНОРНАЯ версия - это `2`. | ||
|
||
## Обновление версии FastAPI | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Й |
||
|
||
Вам следует добавить тесты для вашего приложения. | ||
|
||
С помощью **FastAPI** это очень просто (благодаря Starlette), см. документацию: [Testing](../tutorial/testing.md){.internal-link target=_blank} | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Не переведено. |
||
|
||
После создания тестов вы можете обновить свою версию **FastAPI** до более новой. После это следует убедиться, что ваш код работает корректно, запустив тесты. | ||
|
||
Если все работает корректно, или после внесения необходимых изменений все ваши тесты проходят, только тогда вы можете закрепить вашу новую версию `fastapi`. | ||
|
||
## О Starlette | ||
|
||
Не следует закреплять версию `starlette`. | ||
|
||
Разные версии **FastAPI** будут использовать более новые версии Starlette. | ||
|
||
Так что решение об используемой версии Starlette, вы можете оставить **FastAPI**. | ||
|
||
## О Pydantic | ||
|
||
Pydantic включает свои собственные тесты для **FastAPI**, так что новые версии Pydantic (выше `1.0.0`) всегда совместимы с FastAPI. | ||
|
||
Вы можете закрепить любую версию Pydantic, которая вам подходит, выше `1.0.0` и ниже `2.0.0`. | ||
|
||
Например: | ||
|
||
```txt | ||
pydantic>=1.2.0,<2.0.0 | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -57,6 +57,8 @@ nav: | |
- uk: /uk/ | ||
- zh: /zh/ | ||
- async.md | ||
- Развёртывание: | ||
- deployment/versions.md | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Хорошо, что не забыли про этот файл. |
||
markdown_extensions: | ||
- toc: | ||
permalink: true | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
На русском, как будто бы, глагола не достаёт: "текущие версии до сих пор
0.x.x
". Может быть "текущие версии до сих пор не достигли 1.x.x", раз речь о семвере? Впрочем, если над этим слишком долго думать, то выйдет уже 1.0 .))