Skip to content
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

AlertRED
Copy link
Contributor

No description provided.

@tiangolo
Copy link
Owner

📝 Docs preview for commit 82ff11f at: https://d8e4f2bb.fastapitiangolo.pages.dev

@h0rn3t
Copy link

h0rn3t commented Oct 26, 2023

fucking russian-terrorists with theirs translation ...

@tiangolo tiangolo added lang-all Translations lang-ru Russian translations awaiting-review labels Oct 30, 2023
@tiangolo
Copy link
Owner

tiangolo commented Jan 7, 2024

📝 Docs preview for commit 5b0475b at: https://e1b82d0b.fastapitiangolo.pages.dev

{!> ../../../docs_src/dependencies/tutorial006.py!}
```

Эти зависимости будут выполняться/решаться таким же образом, как и обычные зависимости. Но их значение (если они возвращают какое-либо значение) не будет передано вашей *функции операции пути*.
Copy link
Contributor

@s111d s111d Jan 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

РАЗрешаться?
...тем же образом... что и обычные зависимости
И, кмк, здесь не "значение", а скорее "результат" – т.к. результат выполнения.
Например: Но результат их выполнения (если они что-либо возвращают) не будет передан вашей ФОП.


Используя эти "зависимости" в *декораторах операций путей*, вы можете убедиться, что они выполняются, избегая ошибок редактора в котором вы работаете.

Это также может помочь избежать путаницы для новых разработчиков, которые видят неиспользуемый параметр в вашем коде и могут подумать, что в нем нет необходимости.
Copy link
Contributor

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`.
Copy link
Contributor

@s111d s111d Jan 7, 2024

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}.
Copy link
Contributor

@s111d s111d Jan 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"реализуя безопасность" либо
"реализуя функционал безопасности" либо
"при разработке безопасности" либо
"работая над безопасностью"

далее можно не переводить дословно, а просто сказать "вы получите больше преимуществ используя"


Вы можете использовать те же *функции зависимостей*, что и обычно.

### Требования к зависимостям
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Скорее здесь "требования зависимостей". Или "зависимости зависимостей".


### Требования к зависимостям

Они могут объявлять требования к запросу (например, к заголовкам) или другим подзависимостям:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Я бы тут раскрыл: Зависимости могут...


### Возвращаемые значения

Они могут возвращать или не возвращать значения, в любом случае они использоваться не будут.
Copy link
Contributor

@s111d s111d Jan 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Они... они – но уже другие они.
Я бы раскрыл первые, как и выше: Такие зависимости могут... в любом случае те использованы не будут.


Они могут возвращать или не возвращать значения, в любом случае они использоваться не будут.

Таким образом, вы можете повторно использовать обычную зависимость (которая возвращает значение), уже используемую в другом месте, и даже если значение не будет использовано, зависимость будет выполнена:
Copy link
Contributor

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!}
```

## Зависимости для группы *операций путей*
Copy link
Contributor

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` для группы *операций путией*.
Copy link
Contributor

@s111d s111d Jan 7, 2024

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` можно добавить `список зависимостей` в *декоратор операции пути*.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

На этот случай, ...
...через Depends,


Для таких случаев вместо объявления параметра в *функции операции пути* с `Depends` можно добавить `список зависимостей` в *декоратор операции пути*.

## Добавление `зависимости` в *декоратор операции пути*
Copy link
Contributor

@s111d s111d Jan 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

а вот здесь "dependencies" не надо переводить, это название параметра

Так и написать: Добавление параметра "dependencies"...


*Декоратор операции пути* принимает необязательный аргумент `dependencies`.

Это должен быть `список` объектов типа `Depends()`:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Можно явно уточнить: (list)

Эти зависимости будут выполняться/решаться таким же образом, как и обычные зависимости. Но их значение (если они возвращают какое-либо значение) не будет передано вашей *функции операции пути*.

!!! tip "Подсказка"
Некоторые редакторы проверяют наличие неиспользуемых параметров функции и отображают их как ошибки.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

отображают –> помечают

!!! tip "Подсказка"
Некоторые редакторы проверяют наличие неиспользуемых параметров функции и отображают их как ошибки.

Используя эти "зависимости" в *декораторах операций путей*, вы можете убедиться, что они выполняются, избегая ошибок редактора в котором вы работаете.
Copy link
Contributor

@s111d s111d Jan 7, 2024

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}.

## Ошибки зависимостей и возвращаемые значения
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

тут скорее "В зависимостях"

@tiangolo
Copy link
Owner

tiangolo commented Feb 8, 2024

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.

@tiangolo tiangolo closed this Feb 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants