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 Ukrainian translation for docs/uk/docs/tutorial/index.md #10079

Merged
merged 2 commits into from
Sep 2, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
80 changes: 80 additions & 0 deletions docs/uk/docs/tutorial/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Π’ΡƒΡ‚ΠΎΡ€Ρ–Π°Π» - ΠŸΠΎΡΡ–Π±Π½ΠΈΠΊ користувача

Π£ Ρ†ΡŒΠΎΠΌΡƒ посібнику ΠΏΠΎΠΊΠ°Π·Π°Π½ΠΎ, як користуватися **FastAPI** Π· Π±Ρ–Π»ΡŒΡˆΡ–ΡΡ‚ΡŽ ΠΉΠΎΠ³ΠΎ Ρ„ΡƒΠ½ΠΊΡ†Ρ–ΠΉ, ΠΊΡ€ΠΎΠΊ Π·Π° ΠΊΡ€ΠΎΠΊΠΎΠΌ.

КоТСн Ρ€ΠΎΠ·Π΄Ρ–Π» поступово Π½Π°Π΄Π±ΡƒΠ΄ΠΎΠ²ΡƒΡ”Ρ‚ΡŒΡΡ Π½Π° ΠΏΠΎΠΏΠ΅Ρ€Π΅Π΄Π½Ρ–, Π°Π»Π΅ Π²Ρ–Π½ структурований Π½Π° ΠΎΠΊΡ€Π΅ΠΌΡ– Ρ‚Π΅ΠΌΠΈ, Ρ‰ΠΎΠ± Π²ΠΈ ΠΌΠΎΠ³Π»ΠΈ ΠΏΠ΅Ρ€Π΅ΠΉΡ‚ΠΈ Π±Π΅Π·ΠΏΠΎΡΠ΅Ρ€Π΅Π΄Π½ΡŒΠΎ Π΄ΠΎ Π±ΡƒΠ΄ΡŒ-якої ΠΊΠΎΠ½ΠΊΡ€Π΅Ρ‚Π½ΠΎΡ—, Ρ‰ΠΎΠ± Π²ΠΈΡ€Ρ–ΡˆΠΈΡ‚ΠΈ Π²Π°ΡˆΡ– ΠΊΠΎΠ½ΠΊΡ€Π΅Ρ‚Π½Ρ– ΠΏΠΎΡ‚Ρ€Π΅Π±ΠΈ API.

Π’Ρ–Π½ Ρ‚Π°ΠΊΠΎΠΆ створСний як Π΄ΠΎΠ²Ρ–Π΄Π½ΠΈΠΊ для Ρ€ΠΎΠ±ΠΎΡ‚ΠΈ Ρƒ ΠΌΠ°ΠΉΠ±ΡƒΡ‚Π½ΡŒΠΎΠΌΡƒ.

Π’ΠΎΠΆ Π²ΠΈ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ повСрнутися Ρ– ΠΏΠΎΠ±Π°Ρ‡ΠΈΡ‚ΠΈ самС Ρ‚Π΅, Ρ‰ΠΎ Π²Π°ΠΌ ΠΏΠΎΡ‚Ρ€Ρ–Π±Π½ΠΎ.

## Π—Π°ΠΏΡƒΡΡ‚Ρ–Ρ‚ΡŒ ΠΊΠΎΠ΄

Усі Π±Π»ΠΎΠΊΠΈ ΠΊΠΎΠ΄Ρƒ ΠΌΠΎΠΆΠ½Π° ΡΠΊΠΎΠΏΡ–ΡŽΠ²Π°Ρ‚ΠΈ Ρ‚Π° використовувати Π±Π΅Π·ΠΏΠΎΡΠ΅Ρ€Π΅Π΄Π½ΡŒΠΎ (Ρ†Π΅ Ρ„Π°ΠΊΡ‚ΠΈΡ‡Π½ΠΎ ΠΏΠ΅Ρ€Π΅Π²Ρ–Ρ€Π΅Π½Ρ– Ρ„Π°ΠΉΠ»ΠΈ Python).

Π©ΠΎΠ± запустити Π±ΡƒΠ΄ΡŒ-який Ρ–Π· ΠΏΡ€ΠΈΠΊΠ»Π°Π΄Ρ–Π², ΡΠΊΠΎΠΏΡ–ΡŽΠΉΡ‚Π΅ ΠΊΠΎΠ΄ Ρƒ Ρ„Π°ΠΉΠ» `main.py` Ρ– Π·Π°ΠΏΡƒΡΡ‚Ρ–Ρ‚ΡŒ `uvicorn` Π·Π° допомогою:

<div class="termy">

```console
$ uvicorn main:app --reload

<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
<span style="color: green;">INFO</span>: Started reloader process [28720]
<span style="color: green;">INFO</span>: Started server process [28722]
<span style="color: green;">INFO</span>: Waiting for application startup.
<span style="color: green;">INFO</span>: Application startup complete.
```

</div>

**Π”Π£Π–Π• Ρ€Π°Π΄ΠΈΠΌΠΎ** написати Π°Π±ΠΎ ΡΠΊΠΎΠΏΡ–ΡŽΠ²Π°Ρ‚ΠΈ ΠΊΠΎΠ΄, Π²Ρ–Π΄Ρ€Π΅Π΄Π°Π³ΡƒΠ²Π°Ρ‚ΠΈ ΠΉΠΎΠ³ΠΎ Ρ‚Π° запустити локально.

Використання ΠΉΠΎΠ³ΠΎ Ρƒ своєму Ρ€Π΅Π΄Π°ΠΊΡ‚ΠΎΡ€Ρ– – Ρ†Π΅ Ρ‚Π΅, Ρ‰ΠΎ дійсно ΠΏΠΎΠΊΠ°Π·ΡƒΡ” Π²Π°ΠΌ ΠΏΠ΅Ρ€Π΅Π²Π°Π³ΠΈ FastAPI, Π±Π°Ρ‡ΠΈΡ‚Π΅, як ΠΌΠ°Π»ΠΎ ΠΊΠΎΠ΄Ρƒ Π²Π°ΠΌ ΠΏΠΎΡ‚Ρ€Ρ–Π±Π½ΠΎ написати, всі ΠΏΠ΅Ρ€Π΅Π²Ρ–Ρ€ΠΊΠΈ Ρ‚ΠΈΠΏΡ–Π², автозаповнСння Ρ‚ΠΎΡ‰ΠΎ.

---

## ВстановлСння FastAPI

ΠŸΠ΅Ρ€ΡˆΠΈΠΌ ΠΊΡ€ΠΎΠΊΠΎΠΌ Ρ” встановлСння FastAPI.

Для Ρ‚ΡƒΡ‚ΠΎΡ€Ρ–Π°Π»Ρƒ Π²ΠΈ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ встановити ΠΉΠΎΠ³ΠΎ Π· усіма нСобов’язковими залСТностями Ρ‚Π° функціями:

<div class="termy">

```console
$ pip install "fastapi[all]"

---> 100%
```

</div>

...який Ρ‚Π°ΠΊΠΎΠΆ Π²ΠΊΠ»ΡŽΡ‡Π°Ρ” `uvicorn`, який Π²ΠΈ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ використовувати як сСрвСр, який запускає ваш ΠΊΠΎΠ΄.

!!! note
Π’ΠΈ Ρ‚Π°ΠΊΠΎΠΆ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ встановити ΠΉΠΎΠ³ΠΎ частина Π·Π° Ρ‡Π°ΡΡ‚ΠΈΠ½ΠΎΡŽ.

Π¦Π΅ Ρ‚Π΅, Ρ‰ΠΎ Π²ΠΈ, ΠΉΠΌΠΎΠ²Ρ–Ρ€Π½ΠΎ, Π·Ρ€ΠΎΠ±ΠΈΠ»ΠΈ Π±, ΠΊΠΎΠ»ΠΈ Π·Π°Ρ…ΠΎΡ‡Π΅Ρ‚Π΅ Ρ€ΠΎΠ·Π³ΠΎΡ€Π½ΡƒΡ‚ΠΈ свою ΠΏΡ€ΠΎΠ³Ρ€Π°ΠΌΡƒ Ρƒ Π²ΠΈΡ€ΠΎΠ±Π½ΠΈΡ‡ΠΎΠΌΡƒ сСрСдовищі:

```
pip install fastapi
```

Π’Π°ΠΊΠΎΠΆ Π²ΡΡ‚Π°Π½ΠΎΠ²Ρ–Ρ‚ΡŒ `uvicorn`, Ρ‰ΠΎΠ± Π²Ρ–Π½ ΠΏΡ€Π°Ρ†ΡŽΠ²Π°Π² як сСрвСр:

```
pip install "uvicorn[standard]"
```

Π† Ρ‚Π΅ самС для ΠΊΠΎΠΆΠ½ΠΎΡ— Π· ΠΎΠΏΡ†Ρ–ΠΎΠ½Π°Π»ΡŒΠ½ΠΈΡ… залСТностСй, які Π²ΠΈ Ρ…ΠΎΡ‡Π΅Ρ‚Π΅ використовувати.

## Π ΠΎΠ·ΡˆΠΈΡ€Π΅Π½ΠΈΠΉ посібник користувача

Існує Ρ‚Π°ΠΊΠΎΠΆ **Π ΠΎΠ·ΡˆΠΈΡ€Π΅Π½ΠΈΠΉ посібник користувача**, який Π²ΠΈ Π·ΠΌΠΎΠΆΠ΅Ρ‚Π΅ ΠΏΡ€ΠΎΡ‡ΠΈΡ‚Π°Ρ‚ΠΈ ΠΏΡ–Π·Π½Ρ–ΡˆΠ΅ після Ρ†ΡŒΠΎΠ³ΠΎ **Π’ΡƒΡ‚ΠΎΡ€Ρ–Π°Π» - ΠŸΠΎΡΡ–Π±Π½ΠΈΠΊ користувача**.

**Π ΠΎΠ·ΡˆΠΈΡ€Π΅Π½ΠΈΠΉ посібник користувача** засновано Π½Π° Ρ†ΡŒΠΎΠΌΡƒ, використовує Ρ‚Ρ– самі ΠΊΠΎΠ½Ρ†Π΅ΠΏΡ†Ρ–Ρ— Ρ‚Π° Π½Π°Π²Ρ‡Π°Ρ” вас дСяким Π΄ΠΎΠ΄Π°Ρ‚ΠΊΠΎΠ²ΠΈΠΌ функціям.

АлС Π²Π°ΠΌ слід спочатку ΠΏΡ€ΠΎΡ‡ΠΈΡ‚Π°Ρ‚ΠΈ **Π’ΡƒΡ‚ΠΎΡ€Ρ–Π°Π» - ΠŸΠΎΡΡ–Π±Π½ΠΈΠΊ користувача** (Ρ‚Π΅, Ρ‰ΠΎ Π²ΠΈ Π·Π°Ρ€Π°Π· Ρ‡ΠΈΡ‚Π°Ρ”Ρ‚Π΅).

Π’Ρ–Π½ Ρ€ΠΎΠ·Ρ€ΠΎΠ±Π»Π΅Π½ΠΈΠΉ Ρ‚Π°ΠΊΠΈΠΌ Ρ‡ΠΈΠ½ΠΎΠΌ, Ρ‰ΠΎ Π²ΠΈ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ створити ΠΏΠΎΠ²Π½Ρƒ ΠΏΡ€ΠΎΠ³Ρ€Π°ΠΌΡƒ лишС Π·Π° допомогою **Π’ΡƒΡ‚ΠΎΡ€Ρ–Π°Π» - ΠŸΠΎΡΡ–Π±Π½ΠΈΠΊ користувача**, Π° ΠΏΠΎΡ‚Ρ–ΠΌ Ρ€ΠΎΠ·ΡˆΠΈΡ€ΠΈΡ‚ΠΈ Ρ—Ρ— Ρ€Ρ–Π·Π½ΠΈΠΌΠΈ способами, Π·Π°Π»Π΅ΠΆΠ½ΠΎ Π²Ρ–Π΄ Π²Π°ΡˆΠΈΡ… ΠΏΠΎΡ‚Ρ€Π΅Π±, Π²ΠΈΠΊΠΎΡ€ΠΈΡΡ‚ΠΎΠ²ΡƒΡŽΡ‡ΠΈ дСякі Π· Π΄ΠΎΠ΄Π°Ρ‚ΠΊΠΎΠ²ΠΈΡ… Ρ–Π΄Π΅ΠΉ Π· **Π ΠΎΠ·ΡˆΠΈΡ€Π΅Π½ΠΎΠ³ΠΎ посібника користувача** .