-
-
Notifications
You must be signed in to change notification settings - Fork 6.1k
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/tutorial/dependencies/dependencies-in-path-operation-decorators.md
#10526
Conversation
…endencies-in-path-operation-decorators.md`
📝 Docs preview for commit 82ff11f at: https://d8e4f2bb.fastapitiangolo.pages.dev |
fucking russian-terrorists with theirs translation ... |
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
Outdated
Show resolved
Hide resolved
📝 Docs preview for commit 5b0475b at: https://e1b82d0b.fastapitiangolo.pages.dev |
{!> ../../../docs_src/dependencies/tutorial006.py!} | ||
``` | ||
|
||
Эти зависимости будут выполняться/решаться таким же образом, как и обычные зависимости. Но их значение (если они возвращают какое-либо значение) не будет передано вашей *функции операции пути*. |
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.
РАЗрешаться?
...тем же образом... что и обычные зависимости
И, кмк, здесь не "значение", а скорее "результат" – т.к. результат выполнения.
Например: Но результат их выполнения (если они что-либо возвращают) не будет передан вашей ФОП.
|
||
Используя эти "зависимости" в *декораторах операций путей*, вы можете убедиться, что они выполняются, избегая ошибок редактора в котором вы работаете. | ||
|
||
Это также может помочь избежать путаницы для новых разработчиков, которые видят неиспользуемый параметр в вашем коде и могут подумать, что в нем нет необходимости. |
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.
У новых разработчиков?
Это также может помочь избежать путаницы для новых разработчиков, которые видят неиспользуемый параметр в вашем коде и могут подумать, что в нем нет необходимости. | ||
|
||
!!! info "Дополнительная информация" | ||
В этом примере мы используем придуманные пользовательские заголовки `X-Key` и `X-Token`. |
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.
придуманные –> вымышленные?
!!! info "Дополнительная информация" | ||
В этом примере мы используем придуманные пользовательские заголовки `X-Key` и `X-Token`. | ||
|
||
Но в реальных случаях, при внедрении безопасности, вы получили бы больше преимуществ от использования интегрированных [утилит безопасности (следующая глава)](../security/index.md){.internal-link target=_blank}. |
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.
"реализуя безопасность" либо
"реализуя функционал безопасности" либо
"при разработке безопасности" либо
"работая над безопасностью"
далее можно не переводить дословно, а просто сказать "вы получите больше преимуществ используя"
|
||
Вы можете использовать те же *функции зависимостей*, что и обычно. | ||
|
||
### Требования к зависимостям |
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.
Скорее здесь "требования зависимостей". Или "зависимости зависимостей".
|
||
### Требования к зависимостям | ||
|
||
Они могут объявлять требования к запросу (например, к заголовкам) или другим подзависимостям: |
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.
Я бы тут раскрыл: Зависимости могут...
|
||
### Возвращаемые значения | ||
|
||
Они могут возвращать или не возвращать значения, в любом случае они использоваться не будут. |
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.
Они... они – но уже другие они.
Я бы раскрыл первые, как и выше: Такие зависимости могут... в любом случае те использованы не будут.
|
||
Они могут возвращать или не возвращать значения, в любом случае они использоваться не будут. | ||
|
||
Таким образом, вы можете повторно использовать обычную зависимость (которая возвращает значение), уже используемую в другом месте, и даже если значение не будет использовано, зависимость будет выполнена: |
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.
(ТАКУЮ которая ...)
и ХОТЯ результат её не будет использован... (т.к. строчкой выше сказано, что результат не будет использован в любом случае)
{!> ../../../docs_src/dependencies/tutorial006.py!} | ||
``` | ||
|
||
## Зависимости для группы *операций путей* |
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.
для совокупности, либо, лучше, "для нескольких"
|
||
## Зависимости для группы *операций путей* | ||
|
||
Позже, читая о том, как структурировать большие приложения ([Большие приложения - несколько файлов](../../tutorial/bigger-applications.md){.internal-link target=_blank}), возможно, с несколькими файлами, вы узнаете, как объявить один параметр `dependencies` для группы *операций путией*. |
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.
Позже –> либо НИЖЕ
читая –> прочитав (узнают что-либо только по окончании чтения)
структурировать -> строить
Крупные приложения: несколько файлов
либо
Приложения покрупнее: несколько файлов
possibly with multiple files: быть может ИЗ нескольких файлов
либо
возможно многофайловые
Итого:
Ниже, прочитав о том, как строить приложения покрупнее (Большие приложения: из нескольких файлов), возможно многофайловые, вы узнаете...
один –> можно подчеркнуть: ЕДИНЫЙ
путией –> путей
|
||
Но вам все равно нужно, чтобы она была выполнена/решена. | ||
|
||
Для таких случаев вместо объявления параметра в *функции операции пути* с `Depends` можно добавить `список зависимостей` в *декоратор операции пути*. |
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.
На этот случай, ...
...через Depends,
|
||
Для таких случаев вместо объявления параметра в *функции операции пути* с `Depends` можно добавить `список зависимостей` в *декоратор операции пути*. | ||
|
||
## Добавление `зависимости` в *декоратор операции пути* |
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.
а вот здесь "dependencies" не надо переводить, это название параметра
Так и написать: Добавление параметра "dependencies"...
|
||
*Декоратор операции пути* принимает необязательный аргумент `dependencies`. | ||
|
||
Это должен быть `список` объектов типа `Depends()`: |
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.
Можно явно уточнить: (list)
Эти зависимости будут выполняться/решаться таким же образом, как и обычные зависимости. Но их значение (если они возвращают какое-либо значение) не будет передано вашей *функции операции пути*. | ||
|
||
!!! tip "Подсказка" | ||
Некоторые редакторы проверяют наличие неиспользуемых параметров функции и отображают их как ошибки. |
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.
отображают –> помечают
!!! tip "Подсказка" | ||
Некоторые редакторы проверяют наличие неиспользуемых параметров функции и отображают их как ошибки. | ||
|
||
Используя эти "зависимости" в *декораторах операций путей*, вы можете убедиться, что они выполняются, избегая ошибок редактора в котором вы работаете. |
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.
также не переводить dependencies
Напр.: Используя dependencies
в декораторах операций путей, вы можете быть уверены, что они задействуются, но не будут в то же время создавать ошибок в IDE и статических анализаторах кода.
|
||
Но в реальных случаях, при внедрении безопасности, вы получили бы больше преимуществ от использования интегрированных [утилит безопасности (следующая глава)](../security/index.md){.internal-link target=_blank}. | ||
|
||
## Ошибки зависимостей и возвращаемые значения |
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.
тут скорее "В зависимостях"
As this PR had requested changes to be applied but has been inactive for a while, it's now going to be closed. But if there's anyone interested, feel free to create a new PR. |
No description provided.