From: Aykhan Shahsuvarov <88669260+aykhans@users.noreply.github.com>
Date: Wed, 31 Jan 2024 15:45:57 +0000 (+0400)
Subject: 🌐 Add Azerbaijani translation for `docs/az/docs/index.md` (#11047)
X-Git-Tag: 0.109.1~16
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=67494c2b5eaf27f372812e21850c204e2bc79cc6;p=thirdparty%2Ffastapi%2Ffastapi.git
🌐 Add Azerbaijani translation for `docs/az/docs/index.md` (#11047)
---
diff --git a/docs/az/docs/index.md b/docs/az/docs/index.md
new file mode 100644
index 0000000000..a227065125
--- /dev/null
+++ b/docs/az/docs/index.md
@@ -0,0 +1,469 @@
+
+ 
+
+
+ FastAPI framework, yüksÉk mÉshuldarlı, öyrÉnmÉsi asan, çevik kodlama, istifadÉyÉ hazırdır
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+---
+
+**SÉnÉdlÉr**: https://fastapi.tiangolo.com
+
+**Qaynaq Kodu**: https://github.com/tiangolo/fastapi
+
+---
+
+FastAPI Python 3.8+ ilÉ API yaratmaq üçün standart Python tip mÉslÉhÉtlÉrinÉ Ésaslanan, müasir, sürÉtli (yüksÉk performanslı) framework-dür.
+
+Æsas xüsusiyyÉtlÉri bunlardır:
+
+* **SürÉtli**: Ãox yüksÉk performans, **NodeJS** vÉ **Go** sÉviyyÉsindÉ (Starlette vÉ Pydantic-É tÉÅÉkkürlÉr). [Æn sürÉtli Python frameworklÉrindÉn biridir](#performans).
+* **Ãevik kodlama**: Funksiyanallıqları inkiÅaf etdirmÉk sürÉtini tÉxminÉn 200%-dÉn 300%-É qÉdÉr artırın. *
+* **Daha az xÉta**: Ä°nsan (developer) tÉrÉfindÉn törÉdilÉn sÉhvlÉrin tÉxminÉn 40% -ni azaldın. *
+* **Ä°ntuitiv**: Æla redaktor dÉstÉyi. HÉr yerdÉ otomatik tamamlama. XÉtaları müÉyyÉnlÉÅdirmÉyÉ daha az vaxt sÉrf edÉcÉksiniz.
+* **Asan**: Ä°stifadÉsi vÉ Ã¶yrÉnilmÉsi asan olması üçün nÉzÉrdÉ tutulmuÅdur. SÉnÉdlÉri oxumaq üçün daha az vaxt ayıracaqsınız.
+* **Qısa**: Kod tÉkrarlanmasını minimuma endirin. HÉr bir parametr tÉrifindÉ birdÉn çox xüsusiyyÉt ilÉ vÉ daha az sÉhvlÉ qarÅılaÅacaqsınız.
+* **Güclü**: Avtomatik vÉ interaktiv sÉnÉdlÉrlÉ birlikdÉ istifadÉyÉ hazır kod ÉldÉ edÉ bilÉrsiniz.
+* **Standartlara Ésaslanan**: API-lar üçün açıq standartlara Ésaslanır (vÉ tam uyÄun gÉlir): OpenAPI (ÉvvÉlki adı ilÉ Swagger) vÉ JSON Schema.
+
+* Bu fikirlÉr daxili development komandasının hazırladıqları mÉhsulların sınaqlarına Ésaslanır.
+
+## Sponsorlar
+
+
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+
+{% endfor -%}`
+{%- for sponsor in sponsors.silver -%}
+
+{% endfor %}
+{% endif %}
+
+
+
+DigÉr sponsorlar
+
+## RÉylÉr
+
+"_[...] Son günlÉrdÉ **FastAPI**-ı çox istifadÉ edirÉm. [...] ÆslindÉ onu komandamın bütün **Microsoftda ML sevislÉrindÉ** istifadÉ etmÉyi planlayıram. Onların bÉzilÉri **windows**-un Ésas mÉhsuluna vÉ bÉzi **Office** mÉhsullarına inteqrasiya olunurlar._"
+
+Kabir Khan -
Microsoft (ref)Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala -
Uber (ref)Kevin Glisson, Marc Vilanova, Forest Monsen -
Netflix (ref)Deon Pillsbury -
Cisco (ref)
+
+ÆgÉr siz veb API ÉvÉzinÉ terminalda istifadÉ edilÉcÉk CLI proqramı qurursunuzsa, **Typer**-a baxa bilÉrsiniz.
+
+**Typer** FastAPI-ın kiçik qardaÅıdır. VÉ o, CLI-lÉrin **FastAPI**-ı olmaq üçün nÉzÉrdÉ tutulub. â¨ï¸ ð
+
+## TÉlÉblÉr
+
+Python 3.8+
+
+FastAPI nÉhÉnglÉrin çiyinlÉrindÉ dayanır:
+
+* Web tÉrÉfi üçün Starlette.
+* Data tÉrÉfi üçün Pydantic.
+
+## QuraÅdırma
+
+
+
+```console
+$ pip install fastapi
+
+---> 100%
+```
+
+
+
+TÉtbiqimizi Élçatan etmÉk üçün bizÉ Uvicorn vÉ ya Hypercorn kimi ASGI server lazımdır.
+
+
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+
+
+## NümunÉ
+
+### Kodu yaradaq
+
+* `main.py` adlı fayl yaradaq vÉ ona aÅaÄıdakı kodu yerlÉÅdirÉk:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+ return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+ return {"item_id": item_id, "q": q}
+```
+
+
+VÉ ya async def...
+
+ÆgÉr kodunuzda `async` vÉ ya `await` vardırsa `async def` istifadÉ edÉ bilÉrik:
+
+```Python hl_lines="9 14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+ return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+ return {"item_id": item_id, "q": q}
+```
+
+**Qeyd**:
+
+ÆgÉr bu mövzu haqqında mÉlumatınız yoxdursa `async` vÉ `await` sÉnÉdindÉki _"TÉlÉsirsÉn?"_ bölmÉsinÉ baxa bilÉrsiniz.
+
+
+
+### Kodu iÅÉ salaq
+
+Serveri aÅaÄıdakı Émr ilÉ iÅÉ salaq:
+
+
+
+```console
+$ uvicorn main:app --reload
+
+INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO: Started reloader process [28720]
+INFO: Started server process [28722]
+INFO: Waiting for application startup.
+INFO: Application startup complete.
+```
+
+
+
+
+uvicorn main:app --reload Émri haqqında...
+
+`uvicorn main:app` Émri aÅaÄıdakılara instinad edir:
+
+* `main`: `main.py` faylı (yÉni Python "modulu").
+* `app`: `main.py` faylında `app = FastAPI()` sÉtrindÉ yaratdıÄımız `FastAPI` obyektidir.
+* `--reload`: kod dÉyiÅikliyindÉn sonra avtomatik olaraq serveri yenidÉn iÅÉ salır. Bu parametrdÉn yalnız development mÉrhÉlÉsindÉ istifadÉ etmÉliyik.
+
+
+
+### Ä°ndi yoxlayaq
+
+Bu linki brauzerimizdÉ açaq http://127.0.0.1:8000/items/5?q=somequery.
+
+AÅaÄıdakı kimi bir JSON cavabı görÉcÉksiniz:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+Siz artıq bir API yaratmısınız, hansı ki:
+
+* `/` vÉ `/items/{item_id}` _yollarında_ HTTP sorÄularını qÉbul edir.
+* HÉr iki _yolda_ `GET` ÉmÉliyyatlarını (hÉmçinin HTTP _metodları_ kimi bilinir) aparır.
+* `/items/{item_id}` _yolu_ `item_id` adlı `int` qiymÉti almalı olan _yol parametrinÉ_ sahibdir.
+* `/items/{item_id}` _yolunun_ `q` adlı yol parametri var vÉ bu parametr istÉyÉ baÄlı olsa da, `str` qiymÉtini almalıdır.
+
+### Ä°nteraktiv API SÉnÉdlÉri
+
+İndi http://127.0.0.1:8000/docs ünvanına daxil olun.
+
+Avtomatik interaktiv API sÉnÉdlÉrini görÉcÉksiniz (Swagger UI tÉrÉfindÉn tÉmin edilir):
+
+
+
+### Alternativ API sÉnÉdlÉri
+
+Ä°ndi isÉ http://127.0.0.1:8000/redoc ünvanına daxil olun.
+
+ReDoc tÉrÉfindÉn tÉqdim edilÉn avtomatik sÉnÉdlÉri görÉcÉksiniz:
+
+
+
+## NümunÉni YenilÉyÉk
+
+Ä°ndi gÉlin `main.py` faylını `PUT` sorÄusu ilÉ birlikdÉ gövdÉ qÉbul edÉcÉk ÅÉkildÉ dÉyiÅdirÉk.
+
+Pydantic sayÉsindÉ standart Python tiplÉrindÉn istifadÉ edÉrÉk gövdÉni müÉyyÉn edÉk.
+
+```Python hl_lines="4 9-12 25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+ name: str
+ price: float
+ is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+ return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+ return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+ return {"item_name": item.name, "item_id": item_id}
+```
+Server avtomatik olaraq yenidÉn iÅÉ salınmalı idi (çünki biz yuxarıda `uvicorn` Émri ilÉ `--reload` parametrindÉn istifadÉ etmiÅik).
+
+### Ä°nteraktiv API sÉnÉdlÉrindÉki dÉyiÅikliyÉ baxaq
+
+YenidÉn http://127.0.0.1:8000/docs ünvanına daxil olun.
+
+* Ä°nteraktiv API sÉnÉdlÉri yeni gövdÉ dÉ daxil olmaq ilÉ avtomatik olaraq yenilÉnÉcÉk:
+
+
+
+* "Try it out" düymÉsini kliklÉyin, bu, parametrlÉri doldurmaÄa vÉ API ilÉ birbaÅa ÉlaqÉ saxlamaÄa imkan verir:
+
+
+
+* Sonra "Execute" düymÉsini kliklÉyin, istifadÉçi interfeysi API ilÉ ÉlaqÉ quracaq, parametrlÉri göndÉrÉcÉk, nÉticÉlÉri ÉldÉ edÉcÉk vÉ onları ekranda göstÉrÉcÉk:
+
+
+
+### Alternativ API SÉnÉdlÉrindÉki DÉyiÅikliyÉ Baxaq
+
+Ä°ndi isÉ yenidÉn http://127.0.0.1:8000/redoc ünvanına daxil olun.
+
+* Alternativ sÉnÉdlÉr hÉm dÉ yeni sorÄu parametri vÉ gövdÉsini Éks etdirÉcÉk:
+
+
+
+### XülasÉ
+
+ÃmumilÉÅdirsÉk, parametrlÉr, gövdÉ vÉ s. Biz mÉlumat növlÉrini **bir dÉfÉ** funksiya parametrlÉri kimi tÉyin edirik.
+
+Bunu standart müasir Python tiplÉri ilÉ edirsiniz.
+
+Yeni sintaksis, müÉyyÉn bir kitabxananın metodlarını vÉ ya siniflÉrini vÉ s. öyrÉnmÉk mÉcburiyyÉtindÉ deyilsiniz.
+
+SadÉcÉ standart **Python 3.8+**.
+
+MÉsÉlÉn, `int` üçün:
+
+```Python
+item_id: int
+```
+
+vÉ ya daha mürÉkkÉb `Item` modeli üçün:
+
+```Python
+item: Item
+```
+
+...vÉ yalnız parametr tipini tÉyin etmÉklÉ bunları ÉldÉ edirsiniz:
+
+* Redaktor dÉstÉyi ilÉ:
+ * Avtomatik tamamlama.
+ * Tip yoxlanması.
+* MÉlumatların TÉsdiqlÉnmÉsi:
+ * MÉlumat etibarsız olduqda avtomatik olaraq aydın xÉtalar göstÉrir.
+ * HÉtta çox dÉrin JSON obyektlÉrindÉ belÉ doÄrulama aparır.
+* Daxil olan mÉlumatları çevirmÉk üçün aÅaÄıdakı mÉlumat növlÉrindÉn istifadÉ edilir:
+ * JSON.
+ * Yol parametrlÉri.
+ * SorÄu parametrlÉri.
+ * ÃÉrÉzlÉr.
+ * BaÅlıqlaq.
+ * Formalar.
+ * Fayllar.
+* Daxil olan mÉlumatları çevirmÉk üçün aÅaÄıdakı mÉlumat növlÉrindÉn istifadÉ edilir (JSON olaraq):
+ * Python tiplÉrinin (`str`, `int`, `float`, `bool`, `list`, vÉ s) çevrilmÉsi.
+ * `datetime` obyektlÉri.
+ * `UUID` obyektlÉri.
+ * VerilÉnlÉr bazası modellÉri.
+ * vÉ daha çoxu...
+* 2 alternativ istifadÉçi interfeysi daxil olmaqla avtomatik interaktiv API sÉnÉdlÉrini tÉmin edir:
+ * Swagger UI.
+ * ReDoc.
+
+---
+
+GÉlin ÉvvÉlki nümunÉyÉ qayıdaq vÉ **FastAPI**-nin nÉlÉr edÉcÉyinÉ nÉzÉr salaq:
+
+* `GET` vÉ `PUT` sorÄuları üçün `item_id`-nin yolda olub-olmadıÄını yoxlayacaq.
+* `item_id`-nin `GET` vÉ `PUT` sorÄuları üçün növünün `int` olduÄunu yoxlayacaq.
+ * ÆgÉr `int` deyilsÉ, sÉbÉbini göstÉrÉn bir xÉta mesajı göstÉrÉcÉkdir.
+* mÉcburi olmayan `q` parametrinin `GET` (`http://127.0.0.1:8000/items/foo?q=somequery` burdakı kimi) sorÄusu içÉrisindÉ olub olmadıÄını yoxlayacaq.
+ * `q` parametrini `= None` ilÉ yaratdıÄımız üçün, mÉcburi olmayan parametr olacaq.
+ * ÆgÉr `None` olmasaydı, bu mÉcburi parametr olardı (`PUT` metodunun gövdÉsindÉ olduÄu kimi).
+* `PUT` sorÄusu üçün, `/items/{item_id}` gövdÉsini JSON olaraq oxuyacaq:
+ * `name` adında mÉcburi bir parametr olub olmadıÄını vÉ ÉgÉr varsa, tipinin `str` olub olmadıÄını yoxlayacaq.
+ * `price` adında mÉcburi bir parametr olub olmadıÄını vÉ ÉgÉr varsa, tipinin `float` olub olmadıÄını yoxlayacaq.
+ * `is_offer` adında mÉcburi olmayan bir parametr olub olmadıÄını vÉ ÉgÉr varsa, tipinin `float` olub olmadıÄını yoxlayacaq.
+ * Bütün bunlar Én dÉrin JSON obyektlÉrindÉ belÉ iÅlÉyÉcÉk.
+* MÉlumatların JSON-a vÉ JSON-un Python obyektinÉ Ã§evrilmÉsi avtomatik hÉyata keçirilÉcÉk.
+* HÉr Åeyi OpenAPI ilÉ uyÄun olacaq ÅÉkildÉ avtomatik olaraq sÉnÉdlÉÅdirÉcÉk vÉ onları aÅaÄıdakı kimi istifadÉ edÉ bilÉcÉk:
+ * Ä°nteraktiv sÉnÉdlÉÅmÉ sistemlÉri.
+ * Bir çox proqramlaÅdırma dillÉri üçün avtomatlaÅdırılmıŠmüÅtÉri kodu yaratma sistemlÉri.
+* 2 interaktiv sÉnÉdlÉÅmÉ veb interfeysini birbaÅa tÉmin edÉcÉk.
+
+---
+
+Yeni baÅlamıÅıq, amma siz artıq iÅin mÉntiqini baÅa düÅmüsünüz.
+
+Ä°ndi aÅaÄıdakı sÉtri dÉyiÅdirmÉyÉ Ã§alıÅın:
+
+```Python
+ return {"item_name": item.name, "item_id": item_id}
+```
+
+...bundan:
+
+```Python
+ ... "item_name": item.name ...
+```
+
+...buna:
+
+```Python
+ ... "item_price": item.price ...
+```
+
+...vÉ redaktorun mÉlumat tiplÉrini bildiyini vÉ avtomatik tamaladıÄını görÉcÉksiniz:
+
+
+
+Daha çox funksiyaya malik daha dolÄun nümunÉ Ã¼Ã§Ã¼n ÃyrÉdici - Ä°stifadÉçi TÉlimatı sÉhifÉsinÉ baxa bilÉrsiniz.
+
+**Spoiler xÉbÉrdarlıÄı**: ÃyrÉdici - istifadÉçi tÉlimatına bunlar daxildir:
+
+* **ParametrlÉrin**, **baÅlıqlar**, çÉrÉzlÉr, **forma sahÉlÉri** vÉ **fayllar** olaraq müÉyyÉn edilmÉsi.
+* `maximum_length` vÉ ya `regex` kimi **doÄrulama mÉhdudiyyÉtlÉrinin** necÉ tÉyin edilÉcÉyi.
+* Ãox güclü vÉ istifadÉsi asan **Dependency Injection** sistemi.
+* TÉhlükÉsizlik vÉ autentifikasiya, **JWT tokenlÉri** ilÉ **OAuth2** dÉstÉyi vÉ **HTTP Basic** autentifikasiyası.
+* **çox dÉrin JSON modellÉrini** müÉyyÉn etmÉk üçün daha irÉli sÉviyyÉ (lakin eyni dÉrÉcÉdÉ asan) üsullar (Pydantic sayÉsindÉ).
+* Strawberry vÉ digÉr kitabxanalar ilÉ **GraphQL** inteqrasiyası.
+* DigÉr ÉlavÉ xüsusiyyÉtlÉr (Starlette sayÉsindÉ):
+ * **WebSockets**
+ * HTTPX vÉ `pytest` sayÉsindÉ Ã§ox asan testlÉr
+ * **CORS**
+ * **Cookie Sessions**
+ * ...vÉ daha çoxu.
+
+## Performans
+
+MüstÉqil TechEmpower meyarları göstÉrir ki, Uvicorn üzÉrindÉ iÅlÉyÉn **FastAPI** proqramları Én sürÉtli Python kitabxanalarından biridir, yalnız Starlette vÉ Uvicorn-un özündÉn yavaÅdır, ki FastAPI bunların üzÉrinÉ qurulmuÅ bir framework-dür. (*)
+
+Ætraflı mÉlumat üçün bu bölmÉyÉ nÉzÉr salın MüqayisÉlÉr.
+
+## MÉcburi Olmayan TÉlÉblÉr
+
+Pydantic tÉrÉfindÉn istifadÉ olunanlar:
+
+* email_validator - e-poçtun yoxlanılması üçün.
+* pydantic-settings - parametrlÉrin idarÉ edilmÉsi üçün.
+* pydantic-extra-types - Pydantic ilÉ istifadÉ edilÉ bilÉn ÉlavÉ tiplÉr üçün.
+
+Starlette tÉrÉfindÉn istifadÉ olunanlar:
+
+* httpx - ÆgÉr `TestClient` strukturundan istifadÉ edÉcÉksinizsÉ, tÉlÉb olunur.
+* jinja2 - Standart Åablon konfiqurasiyasından istifadÉ etmÉk istÉyirsinizsÉ, tÉlÉb olunur.
+* python-multipart - `request.form()` ilÉ forma "çevirmÉ" dÉstÉyindÉn istifadÉ etmÉk istÉyirsinizsÉ, tÉlÉb olunur.
+* itsdangerous - `SessionMiddleware` dÉstÉyi üçün tÉlÉb olunur.
+* pyyaml - `SchemaGenerator` dÉstÉyi üçün tÉlÉb olunur (Ãox güman ki, FastAPI istifadÉ edÉrkÉn buna ehtiyacınız olmayacaq).
+* ujson - `UJSONResponse` istifadÉ etmÉk istÉyirsinizsÉ, tÉlÉb olunur.
+
+HÉm FastAPI, hÉm dÉ Starlette tÉrÉfindÉn istifadÉ olunur:
+
+* uvicorn - YaratdıÄımız proqramı servis edÉcÉk veb server kimi fÉaliyyÉt göstÉrir.
+* orjson - `ORJSONResponse` istifadÉ edÉcÉksinizsÉ tÉlÉb olunur.
+
+Bütün bunları `pip install fastapi[all]` ilÉ quraÅdıra bilÉrsiniz.
+
+## Lisenziya
+
+Bu layihÉ MIT lisenziyasının ÅÉrtlÉrinÉ ÉsasÉn lisenziyalaÅdırılıb.
diff --git a/docs/az/mkdocs.yml b/docs/az/mkdocs.yml
new file mode 100644
index 0000000000..de18856f44
--- /dev/null
+++ b/docs/az/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 2b843e026d..9e22e3a22d 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -267,6 +267,8 @@ extra:
alternate:
- link: /
name: en - English
+ - link: /az/
+ name: az - azÉrbaycan dili
- link: /bn/
name: bn - বাà¦à¦²à¦¾
- link: /de/