From d78a12e293e25cf5ce099f2ff66713a8ed9646c1 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci-lite[bot]" <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Date: Sat, 14 Mar 2026 16:58:09 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Auto=20format?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ur/docs/_llm-test.md | 2 +- docs/ur/docs/advanced/async-tests.md | 6 +- docs/ur/docs/alternatives.md | 32 +-- docs/ur/docs/contributing.md | 261 ----------------- docs/ur/docs/deployment/docker.md | 2 +- docs/ur/docs/external-links.md | 25 -- docs/ur/docs/fastapi-cli.md | 4 +- docs/ur/docs/fastapi-people.md | 285 ------------------- docs/ur/docs/how-to/custom-docs-ui-assets.md | 8 +- docs/ur/docs/management-tasks.md | 157 ---------- docs/ur/docs/management.md | 39 --- docs/ur/docs/newsletter.md | 5 - docs/ur/docs/project-generation.md | 2 +- docs/ur/docs/reference/apirouter.md | 24 -- docs/ur/docs/reference/background.md | 11 - docs/ur/docs/reference/dependencies.md | 29 -- docs/ur/docs/reference/encoders.md | 3 - docs/ur/docs/reference/exceptions.md | 20 -- docs/ur/docs/reference/fastapi.md | 31 -- docs/ur/docs/reference/httpconnection.md | 11 - docs/ur/docs/reference/index.md | 6 - docs/ur/docs/reference/middleware.md | 37 --- docs/ur/docs/reference/openapi/docs.md | 11 - docs/ur/docs/reference/openapi/index.md | 5 - docs/ur/docs/reference/openapi/models.md | 5 - docs/ur/docs/reference/parameters.md | 35 --- docs/ur/docs/reference/request.md | 19 -- docs/ur/docs/reference/response.md | 15 - docs/ur/docs/reference/responses.md | 172 ----------- docs/ur/docs/reference/security/index.md | 75 ----- docs/ur/docs/reference/staticfiles.md | 13 - docs/ur/docs/reference/status.md | 36 --- docs/ur/docs/reference/templating.md | 13 - docs/ur/docs/reference/testclient.md | 13 - docs/ur/docs/reference/uploadfile.md | 22 -- docs/ur/docs/reference/websockets.md | 73 ----- docs/ur/docs/release-notes.md | 6 - docs/ur/docs/translation-banner.md | 2 +- docs/ur/docs/tutorial/bigger-applications.md | 40 +-- docs/ur/docs/tutorial/first-steps.md | 4 +- docs/ur/docs/tutorial/testing.md | 16 +- 41 files changed, 59 insertions(+), 1516 deletions(-) delete mode 100644 docs/ur/docs/contributing.md delete mode 100644 docs/ur/docs/external-links.md delete mode 100644 docs/ur/docs/fastapi-people.md delete mode 100644 docs/ur/docs/management-tasks.md delete mode 100644 docs/ur/docs/management.md delete mode 100644 docs/ur/docs/newsletter.md delete mode 100644 docs/ur/docs/reference/apirouter.md delete mode 100644 docs/ur/docs/reference/background.md delete mode 100644 docs/ur/docs/reference/dependencies.md delete mode 100644 docs/ur/docs/reference/encoders.md delete mode 100644 docs/ur/docs/reference/exceptions.md delete mode 100644 docs/ur/docs/reference/fastapi.md delete mode 100644 docs/ur/docs/reference/httpconnection.md delete mode 100644 docs/ur/docs/reference/index.md delete mode 100644 docs/ur/docs/reference/middleware.md delete mode 100644 docs/ur/docs/reference/openapi/docs.md delete mode 100644 docs/ur/docs/reference/openapi/index.md delete mode 100644 docs/ur/docs/reference/openapi/models.md delete mode 100644 docs/ur/docs/reference/parameters.md delete mode 100644 docs/ur/docs/reference/request.md delete mode 100644 docs/ur/docs/reference/response.md delete mode 100644 docs/ur/docs/reference/responses.md delete mode 100644 docs/ur/docs/reference/security/index.md delete mode 100644 docs/ur/docs/reference/staticfiles.md delete mode 100644 docs/ur/docs/reference/status.md delete mode 100644 docs/ur/docs/reference/templating.md delete mode 100644 docs/ur/docs/reference/testclient.md delete mode 100644 docs/ur/docs/reference/uploadfile.md delete mode 100644 docs/ur/docs/reference/websockets.md delete mode 100644 docs/ur/docs/release-notes.md diff --git a/docs/ur/docs/_llm-test.md b/docs/ur/docs/_llm-test.md index 98f81230c6..760a977321 100644 --- a/docs/ur/docs/_llm-test.md +++ b/docs/ur/docs/_llm-test.md @@ -177,7 +177,7 @@ Tabs اور `Info`/`Note`/`Warning` وغیرہ بلاکس میں عمودی خط لنک کا متن ترجمہ ہونا چاہیے، لنک کا پتہ ترجمے کی طرف اشارہ کرنا چاہیے: -* [FastAPI لنک](https://fastapi.tiangolo.com/) +* [FastAPI لنک](https://fastapi.tiangolo.com/ur/) //// diff --git a/docs/ur/docs/advanced/async-tests.md b/docs/ur/docs/advanced/async-tests.md index 8a6a2ba917..7af0bc88d5 100644 --- a/docs/ur/docs/advanced/async-tests.md +++ b/docs/ur/docs/advanced/async-tests.md @@ -25,9 +25,9 @@ ``` . ├── app -│ ├── __init__.py -│ ├── main.py -│ └── test_main.py +│   ├── __init__.py +│   ├── main.py +│   └── test_main.py ``` `main.py` فائل میں ہوگا: diff --git a/docs/ur/docs/alternatives.md b/docs/ur/docs/alternatives.md index 9af47c3627..bd2ea9d937 100644 --- a/docs/ur/docs/alternatives.md +++ b/docs/ur/docs/alternatives.md @@ -14,7 +14,7 @@ ## پچھلے tools { #previous-tools } -### [Django](https://www.djangoproject.com/) { #django } +### [Django](https://www.djangoproject.com/){ #django } یہ سب سے مقبول Python framework ہے اور وسیع پیمانے پر قابل اعتماد ہے۔ اسے Instagram جیسے systems بنانے کے لیے استعمال کیا جاتا ہے۔ @@ -22,7 +22,7 @@ یہ backend میں HTML بنانے کے لیے بنایا گیا تھا، نہ کہ جدید frontend (جیسے React، Vue.js اور Angular) یا دوسرے systems (جیسے IoT devices) کے ذریعے استعمال ہونے والی APIs بنانے کے لیے۔ -### [Django REST Framework](https://www.django-rest-framework.org/) { #django-rest-framework } +### [Django REST Framework](https://www.django-rest-framework.org/){ #django-rest-framework } Django REST framework اس لیے بنایا گیا تاکہ Django کے نیچے استعمال کرتے ہوئے Web APIs بنانے کا ایک لچکدار toolkit فراہم کیا جائے، تاکہ اس کی API صلاحیتوں کو بہتر بنایا جا سکے۔ @@ -42,7 +42,7 @@ Django REST Framework Tom Christie نے بنایا تھا۔ Starlette اور Uvi /// -### [Flask](https://flask.palletsprojects.com) { #flask } +### [Flask](https://flask.palletsprojects.com){ #flask } Flask ایک "microframework" ہے، اس میں database integrations یا وہ بہت سی چیزیں شامل نہیں ہیں جو Django میں بطور default آتی ہیں۔ @@ -64,7 +64,7 @@ Flask کی سادگی کو دیکھتے ہوئے، یہ APIs بنانے کے ل /// -### [Requests](https://requests.readthedocs.io) { #requests } +### [Requests](https://requests.readthedocs.io){ #requests } **FastAPI** دراصل **Requests** کا متبادل نہیں ہے۔ ان کا دائرہ کار بہت مختلف ہے۔ @@ -106,7 +106,7 @@ def read_url(): /// -### [Swagger](https://swagger.io/) / [OpenAPI](https://github.com/OAI/OpenAPI-Specification/) { #swagger-openapi } +### [Swagger](https://swagger.io/) / [OpenAPI](https://github.com/OAI/OpenAPI-Specification/){ #swagger-openapi } Django REST Framework سے مجھے جو بنیادی feature چاہیے تھا وہ خودکار API documentation تھا۔ @@ -135,7 +135,7 @@ API specifications کے لیے ایک کھلا standard اپنانے اور اس کئی Flask REST frameworks ہیں، لیکن ان کی تحقیق میں وقت اور محنت لگانے کے بعد، میں نے پایا کہ بہت سے بند یا ترک کر دیے گئے ہیں، کئی کھڑے مسائل کے ساتھ جو انہیں ناموزوں بناتے ہیں۔ -### [Marshmallow](https://marshmallow.readthedocs.io/en/stable/) { #marshmallow } +### [Marshmallow](https://marshmallow.readthedocs.io/en/stable/){ #marshmallow } API systems کی ایک بنیادی ضرورت data "serialization" ہے جو code (Python) سے data لے کر اسے network پر بھیجی جا سکنے والی چیز میں تبدیل کرتی ہے۔ مثلاً، database سے data رکھنے والے object کو JSON object میں تبدیل کرنا۔ `datetime` objects کو strings میں تبدیل کرنا، وغیرہ۔ @@ -153,7 +153,7 @@ Data types اور validation فراہم کرنے والے "schemas" define کر /// -### [Webargs](https://webargs.readthedocs.io/en/latest/) { #webargs } +### [Webargs](https://webargs.readthedocs.io/en/latest/){ #webargs } APIs کی ایک اور بڑی ضرورت آنے والی requests سے data parsing ہے۔ @@ -175,7 +175,7 @@ Webargs وہی Marshmallow developers نے بنایا تھا۔ /// -### [APISpec](https://apispec.readthedocs.io/en/stable/) { #apispec } +### [APISpec](https://apispec.readthedocs.io/en/stable/){ #apispec } Marshmallow اور Webargs plug-ins کے طور پر validation، parsing اور serialization فراہم کرتے ہیں۔ @@ -205,7 +205,7 @@ APIs کے لیے کھلے standard، OpenAPI، کی حمایت کرنے کی۔ /// -### [Flask-apispec](https://flask-apispec.readthedocs.io/en/latest/) { #flask-apispec } +### [Flask-apispec](https://flask-apispec.readthedocs.io/en/latest/){ #flask-apispec } یہ ایک Flask plug-in ہے، جو Webargs، Marshmallow اور APISpec کو جوڑتا ہے۔ @@ -259,7 +259,7 @@ Flask-apispec وہی Marshmallow developers نے بنایا تھا۔ /// -### [Sanic](https://sanic.readthedocs.io/en/latest/) { #sanic } +### [Sanic](https://sanic.readthedocs.io/en/latest/){ #sanic } یہ `asyncio` پر مبنی انتہائی تیز Python frameworks میں سے پہلے تھا۔ اسے Flask سے بہت ملتا جلتا بنایا گیا تھا۔ @@ -279,7 +279,7 @@ Flask-apispec وہی Marshmallow developers نے بنایا تھا۔ /// -### [Falcon](https://falconframework.org/) { #falcon } +### [Falcon](https://falconframework.org/){ #falcon } Falcon ایک اور اعلیٰ performance Python framework ہے، اسے کم سے کم ہونے کے لیے ڈیزائن کیا گیا ہے، اور دوسرے frameworks جیسے Hug کی بنیاد کے طور پر کام کرنے کے لیے۔ @@ -297,7 +297,7 @@ Hug کے ساتھ مل کر (چونکہ Hug، Falcon پر مبنی ہے) **FastA /// -### [Molten](https://moltenframework.com/) { #molten } +### [Molten](https://moltenframework.com/){ #molten } میں نے **FastAPI** بنانے کے ابتدائی مراحل میں Molten دریافت کیا۔ اور اس کے کافی ملتے جلتے آئیڈیاز ہیں: @@ -321,7 +321,7 @@ Model attributes کی "default" value استعمال کرکے data types کے ل /// -### [Hug](https://github.com/hugapi/hug) { #hug } +### [Hug](https://github.com/hugapi/hug){ #hug } Hug ان پہلے frameworks میں سے ایک تھا جنہوں نے Python type hints استعمال کرکے API parameter types declare کرنا implement کیا۔ یہ ایک زبردست آئیڈیا تھا جس نے دوسرے tools کو بھی ایسا کرنے کی تحریک دی۔ @@ -401,7 +401,7 @@ APIStar Tom Christie نے بنایا تھا۔ وہی شخص جس نے بنایا ## **FastAPI** کے ذریعے استعمال شدہ { #used-by-fastapi } -### [Pydantic](https://docs.pydantic.dev/) { #pydantic } +### [Pydantic](https://docs.pydantic.dev/){ #pydantic } Pydantic ایک library ہے جو Python type hints کی بنیاد پر data validation، serialization اور documentation (JSON Schema استعمال کرتے ہوئے) define کرتی ہے۔ @@ -417,7 +417,7 @@ Pydantic ایک library ہے جو Python type hints کی بنیاد پر data va /// -### [Starlette](https://www.starlette.dev/) { #starlette } +### [Starlette](https://www.starlette.dev/){ #starlette } Starlette ایک ہلکا پھلکا ASGI framework/toolkit ہے، جو اعلیٰ performance asyncio services بنانے کے لیے مثالی ہے۔ @@ -462,7 +462,7 @@ ASGI ایک نیا "standard" ہے جو Django core ٹیم کے ممبران dev /// -### [Uvicorn](https://www.uvicorn.dev/) { #uvicorn } +### [Uvicorn](https://www.uvicorn.dev/){ #uvicorn } Uvicorn ایک بجلی کی رفتار والا ASGI server ہے، uvloop اور httptools پر مبنی۔ diff --git a/docs/ur/docs/contributing.md b/docs/ur/docs/contributing.md deleted file mode 100644 index 4a39c2dafd..0000000000 --- a/docs/ur/docs/contributing.md +++ /dev/null @@ -1,261 +0,0 @@ -# ترقی - تعاون - -پہلے، آپ [FastAPI کی مدد کریں اور مدد حاصل کریں](help-fastapi.md) کے بنیادی طریقے دیکھنا چاہیں گے۔ - -## ترقی - -اگر آپ نے پہلے ہی [fastapi repository](https://github.com/fastapi/fastapi) clone کر لیا ہے اور code میں گہرائی سے جانا چاہتے ہیں، تو یہاں آپ کا ماحول ترتیب دینے کی کچھ ہدایات ہیں۔ - -### ضروریات install کریں - -Virtual environment بنائیں اور [`uv`](https://github.com/astral-sh/uv) کے ساتھ درکار packages install کریں: - -
- -```console -$ uv sync --extra all - ----> 100% -``` - -
- -یہ تمام dependencies اور آپ کا مقامی FastAPI آپ کے مقامی ماحول میں install کر دے گا۔ - -### اپنا مقامی FastAPI استعمال کریں - -اگر آپ ایک Python فائل بناتے ہیں جو FastAPI import اور استعمال کرتی ہے، اور اسے اپنے مقامی ماحول کے Python سے چلاتے ہیں، تو یہ آپ کا clone شدہ مقامی FastAPI source code استعمال کرے گا۔ - -اور اگر آپ اس مقامی FastAPI source code کو اپڈیٹ کرتے ہیں تو جب آپ وہ Python فائل دوبارہ چلائیں گے، یہ FastAPI کا وہ تازہ ورژن استعمال کرے گا جو آپ نے ابھی ترمیم کیا ہے۔ - -اس طرح، ہر تبدیلی ٹیسٹ کرنے کے لیے آپ کو اپنا مقامی ورژن "install" نہیں کرنا پڑتا۔ - -/// note | تکنیکی تفصیلات - -یہ صرف تب ہوتا ہے جب آپ `pip install fastapi` براہ راست چلانے کی بجائے `uv sync --extra all` استعمال کرکے install کرتے ہیں۔ - -اس کی وجہ یہ ہے کہ `uv sync --extra all` بطور default FastAPI کا مقامی ورژن "editable" mode میں install کرتا ہے۔ - -/// - -### Code فارمیٹ کریں - -ایک script ہے جسے آپ چلا سکتے ہیں جو آپ کا سارا code فارمیٹ اور صاف کر دے گی: - -
- -```console -$ bash scripts/format.sh -``` - -
- -یہ آپ کے تمام imports کو بھی خودکار طریقے سے ترتیب دے گی۔ - -## Tests - -ایک script ہے جسے آپ مقامی طور پر تمام code ٹیسٹ کرنے اور HTML میں coverage reports بنانے کے لیے چلا سکتے ہیں: - -
- -```console -$ bash scripts/test-cov-html.sh -``` - -
- -یہ command `./htmlcov/` directory بناتی ہے، اگر آپ `./htmlcov/index.html` فائل اپنے browser میں کھولیں، تو آپ انٹرایکٹو طریقے سے دیکھ سکتے ہیں کہ code کے کون سے حصے tests سے cover ہیں، اور کوئی حصہ رہ تو نہیں گیا۔ - -## Docs - -پہلے، یقینی بنائیں کہ آپ نے اوپر بیان کردہ طریقے سے اپنا ماحول ترتیب دیا ہے، جو تمام ضروریات install کر دے گا۔ - -### Docs لائیو - -مقامی ترقی کے دوران، ایک script ہے جو سائٹ بناتی ہے اور کسی بھی تبدیلی کو چیک کرتی ہے، لائیو ری لوڈنگ کے ساتھ: - -
- -```console -$ python ./scripts/docs.py live - -[INFO] Serving on http://127.0.0.1:8008 -[INFO] Start watching changes -[INFO] Start detecting changes -``` - -
- -یہ documentation کو `http://127.0.0.1:8008` پر serve کرے گا۔ - -اس طرح، آپ documentation/source فائلوں میں ترمیم کر سکتے ہیں اور تبدیلیاں لائیو دیکھ سکتے ہیں۔ - -/// tip | مشورہ - -متبادل طور پر، آپ وہی اقدامات خود دستی طور پر کر سکتے ہیں جو script کرتی ہے۔ - -زبان کی directory میں جائیں، بنیادی docs کے لیے انگریزی میں یہ `docs/en/` پر ہے: - -```console -$ cd docs/en/ -``` - -پھر اس directory میں `mkdocs` چلائیں: - -```console -$ mkdocs serve --dev-addr 127.0.0.1:8008 -``` - -/// - -#### Typer CLI (اختیاری) - -یہاں ہدایات آپ کو دکھاتی ہیں کہ `./scripts/docs.py` script کو `python` program کے ساتھ براہ راست کیسے استعمال کریں۔ - -لیکن آپ [Typer CLI](https://typer.tiangolo.com/typer-cli/) بھی استعمال کر سکتے ہیں، اور completion install کرنے کے بعد آپ کو اپنے terminal میں commands کے لیے autocompletion ملے گی۔ - -اگر آپ Typer CLI install کرتے ہیں، تو آپ اس کے ساتھ completion install کر سکتے ہیں: - -
- -```console -$ typer --install-completion - -zsh completion installed in /home/user/.bashrc. -Completion will take effect once you restart the terminal. -``` - -
- -### Docs کی ساخت - -Documentation [MkDocs](https://www.mkdocs.org/) استعمال کرتی ہے۔ - -اور `./scripts/docs.py` میں تراجم کو سنبھالنے کے لیے اضافی tools/scripts موجود ہیں۔ - -/// tip | مشورہ - -آپ کو `./scripts/docs.py` کا code دیکھنے کی ضرورت نہیں، آپ بس اسے command line میں استعمال کرتے ہیں۔ - -/// - -تمام documentation `./docs/en/` directory میں Markdown فارمیٹ میں ہے۔ - -بہت سے tutorials میں code blocks ہوتے ہیں۔ - -زیادہ تر معاملات میں، یہ code blocks مکمل applications ہیں جو جیسے ہیں ویسے چلائی جا سکتی ہیں۔ - -درحقیقت، وہ code blocks Markdown کے اندر نہیں لکھے جاتے، بلکہ `./docs_src/` directory میں Python فائلیں ہیں۔ - -اور وہ Python فائلیں سائٹ generate کرتے وقت documentation میں شامل/inject کی جاتی ہیں۔ - -### Tests کے لیے Docs - -زیادہ تر tests دراصل documentation میں موجود مثالی source فائلوں کے خلاف چلتے ہیں۔ - -اس سے یہ یقینی بنانے میں مدد ملتی ہے کہ: - -* Documentation تازہ ترین ہے۔ -* Documentation کی مثالیں جیسی ہیں ویسی چلائی جا سکتی ہیں۔ -* زیادہ تر features documentation سے cover ہیں، test coverage سے یقینی بنائی گئی ہیں۔ - -#### Apps اور docs بیک وقت - -اگر آپ مثالیں چلاتے ہیں، جیسے: - -
- -```console -$ fastapi dev tutorial001.py - -INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) -``` - -
- -چونکہ Uvicorn بطور default port `8000` استعمال کرتا ہے، port `8008` پر documentation اس سے نہیں ٹکرائے گی۔ - -### تراجم - -تراجم میں مدد بہت زیادہ قدر کی جاتی ہے! اور یہ کمیونٹی کی مدد کے بغیر نہیں ہو سکتا۔ 🌎 🚀 - -ترجمے کی pull requests FastAPI ٹیم کی طرف سے ڈیزائن کردہ prompts سے رہنمائی حاصل کرنے والے LLMs اور ہر supported زبان کے لیے مقامی بولنے والوں کی کمیونٹی کے ساتھ مل کر بنائی جاتی ہیں۔ - -#### فی زبان LLM Prompt - -ہر زبان کی ایک directory ہے: [https://github.com/fastapi/fastapi/tree/master/docs](https://github.com/fastapi/fastapi/tree/master/docs)، اس میں آپ `llm-prompt.md` فائل دیکھ سکتے ہیں جس میں اس زبان کے لیے مخصوص prompt ہے۔ - -مثال کے طور پر، ہسپانوی کے لیے prompt یہاں ہے: [`docs/es/llm-prompt.md`](https://github.com/fastapi/fastapi/blob/master/docs/es/llm-prompt.md)۔ - -اگر آپ کو اپنی زبان میں غلطیاں نظر آئیں، تو آپ اپنی زبان کی فائل میں prompt کے لیے تجاویز دے سکتے ہیں، اور تبدیلیوں کے بعد ان مخصوص pages کی دوبارہ تخلیق کی درخواست کر سکتے ہیں۔ - -#### ترجمے کی PRs کا Review - -آپ اپنی زبان کے لیے موجودہ [pull requests](https://github.com/fastapi/fastapi/pulls) بھی چیک کر سکتے ہیں۔ آپ اپنی زبان کے label کے ساتھ pull requests فلٹر کر سکتے ہیں۔ مثال کے طور پر، ہسپانوی کے لیے label [`lang-es`](https://github.com/fastapi/fastapi/pulls?q=is%3Aopen+sort%3Aupdated-desc+label%3Alang-es+label%3Aawaiting-review) ہے۔ - -Pull request کا review کرتے وقت، بہتر ہے کہ اسی pull request میں تبدیلیاں تجویز نہ کریں، کیونکہ یہ LLM سے generate کیا گیا ہے، اور یہ یقینی بنانا ممکن نہیں ہوگا کہ چھوٹی انفرادی تبدیلیاں دوسرے ملتے جلتے حصوں میں نقل ہوں، یا وہی مواد دوبارہ ترجمہ کرتے وقت محفوظ رہیں۔ - -ترجمے کی PR میں تجاویز شامل کرنے کی بجائے، اس زبان کی LLM prompt فائل میں تجاویز دیں، ایک نئی PR میں۔ مثال کے طور پر، ہسپانوی کی LLM prompt فائل یہاں ہے: [`docs/es/llm-prompt.md`](https://github.com/fastapi/fastapi/blob/master/docs/es/llm-prompt.md)۔ - -/// tip | مشورہ - -[Pull request review شامل کرنے](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews) کے بارے میں docs چیک کریں تاکہ اسے منظور یا تبدیلیوں کی درخواست کر سکیں۔ - -/// - -#### اپنی زبان کے لیے Notifications سبسکرائب کریں - -چیک کریں کہ آیا آپ کی زبان کے تراجم کی coordination کے لیے [GitHub Discussion](https://github.com/fastapi/fastapi/discussions/categories/translations) ہے۔ آپ اسے سبسکرائب کر سکتے ہیں، اور جب review کے لیے نئی pull request ہوگی، discussion میں خودکار تبصرہ شامل کیا جائے گا۔ - -آپ جس زبان کا ترجمہ کرنا چاہتے ہیں اس کا 2 حرفی code جاننے کے لیے [List of ISO 639-1 codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) کا جدول استعمال کر سکتے ہیں۔ - -#### نئی زبان کی درخواست - -فرض کریں کہ آپ ایسی زبان کے تراجم کی درخواست کرنا چاہتے ہیں جس کا ابھی تک ترجمہ نہیں ہوا، کوئی page بھی نہیں۔ مثال کے طور پر، لاطینی۔ - -* پہلا قدم یہ ہوگا کہ آپ 2 اور لوگ تلاش کریں جو آپ کے ساتھ اس زبان کے لیے ترجمے کی PRs کا review کرنے کو تیار ہوں۔ -* جب کم از کم 3 لوگ اس زبان کی دیکھ بھال میں مدد کا عہد کرنے کو تیار ہوں، تو آپ اگلے اقدامات جاری رکھ سکتے ہیں۔ -* Template کے مطابق نئی discussion بنائیں۔ -* اپنے ساتھ مدد کرنے والے 2 دوسرے لوگوں کو tag کریں، اور ان سے وہاں تصدیق کرنے کو کہیں کہ وہ مدد کریں گے۔ - -جب discussion میں کئی لوگ ہوں، FastAPI ٹیم اس کا جائزہ لے سکتی ہے اور اسے سرکاری ترجمہ بنا سکتی ہے۔ - -پھر docs خودکار طور پر LLMs کے ذریعے ترجمہ ہوں گے، اور مقامی بولنے والوں کی ٹیم ترجمے کا review کر سکتی ہے، اور LLM prompts کو بہتر بنانے میں مدد کر سکتی ہے۔ - -جب نیا ترجمہ ہوگا، مثال کے طور پر اگر docs اپڈیٹ ہوں یا نیا سیکشن ہو، تو اسی discussion میں review کے لیے نئے ترجمے کے link کے ساتھ تبصرہ آئے گا۔ - -## خودکار Code اور AI - -آپ کو ہر وہ tool استعمال کرنے کی ترغیب دی جاتی ہے جو آپ چاہیں تاکہ اپنا کام کریں اور جتنا ہو سکے مؤثر طریقے سے تعاون کریں، بشمول AI (LLM) tools وغیرہ۔ تاہم، تعاون میں بامعنی انسانی مداخلت، فیصلے، سیاق و سباق وغیرہ ہونا چاہیے۔ - -اگر PR میں لگائی گئی **انسانی محنت**، جیسے LLM prompts لکھنا، اس **محنت سے کم** ہے جو ہمیں اسے **review** کرنے میں لگانی ہوگی، تو براہ کرم PR **جمع نہ کریں**۔ - -اس طرح سوچیں: ہم خود LLM prompts لکھ سکتے ہیں یا خودکار tools چلا سکتے ہیں، اور یہ بیرونی PRs کا review کرنے سے تیز ہوگا۔ - -### خودکار اور AI PRs بند کرنا - -اگر ہمیں ایسی PRs نظر آئیں جو AI سے generate کی گئی یا اسی طرح خودکار لگتی ہیں، تو ہم انہیں flag کرکے بند کر دیں گے۔ - -یہی تبصروں اور تفصیلات پر بھی لاگو ہوتا ہے، براہ کرم LLM سے generate کیا گیا مواد copy paste نہ کریں۔ - -### انسانی محنت پر Denial of Service - -خودکار tools اور AI کا استعمال کرکے ایسی PRs یا تبصرے جمع کرنا جنہیں ہمیں احتیاط سے review اور سنبھالنا ہو، ہماری انسانی محنت پر [Denial-of-service attack](https://en.wikipedia.org/wiki/Denial-of-service_attack) کے مترادف ہوگا۔ - -PR جمع کرنے والے شخص کی طرف سے بہت کم محنت (ایک LLM prompt) ہماری طرف سے بڑی مقدار میں محنت (احتیاط سے code کا review) پیدا کرتی ہے۔ - -براہ کرم ایسا نہ کریں۔ - -ہمیں بار بار خودکار PRs یا تبصروں سے spam کرنے والے اکاؤنٹس کو block کرنا ہوگا۔ - -### Tools سمجھداری سے استعمال کریں - -جیسا کہ Uncle Ben نے کہا: - -
-بڑی طاقت tools کے ساتھ بڑی ذمہ داری آتی ہے۔ -
- -نادانستہ طور پر نقصان پہنچانے سے بچیں۔ - -آپ کے پاس حیرت انگیز tools ہیں، انہیں سمجھداری سے مؤثر طریقے سے مدد کرنے کے لیے استعمال کریں۔ diff --git a/docs/ur/docs/deployment/docker.md b/docs/ur/docs/deployment/docker.md index 5905f0459f..770509181f 100644 --- a/docs/ur/docs/deployment/docker.md +++ b/docs/ur/docs/deployment/docker.md @@ -267,7 +267,7 @@ CMD fastapi run app/main.py --port 80 ``` . ├── app -│ ├── __init__.py +│   ├── __init__.py │ └── main.py ├── Dockerfile └── requirements.txt diff --git a/docs/ur/docs/external-links.md b/docs/ur/docs/external-links.md deleted file mode 100644 index 7027d88c37..0000000000 --- a/docs/ur/docs/external-links.md +++ /dev/null @@ -1,25 +0,0 @@ -# بیرونی لنکس - -**FastAPI** کی ایک شاندار کمیونٹی ہے جو مسلسل بڑھ رہی ہے۔ - -**FastAPI** سے متعلق بہت سے مضامین، مقالات، tools، اور projects ہیں۔ - -آپ آسانی سے search engine یا video platform استعمال کرکے FastAPI سے متعلق بہت سے وسائل تلاش کر سکتے ہیں۔ - -/// info | معلومات - -پہلے، اس صفحے پر بیرونی مضامین کے لنکس درج کیے جاتے تھے۔ - -لیکن اب جب FastAPI تمام زبانوں میں سب سے زیادہ GitHub stars والا backend framework ہے، اور Python میں سب سے زیادہ starred اور استعمال ہونے والا framework ہے، تو اس کے بارے میں لکھے گئے تمام مضامین درج کرنے کی کوشش کرنا اب مناسب نہیں رہا۔ - -/// - -## GitHub Repositories - -سب سے زیادہ starred [`fastapi` topic والی GitHub repositories](https://github.com/topics/fastapi): - -{% for repo in topic_repos %} - -★ {{repo.stars}} - {{repo.name}} by @{{repo.owner_login}}. - -{% endfor %} diff --git a/docs/ur/docs/fastapi-cli.md b/docs/ur/docs/fastapi-cli.md index 94c3d377aa..285581960b 100644 --- a/docs/ur/docs/fastapi-cli.md +++ b/docs/ur/docs/fastapi-cli.md @@ -78,8 +78,8 @@ from main import app ``` . ├── backend -│ ├── main.py -│ ├── __init__.py +│   ├── main.py +│   ├── __init__.py ``` تو آپ `entrypoint` اس طرح سیٹ کریں گے: diff --git a/docs/ur/docs/fastapi-people.md b/docs/ur/docs/fastapi-people.md deleted file mode 100644 index 02c33ef6e9..0000000000 --- a/docs/ur/docs/fastapi-people.md +++ /dev/null @@ -1,285 +0,0 @@ ---- -hide: - - navigation ---- - -# FastAPI کے لوگ - -FastAPI کی ایک حیرت انگیز کمیونٹی ہے جو ہر پس منظر سے لوگوں کا خیرمقدم کرتی ہے۔ - -## بانی - -ارے! 👋 - -یہ میں ہوں: - -
-{% for user in people.maintainers %} - -
@{{ contributors.tiangolo.login }}
Answers: {{ user.answers }}
Pull Requests: {{ contributors.tiangolo.count }}
-{% endfor %} - -
- -میں **FastAPI** کا بانی ہوں۔ آپ اس کے بارے میں مزید [FastAPI کی مدد کریں - مدد حاصل کریں - مصنف سے جڑیں](help-fastapi.md#connect-with-the-author) میں پڑھ سکتے ہیں۔ - -...لیکن یہاں میں آپ کو کمیونٹی دکھانا چاہتا ہوں۔ - ---- - -**FastAPI** کو کمیونٹی سے بہت زیادہ حمایت ملتی ہے۔ اور میں ان کے تعاون کو نمایاں کرنا چاہتا ہوں۔ - -یہ وہ لوگ ہیں جو: - -* [GitHub میں سوالات کے ساتھ دوسروں کی مدد کرتے ہیں](help-fastapi.md#help-others-with-questions-in-github)۔ -* [Pull Requests بناتے ہیں](help-fastapi.md#create-a-pull-request)۔ -* Pull Requests کا Review کرتے ہیں، [خاص طور پر تراجم کے لیے اہم](contributing.md#translations)۔ -* [Repository منظم](management-tasks.md) کرنے میں مدد کرتے ہیں (ٹیم ممبران)۔ - -یہ سب کام repository کو برقرار رکھنے میں مدد کرتے ہیں۔ - -ان کے لیے تالیاں۔ 👏 🙇 - -## ٹیم - -یہ موجودہ ٹیم ممبران کی فہرست ہے۔ 😎 - -ان کی شمولیت اور اجازتوں کی مختلف سطحیں ہیں، وہ [repository management tasks](./management-tasks.md) انجام دے سکتے ہیں اور مل کر ہم [FastAPI repository کو منظم کرتے ہیں](./management.md)۔ - -
- -{% for user in members["members"] %} - -
@{{ user.login }}
- -{% endfor %} - -
- -حالانکہ ٹیم ممبران کے پاس خصوصی کام انجام دینے کی اجازتیں ہیں، [FastAPI کو برقرار رکھنے میں دوسروں کی ہر مدد](./help-fastapi.md#help-maintain-fastapi) کی بہت قدر کی جاتی ہے! 🙇‍♂️ - -## FastAPI Experts - -یہ وہ صارفین ہیں جو [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کرتے رہے ہیں۔ 🙇 - -انہوں نے بہت سے دوسروں کی مدد کرکے ثابت کیا ہے کہ وہ **FastAPI Experts** ہیں۔ ✨ - -/// tip | مشورہ - -آپ بھی سرکاری FastAPI Expert بن سکتے ہیں! - -بس [GitHub میں سوالات کے ساتھ دوسروں کی مدد کریں](help-fastapi.md#help-others-with-questions-in-github)۔ 🤓 - -/// - -آپ **FastAPI Experts** یہاں دیکھ سکتے ہیں: - -* [پچھلا مہینہ](#fastapi-experts-last-month) 🤓 -* [3 مہینے](#fastapi-experts-3-months) 😎 -* [6 مہینے](#fastapi-experts-6-months) 🧐 -* [1 سال](#fastapi-experts-1-year) 🧑‍🔬 -* [**ہمیشہ**](#fastapi-experts-all-time) 🧙 - -### FastAPI Experts - پچھلا مہینہ - -یہ وہ صارفین ہیں جو پچھلے مہینے [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کرتے رہے ہیں۔ 🤓 - -
- -{% for user in people.last_month_experts[:10] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Questions replied: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -### FastAPI Experts - 3 مہینے - -یہ وہ صارفین ہیں جو پچھلے 3 مہینوں میں [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کرتے رہے ہیں۔ 😎 - -
- -{% for user in people.three_months_experts[:10] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Questions replied: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -### FastAPI Experts - 6 مہینے - -یہ وہ صارفین ہیں جو پچھلے 6 مہینوں میں [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کرتے رہے ہیں۔ 🧐 - -
- -{% for user in people.six_months_experts[:10] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Questions replied: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -### FastAPI Experts - 1 سال - -یہ وہ صارفین ہیں جو پچھلے سال [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کرتے رہے ہیں۔ 🧑‍🔬 - -
- -{% for user in people.one_year_experts[:20] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Questions replied: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -### FastAPI Experts - ہمیشہ - -یہ ہیں ہمیشہ کے **FastAPI Experts**۔ 🤓🤯 - -یہ وہ صارفین ہیں جنہوں نے *ہمیشہ سے* [GitHub میں سوالات کے ساتھ سب سے زیادہ دوسروں کی مدد](help-fastapi.md#help-others-with-questions-in-github) کی ہے۔ 🧙 - -
- -{% for user in people.experts[:50] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Questions replied: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -## اعلیٰ شراکت دار - -یہ ہیں **اعلیٰ شراکت دار**۔ 👷 - -ان صارفین نے سب سے زیادہ [Pull Requests بنائی ہیں](help-fastapi.md#create-a-pull-request) جو *merge* ہو چکی ہیں۔ - -انہوں نے source code، documentation وغیرہ میں تعاون کیا ہے۔ 📦 - -
- -{% for user in (contributors.values() | list)[:50] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Pull Requests: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -سینکڑوں دوسرے شراکت دار بھی ہیں، آپ انہیں [FastAPI GitHub Contributors page](https://github.com/fastapi/fastapi/graphs/contributors) پر دیکھ سکتے ہیں۔ 👷 - -## اعلیٰ ترجمہ جائزہ کار - -یہ صارفین **اعلیٰ ترجمہ جائزہ کار** ہیں۔ 🕵️ - -ترجمہ جائزہ کاروں کے پاس documentation کے [**تراجم کی منظوری**](contributing.md#translations) دینے کا اختیار ہے۔ ان کے بغیر، کئی دوسری زبانوں میں documentation نہ ہوتی۔ - -
-{% for user in (translation_reviewers.values() | list)[:50] %} - -{% if user.login not in skip_users %} - -
@{{ user.login }}
Reviews: {{ user.count }}
- -{% endif %} - -{% endfor %} - -
- -## سرپرست - -یہ ہیں **سرپرست**۔ 😎 - -وہ **FastAPI** (اور دوسرے) کے ساتھ میرے کام کی حمایت کر رہے ہیں، بنیادی طور پر [GitHub Sponsors](https://github.com/sponsors/tiangolo) کے ذریعے۔ - -{% if sponsors %} - -{% if sponsors.gold %} - -### گولڈ سرپرست - -{% for sponsor in sponsors.gold -%} - -{% endfor %} -{% endif %} - -{% if sponsors.silver %} - -### سلور سرپرست - -{% for sponsor in sponsors.silver -%} - -{% endfor %} -{% endif %} - -{% if sponsors.bronze %} - -### برانز سرپرست - -{% for sponsor in sponsors.bronze -%} - -{% endfor %} -{% endif %} - -{% endif %} - -### انفرادی سرپرست - -{% if github_sponsors %} -{% for group in github_sponsors.sponsors %} - -
- -{% for user in group %} -{% if user.login not in sponsors_badge.logins %} - -
@{{ user.login }}
- -{% endif %} -{% endfor %} - -
- -{% endfor %} -{% endif %} - -## ڈیٹا کے بارے میں - تکنیکی تفصیلات - -اس صفحے کا بنیادی مقصد کمیونٹی کی دوسروں کی مدد کرنے کی کوششوں کو نمایاں کرنا ہے۔ - -خاص طور پر ایسی کوششوں کو شامل کرتے ہوئے جو عام طور پر کم نظر آتی ہیں، اور بہت سے معاملات میں زیادہ محنت طلب ہوتی ہیں، جیسے سوالات میں دوسروں کی مدد کرنا اور تراجم کے ساتھ Pull Requests کا review کرنا۔ - -ڈیٹا ہر مہینے حساب کیا جاتا ہے، آپ [source code یہاں](https://github.com/fastapi/fastapi/blob/master/scripts/) پڑھ سکتے ہیں۔ - -یہاں میں سرپرستوں کے تعاون کو بھی نمایاں کر رہا ہوں۔ - -میں algorithm، سیکشنز، thresholds وغیرہ کو اپڈیٹ کرنے کا حق بھی محفوظ رکھتا ہوں (احتیاطاً 🤷)۔ diff --git a/docs/ur/docs/how-to/custom-docs-ui-assets.md b/docs/ur/docs/how-to/custom-docs-ui-assets.md index 104c529c08..dfee51d19b 100644 --- a/docs/ur/docs/how-to/custom-docs-ui-assets.md +++ b/docs/ur/docs/how-to/custom-docs-ui-assets.md @@ -80,8 +80,8 @@ JavaScript اور CSS خود host کرنا مفید ہو سکتا ہے اگر، ``` . ├── app -│ ├── __init__.py -│ ├── main.py +│   ├── __init__.py +│   ├── main.py └── static/ ``` @@ -105,8 +105,8 @@ Docs کے لیے ضروری static فائلیں ڈاؤن لوڈ کریں اور ``` . ├── app -│ ├── __init__.py -│ ├── main.py +│   ├── __init__.py +│   ├── main.py └── static ├── redoc.standalone.js ├── swagger-ui-bundle.js diff --git a/docs/ur/docs/management-tasks.md b/docs/ur/docs/management-tasks.md deleted file mode 100644 index 6bbaf03994..0000000000 --- a/docs/ur/docs/management-tasks.md +++ /dev/null @@ -1,157 +0,0 @@ -# Repository Management Tasks - -یہ وہ کام ہیں جو FastAPI repository کو manage کرنے کے لیے [ٹیم ممبران](./fastapi-people.md#team) انجام دے سکتے ہیں۔ - -/// tip | مشورہ - -یہ سیکشن صرف مٹھی بھر لوگوں کے لیے مفید ہے، وہ ٹیم ممبران جن کے پاس repository manage کرنے کی اجازتیں ہیں۔ آپ شاید اسے چھوڑ سکتے ہیں۔ 😉 - -/// - -...تو آپ [FastAPI کی ٹیم کے ممبر](./fastapi-people.md#team) ہیں؟ واہ، آپ بہت زبردست ہیں! 😎 - -آپ [FastAPI کی مدد کریں - مدد حاصل کریں](./help-fastapi.md) میں سب کچھ بیرونی شراکت داروں کی طرح مدد کر سکتے ہیں۔ لیکن اس کے علاوہ، کچھ کام ایسے ہیں جو صرف آپ (ٹیم کے حصے کے طور پر) انجام دے سکتے ہیں۔ - -یہاں ان کاموں کی عمومی ہدایات ہیں جو آپ انجام دے سکتے ہیں۔ - -آپ کی مدد کے لیے بہت شکریہ۔ 🙇 - -## مہربان رہیں - -سب سے پہلے، مہربان رہیں۔ 😊 - -اگر آپ ٹیم میں شامل کیے گئے تو شاید آپ بہت مہربان ہیں، لیکن یہ ذکر کرنا ضروری ہے۔ 🤓 - -### جب چیزیں مشکل ہوں - -جب چیزیں اچھی ہوں تو سب کچھ آسان ہوتا ہے، تو اس کے لیے زیادہ ہدایات کی ضرورت نہیں۔ لیکن جب چیزیں مشکل ہوں، یہاں کچھ رہنمائی ہے۔ - -اچھی بات تلاش کرنے کی کوشش کریں۔ عام طور پر، اگر لوگ غیر دوستانہ نہیں ہو رہے، تو ان کی محنت اور دلچسپی کا شکریہ ادا کرنے کی کوشش کریں، چاہے آپ بنیادی موضوع (بحث، PR) سے متفق نہ ہوں، بس project میں دلچسپی لینے، یا کچھ کرنے کی کوشش میں وقت لگانے کا شکریہ ادا کریں۔ - -متن میں جذبات ظاہر کرنا مشکل ہوتا ہے، مدد کے لیے emojis استعمال کریں۔ 😅 - -Discussions اور PRs میں، بہت سے معاملات میں لوگ اپنی پریشانی لاتے ہیں اور بغیر فلٹر کے دکھاتے ہیں، بہت سے معاملات میں مبالغہ آرائی، شکایت، حق جتانا وغیرہ۔ یہ واقعی اچھا نہیں ہے، اور جب ایسا ہوتا ہے تو ان کے مسائل حل کرنے کی ہماری ترجیح کم ہو جاتی ہے۔ لیکن پھر بھی، سانس لینے کی کوشش کریں، اور اپنے جوابات میں نرم رہیں۔ - -تلخ طنز یا ممکنہ طور پر passive-aggressive تبصروں سے بچنے کی کوشش کریں۔ اگر کچھ غلط ہے، تو طنزیہ ہونے سے بہتر ہے کہ براہ راست (نرمی سے) بات کریں۔ - -جتنا ہو سکے مخصوص اور معروضی ہونے کی کوشش کریں، عمومی باتوں سے بچیں۔ - -ان گفتگو کے لیے جو زیادہ مشکل ہوں، مثلاً PR مسترد کرنا، آپ مجھ سے (@tiangolo) براہ راست سنبھالنے کو کہہ سکتے ہیں۔ - -## PR Titles ترمیم کریں - -* PR title ترمیم کریں تاکہ یہ [gitmoji](https://gitmoji.dev/) سے emoji کے ساتھ شروع ہو۔ - * Emoji character استعمال کریں، GitHub code نہیں۔ تو `🐛` استعمال کریں `:bug:` کی بجائے۔ تاکہ GitHub سے باہر بھی صحیح دکھائی دے، مثلاً release notes میں۔ - * تراجم کے لیے `🌐` emoji ("globe with meridians") استعمال کریں۔ -* Title فعل سے شروع کریں۔ مثلاً `Add`، `Refactor`، `Fix` وغیرہ۔ اس طرح title بتائے گا کہ PR کیا کرتا ہے۔ جیسے `Add support for teleporting`، بجائے `Teleporting wasn't working, so this PR fixes it`۔ -* PR title کا متن "امری" انداز میں ترمیم کریں، جیسے حکم دے رہے ہوں۔ تو `Adding support for teleporting` کی بجائے `Add support for teleporting` استعمال کریں۔ -* Title وضاحتی ہو کہ یہ کیا حاصل کرتا ہے۔ اگر feature ہے تو اسے بیان کرنے کی کوشش کریں، مثلاً `Add support for teleporting` بجائے `Create TeleportAdapter class`۔ -* Title نقطے (`.`) سے ختم نہ کریں۔ -* جب PR ترجمے کے لیے ہو، `🌐` سے شروع کریں اور پھر `Add {language} translation for` اور پھر ترجمہ شدہ فائل کا path۔ مثال کے طور پر: - -```Markdown -🌐 Add Spanish translation for `docs/es/docs/teleporting.md` -``` - -PR merge ہونے کے بعد، ایک GitHub Action ([latest-changes](https://github.com/tiangolo/latest-changes)) خودکار طور پر تازہ ترین تبدیلیاں اپڈیٹ کرنے کے لیے PR title استعمال کرے گی۔ - -تو اچھا PR title ہونا نہ صرف GitHub میں اچھا دکھائے گا، بلکہ release notes میں بھی۔ 📝 - -## PRs میں Labels شامل کریں - -وہی GitHub Action [latest-changes](https://github.com/tiangolo/latest-changes) release notes میں اس PR کو کس سیکشن میں رکھنا ہے یہ فیصلہ کرنے کے لیے PR میں ایک label استعمال کرتی ہے۔ - -یقینی بنائیں کہ آپ [latest-changes labels کی فہرست](https://github.com/tiangolo/latest-changes#using-labels) سے supported label استعمال کریں: - -* `breaking`: Breaking Changes - * موجودہ code ٹوٹ جائے گا اگر وہ اپنا code تبدیل کیے بغیر ورژن اپڈیٹ کریں۔ یہ شاذ و نادر ہوتا ہے، تو یہ label کم استعمال ہوتا ہے۔ -* `security`: Security Fixes - * یہ security fixes کے لیے ہے، جیسے vulnerabilities۔ یہ تقریباً کبھی استعمال نہیں ہوگا۔ -* `feature`: Features - * نئی features، ایسی چیزوں کی سہولت شامل کرنا جو پہلے موجود نہیں تھیں۔ -* `bug`: Fixes - * کوئی چیز جو supported تھی وہ کام نہیں کر رہی تھی، اور یہ اسے ٹھیک کرتا ہے۔ -* `refactor`: Refactors - * یہ عام طور پر اندرونی code میں تبدیلیوں کے لیے ہے جو رویے کو نہیں بدلتیں۔ -* `upgrade`: Upgrades - * یہ project سے براہ راست dependencies کے upgrades کے لیے ہے۔ -* `docs`: Docs - * Docs میں تبدیلیاں۔ اس میں تراجم کی تبدیلیاں شامل نہیں ہیں۔ -* `lang-all`: Translations - * تراجم کے لیے استعمال کریں۔ -* `internal`: Internal - * ایسی تبدیلیوں کے لیے استعمال کریں جو صرف repo management کو متاثر کرتی ہیں۔ - -/// tip | مشورہ - -Dependabot جیسے tools کچھ labels شامل کریں گے، جیسے `dependencies`، لیکن یاد رکھیں کہ یہ label `latest-changes` GitHub Action استعمال نہیں کرتی، تو release notes میں استعمال نہیں ہوگا۔ براہ کرم یقینی بنائیں کہ اوپر والے labels میں سے ایک شامل ہو۔ - -/// - -## ترجمے کی PRs میں Labels شامل کریں - -جب ترجمے کی PR ہو، `lang-all` label کے علاوہ، زبان کے لیے بھی label شامل کریں۔ - -ہر زبان کے لیے زبان code کا استعمال کرتے ہوئے ایک label ہوگا، جیسے `lang-{lang code}`، مثلاً ہسپانوی کے لیے `lang-es`، فرانسیسی کے لیے `lang-fr` وغیرہ۔ - -* مخصوص زبان کا label شامل کریں۔ -* `awaiting-review` label شامل کریں۔ - -`awaiting-review` label خاص ہے، صرف تراجم کے لیے۔ ایک GitHub Action اسے detect کرے گا، پھر زبان کا label پڑھے گا، اور اس زبان کے تراجم manage کرنے والی GitHub Discussions کو اپڈیٹ کرے گا تاکہ لوگوں کو بتایا جائے کہ review کے لیے نیا ترجمہ ہے۔ - -جب کوئی مقامی بولنے والا آئے، PR کا review کرے، اور اسے منظور کرے، GitHub Action آ کر `awaiting-review` label ہٹائے گا، اور `approved-1` label شامل کرے گا۔ - -اس طرح، ہم نوٹ کر سکتے ہیں جب نئے تراجم تیار ہوں، کیونکہ ان کے پاس `approved-1` label ہوتا ہے۔ - -## ترجمے کی PRs Merge کریں - -تراجم LLMs اور scripts سے خودکار طور پر generate کیے جاتے ہیں۔ - -ایک GitHub Action ہے جو کسی زبان کے تراجم شامل یا اپڈیٹ کرنے کے لیے دستی طور پر چلایا جا سکتا ہے: [`translate.yml`](https://github.com/fastapi/fastapi/actions/workflows/translate.yml)۔ - -ان زبان کے ترجمے کی PRs کے لیے، تصدیق کریں کہ: - -* PR خودکار تھا (@tiangolo کی طرف سے)، کسی اور صارف نے نہیں بنایا۔ -* اس میں `lang-all` اور `lang-{lang code}` labels ہیں۔ -* اگر PR کم از کم ایک مقامی بولنے والے نے منظور کیا ہو، آپ اسے merge کر سکتے ہیں۔ - -## PRs کا Review کریں - -* اگر PR نہیں بتاتی کہ یہ کیا کرتی ہے یا کیوں، اگر ایسا لگے کہ مفید ہو سکتی ہے، مزید معلومات مانگیں۔ ورنہ، آزادانہ طور پر اسے بند کر دیں۔ - -* اگر PR spam لگے، بے معنی لگے، صرف اعداد و شمار تبدیل کرنے کے لیے ("contributor" ظاہر ہونے کے لیے) یا اسی طرح، آپ اسے `invalid` نشان زد کر سکتے ہیں، اور یہ خودکار طور پر بند ہو جائے گی۔ - -* اگر PR AI سے generate شدہ لگتی ہے، اور ایسا لگے کہ اس کا review کرنا prompt لکھنے سے زیادہ وقت لے گا، اسے `maybe-ai` نشان زد کریں، اور یہ خودکار طور پر بند ہو جائے گی۔ - -* PR کا کوئی مخصوص use case ہونا چاہیے جو یہ حل کر رہی ہو۔ - -* اگر PR feature کے لیے ہے تو اس میں docs ہونے چاہئیں۔ - * جب تک یہ ایسی feature نہ ہو جسے ہم حوصلہ شکنی کرنا چاہتے ہیں۔ -* Docs میں source مثالی فائل شامل ہونی چاہیے، براہ راست Markdown میں Python نہیں لکھنا چاہیے۔ -* اگر source مثال فائل(فائلوں) کے مختلف Python ورژنز کے لیے مختلف syntax ہو سکتے ہیں، تو فائل کے مختلف ورژنز ہونے چاہئیں، اور docs میں tabs میں دکھائے جانے چاہئیں۔ -* Source مثال ٹیسٹ کرنے والے tests ہونے چاہئیں۔ -* PR لاگو کرنے سے پہلے، نئے tests fail ہونے چاہئیں۔ -* PR لاگو کرنے کے بعد، نئے tests pass ہونے چاہئیں۔ -* Coverage 100% رہنا چاہیے۔ -* اگر آپ دیکھیں کہ PR درست ہے، یا ہم نے بحث کی اور فیصلہ کیا کہ اسے قبول کیا جائے، آپ PR کے اوپر commits شامل کر سکتے ہیں اسے بہتر بنانے، docs شامل کرنے، tests، فارمیٹ کرنے، refactor کرنے، اضافی فائلیں ہٹانے وغیرہ کے لیے۔ -* PR میں تبصرہ کرنے کے لیے آزاد محسوس کریں مزید معلومات مانگنے، تبدیلیاں تجویز کرنے وغیرہ کے لیے۔ -* جب آپ سمجھیں کہ PR تیار ہے، اسے اندرونی GitHub project میں میرے review کے لیے منتقل کریں۔ - -## FastAPI People PRs - -ہر مہینے، ایک GitHub Action FastAPI People data اپڈیٹ کرتی ہے۔ وہ PRs اس طرح نظر آتی ہیں: [👥 Update FastAPI People](https://github.com/fastapi/fastapi/pull/11669)۔ - -اگر tests pass ہو رہے ہوں، آپ اسے فوراً merge کر سکتے ہیں۔ - -## Dependabot PRs - -Dependabot مختلف چیزوں کے لیے dependencies اپڈیٹ کرنے کی PRs بنائے گا، اور وہ PRs ملتی جلتی نظر آتی ہیں، لیکن کچھ دوسروں سے بہت زیادہ نازک ہوتی ہیں۔ - -* اگر PR براہ راست dependency کے لیے ہو، تو Dependabot بنیادی dependencies میں `pyproject.toml` تبدیل کر رہا ہے، **اسے merge نہ کریں**۔ 😱 مجھے پہلے چیک کرنے دیں۔ -* اگر PR اندرونی dependencies میں سے کسی کو اپڈیٹ کرتی ہے، مثلاً `pyproject.toml` میں `dev` group، یا GitHub Action ورژنز، اگر tests pass ہو رہے ہیں، release notes (PR میں خلاصے میں دکھائی جاتی ہیں) میں کوئی واضح ممکنہ breaking change نظر نہیں آتی، آپ اسے merge کر سکتے ہیں۔ 😎 - -## GitHub Discussions جوابات نشان زد کریں - -جب GitHub Discussions میں کسی سوال کا جواب دیا گیا ہو، "Mark as answer" پر کلک کرکے جواب نشان زد کریں۔ - -آپ discussions کو [`Questions` جو `Unanswered` ہیں](https://github.com/tiangolo/fastapi/discussions/categories/questions?discussions_q=category:Questions+is:open+is:unanswered) سے فلٹر کر سکتے ہیں۔ diff --git a/docs/ur/docs/management.md b/docs/ur/docs/management.md deleted file mode 100644 index e1272ea96f..0000000000 --- a/docs/ur/docs/management.md +++ /dev/null @@ -1,39 +0,0 @@ -# Repository Management - -یہاں FastAPI repository کی انتظامیہ اور دیکھ بھال کی مختصر تفصیل ہے۔ - -## مالک - -میں، [@tiangolo](https://github.com/tiangolo)، FastAPI repository کا بانی اور مالک ہوں۔ 🤓 - -میں عام طور پر ہر PR کو merge کرنے سے پہلے حتمی review دیتا ہوں۔ میں project کے حتمی فیصلے کرتا ہوں، میں [BDFL](https://en.wikipedia.org/wiki/Benevolent_dictator_for_life) ہوں۔ 😅 - -## ٹیم - -لوگوں کی ایک ٹیم ہے جو project کو manage اور برقرار رکھنے میں مدد کرتی ہے۔ 😎 - -ان کی اجازتوں اور [مخصوص ہدایات](./management-tasks.md) کی مختلف سطحیں ہیں۔ - -وہ جو کام انجام دے سکتے ہیں ان میں سے کچھ یہ ہیں: - -* PRs میں labels شامل کرنا۔ -* PR titles ترمیم کرنا۔ -* PRs کے اوپر commits شامل کرنا تاکہ انہیں بہتر بنایا جا سکے۔ -* GitHub Discussions سوالات میں جوابات نشان زد کرنا، وغیرہ۔ -* PRs کی مخصوص اقسام merge کرنا۔ - -آپ موجودہ ٹیم ممبران [FastAPI کے لوگ - ٹیم](./fastapi-people.md#team) میں دیکھ سکتے ہیں۔ - -ٹیم میں شمولیت صرف دعوت نامے سے ہے، اور میں اجازتیں، ہدایات، یا رکنیت اپڈیٹ یا ہٹا سکتا ہوں۔ - -## FastAPI Experts - -وہ لوگ جو GitHub Discussions میں سب سے زیادہ دوسروں کی مدد کرتے ہیں [**FastAPI Experts**](./fastapi-people.md#fastapi-experts) بن سکتے ہیں۔ - -یہ عام طور پر project میں تعاون کا بہترین طریقہ ہے۔ - -## بیرونی تعاون - -بیرونی تعاون کا بہت خیرمقدم ہے اور اس کی قدر کی جاتی ہے، بشمول سوالات کے جوابات دینا، PRs جمع کرنا وغیرہ۔ 🙇‍♂️ - -[FastAPI کو برقرار رکھنے میں مدد](./help-fastapi.md#help-maintain-fastapi) کرنے کے بہت سے طریقے ہیں۔ diff --git a/docs/ur/docs/newsletter.md b/docs/ur/docs/newsletter.md deleted file mode 100644 index 5e03d177d3..0000000000 --- a/docs/ur/docs/newsletter.md +++ /dev/null @@ -1,5 +0,0 @@ -# FastAPI اور دوستوں کا newsletter - - - - diff --git a/docs/ur/docs/project-generation.md b/docs/ur/docs/project-generation.md index cda6781607..073588139f 100644 --- a/docs/ur/docs/project-generation.md +++ b/docs/ur/docs/project-generation.md @@ -8,7 +8,7 @@ GitHub Repository: [Full Stack FastAPI Template](https://github.com/tiangolo/ful ## Full Stack FastAPI Template - Technology Stack اور Features { #full-stack-fastapi-template-technology-stack-and-features } -- ⚡ [**FastAPI**](https://fastapi.tiangolo.com) Python backend API کے لیے۔ +- ⚡ [**FastAPI**](https://fastapi.tiangolo.com/ur) Python backend API کے لیے۔ - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) Python SQL database interactions (ORM) کے لیے۔ - 🔍 [Pydantic](https://docs.pydantic.dev)، FastAPI کے ذریعے استعمال شدہ، data validation اور settings management کے لیے۔ - 💾 [PostgreSQL](https://www.postgresql.org) بطور SQL database۔ diff --git a/docs/ur/docs/reference/apirouter.md b/docs/ur/docs/reference/apirouter.md deleted file mode 100644 index 4911830a93..0000000000 --- a/docs/ur/docs/reference/apirouter.md +++ /dev/null @@ -1,24 +0,0 @@ -# `APIRouter` class - -یہاں `APIRouter` class کی حوالہ جاتی معلومات ہیں، اس کے تمام parameters، attributes اور methods کے ساتھ۔ - -آپ `APIRouter` class کو براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import APIRouter -``` - -::: fastapi.APIRouter - options: - members: - - websocket - - include_router - - get - - put - - post - - delete - - options - - head - - patch - - trace - - on_event diff --git a/docs/ur/docs/reference/background.md b/docs/ur/docs/reference/background.md deleted file mode 100644 index 9700e75055..0000000000 --- a/docs/ur/docs/reference/background.md +++ /dev/null @@ -1,11 +0,0 @@ -# Background Tasks - `BackgroundTasks` - -آپ *path operation function* یا dependency function میں `BackgroundTasks` type کا parameter declare کر سکتے ہیں، اور پھر اسے response بھیجنے کے بعد background tasks کے عمل کو schedule کرنے کے لیے استعمال کر سکتے ہیں۔ - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import BackgroundTasks -``` - -::: fastapi.BackgroundTasks diff --git a/docs/ur/docs/reference/dependencies.md b/docs/ur/docs/reference/dependencies.md deleted file mode 100644 index 55eeefd5bd..0000000000 --- a/docs/ur/docs/reference/dependencies.md +++ /dev/null @@ -1,29 +0,0 @@ -# Dependencies - `Depends()` اور `Security()` - -## `Depends()` - -Dependencies کو بنیادی طور پر خاص function `Depends()` کے ذریعے سنبھالا جاتا ہے جو ایک callable لیتا ہے۔ - -یہاں اس کی اور اس کے parameters کی حوالہ جاتی معلومات ہیں۔ - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import Depends -``` - -::: fastapi.Depends - -## `Security()` - -بہت سے منظرناموں میں، آپ `Depends()` استعمال کر کے dependencies کے ذریعے security (authorization، authentication، وغیرہ) کو سنبھال سکتے ہیں۔ - -لیکن جب آپ OAuth2 scopes بھی declare کرنا چاہیں، تو آپ `Depends()` کی بجائے `Security()` استعمال کر سکتے ہیں۔ - -آپ `Security()` کو براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import Security -``` - -::: fastapi.Security diff --git a/docs/ur/docs/reference/encoders.md b/docs/ur/docs/reference/encoders.md deleted file mode 100644 index 28df2e43a2..0000000000 --- a/docs/ur/docs/reference/encoders.md +++ /dev/null @@ -1,3 +0,0 @@ -# Encoders - `jsonable_encoder` - -::: fastapi.encoders.jsonable_encoder diff --git a/docs/ur/docs/reference/exceptions.md b/docs/ur/docs/reference/exceptions.md deleted file mode 100644 index afa153d64e..0000000000 --- a/docs/ur/docs/reference/exceptions.md +++ /dev/null @@ -1,20 +0,0 @@ -# Exceptions - `HTTPException` اور `WebSocketException` - -یہ وہ exceptions ہیں جو آپ client کو غلطیاں دکھانے کے لیے raise کر سکتے ہیں۔ - -جب آپ کوئی exception raise کرتے ہیں، جیسا کہ عام Python میں ہوتا ہے، باقی کا عمل روک دیا جاتا ہے۔ اس طرح آپ code میں کہیں سے بھی یہ exceptions raise کر کے request کو روک سکتے ہیں اور client کو غلطی دکھا سکتے ہیں۔ - -آپ یہ استعمال کر سکتے ہیں: - -* `HTTPException` -* `WebSocketException` - -یہ exceptions براہ راست `fastapi` سے import کی جا سکتی ہیں: - -```python -from fastapi import HTTPException, WebSocketException -``` - -::: fastapi.HTTPException - -::: fastapi.WebSocketException diff --git a/docs/ur/docs/reference/fastapi.md b/docs/ur/docs/reference/fastapi.md deleted file mode 100644 index 63a7c1a8a1..0000000000 --- a/docs/ur/docs/reference/fastapi.md +++ /dev/null @@ -1,31 +0,0 @@ -# `FastAPI` class - -یہاں `FastAPI` class کی حوالہ جاتی معلومات ہیں، اس کے تمام parameters، attributes اور methods کے ساتھ۔ - -آپ `FastAPI` class کو براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import FastAPI -``` - -::: fastapi.FastAPI - options: - members: - - openapi_version - - webhooks - - state - - dependency_overrides - - openapi - - websocket - - include_router - - get - - put - - post - - delete - - options - - head - - patch - - trace - - on_event - - middleware - - exception_handler diff --git a/docs/ur/docs/reference/httpconnection.md b/docs/ur/docs/reference/httpconnection.md deleted file mode 100644 index 17bf6db4eb..0000000000 --- a/docs/ur/docs/reference/httpconnection.md +++ /dev/null @@ -1,11 +0,0 @@ -# `HTTPConnection` class - -جب آپ ایسی dependencies define کرنا چاہیں جو HTTP اور WebSockets دونوں کے ساتھ مطابقت رکھتی ہوں، تو آپ `Request` یا `WebSocket` کی بجائے `HTTPConnection` لینے والا parameter define کر سکتے ہیں۔ - -آپ اسے `fastapi.requests` سے import کر سکتے ہیں: - -```python -from fastapi.requests import HTTPConnection -``` - -::: fastapi.requests.HTTPConnection diff --git a/docs/ur/docs/reference/index.md b/docs/ur/docs/reference/index.md deleted file mode 100644 index 76f455183c..0000000000 --- a/docs/ur/docs/reference/index.md +++ /dev/null @@ -1,6 +0,0 @@ -# حوالہ جات - -یہاں حوالہ جات یا code API موجود ہے، جس میں classes، functions، parameters، attributes، اور FastAPI کے تمام وہ حصے شامل ہیں جو آپ اپنی applications میں استعمال کر سکتے ہیں۔ - -اگر آپ **FastAPI سیکھنا** چاہتے ہیں تو آپ کے لیے -[FastAPI ٹیوٹوریل](https://fastapi.tiangolo.com/tutorial/) پڑھنا زیادہ بہتر ہوگا۔ diff --git a/docs/ur/docs/reference/middleware.md b/docs/ur/docs/reference/middleware.md deleted file mode 100644 index 9d8a703e9a..0000000000 --- a/docs/ur/docs/reference/middleware.md +++ /dev/null @@ -1,37 +0,0 @@ -# Middleware - -Starlette کی طرف سے براہ راست فراہم کردہ کئی middlewares دستیاب ہیں۔ - -ان کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Middleware](https://fastapi.tiangolo.com/advanced/middleware/)۔ - -::: fastapi.middleware.cors.CORSMiddleware - -اسے `fastapi` سے import کیا جا سکتا ہے: - -```python -from fastapi.middleware.cors import CORSMiddleware -``` - -::: fastapi.middleware.gzip.GZipMiddleware - -اسے `fastapi` سے import کیا جا سکتا ہے: - -```python -from fastapi.middleware.gzip import GZipMiddleware -``` - -::: fastapi.middleware.httpsredirect.HTTPSRedirectMiddleware - -اسے `fastapi` سے import کیا جا سکتا ہے: - -```python -from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware -``` - -::: fastapi.middleware.trustedhost.TrustedHostMiddleware - -اسے `fastapi` سے import کیا جا سکتا ہے: - -```python -from fastapi.middleware.trustedhost import TrustedHostMiddleware -``` diff --git a/docs/ur/docs/reference/openapi/docs.md b/docs/ur/docs/reference/openapi/docs.md deleted file mode 100644 index 7adf91912a..0000000000 --- a/docs/ur/docs/reference/openapi/docs.md +++ /dev/null @@ -1,11 +0,0 @@ -# OpenAPI `docs` - -OpenAPI خودکار UI دستاویزات کو سنبھالنے کے لیے utilities، بشمول Swagger UI (بطور ڈیفالٹ `/docs` پر) اور ReDoc (بطور ڈیفالٹ `/redoc` پر)۔ - -::: fastapi.openapi.docs.get_swagger_ui_html - -::: fastapi.openapi.docs.get_redoc_html - -::: fastapi.openapi.docs.get_swagger_ui_oauth2_redirect_html - -::: fastapi.openapi.docs.swagger_ui_default_parameters diff --git a/docs/ur/docs/reference/openapi/index.md b/docs/ur/docs/reference/openapi/index.md deleted file mode 100644 index bde19f41dd..0000000000 --- a/docs/ur/docs/reference/openapi/index.md +++ /dev/null @@ -1,5 +0,0 @@ -# OpenAPI - -OpenAPI کو سنبھالنے کے لیے کئی utilities دستیاب ہیں۔ - -عام طور پر آپ کو انہیں استعمال کرنے کی ضرورت نہیں ہوتی جب تک کہ آپ کے پاس کوئی مخصوص جدید استعمال کا معاملہ نہ ہو جس کے لیے ان کی ضرورت ہو۔ diff --git a/docs/ur/docs/reference/openapi/models.md b/docs/ur/docs/reference/openapi/models.md deleted file mode 100644 index a8f3072aa8..0000000000 --- a/docs/ur/docs/reference/openapi/models.md +++ /dev/null @@ -1,5 +0,0 @@ -# OpenAPI `models` - -OpenAPI Pydantic models جو تیار کردہ OpenAPI کو generate اور validate کرنے کے لیے استعمال ہوتے ہیں۔ - -::: fastapi.openapi.models diff --git a/docs/ur/docs/reference/parameters.md b/docs/ur/docs/reference/parameters.md deleted file mode 100644 index e95c774bc7..0000000000 --- a/docs/ur/docs/reference/parameters.md +++ /dev/null @@ -1,35 +0,0 @@ -# Request Parameters - -یہاں request parameters کی حوالہ جاتی معلومات ہیں۔ - -یہ وہ خاص functions ہیں جو آپ *path operation function* کے parameters یا dependency functions میں `Annotated` کے ساتھ استعمال کر کے request سے ڈیٹا حاصل کر سکتے ہیں۔ - -اس میں شامل ہیں: - -* `Query()` -* `Path()` -* `Body()` -* `Cookie()` -* `Header()` -* `Form()` -* `File()` - -آپ ان سب کو براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import Body, Cookie, File, Form, Header, Path, Query -``` - -::: fastapi.Query - -::: fastapi.Path - -::: fastapi.Body - -::: fastapi.Cookie - -::: fastapi.Header - -::: fastapi.Form - -::: fastapi.File diff --git a/docs/ur/docs/reference/request.md b/docs/ur/docs/reference/request.md deleted file mode 100644 index 6174dce865..0000000000 --- a/docs/ur/docs/reference/request.md +++ /dev/null @@ -1,19 +0,0 @@ -# `Request` class - -آپ *path operation function* یا dependency میں `Request` type کا parameter declare کر سکتے ہیں اور پھر بغیر کسی validation وغیرہ کے خام request object تک براہ راست رسائی حاصل کر سکتے ہیں۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Request کو براہ راست استعمال کرنا](https://fastapi.tiangolo.com/advanced/using-request-directly/) - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import Request -``` - -/// tip | مشورہ - -جب آپ ایسی dependencies define کرنا چاہیں جو HTTP اور WebSockets دونوں کے ساتھ مطابقت رکھتی ہوں، تو آپ `Request` یا `WebSocket` کی بجائے `HTTPConnection` لینے والا parameter define کر سکتے ہیں۔ - -/// - -::: fastapi.Request diff --git a/docs/ur/docs/reference/response.md b/docs/ur/docs/reference/response.md deleted file mode 100644 index a3153ee8d6..0000000000 --- a/docs/ur/docs/reference/response.md +++ /dev/null @@ -1,15 +0,0 @@ -# `Response` class - -آپ *path operation function* یا dependency میں `Response` type کا parameter declare کر سکتے ہیں اور پھر response کے لیے ڈیٹا جیسے headers یا cookies سیٹ کر سکتے ہیں۔ - -آپ اسے براہ راست ایک instance بنانے اور اپنی *path operations* سے واپس کرنے کے لیے بھی استعمال کر سکتے ہیں۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں حسب ضرورت Response واپس کرنا](https://fastapi.tiangolo.com/advanced/response-directly/#returning-a-custom-response) - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import Response -``` - -::: fastapi.Response diff --git a/docs/ur/docs/reference/responses.md b/docs/ur/docs/reference/responses.md deleted file mode 100644 index 1507bfe128..0000000000 --- a/docs/ur/docs/reference/responses.md +++ /dev/null @@ -1,172 +0,0 @@ -# حسب ضرورت Response Classes - File، HTML، Redirect، Streaming، وغیرہ - -کئی حسب ضرورت response classes دستیاب ہیں جنہیں آپ ایک instance بنا کر اپنی *path operations* سے براہ راست واپس کر سکتے ہیں۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں حسب ضرورت Response - HTML، Stream، File، اور دیگر](https://fastapi.tiangolo.com/advanced/custom-response/)۔ - -آپ انہیں براہ راست `fastapi.responses` سے import کر سکتے ہیں: - -```python -from fastapi.responses import ( - FileResponse, - HTMLResponse, - JSONResponse, - ORJSONResponse, - PlainTextResponse, - RedirectResponse, - Response, - StreamingResponse, - UJSONResponse, -) -``` - -## FastAPI Responses - -کچھ حسب ضرورت FastAPI response classes تھیں جو JSON کی کارکردگی کو بہتر بنانے کے لیے بنائی گئی تھیں۔ - -تاہم، اب یہ deprecated ہو چکی ہیں کیونکہ اب آپ [Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/) استعمال کر کے بہتر کارکردگی حاصل کر سکتے ہیں۔ - -اس طرح، Pydantic ڈیٹا کو Rust کی طرف JSON bytes میں serialize کرے گا، جو ان حسب ضرورت JSON responses سے بہتر کارکردگی فراہم کرے گا۔ - -اس کے بارے میں مزید پڑھیں [حسب ضرورت Response - HTML، Stream، File، اور دیگر - `orjson` یا Response Model](https://fastapi.tiangolo.com/advanced/custom-response/#orjson-or-response-model)۔ - -::: fastapi.responses.UJSONResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.ORJSONResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -## Starlette Responses - -آپ ان سب کے بارے میں مزید پڑھ سکتے ہیں [FastAPI دستاویزات میں حسب ضرورت Response](https://fastapi.tiangolo.com/advanced/custom-response/) اور [Starlette دستاویزات میں Responses](https://starlette.dev/responses/)۔ - -::: fastapi.responses.FileResponse - options: - members: - - chunk_size - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.HTMLResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.JSONResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.PlainTextResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.RedirectResponse - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.Response - options: - members: - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie - -::: fastapi.responses.StreamingResponse - options: - members: - - body_iterator - - charset - - status_code - - media_type - - body - - background - - raw_headers - - render - - init_headers - - headers - - set_cookie - - delete_cookie diff --git a/docs/ur/docs/reference/security/index.md b/docs/ur/docs/reference/security/index.md deleted file mode 100644 index 534c0f7faa..0000000000 --- a/docs/ur/docs/reference/security/index.md +++ /dev/null @@ -1,75 +0,0 @@ -# Security ٹولز - -جب آپ کو OAuth2 scopes کے ساتھ dependencies declare کرنی ہوں تو آپ `Security()` استعمال کرتے ہیں۔ - -لیکن آپ کو پھر بھی یہ define کرنا ہوگا کہ dependable کیا ہے، یعنی وہ callable جو آپ `Depends()` یا `Security()` کو parameter کے طور پر دیتے ہیں۔ - -ایسے dependables بنانے کے لیے کئی ٹولز دستیاب ہیں، اور یہ OpenAPI میں ضم ہو جاتے ہیں تاکہ یہ خودکار docs UI میں دکھائے جائیں، خودکار طور پر بنائے گئے clients اور SDKs کے ذریعے استعمال ہو سکیں، وغیرہ۔ - -آپ انہیں `fastapi.security` سے import کر سکتے ہیں: - -```python -from fastapi.security import ( - APIKeyCookie, - APIKeyHeader, - APIKeyQuery, - HTTPAuthorizationCredentials, - HTTPBasic, - HTTPBasicCredentials, - HTTPBearer, - HTTPDigest, - OAuth2, - OAuth2AuthorizationCodeBearer, - OAuth2PasswordBearer, - OAuth2PasswordRequestForm, - OAuth2PasswordRequestFormStrict, - OpenIdConnect, - SecurityScopes, -) -``` - -ان کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Security](https://fastapi.tiangolo.com/tutorial/security/)۔ - -## API Key Security Schemes - -::: fastapi.security.APIKeyCookie - -::: fastapi.security.APIKeyHeader - -::: fastapi.security.APIKeyQuery - -## HTTP Authentication Schemes - -::: fastapi.security.HTTPBasic - -::: fastapi.security.HTTPBearer - -::: fastapi.security.HTTPDigest - -## HTTP Credentials - -::: fastapi.security.HTTPAuthorizationCredentials - -::: fastapi.security.HTTPBasicCredentials - -## OAuth2 Authentication - -::: fastapi.security.OAuth2 - -::: fastapi.security.OAuth2AuthorizationCodeBearer - -::: fastapi.security.OAuth2PasswordBearer - -## OAuth2 Password Form - -::: fastapi.security.OAuth2PasswordRequestForm - -::: fastapi.security.OAuth2PasswordRequestFormStrict - -## OAuth2 Security Scopes میں Dependencies - -::: fastapi.security.SecurityScopes - -## OpenID Connect - -::: fastapi.security.OpenIdConnect diff --git a/docs/ur/docs/reference/staticfiles.md b/docs/ur/docs/reference/staticfiles.md deleted file mode 100644 index 2049953897..0000000000 --- a/docs/ur/docs/reference/staticfiles.md +++ /dev/null @@ -1,13 +0,0 @@ -# Static Files - `StaticFiles` - -آپ `StaticFiles` class کو static files فراہم کرنے کے لیے استعمال کر سکتے ہیں، جیسے JavaScript، CSS، تصاویر، وغیرہ۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Static Files](https://fastapi.tiangolo.com/tutorial/static-files/)۔ - -آپ اسے براہ راست `fastapi.staticfiles` سے import کر سکتے ہیں: - -```python -from fastapi.staticfiles import StaticFiles -``` - -::: fastapi.staticfiles.StaticFiles diff --git a/docs/ur/docs/reference/status.md b/docs/ur/docs/reference/status.md deleted file mode 100644 index ba04f7f538..0000000000 --- a/docs/ur/docs/reference/status.md +++ /dev/null @@ -1,36 +0,0 @@ -# Status Codes - -آپ `status` module کو `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import status -``` - -`status` براہ راست Starlette کی طرف سے فراہم کیا گیا ہے۔ - -اس میں نامزد constants (variables) کا ایک گروپ ہے جن کی قدریں integer status codes ہیں۔ - -مثال کے طور پر: - -* 200: `status.HTTP_200_OK` -* 403: `status.HTTP_403_FORBIDDEN` -* وغیرہ۔ - -یہ آپ کی app میں HTTP (اور WebSocket) status codes تک فوری رسائی کے لیے آسان ہو سکتا ہے، نام کے لیے autocompletion استعمال کرتے ہوئے بغیر integer status codes یاد رکھنے کی ضرورت کے۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/)۔ - -## مثال - -```python -from fastapi import FastAPI, status - -app = FastAPI() - - -@app.get("/items/", status_code=status.HTTP_418_IM_A_TEAPOT) -def read_items(): - return [{"name": "Plumbus"}, {"name": "Portal Gun"}] -``` - -::: fastapi.status diff --git a/docs/ur/docs/reference/templating.md b/docs/ur/docs/reference/templating.md deleted file mode 100644 index 4b82552597..0000000000 --- a/docs/ur/docs/reference/templating.md +++ /dev/null @@ -1,13 +0,0 @@ -# Templating - `Jinja2Templates` - -آپ `Jinja2Templates` class کو Jinja templates render کرنے کے لیے استعمال کر سکتے ہیں۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Templates](https://fastapi.tiangolo.com/advanced/templates/)۔ - -آپ اسے براہ راست `fastapi.templating` سے import کر سکتے ہیں: - -```python -from fastapi.templating import Jinja2Templates -``` - -::: fastapi.templating.Jinja2Templates diff --git a/docs/ur/docs/reference/testclient.md b/docs/ur/docs/reference/testclient.md deleted file mode 100644 index dfecf5aab2..0000000000 --- a/docs/ur/docs/reference/testclient.md +++ /dev/null @@ -1,13 +0,0 @@ -# Test Client - `TestClient` - -آپ `TestClient` class کو FastAPI applications کی جانچ کرنے کے لیے استعمال کر سکتے ہیں بغیر کوئی حقیقی HTTP اور socket connection بنائے، بس FastAPI code کے ساتھ براہ راست بات چیت کر کے۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں Testing](https://fastapi.tiangolo.com/tutorial/testing/)۔ - -آپ اسے براہ راست `fastapi.testclient` سے import کر سکتے ہیں: - -```python -from fastapi.testclient import TestClient -``` - -::: fastapi.testclient.TestClient diff --git a/docs/ur/docs/reference/uploadfile.md b/docs/ur/docs/reference/uploadfile.md deleted file mode 100644 index 2d7458281e..0000000000 --- a/docs/ur/docs/reference/uploadfile.md +++ /dev/null @@ -1,22 +0,0 @@ -# `UploadFile` class - -آپ *path operation function* کے parameters کو `UploadFile` type کا define کر سکتے ہیں تاکہ request سے files وصول کی جا سکیں۔ - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import UploadFile -``` - -::: fastapi.UploadFile - options: - members: - - file - - filename - - size - - headers - - content_type - - read - - write - - seek - - close diff --git a/docs/ur/docs/reference/websockets.md b/docs/ur/docs/reference/websockets.md deleted file mode 100644 index fd2028b97e..0000000000 --- a/docs/ur/docs/reference/websockets.md +++ /dev/null @@ -1,73 +0,0 @@ -# WebSockets - -WebSockets define کرتے وقت، آپ عام طور پر `WebSocket` type کا parameter declare کرتے ہیں اور اس کے ذریعے client سے ڈیٹا پڑھ سکتے ہیں اور اسے ڈیٹا بھیج سکتے ہیں۔ - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں WebSockets](https://fastapi.tiangolo.com/advanced/websockets/) - -یہ Starlette کی طرف سے براہ راست فراہم کیا گیا ہے، لیکن آپ اسے `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import WebSocket -``` - -/// tip | مشورہ - -جب آپ ایسی dependencies define کرنا چاہیں جو HTTP اور WebSockets دونوں کے ساتھ مطابقت رکھتی ہوں، تو آپ `Request` یا `WebSocket` کی بجائے `HTTPConnection` لینے والا parameter define کر سکتے ہیں۔ - -/// - -::: fastapi.WebSocket - options: - members: - - scope - - app - - url - - base_url - - headers - - query_params - - path_params - - cookies - - client - - state - - url_for - - client_state - - application_state - - receive - - send - - accept - - receive_text - - receive_bytes - - receive_json - - iter_text - - iter_bytes - - iter_json - - send_text - - send_bytes - - send_json - - close - -## WebSockets - اضافی classes - -WebSockets کو سنبھالنے کے لیے اضافی classes۔ - -Starlette کی طرف سے براہ راست فراہم کی گئی ہیں، لیکن آپ انہیں `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi.websockets import WebSocketDisconnect, WebSocketState -``` - -::: fastapi.websockets.WebSocketDisconnect - -جب کوئی client منقطع ہوتا ہے تو `WebSocketDisconnect` exception raise ہوتا ہے، آپ اسے catch کر سکتے ہیں۔ - -آپ اسے براہ راست `fastapi` سے import کر سکتے ہیں: - -```python -from fastapi import WebSocketDisconnect -``` - -اس کے بارے میں مزید پڑھیں [FastAPI دستاویزات میں WebSockets](https://fastapi.tiangolo.com/advanced/websockets/#handling-disconnections-and-multiple-clients) - -::: fastapi.websockets.WebSocketState - -`WebSocketState` ایک enumeration ہے جو WebSocket connection کی ممکنہ حالتوں کو ظاہر کرتا ہے۔ diff --git a/docs/ur/docs/release-notes.md b/docs/ur/docs/release-notes.md deleted file mode 100644 index 96f8498f2c..0000000000 --- a/docs/ur/docs/release-notes.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -hide: - - navigation ---- - -# ریلیز نوٹس diff --git a/docs/ur/docs/translation-banner.md b/docs/ur/docs/translation-banner.md index 991e46fdae..282371417f 100644 --- a/docs/ur/docs/translation-banner.md +++ b/docs/ur/docs/translation-banner.md @@ -4,7 +4,7 @@ اس میں اصل معنی کی غلط تشریح یا غیر فطری زبان جیسی خامیاں ہو سکتی ہیں۔ 🤖 -آپ [مصنوعی ذہانت LLM کو بہتر رہنمائی دینے میں ہماری مدد کر کے](https://fastapi.tiangolo.com/contributing/#translations) اس ترجمے کو بہتر بنا سکتے ہیں۔ +آپ [مصنوعی ذہانت LLM کو بہتر رہنمائی دینے میں ہماری مدد کر کے](https://fastapi.tiangolo.com/ur/contributing/#translations) اس ترجمے کو بہتر بنا سکتے ہیں۔ [انگریزی نسخہ](ENGLISH_VERSION_URL) diff --git a/docs/ur/docs/tutorial/bigger-applications.md b/docs/ur/docs/tutorial/bigger-applications.md index ad0b0d6156..d706ddeba1 100644 --- a/docs/ur/docs/tutorial/bigger-applications.md +++ b/docs/ur/docs/tutorial/bigger-applications.md @@ -17,16 +17,16 @@ ``` . ├── app -│ ├── __init__.py -│ ├── main.py -│ ├── dependencies.py -│ └── routers -│ │ ├── __init__.py -│ │ ├── items.py -│ │ └── users.py -│ └── internal -│ ├── __init__.py -│ └── admin.py +│   ├── __init__.py +│   ├── main.py +│   ├── dependencies.py +│   └── routers +│   │ ├── __init__.py +│   │ ├── items.py +│   │ └── users.py +│   └── internal +│   ├── __init__.py +│   └── admin.py ``` /// tip | مشورہ @@ -59,16 +59,16 @@ from app.routers import items ```bash . ├── app # "app" is a Python package -│ ├── __init__.py # this file makes "app" a "Python package" -│ ├── main.py # "main" module, e.g. import app.main -│ ├── dependencies.py # "dependencies" module, e.g. import app.dependencies -│ └── routers # "routers" is a "Python subpackage" -│ │ ├── __init__.py # makes "routers" a "Python subpackage" -│ │ ├── items.py # "items" submodule, e.g. import app.routers.items -│ │ └── users.py # "users" submodule, e.g. import app.routers.users -│ └── internal # "internal" is a "Python subpackage" -│ ├── __init__.py # makes "internal" a "Python subpackage" -│ └── admin.py # "admin" submodule, e.g. import app.internal.admin +│   ├── __init__.py # this file makes "app" a "Python package" +│   ├── main.py # "main" module, e.g. import app.main +│   ├── dependencies.py # "dependencies" module, e.g. import app.dependencies +│   └── routers # "routers" is a "Python subpackage" +│   │ ├── __init__.py # makes "routers" a "Python subpackage" +│   │ ├── items.py # "items" submodule, e.g. import app.routers.items +│   │ └── users.py # "users" submodule, e.g. import app.routers.users +│   └── internal # "internal" is a "Python subpackage" +│   ├── __init__.py # makes "internal" a "Python subpackage" +│   └── admin.py # "admin" submodule, e.g. import app.internal.admin ``` ## `APIRouter` { #apirouter } diff --git a/docs/ur/docs/tutorial/first-steps.md b/docs/ur/docs/tutorial/first-steps.md index 15760a7ea5..02606a37e0 100644 --- a/docs/ur/docs/tutorial/first-steps.md +++ b/docs/ur/docs/tutorial/first-steps.md @@ -163,8 +163,8 @@ from main import app ``` . ├── backend -│ ├── main.py -│ ├── __init__.py +│   ├── main.py +│   ├── __init__.py ``` تو آپ `entrypoint` اس طرح سیٹ کریں گے: diff --git a/docs/ur/docs/tutorial/testing.md b/docs/ur/docs/tutorial/testing.md index 20d2777661..08608657eb 100644 --- a/docs/ur/docs/tutorial/testing.md +++ b/docs/ur/docs/tutorial/testing.md @@ -69,8 +69,8 @@ $ pip install httpx ``` . ├── app -│ ├── __init__.py -│ └── main.py +│   ├── __init__.py +│   └── main.py ``` فائل `main.py` میں آپ کی **FastAPI** app ہے: @@ -84,9 +84,9 @@ $ pip install httpx ``` hl_lines="5" . ├── app -│ ├── __init__.py -│ ├── main.py -│ └── test_main.py +│   ├── __init__.py +│   ├── main.py +│   └── test_main.py ``` چونکہ یہ فائل اسی package میں ہے، آپ `main` module (`main.py`) سے object `app` import کرنے کے لیے relative imports استعمال کر سکتے ہیں: @@ -106,9 +106,9 @@ $ pip install httpx ``` . ├── app -│ ├── __init__.py -│ ├── main.py -│ └── test_main.py +│   ├── __init__.py +│   ├── main.py +│   └── test_main.py ``` فرض کریں اب فائل `main.py` آپ کی **FastAPI** app کے ساتھ کچھ اور **path operations** رکھتی ہے۔