Aleksei Kotenko
6 months ago
committed by
GitHub
GitHub
991 changed files with 56110 additions and 33698 deletions
@ -0,0 +1,38 @@ |
|||||
|
docs: |
||||
|
- all: |
||||
|
- changed-files: |
||||
|
- any-glob-to-any-file: |
||||
|
- docs/en/docs/** |
||||
|
- docs_src/** |
||||
|
- all-globs-to-all-files: |
||||
|
- '!fastapi/**' |
||||
|
- '!pyproject.toml' |
||||
|
- '!docs/en/data/sponsors.yml' |
||||
|
- '!docs/en/overrides/main.html' |
||||
|
|
||||
|
lang-all: |
||||
|
- all: |
||||
|
- changed-files: |
||||
|
- any-glob-to-any-file: |
||||
|
- docs/*/docs/** |
||||
|
- all-globs-to-all-files: |
||||
|
- '!docs/en/docs/**' |
||||
|
- '!fastapi/**' |
||||
|
- '!pyproject.toml' |
||||
|
|
||||
|
internal: |
||||
|
- all: |
||||
|
- changed-files: |
||||
|
- any-glob-to-any-file: |
||||
|
- .github/** |
||||
|
- scripts/** |
||||
|
- .gitignore |
||||
|
- .pre-commit-config.yaml |
||||
|
- pdm_build.py |
||||
|
- requirements*.txt |
||||
|
- docs/en/data/sponsors.yml |
||||
|
- docs/en/overrides/main.html |
||||
|
- all-globs-to-all-files: |
||||
|
- '!docs/*/docs/**' |
||||
|
- '!fastapi/**' |
||||
|
- '!pyproject.toml' |
||||
@ -0,0 +1,18 @@ |
|||||
|
name: Add to Project |
||||
|
|
||||
|
on: |
||||
|
pull_request_target: |
||||
|
issues: |
||||
|
types: |
||||
|
- opened |
||||
|
- reopened |
||||
|
|
||||
|
jobs: |
||||
|
add-to-project: |
||||
|
name: Add to project |
||||
|
runs-on: ubuntu-latest |
||||
|
steps: |
||||
|
- uses: actions/[email protected] |
||||
|
with: |
||||
|
project-url: https://github.com/orgs/fastapi/projects/2 |
||||
|
github-token: ${{ secrets.PROJECTS_TOKEN }} |
||||
@ -2,7 +2,7 @@ name: Issue Manager |
|||||
|
|
||||
on: |
on: |
||||
schedule: |
schedule: |
||||
- cron: "10 3 * * *" |
- cron: "13 22 * * *" |
||||
issue_comment: |
issue_comment: |
||||
types: |
types: |
||||
- created |
- created |
||||
@ -16,6 +16,7 @@ on: |
|||||
|
|
||||
permissions: |
permissions: |
||||
issues: write |
issues: write |
||||
|
pull-requests: write |
||||
|
|
||||
jobs: |
jobs: |
||||
issue-manager: |
issue-manager: |
||||
@ -26,7 +27,7 @@ jobs: |
|||||
env: |
env: |
||||
GITHUB_CONTEXT: ${{ toJson(github) }} |
GITHUB_CONTEXT: ${{ toJson(github) }} |
||||
run: echo "$GITHUB_CONTEXT" |
run: echo "$GITHUB_CONTEXT" |
||||
- uses: tiangolo/[email protected].0 |
- uses: tiangolo/[email protected].1 |
||||
with: |
with: |
||||
token: ${{ secrets.GITHUB_TOKEN }} |
token: ${{ secrets.GITHUB_TOKEN }} |
||||
config: > |
config: > |
||||
@ -35,8 +36,8 @@ jobs: |
|||||
"delay": 864000, |
"delay": 864000, |
||||
"message": "Assuming the original need was handled, this will be automatically closed now. But feel free to add more comments or create new issues or PRs." |
"message": "Assuming the original need was handled, this will be automatically closed now. But feel free to add more comments or create new issues or PRs." |
||||
}, |
}, |
||||
"changes-requested": { |
"waiting": { |
||||
"delay": 2628000, |
"delay": 2628000, |
||||
"message": "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." |
"message": "As this PR has been waiting for the original user for a while but seems to be inactive, it's now going to be closed. But if there's anyone interested, feel free to create a new PR." |
||||
} |
} |
||||
} |
} |
||||
|
|||||
@ -0,0 +1,33 @@ |
|||||
|
name: Labels |
||||
|
on: |
||||
|
pull_request_target: |
||||
|
types: |
||||
|
- opened |
||||
|
- synchronize |
||||
|
- reopened |
||||
|
# For label-checker |
||||
|
- labeled |
||||
|
- unlabeled |
||||
|
|
||||
|
jobs: |
||||
|
labeler: |
||||
|
permissions: |
||||
|
contents: read |
||||
|
pull-requests: write |
||||
|
runs-on: ubuntu-latest |
||||
|
steps: |
||||
|
- uses: actions/labeler@v5 |
||||
|
if: ${{ github.event.action != 'labeled' && github.event.action != 'unlabeled' }} |
||||
|
- run: echo "Done adding labels" |
||||
|
# Run this after labeler applied labels |
||||
|
check-labels: |
||||
|
needs: |
||||
|
- labeler |
||||
|
permissions: |
||||
|
pull-requests: read |
||||
|
runs-on: ubuntu-latest |
||||
|
steps: |
||||
|
- uses: docker://agilepathway/pull-request-label-checker:latest |
||||
|
with: |
||||
|
one_of: breaking,security,feature,bug,refactor,upgrade,docs,lang-all,internal |
||||
|
repo_token: ${{ secrets.GITHUB_TOKEN }} |
||||
@ -34,8 +34,7 @@ jobs: |
|||||
if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }} |
if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }} |
||||
with: |
with: |
||||
limit-access-to-actor: true |
limit-access-to-actor: true |
||||
- uses: docker://tiangolo/latest-changes:0.3.0 |
- uses: tiangolo/[email protected] |
||||
# - uses: tiangolo/latest-changes@main |
|
||||
with: |
with: |
||||
token: ${{ secrets.GITHUB_TOKEN }} |
token: ${{ secrets.GITHUB_TOKEN }} |
||||
latest_changes_file: docs/en/docs/release-notes.md |
latest_changes_file: docs/en/docs/release-notes.md |
||||
|
|||||
@ -1,185 +0,0 @@ |
|||||
--- |
|
||||
hide: |
|
||||
- navigation |
|
||||
--- |
|
||||
|
|
||||
# FastAPI İnsanlar |
|
||||
|
|
||||
FastAPI-ın bütün mənşəli insanları qəbul edən heyrətamiz icması var. |
|
||||
|
|
||||
|
|
||||
|
|
||||
## Yaradıcı - İcraçı |
|
||||
|
|
||||
Salam! 👋 |
|
||||
|
|
||||
Bu mənəm: |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.maintainers %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Cavablar: {{ user.answers }}</div><div class="count">Pull Request-lər: {{ user.prs }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
Mən **FastAPI**-ın yaradıcısı və icraçısıyam. Əlavə məlumat almaq üçün [Yardım FastAPI - Yardım alın - Müəlliflə əlaqə qurun](help-fastapi.md#connect-with-the-author){.internal-link target=_blank} səhifəsinə baxa bilərsiniz. |
|
||||
|
|
||||
...Burada isə sizə icmanı göstərmək istəyirəm. |
|
||||
|
|
||||
--- |
|
||||
|
|
||||
**FastAPI** icmadan çoxlu dəstək alır və mən onların əməyini vurğulamaq istəyirəm. |
|
||||
|
|
||||
Bu insanlar: |
|
||||
|
|
||||
* [GitHub-da başqalarının suallarına kömək edirlər](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank}. |
|
||||
* [Pull Request-lər yaradırlar](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}. |
|
||||
* Pull Request-ləri ([xüsusilə tərcümələr üçün vacib olan](contributing.md#translations){.internal-link target=_blank}.) nəzərdən keçirirlər. |
|
||||
|
|
||||
Bu insanlara təşəkkür edirəm. 👏 🙇 |
|
||||
|
|
||||
## Keçən ayın ən fəal istifadəçiləri |
|
||||
|
|
||||
Bu istifadəçilər keçən ay [GitHub-da başqalarının suallarına](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank} ən çox kömək edənlərdir. ☕ |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.last_month_experts[:10] %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Cavablandırılmış suallar: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Mütəxəssislər |
|
||||
|
|
||||
Burada **FastAPI Mütəxəssisləri** var. 🤓 |
|
||||
|
|
||||
Bu istifadəçilər indiyə qədər [GitHub-da başqalarının suallarına](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank} ən çox kömək edənlərdir. |
|
||||
|
|
||||
Onlar bir çox insanlara kömək edərək mütəxəssis olduqlarını sübut ediblər. ✨ |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.experts[:50] %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Cavablandırılmış suallar: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Ən yaxşı əməkdaşlar |
|
||||
|
|
||||
Burada **Ən yaxşı əməkdaşlar** var. 👷 |
|
||||
|
|
||||
Bu istifadəçilərin ən çox *birləşdirilmiş* [Pull Request-ləri var](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}. |
|
||||
|
|
||||
Onlar mənbə kodu, sənədləmə, tərcümələr və s. barədə əmək göstərmişlər. 📦 |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.top_contributors[:50] %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Pull Request-lər: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
Bundan başqa bir neçə (yüzdən çox) əməkdaş var ki, onları <a href="https://github.com/fastapi/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Əməkdaşlar səhifəsində</a> görə bilərsiniz. 👷 |
|
||||
|
|
||||
## Ən çox rəy verənlər |
|
||||
|
|
||||
Bu istifadəçilər **ən çox rəy verənlər**dir. |
|
||||
|
|
||||
### Tərcümələr üçün rəylər |
|
||||
|
|
||||
Mən yalnız bir neçə dildə danışıram (və çox da yaxşı deyil 😅). Bu səbəbdən, rəy verənlər sənədlərin [**tərcümələrini təsdiqləmək üçün gücə malik olanlar**](contributing.md#translations){.internal-link target=_blank}dır. Onlar olmadan, bir çox dilə tərcümə olunmuş sənədlər olmazdı. |
|
||||
|
|
||||
--- |
|
||||
|
|
||||
Başqalarının Pull Request-lərinə **Ən çox rəy verənlər** 🕵️ kodun, sənədlərin və xüsusilə də **tərcümələrin** keyfiyyətini təmin edirlər. |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.top_translations_reviewers[:50] %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Rəylər: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Sponsorlar |
|
||||
|
|
||||
Bunlar **Sponsorlar**dır. 😎 |
|
||||
|
|
||||
Onlar mənim **FastAPI** (və digər) işlərimi əsasən <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub Sponsorlar</a> vasitəsilə dəstəkləyirlər. |
|
||||
|
|
||||
{% if sponsors %} |
|
||||
|
|
||||
{% if sponsors.gold %} |
|
||||
|
|
||||
### Qızıl Sponsorlar |
|
||||
|
|
||||
{% for sponsor in sponsors.gold -%} |
|
||||
<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a> |
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
{% if sponsors.silver %} |
|
||||
|
|
||||
### Gümüş Sponsorlar |
|
||||
|
|
||||
{% for sponsor in sponsors.silver -%} |
|
||||
<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a> |
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
{% if sponsors.bronze %} |
|
||||
|
|
||||
### Bürünc Sponsorlar |
|
||||
|
|
||||
{% for sponsor in sponsors.bronze -%} |
|
||||
<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a> |
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
{% endif %} |
|
||||
|
|
||||
### Fərdi Sponsorlar |
|
||||
|
|
||||
{% if github_sponsors %} |
|
||||
{% for group in github_sponsors.sponsors %} |
|
||||
|
|
||||
<div class="user-list user-list-center"> |
|
||||
|
|
||||
{% for user in group %} |
|
||||
{% if user.login not in sponsors_badge.logins %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a></div> |
|
||||
|
|
||||
{% endif %} |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
|
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
## Məlumatlar haqqında - texniki detallar |
|
||||
|
|
||||
Bu səhifənin əsas məqsədi, icmanın başqalarına kömək etmək üçün göstərdiyi əməyi vurğulamaqdır. |
|
||||
|
|
||||
Xüsusilə də normalda daha az görünən və bir çox hallarda daha çətin olan, başqalarının suallarına kömək etmək və tərcümələrlə bağlı Pull Request-lərə rəy vermək kimi səy göstərmək. |
|
||||
|
|
||||
Bu səhifənin məlumatları hər ay hesablanır və siz <a href="https://github.com/fastapi/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">buradan mənbə kodunu</a> oxuya bilərsiniz. |
|
||||
|
|
||||
Burada sponsorların əməyini də vurğulamaq istəyirəm. |
|
||||
|
|
||||
Mən həmçinin alqoritmi, bölmələri, eşikləri və s. yeniləmək hüququnu da qoruyuram (hər ehtimala qarşı 🤷). |
|
||||
@ -8,14 +8,17 @@ Aus diesem Grund werden diese üblicherweise in Umgebungsvariablen bereitgestell |
|||||
|
|
||||
## Umgebungsvariablen |
## Umgebungsvariablen |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Wenn Sie bereits wissen, was „Umgebungsvariablen“ sind und wie man sie verwendet, können Sie gerne mit dem nächsten Abschnitt weiter unten fortfahren. |
Wenn Sie bereits wissen, was „Umgebungsvariablen“ sind und wie man sie verwendet, können Sie gerne mit dem nächsten Abschnitt weiter unten fortfahren. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Eine <a href="https://de.wikipedia.org/wiki/Umgebungsvariable" class="external-link" target="_blank">Umgebungsvariable</a> (auch bekannt als „env var“) ist eine Variable, die sich außerhalb des Python-Codes im Betriebssystem befindet und von Ihrem Python-Code (oder auch von anderen Programmen) gelesen werden kann. |
Eine <a href="https://de.wikipedia.org/wiki/Umgebungsvariable" class="external-link" target="_blank">Umgebungsvariable</a> (auch bekannt als „env var“) ist eine Variable, die sich außerhalb des Python-Codes im Betriebssystem befindet und von Ihrem Python-Code (oder auch von anderen Programmen) gelesen werden kann. |
||||
|
|
||||
Sie können Umgebungsvariablen in der Shell erstellen und verwenden, ohne Python zu benötigen: |
Sie können Umgebungsvariablen in der Shell erstellen und verwenden, ohne Python zu benötigen: |
||||
|
|
||||
=== "Linux, macOS, Windows Bash" |
//// tab | Linux, macOS, Windows Bash |
||||
|
|
||||
<div class="termy"> |
<div class="termy"> |
||||
|
|
||||
@ -31,7 +34,9 @@ Sie können Umgebungsvariablen in der Shell erstellen und verwenden, ohne Python |
|||||
|
|
||||
</div> |
</div> |
||||
|
|
||||
=== "Windows PowerShell" |
//// |
||||
|
|
||||
|
//// tab | Windows PowerShell |
||||
|
|
||||
<div class="termy"> |
<div class="termy"> |
||||
|
|
||||
@ -47,6 +52,8 @@ Sie können Umgebungsvariablen in der Shell erstellen und verwenden, ohne Python |
|||||
|
|
||||
</div> |
</div> |
||||
|
|
||||
|
//// |
||||
|
|
||||
### Umgebungsvariablen mit Python auslesen |
### Umgebungsvariablen mit Python auslesen |
||||
|
|
||||
Sie können Umgebungsvariablen auch außerhalb von Python im Terminal (oder mit einer anderen Methode) erstellen und diese dann mit Python auslesen. |
Sie können Umgebungsvariablen auch außerhalb von Python im Terminal (oder mit einer anderen Methode) erstellen und diese dann mit Python auslesen. |
||||
@ -60,11 +67,14 @@ name = os.getenv("MY_NAME", "World") |
|||||
print(f"Hello {name} from Python") |
print(f"Hello {name} from Python") |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Das zweite Argument für <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> ist der zurückzugebende Defaultwert. |
Das zweite Argument für <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> ist der zurückzugebende Defaultwert. |
||||
|
|
||||
Wenn nicht angegeben, ist er standardmäßig `None`. Hier übergeben wir `"World"` als Defaultwert. |
Wenn nicht angegeben, ist er standardmäßig `None`. Hier übergeben wir `"World"` als Defaultwert. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Dann könnten Sie dieses Python-Programm aufrufen: |
Dann könnten Sie dieses Python-Programm aufrufen: |
||||
|
|
||||
<div class="termy"> |
<div class="termy"> |
||||
@ -114,9 +124,12 @@ Hello World from Python |
|||||
|
|
||||
</div> |
</div> |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Weitere Informationen dazu finden Sie unter <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>. |
Weitere Informationen dazu finden Sie unter <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>. |
||||
|
|
||||
|
/// |
||||
|
|
||||
### Typen und Validierung |
### Typen und Validierung |
||||
|
|
||||
Diese Umgebungsvariablen können nur Text-Zeichenketten verarbeiten, da sie außerhalb von Python liegen und mit anderen Programmen und dem Rest des Systems (und sogar mit verschiedenen Betriebssystemen wie Linux, Windows, macOS) kompatibel sein müssen. |
Diese Umgebungsvariablen können nur Text-Zeichenketten verarbeiten, da sie außerhalb von Python liegen und mit anderen Programmen und dem Rest des Systems (und sogar mit verschiedenen Betriebssystemen wie Linux, Windows, macOS) kompatibel sein müssen. |
||||
@ -151,9 +164,12 @@ $ pip install "fastapi[all]" |
|||||
|
|
||||
</div> |
</div> |
||||
|
|
||||
!!! info |
/// info |
||||
|
|
||||
In Pydantic v1 war das im Hauptpackage enthalten. Jetzt wird es als unabhängiges Package verteilt, sodass Sie wählen können, ob Sie es installieren möchten oder nicht, falls Sie die Funktionalität nicht benötigen. |
In Pydantic v1 war das im Hauptpackage enthalten. Jetzt wird es als unabhängiges Package verteilt, sodass Sie wählen können, ob Sie es installieren möchten oder nicht, falls Sie die Funktionalität nicht benötigen. |
||||
|
|
||||
|
/// |
||||
|
|
||||
### Das `Settings`-Objekt erstellen |
### Das `Settings`-Objekt erstellen |
||||
|
|
||||
Importieren Sie `BaseSettings` aus Pydantic und erstellen Sie eine Unterklasse, ganz ähnlich wie bei einem Pydantic-Modell. |
Importieren Sie `BaseSettings` aus Pydantic und erstellen Sie eine Unterklasse, ganz ähnlich wie bei einem Pydantic-Modell. |
||||
@ -162,24 +178,34 @@ Auf die gleiche Weise wie bei Pydantic-Modellen deklarieren Sie Klassenattribute |
|||||
|
|
||||
Sie können dieselben Validierungs-Funktionen und -Tools verwenden, die Sie für Pydantic-Modelle verwenden, z. B. verschiedene Datentypen und zusätzliche Validierungen mit `Field()`. |
Sie können dieselben Validierungs-Funktionen und -Tools verwenden, die Sie für Pydantic-Modelle verwenden, z. B. verschiedene Datentypen und zusätzliche Validierungen mit `Field()`. |
||||
|
|
||||
=== "Pydantic v2" |
//// tab | Pydantic v2 |
||||
|
|
||||
```Python hl_lines="2 5-8 11" |
```Python hl_lines="2 5-8 11" |
||||
{!> ../../../docs_src/settings/tutorial001.py!} |
{!> ../../docs_src/settings/tutorial001.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Pydantic v1" |
//// |
||||
|
|
||||
|
//// tab | Pydantic v1 |
||||
|
|
||||
|
/// info |
||||
|
|
||||
!!! info |
|
||||
In Pydantic v1 würden Sie `BaseSettings` direkt von `pydantic` statt von `pydantic_settings` importieren. |
In Pydantic v1 würden Sie `BaseSettings` direkt von `pydantic` statt von `pydantic_settings` importieren. |
||||
|
|
||||
|
/// |
||||
|
|
||||
```Python hl_lines="2 5-8 11" |
```Python hl_lines="2 5-8 11" |
||||
{!> ../../../docs_src/settings/tutorial001_pv1.py!} |
{!> ../../docs_src/settings/tutorial001_pv1.py!} |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
//// |
||||
|
|
||||
|
/// tip | "Tipp" |
||||
|
|
||||
Für ein schnelles Copy-and-paste verwenden Sie nicht dieses Beispiel, sondern das letzte unten. |
Für ein schnelles Copy-and-paste verwenden Sie nicht dieses Beispiel, sondern das letzte unten. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Wenn Sie dann eine Instanz dieser `Settings`-Klasse erstellen (in diesem Fall als `settings`-Objekt), liest Pydantic die Umgebungsvariablen ohne Berücksichtigung der Groß- und Kleinschreibung. Eine Variable `APP_NAME` in Großbuchstaben wird also als Attribut `app_name` gelesen. |
Wenn Sie dann eine Instanz dieser `Settings`-Klasse erstellen (in diesem Fall als `settings`-Objekt), liest Pydantic die Umgebungsvariablen ohne Berücksichtigung der Groß- und Kleinschreibung. Eine Variable `APP_NAME` in Großbuchstaben wird also als Attribut `app_name` gelesen. |
||||
|
|
||||
Als Nächstes werden die Daten konvertiert und validiert. Wenn Sie also dieses `settings`-Objekt verwenden, verfügen Sie über Daten mit den von Ihnen deklarierten Typen (z. B. ist `items_per_user` ein `int`). |
Als Nächstes werden die Daten konvertiert und validiert. Wenn Sie also dieses `settings`-Objekt verwenden, verfügen Sie über Daten mit den von Ihnen deklarierten Typen (z. B. ist `items_per_user` ein `int`). |
||||
@ -189,7 +215,7 @@ Als Nächstes werden die Daten konvertiert und validiert. Wenn Sie also dieses ` |
|||||
Dann können Sie das neue `settings`-Objekt in Ihrer Anwendung verwenden: |
Dann können Sie das neue `settings`-Objekt in Ihrer Anwendung verwenden: |
||||
|
|
||||
```Python hl_lines="18-20" |
```Python hl_lines="18-20" |
||||
{!../../../docs_src/settings/tutorial001.py!} |
{!../../docs_src/settings/tutorial001.py!} |
||||
``` |
``` |
||||
|
|
||||
### Den Server ausführen |
### Den Server ausführen |
||||
@ -206,9 +232,12 @@ $ ADMIN_EMAIL="[email protected]" APP_NAME="ChimichangApp" uvicorn main:app |
|||||
|
|
||||
</div> |
</div> |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Um mehrere Umgebungsvariablen für einen einzelnen Befehl festzulegen, trennen Sie diese einfach durch ein Leerzeichen und fügen Sie alle vor dem Befehl ein. |
Um mehrere Umgebungsvariablen für einen einzelnen Befehl festzulegen, trennen Sie diese einfach durch ein Leerzeichen und fügen Sie alle vor dem Befehl ein. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Und dann würde die Einstellung `admin_email` auf `"[email protected]"` gesetzt. |
Und dann würde die Einstellung `admin_email` auf `"[email protected]"` gesetzt. |
||||
|
|
||||
Der `app_name` wäre `"ChimichangApp"`. |
Der `app_name` wäre `"ChimichangApp"`. |
||||
@ -222,18 +251,21 @@ Sie könnten diese Einstellungen in eine andere Moduldatei einfügen, wie Sie in |
|||||
Sie könnten beispielsweise eine Datei `config.py` haben mit: |
Sie könnten beispielsweise eine Datei `config.py` haben mit: |
||||
|
|
||||
```Python |
```Python |
||||
{!../../../docs_src/settings/app01/config.py!} |
{!../../docs_src/settings/app01/config.py!} |
||||
``` |
``` |
||||
|
|
||||
Und dann verwenden Sie diese in einer Datei `main.py`: |
Und dann verwenden Sie diese in einer Datei `main.py`: |
||||
|
|
||||
```Python hl_lines="3 11-13" |
```Python hl_lines="3 11-13" |
||||
{!../../../docs_src/settings/app01/main.py!} |
{!../../docs_src/settings/app01/main.py!} |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Sie benötigen außerdem eine Datei `__init__.py`, wie in [Größere Anwendungen – mehrere Dateien](../tutorial/bigger-applications.md){.internal-link target=_blank} gesehen. |
Sie benötigen außerdem eine Datei `__init__.py`, wie in [Größere Anwendungen – mehrere Dateien](../tutorial/bigger-applications.md){.internal-link target=_blank} gesehen. |
||||
|
|
||||
|
/// |
||||
|
|
||||
## Einstellungen in einer Abhängigkeit |
## Einstellungen in einer Abhängigkeit |
||||
|
|
||||
In manchen Fällen kann es nützlich sein, die Einstellungen mit einer Abhängigkeit bereitzustellen, anstatt ein globales Objekt `settings` zu haben, das überall verwendet wird. |
In manchen Fällen kann es nützlich sein, die Einstellungen mit einer Abhängigkeit bereitzustellen, anstatt ein globales Objekt `settings` zu haben, das überall verwendet wird. |
||||
@ -245,7 +277,7 @@ Dies könnte besonders beim Testen nützlich sein, da es sehr einfach ist, eine |
|||||
Ausgehend vom vorherigen Beispiel könnte Ihre Datei `config.py` so aussehen: |
Ausgehend vom vorherigen Beispiel könnte Ihre Datei `config.py` so aussehen: |
||||
|
|
||||
```Python hl_lines="10" |
```Python hl_lines="10" |
||||
{!../../../docs_src/settings/app02/config.py!} |
{!../../docs_src/settings/app02/config.py!} |
||||
``` |
``` |
||||
|
|
||||
Beachten Sie, dass wir jetzt keine Standardinstanz `settings = Settings()` erstellen. |
Beachten Sie, dass wir jetzt keine Standardinstanz `settings = Settings()` erstellen. |
||||
@ -254,61 +286,82 @@ Beachten Sie, dass wir jetzt keine Standardinstanz `settings = Settings()` erste |
|||||
|
|
||||
Jetzt erstellen wir eine Abhängigkeit, die ein neues `config.Settings()` zurückgibt. |
Jetzt erstellen wir eine Abhängigkeit, die ein neues `config.Settings()` zurückgibt. |
||||
|
|
||||
=== "Python 3.9+" |
//// tab | Python 3.9+ |
||||
|
|
||||
```Python hl_lines="6 12-13" |
```Python hl_lines="6 12-13" |
||||
{!> ../../../docs_src/settings/app02_an_py39/main.py!} |
{!> ../../docs_src/settings/app02_an_py39/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ |
||||
|
|
||||
```Python hl_lines="6 12-13" |
```Python hl_lines="6 12-13" |
||||
{!> ../../../docs_src/settings/app02_an/main.py!} |
{!> ../../docs_src/settings/app02_an/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+ nicht annotiert" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ nicht annotiert |
||||
|
|
||||
|
/// tip | "Tipp" |
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
||||
|
|
||||
|
/// |
||||
|
|
||||
```Python hl_lines="5 11-12" |
```Python hl_lines="5 11-12" |
||||
{!> ../../../docs_src/settings/app02/main.py!} |
{!> ../../docs_src/settings/app02/main.py!} |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
//// |
||||
|
|
||||
|
/// tip | "Tipp" |
||||
|
|
||||
Wir werden das `@lru_cache` in Kürze besprechen. |
Wir werden das `@lru_cache` in Kürze besprechen. |
||||
|
|
||||
Im Moment nehmen Sie an, dass `get_settings()` eine normale Funktion ist. |
Im Moment nehmen Sie an, dass `get_settings()` eine normale Funktion ist. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Und dann können wir das von der *Pfadoperation-Funktion* als Abhängigkeit einfordern und es überall dort verwenden, wo wir es brauchen. |
Und dann können wir das von der *Pfadoperation-Funktion* als Abhängigkeit einfordern und es überall dort verwenden, wo wir es brauchen. |
||||
|
|
||||
=== "Python 3.9+" |
//// tab | Python 3.9+ |
||||
|
|
||||
```Python hl_lines="17 19-21" |
```Python hl_lines="17 19-21" |
||||
{!> ../../../docs_src/settings/app02_an_py39/main.py!} |
{!> ../../docs_src/settings/app02_an_py39/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ |
||||
|
|
||||
```Python hl_lines="17 19-21" |
```Python hl_lines="17 19-21" |
||||
{!> ../../../docs_src/settings/app02_an/main.py!} |
{!> ../../docs_src/settings/app02_an/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+ nicht annotiert" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ nicht annotiert |
||||
|
|
||||
|
/// tip | "Tipp" |
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
||||
|
|
||||
|
/// |
||||
|
|
||||
```Python hl_lines="16 18-20" |
```Python hl_lines="16 18-20" |
||||
{!> ../../../docs_src/settings/app02/main.py!} |
{!> ../../docs_src/settings/app02/main.py!} |
||||
``` |
``` |
||||
|
|
||||
|
//// |
||||
|
|
||||
### Einstellungen und Tests |
### Einstellungen und Tests |
||||
|
|
||||
Dann wäre es sehr einfach, beim Testen ein anderes Einstellungsobjekt bereitzustellen, indem man eine Abhängigkeitsüberschreibung für `get_settings` erstellt: |
Dann wäre es sehr einfach, beim Testen ein anderes Einstellungsobjekt bereitzustellen, indem man eine Abhängigkeitsüberschreibung für `get_settings` erstellt: |
||||
|
|
||||
```Python hl_lines="9-10 13 21" |
```Python hl_lines="9-10 13 21" |
||||
{!../../../docs_src/settings/app02/test_main.py!} |
{!../../docs_src/settings/app02/test_main.py!} |
||||
``` |
``` |
||||
|
|
||||
Bei der Abhängigkeitsüberschreibung legen wir einen neuen Wert für `admin_email` fest, wenn wir das neue `Settings`-Objekt erstellen, und geben dann dieses neue Objekt zurück. |
Bei der Abhängigkeitsüberschreibung legen wir einen neuen Wert für `admin_email` fest, wenn wir das neue `Settings`-Objekt erstellen, und geben dann dieses neue Objekt zurück. |
||||
@ -321,16 +374,22 @@ Wenn Sie viele Einstellungen haben, die sich möglicherweise oft ändern, vielle |
|||||
|
|
||||
Diese Praxis ist so weit verbreitet, dass sie einen Namen hat. Diese Umgebungsvariablen werden üblicherweise in einer Datei `.env` abgelegt und die Datei wird „dotenv“ genannt. |
Diese Praxis ist so weit verbreitet, dass sie einen Namen hat. Diese Umgebungsvariablen werden üblicherweise in einer Datei `.env` abgelegt und die Datei wird „dotenv“ genannt. |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Eine Datei, die mit einem Punkt (`.`) beginnt, ist eine versteckte Datei in Unix-ähnlichen Systemen wie Linux und macOS. |
Eine Datei, die mit einem Punkt (`.`) beginnt, ist eine versteckte Datei in Unix-ähnlichen Systemen wie Linux und macOS. |
||||
|
|
||||
Aber eine dotenv-Datei muss nicht unbedingt genau diesen Dateinamen haben. |
Aber eine dotenv-Datei muss nicht unbedingt genau diesen Dateinamen haben. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Pydantic unterstützt das Lesen dieser Dateitypen mithilfe einer externen Bibliothek. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>. |
Pydantic unterstützt das Lesen dieser Dateitypen mithilfe einer externen Bibliothek. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>. |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Damit das funktioniert, müssen Sie `pip install python-dotenv` ausführen. |
Damit das funktioniert, müssen Sie `pip install python-dotenv` ausführen. |
||||
|
|
||||
|
/// |
||||
|
|
||||
### Die `.env`-Datei |
### Die `.env`-Datei |
||||
|
|
||||
Sie könnten eine `.env`-Datei haben, mit: |
Sie könnten eine `.env`-Datei haben, mit: |
||||
@ -344,27 +403,40 @@ APP_NAME="ChimichangApp" |
|||||
|
|
||||
Und dann aktualisieren Sie Ihre `config.py` mit: |
Und dann aktualisieren Sie Ihre `config.py` mit: |
||||
|
|
||||
=== "Pydantic v2" |
//// tab | Pydantic v2 |
||||
|
|
||||
```Python hl_lines="9" |
```Python hl_lines="9" |
||||
{!> ../../../docs_src/settings/app03_an/config.py!} |
{!> ../../docs_src/settings/app03_an/config.py!} |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Das Attribut `model_config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/config/" class="external-link" target="_blank">Pydantic: Configuration</a>. |
Das Attribut `model_config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/config/" class="external-link" target="_blank">Pydantic: Configuration</a>. |
||||
|
|
||||
=== "Pydantic v1" |
/// |
||||
|
|
||||
|
//// |
||||
|
|
||||
|
//// tab | Pydantic v1 |
||||
|
|
||||
```Python hl_lines="9-10" |
```Python hl_lines="9-10" |
||||
{!> ../../../docs_src/settings/app03_an/config_pv1.py!} |
{!> ../../docs_src/settings/app03_an/config_pv1.py!} |
||||
``` |
``` |
||||
|
|
||||
!!! tip "Tipp" |
/// tip | "Tipp" |
||||
|
|
||||
Die Klasse `Config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/1.10/usage/model_config/" class="external-link" target="_blank">Pydantic Model Config</a>. |
Die Klasse `Config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/1.10/usage/model_config/" class="external-link" target="_blank">Pydantic Model Config</a>. |
||||
|
|
||||
!!! info |
/// |
||||
|
|
||||
|
//// |
||||
|
|
||||
|
/// info |
||||
|
|
||||
In Pydantic Version 1 erfolgte die Konfiguration in einer internen Klasse `Config`, in Pydantic Version 2 erfolgt sie in einem Attribut `model_config`. Dieses Attribut akzeptiert ein `dict`. Um automatische Codevervollständigung und Inline-Fehlerberichte zu erhalten, können Sie `SettingsConfigDict` importieren und verwenden, um dieses `dict` zu definieren. |
In Pydantic Version 1 erfolgte die Konfiguration in einer internen Klasse `Config`, in Pydantic Version 2 erfolgt sie in einem Attribut `model_config`. Dieses Attribut akzeptiert ein `dict`. Um automatische Codevervollständigung und Inline-Fehlerberichte zu erhalten, können Sie `SettingsConfigDict` importieren und verwenden, um dieses `dict` zu definieren. |
||||
|
|
||||
|
/// |
||||
|
|
||||
Hier definieren wir die Konfiguration `env_file` innerhalb Ihrer Pydantic-`Settings`-Klasse und setzen den Wert auf den Dateinamen mit der dotenv-Datei, die wir verwenden möchten. |
Hier definieren wir die Konfiguration `env_file` innerhalb Ihrer Pydantic-`Settings`-Klasse und setzen den Wert auf den Dateinamen mit der dotenv-Datei, die wir verwenden möchten. |
||||
|
|
||||
### Die `Settings` nur einmal laden mittels `lru_cache` |
### Die `Settings` nur einmal laden mittels `lru_cache` |
||||
@ -390,27 +462,36 @@ würden wir dieses Objekt für jeden Request erstellen und die `.env`-Datei für |
|||||
|
|
||||
Da wir jedoch den `@lru_cache`-Dekorator oben verwenden, wird das `Settings`-Objekt nur einmal erstellt, nämlich beim ersten Aufruf. ✔️ |
Da wir jedoch den `@lru_cache`-Dekorator oben verwenden, wird das `Settings`-Objekt nur einmal erstellt, nämlich beim ersten Aufruf. ✔️ |
||||
|
|
||||
=== "Python 3.9+" |
//// tab | Python 3.9+ |
||||
|
|
||||
```Python hl_lines="1 11" |
```Python hl_lines="1 11" |
||||
{!> ../../../docs_src/settings/app03_an_py39/main.py!} |
{!> ../../docs_src/settings/app03_an_py39/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ |
||||
|
|
||||
```Python hl_lines="1 11" |
```Python hl_lines="1 11" |
||||
{!> ../../../docs_src/settings/app03_an/main.py!} |
{!> ../../docs_src/settings/app03_an/main.py!} |
||||
``` |
``` |
||||
|
|
||||
=== "Python 3.8+ nicht annotiert" |
//// |
||||
|
|
||||
|
//// tab | Python 3.8+ nicht annotiert |
||||
|
|
||||
|
/// tip | "Tipp" |
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
Bevorzugen Sie die `Annotated`-Version, falls möglich. |
||||
|
|
||||
|
/// |
||||
|
|
||||
```Python hl_lines="1 10" |
```Python hl_lines="1 10" |
||||
{!> ../../../docs_src/settings/app03/main.py!} |
{!> ../../docs_src/settings/app03/main.py!} |
||||
``` |
``` |
||||
|
|
||||
|
//// |
||||
|
|
||||
Dann wird bei allen nachfolgenden Aufrufen von `get_settings()`, in den Abhängigkeiten für darauffolgende Requests, dasselbe Objekt zurückgegeben, das beim ersten Aufruf zurückgegeben wurde, anstatt den Code von `get_settings()` erneut auszuführen und ein neues `Settings`-Objekt zu erstellen. |
Dann wird bei allen nachfolgenden Aufrufen von `get_settings()`, in den Abhängigkeiten für darauffolgende Requests, dasselbe Objekt zurückgegeben, das beim ersten Aufruf zurückgegeben wurde, anstatt den Code von `get_settings()` erneut auszuführen und ein neues `Settings`-Objekt zu erstellen. |
||||
|
|
||||
#### Technische Details zu `lru_cache` |
#### Technische Details zu `lru_cache` |
||||
|
|||||
@ -1,36 +0,0 @@ |
|||||
# Externe Links und Artikel |
|
||||
|
|
||||
**FastAPI** hat eine großartige Community, die ständig wächst. |
|
||||
|
|
||||
Es gibt viele Beiträge, Artikel, Tools und Projekte zum Thema **FastAPI**. |
|
||||
|
|
||||
Hier ist eine unvollständige Liste einiger davon. |
|
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Wenn Sie einen Artikel, ein Projekt, ein Tool oder irgendetwas im Zusammenhang mit **FastAPI** haben, was hier noch nicht aufgeführt ist, erstellen Sie einen <a href="https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request und fügen Sie es hinzu</a>. |
|
||||
|
|
||||
!!! note "Hinweis Deutsche Übersetzung" |
|
||||
Die folgenden Überschriften und Links werden aus einer <a href="https://github.com/fastapi/fastapi/blob/master/docs/en/data/external_links.yml" class="external-link" target="_blank">anderen Datei</a> gelesen und sind daher nicht ins Deutsche übersetzt. |
|
||||
|
|
||||
{% for section_name, section_content in external_links.items() %} |
|
||||
|
|
||||
## {{ section_name }} |
|
||||
|
|
||||
{% for lang_name, lang_content in section_content.items() %} |
|
||||
|
|
||||
### {{ lang_name }} |
|
||||
|
|
||||
{% for item in lang_content %} |
|
||||
|
|
||||
* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>. |
|
||||
|
|
||||
{% endfor %} |
|
||||
{% endfor %} |
|
||||
{% endfor %} |
|
||||
|
|
||||
## Projekte |
|
||||
|
|
||||
Die neuesten GitHub-Projekte zum Thema `fastapi`: |
|
||||
|
|
||||
<div class="github-topic-projects"> |
|
||||
</div> |
|
||||
@ -1,176 +0,0 @@ |
|||||
--- |
|
||||
hide: |
|
||||
- navigation |
|
||||
--- |
|
||||
|
|
||||
# FastAPI Leute |
|
||||
|
|
||||
FastAPI hat eine großartige Gemeinschaft, die Menschen mit unterschiedlichstem Hintergrund willkommen heißt. |
|
||||
|
|
||||
## Erfinder - Betreuer |
|
||||
|
|
||||
Hey! 👋 |
|
||||
|
|
||||
Das bin ich: |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.maintainers %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Answers: {{ user.answers }}</div><div class="count">Pull Requests: {{ user.prs }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
Ich bin der Erfinder und Betreuer von **FastAPI**. Sie können mehr darüber in [FastAPI helfen – Hilfe erhalten – Mit dem Autor vernetzen](help-fastapi.md#mit-dem-autor-vernetzen){.internal-link target=_blank} erfahren. |
|
||||
|
|
||||
... Aber hier möchte ich Ihnen die Gemeinschaft vorstellen. |
|
||||
|
|
||||
--- |
|
||||
|
|
||||
**FastAPI** erhält eine Menge Unterstützung aus der Gemeinschaft. Und ich möchte ihre Beiträge hervorheben. |
|
||||
|
|
||||
Das sind die Menschen, die: |
|
||||
|
|
||||
* [Anderen bei Fragen auf GitHub helfen](help-fastapi.md#anderen-bei-fragen-auf-github-helfen){.internal-link target=_blank}. |
|
||||
* [<abbr title='Pull Request – „Zieh-Anfrage“: Geänderten Quellcode senden, mit dem Vorschlag, ihn mit dem aktuellen Quellcode zu verschmelzen'>Pull Requests</abbr> erstellen](help-fastapi.md#einen-pull-request-erstellen){.internal-link target=_blank}. |
|
||||
* Pull Requests überprüfen (Review), [besonders wichtig für Übersetzungen](contributing.md#ubersetzungen){.internal-link target=_blank}. |
|
||||
|
|
||||
Eine Runde Applaus für sie. 👏 🙇 |
|
||||
|
|
||||
## Aktivste Benutzer im letzten Monat |
|
||||
|
|
||||
Hier die Benutzer, die im letzten Monat am meisten [anderen mit Fragen auf Github](help-fastapi.md#anderen-bei-fragen-auf-github-helfen){.internal-link target=_blank} geholfen haben. ☕ |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.last_month_active %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Fragen beantwortet: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Experten |
|
||||
|
|
||||
Hier die **FastAPI-Experten**. 🤓 |
|
||||
|
|
||||
Das sind die Benutzer, die *insgesamt* [anderen am meisten mit Fragen auf GitHub geholfen haben](help-fastapi.md#anderen-bei-fragen-auf-github-helfen){.internal-link target=_blank}. |
|
||||
|
|
||||
Sie haben bewiesen, dass sie Experten sind, weil sie vielen anderen geholfen haben. ✨ |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.experts %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Fragen beantwortet: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Top-Mitwirkende |
|
||||
|
|
||||
Hier sind die **Top-Mitwirkenden**. 👷 |
|
||||
|
|
||||
Diese Benutzer haben [die meisten Pull Requests erstellt](help-fastapi.md#einen-pull-request-erstellen){.internal-link target=_blank} welche *<abbr title="Mergen – Zusammenführen: Unterschiedliche Versionen eines Quellcodes zusammenführen">gemerged</abbr>* wurden. |
|
||||
|
|
||||
Sie haben Quellcode, Dokumentation, Übersetzungen, usw. beigesteuert. 📦 |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.top_contributors %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Pull Requests: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
Es gibt viele andere Mitwirkende (mehr als hundert), Sie können sie alle auf der <a href="https://github.com/fastapi/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Contributors-Seite</a> sehen. 👷 |
|
||||
|
|
||||
## Top-Rezensenten |
|
||||
|
|
||||
Diese Benutzer sind die **Top-Rezensenten**. 🕵️ |
|
||||
|
|
||||
### Rezensionen für Übersetzungen |
|
||||
|
|
||||
Ich spreche nur ein paar Sprachen (und nicht sehr gut 😅). Daher bestätigen Reviewer [**Übersetzungen der Dokumentation**](contributing.md#ubersetzungen){.internal-link target=_blank}. Ohne sie gäbe es keine Dokumentation in mehreren anderen Sprachen. |
|
||||
|
|
||||
--- |
|
||||
|
|
||||
Die **Top-Reviewer** 🕵️ haben die meisten Pull Requests von anderen überprüft und stellen die Qualität des Codes, der Dokumentation und insbesondere der **Übersetzungen** sicher. |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.top_reviewers %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Reviews: {{ user.count }}</div></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Sponsoren |
|
||||
|
|
||||
Dies sind die **Sponsoren**. 😎 |
|
||||
|
|
||||
Sie unterstützen meine Arbeit an **FastAPI** (und andere), hauptsächlich durch <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub-Sponsoren</a>. |
|
||||
|
|
||||
### Gold Sponsoren |
|
||||
|
|
||||
{% if sponsors %} |
|
||||
{% for sponsor in sponsors.gold -%} |
|
||||
<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}"></a> |
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
### Silber Sponsoren |
|
||||
|
|
||||
{% if sponsors %} |
|
||||
{% for sponsor in sponsors.silver -%} |
|
||||
<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}"></a> |
|
||||
{% endfor %} |
|
||||
{% endif %} |
|
||||
|
|
||||
{% if people %} |
|
||||
{% if people.sponsors_50 %} |
|
||||
|
|
||||
### Bronze Sponsoren |
|
||||
|
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.sponsors_50 %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
|
|
||||
{% endif %} |
|
||||
{% endif %} |
|
||||
|
|
||||
### Individuelle Sponsoren |
|
||||
|
|
||||
{% if people %} |
|
||||
<div class="user-list user-list-center"> |
|
||||
{% for user in people.sponsors %} |
|
||||
|
|
||||
<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a></div> |
|
||||
{% endfor %} |
|
||||
|
|
||||
</div> |
|
||||
{% endif %} |
|
||||
|
|
||||
## Über diese Daten - technische Details |
|
||||
|
|
||||
Der Hauptzweck dieser Seite ist es zu zeigen, wie die Gemeinschaft anderen hilft. |
|
||||
|
|
||||
Das beinhaltet auch Hilfe, die normalerweise weniger sichtbar und in vielen Fällen mühsamer ist, wie, anderen bei Problemen zu helfen und Pull Requests mit Übersetzungen zu überprüfen. |
|
||||
|
|
||||
Diese Daten werden jeden Monat berechnet, Sie können den <a href="https://github.com/fastapi/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">Quellcode hier lesen</a>. |
|
||||
|
|
||||
Hier weise ich auch auf Beiträge von Sponsoren hin. |
|
||||
|
|
||||
Ich behalte mir auch das Recht vor, den Algorithmus, die Abschnitte, die Schwellenwerte usw. zu aktualisieren (nur für den Fall 🤷). |
|
||||
@ -1,5 +0,0 @@ |
|||||
# FastAPI und Freunde Newsletter |
|
||||
|
|
||||
<iframe data-w-type="embedded" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://xr4n4.mjt.lu/wgt/xr4n4/hj5/form?c=40a44fa4" width="100%" style="height: 0;"></iframe> |
|
||||
|
|
||||
<script type="text/javascript" src="https://app.mailjet.com/pas-nc-embedded-v1.js"></script> |
|
||||
@ -1,24 +0,0 @@ |
|||||
# `APIRouter`-Klasse |
|
||||
|
|
||||
Hier sind die Referenzinformationen für die Klasse `APIRouter` mit all ihren Parametern, Attributen und Methoden. |
|
||||
|
|
||||
Sie können die `APIRouter`-Klasse direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import APIRouter |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.APIRouter |
|
||||
options: |
|
||||
members: |
|
||||
- websocket |
|
||||
- include_router |
|
||||
- get |
|
||||
- put |
|
||||
- post |
|
||||
- delete |
|
||||
- options |
|
||||
- head |
|
||||
- patch |
|
||||
- trace |
|
||||
- on_event |
|
||||
@ -1,11 +0,0 @@ |
|||||
# Hintergrundtasks – `BackgroundTasks` |
|
||||
|
|
||||
Sie können einen Parameter in einer *Pfadoperation-Funktion* oder einer Abhängigkeitsfunktion mit dem Typ `BackgroundTasks` deklarieren und diesen danach verwenden, um die Ausführung von Hintergrundtasks nach dem Senden der Response zu definieren. |
|
||||
|
|
||||
Sie können `BackgroundTasks` direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import BackgroundTasks |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.BackgroundTasks |
|
||||
@ -1,29 +0,0 @@ |
|||||
# Abhängigkeiten – `Depends()` und `Security()` |
|
||||
|
|
||||
## `Depends()` |
|
||||
|
|
||||
Abhängigkeiten werden hauptsächlich mit der speziellen Funktion `Depends()` behandelt, die ein Callable entgegennimmt. |
|
||||
|
|
||||
Hier finden Sie deren Referenz und Parameter. |
|
||||
|
|
||||
Sie können sie direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import Depends |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.Depends |
|
||||
|
|
||||
## `Security()` |
|
||||
|
|
||||
In vielen Szenarien können Sie die Sicherheit (Autorisierung, Authentifizierung usw.) mit Abhängigkeiten handhaben, indem Sie `Depends()` verwenden. |
|
||||
|
|
||||
Wenn Sie jedoch auch OAuth2-Scopes deklarieren möchten, können Sie `Security()` anstelle von `Depends()` verwenden. |
|
||||
|
|
||||
Sie können `Security()` direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import Security |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.Security |
|
||||
@ -1,3 +0,0 @@ |
|||||
# Encoder – `jsonable_encoder` |
|
||||
|
|
||||
::: fastapi.encoders.jsonable_encoder |
|
||||
@ -1,20 +0,0 @@ |
|||||
# Exceptions – `HTTPException` und `WebSocketException` |
|
||||
|
|
||||
Dies sind die <abbr title="Exception – Ausnahme, Fehler: Python-Objekt, das einen Fehler nebst Metadaten repräsentiert">Exceptions</abbr>, die Sie auslösen können, um dem Client Fehler zu berichten. |
|
||||
|
|
||||
Wenn Sie eine Exception auslösen, wird, wie es bei normalem Python der Fall wäre, der Rest der Ausführung abgebrochen. Auf diese Weise können Sie diese Exceptions von überall im Code werfen, um einen Request abzubrechen und den Fehler dem Client anzuzeigen. |
|
||||
|
|
||||
Sie können Folgendes verwenden: |
|
||||
|
|
||||
* `HTTPException` |
|
||||
* `WebSocketException` |
|
||||
|
|
||||
Diese Exceptions können direkt von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import HTTPException, WebSocketException |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.HTTPException |
|
||||
|
|
||||
::: fastapi.WebSocketException |
|
||||
@ -1,31 +0,0 @@ |
|||||
# `FastAPI`-Klasse |
|
||||
|
|
||||
Hier sind die Referenzinformationen für die Klasse `FastAPI` mit all ihren Parametern, Attributen und Methoden. |
|
||||
|
|
||||
Sie können die `FastAPI`-Klasse direkt von `fastapi` importieren: |
|
||||
|
|
||||
```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 |
|
||||
@ -1,11 +0,0 @@ |
|||||
# `HTTPConnection`-Klasse |
|
||||
|
|
||||
Wenn Sie Abhängigkeiten definieren möchten, die sowohl mit HTTP als auch mit WebSockets kompatibel sein sollen, können Sie einen Parameter definieren, der eine `HTTPConnection` anstelle eines `Request` oder eines `WebSocket` akzeptiert. |
|
||||
|
|
||||
Sie können diese von `fastapi.requests` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.requests import HTTPConnection |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.requests.HTTPConnection |
|
||||
@ -1,8 +0,0 @@ |
|||||
# Referenz – Code-API |
|
||||
|
|
||||
Hier ist die Referenz oder Code-API, die Klassen, Funktionen, Parameter, Attribute und alle FastAPI-Teile, die Sie in Ihren Anwendungen verwenden können. |
|
||||
|
|
||||
Wenn Sie **FastAPI** lernen möchten, ist es viel besser, das [FastAPI-Tutorial](https://fastapi.tiangolo.com/tutorial/) zu lesen. |
|
||||
|
|
||||
!!! note "Hinweis Deutsche Übersetzung" |
|
||||
Die nachfolgende API wird aus der Quelltext-Dokumentation erstellt, daher sind nur die Einleitungen auf Deutsch. |
|
||||
@ -1,45 +0,0 @@ |
|||||
# Middleware |
|
||||
|
|
||||
Es gibt mehrere Middlewares, die direkt von Starlette bereitgestellt werden. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation über Middleware](../advanced/middleware.md). |
|
||||
|
|
||||
::: fastapi.middleware.cors.CORSMiddleware |
|
||||
|
|
||||
Kann von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.middleware.cors import CORSMiddleware |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.middleware.gzip.GZipMiddleware |
|
||||
|
|
||||
Kann von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.middleware.gzip import GZipMiddleware |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.middleware.httpsredirect.HTTPSRedirectMiddleware |
|
||||
|
|
||||
Kann von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.middleware.trustedhost.TrustedHostMiddleware |
|
||||
|
|
||||
Kann von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.middleware.trustedhost import TrustedHostMiddleware |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.middleware.wsgi.WSGIMiddleware |
|
||||
|
|
||||
Kann von `fastapi` importiert werden: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.middleware.wsgi import WSGIMiddleware |
|
||||
``` |
|
||||
@ -1,11 +0,0 @@ |
|||||
# OpenAPI `docs` |
|
||||
|
|
||||
Werkzeuge zur Verwaltung der automatischen OpenAPI-UI-Dokumentation, einschließlich Swagger UI (standardmäßig unter `/docs`) und ReDoc (standardmäßig unter `/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 |
|
||||
@ -1,5 +0,0 @@ |
|||||
# OpenAPI |
|
||||
|
|
||||
Es gibt mehrere Werkzeuge zur Handhabung von OpenAPI. |
|
||||
|
|
||||
Normalerweise müssen Sie diese nicht verwenden, es sei denn, Sie haben einen bestimmten fortgeschrittenen Anwendungsfall, welcher das erfordert. |
|
||||
@ -1,5 +0,0 @@ |
|||||
# OpenAPI-`models` |
|
||||
|
|
||||
OpenAPI Pydantic-Modelle, werden zum Generieren und Validieren der generierten OpenAPI verwendet. |
|
||||
|
|
||||
::: fastapi.openapi.models |
|
||||
@ -1,35 +0,0 @@ |
|||||
# Request-Parameter |
|
||||
|
|
||||
Hier die Referenzinformationen für die Request-Parameter. |
|
||||
|
|
||||
Dies sind die Sonderfunktionen, die Sie mittels `Annotated` in *Pfadoperation-Funktion*-Parameter oder Abhängigkeitsfunktionen einfügen können, um Daten aus dem Request abzurufen. |
|
||||
|
|
||||
Dies beinhaltet: |
|
||||
|
|
||||
* `Query()` |
|
||||
* `Path()` |
|
||||
* `Body()` |
|
||||
* `Cookie()` |
|
||||
* `Header()` |
|
||||
* `Form()` |
|
||||
* `File()` |
|
||||
|
|
||||
Sie können diese alle direkt von `fastapi` importieren: |
|
||||
|
|
||||
```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 |
|
||||
@ -1,14 +0,0 @@ |
|||||
# `Request`-Klasse |
|
||||
|
|
||||
Sie können einen Parameter in einer *Pfadoperation-Funktion* oder einer Abhängigkeit als vom Typ `Request` deklarieren und dann direkt auf das Requestobjekt zugreifen, ohne jegliche Validierung, usw. |
|
||||
|
|
||||
Sie können es direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import Request |
|
||||
``` |
|
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Wenn Sie Abhängigkeiten definieren möchten, die sowohl mit HTTP als auch mit WebSockets kompatibel sein sollen, können Sie einen Parameter definieren, der eine `HTTPConnection` anstelle eines `Request` oder eines `WebSocket` akzeptiert. |
|
||||
|
|
||||
::: fastapi.Request |
|
||||
@ -1,13 +0,0 @@ |
|||||
# `Response`-Klasse |
|
||||
|
|
||||
Sie können einen Parameter in einer *Pfadoperation-Funktion* oder einer Abhängigkeit als `Response` deklarieren und dann Daten für die Response wie Header oder Cookies festlegen. |
|
||||
|
|
||||
Diese können Sie auch direkt verwenden, um eine Instanz davon zu erstellen und diese von Ihren *Pfadoperationen* zurückzugeben. |
|
||||
|
|
||||
Sie können sie direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import Response |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.Response |
|
||||
@ -1,164 +0,0 @@ |
|||||
# Benutzerdefinierte Responseklassen – File, HTML, Redirect, Streaming, usw. |
|
||||
|
|
||||
Es gibt mehrere benutzerdefinierte Responseklassen, von denen Sie eine Instanz erstellen und diese direkt von Ihren *Pfadoperationen* zurückgeben können. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu benutzerdefinierten Responses – HTML, Stream, Datei, andere](../advanced/custom-response.md). |
|
||||
|
|
||||
Sie können diese direkt von `fastapi.responses` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.responses import ( |
|
||||
FileResponse, |
|
||||
HTMLResponse, |
|
||||
JSONResponse, |
|
||||
ORJSONResponse, |
|
||||
PlainTextResponse, |
|
||||
RedirectResponse, |
|
||||
Response, |
|
||||
StreamingResponse, |
|
||||
UJSONResponse, |
|
||||
) |
|
||||
``` |
|
||||
|
|
||||
## FastAPI-Responses |
|
||||
|
|
||||
Es gibt einige benutzerdefinierte FastAPI-Responseklassen, welche Sie verwenden können, um die JSON-Performanz zu optimieren. |
|
||||
|
|
||||
::: 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.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 |
|
||||
@ -1,73 +0,0 @@ |
|||||
# Sicherheitstools |
|
||||
|
|
||||
Wenn Sie Abhängigkeiten mit OAuth2-Scopes deklarieren müssen, verwenden Sie `Security()`. |
|
||||
|
|
||||
Aber Sie müssen immer noch definieren, was das <abbr title="Das von dem abhängt, die zu verwendende Abhängigkeit">Dependable</abbr>, das Callable ist, welches Sie als Parameter an `Depends()` oder `Security()` übergeben. |
|
||||
|
|
||||
Es gibt mehrere Tools, mit denen Sie diese Dependables erstellen können, und sie werden in OpenAPI integriert, sodass sie in der Oberfläche der automatischen Dokumentation angezeigt werden und von automatisch generierten Clients und SDKs, usw., verwendet werden können. |
|
||||
|
|
||||
Sie können sie von `fastapi.security` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.security import ( |
|
||||
APIKeyCookie, |
|
||||
APIKeyHeader, |
|
||||
APIKeyQuery, |
|
||||
HTTPAuthorizationCredentials, |
|
||||
HTTPBasic, |
|
||||
HTTPBasicCredentials, |
|
||||
HTTPBearer, |
|
||||
HTTPDigest, |
|
||||
OAuth2, |
|
||||
OAuth2AuthorizationCodeBearer, |
|
||||
OAuth2PasswordBearer, |
|
||||
OAuth2PasswordRequestForm, |
|
||||
OAuth2PasswordRequestFormStrict, |
|
||||
OpenIdConnect, |
|
||||
SecurityScopes, |
|
||||
) |
|
||||
``` |
|
||||
|
|
||||
## API-Schlüssel-Sicherheitsschemas |
|
||||
|
|
||||
::: fastapi.security.APIKeyCookie |
|
||||
|
|
||||
::: fastapi.security.APIKeyHeader |
|
||||
|
|
||||
::: fastapi.security.APIKeyQuery |
|
||||
|
|
||||
## HTTP-Authentifizierungsschemas |
|
||||
|
|
||||
::: fastapi.security.HTTPBasic |
|
||||
|
|
||||
::: fastapi.security.HTTPBearer |
|
||||
|
|
||||
::: fastapi.security.HTTPDigest |
|
||||
|
|
||||
## HTTP-Anmeldeinformationen |
|
||||
|
|
||||
::: fastapi.security.HTTPAuthorizationCredentials |
|
||||
|
|
||||
::: fastapi.security.HTTPBasicCredentials |
|
||||
|
|
||||
## OAuth2-Authentifizierung |
|
||||
|
|
||||
::: fastapi.security.OAuth2 |
|
||||
|
|
||||
::: fastapi.security.OAuth2AuthorizationCodeBearer |
|
||||
|
|
||||
::: fastapi.security.OAuth2PasswordBearer |
|
||||
|
|
||||
## OAuth2-Passwortformulare |
|
||||
|
|
||||
::: fastapi.security.OAuth2PasswordRequestForm |
|
||||
|
|
||||
::: fastapi.security.OAuth2PasswordRequestFormStrict |
|
||||
|
|
||||
## OAuth2-Sicherheitsscopes in Abhängigkeiten |
|
||||
|
|
||||
::: fastapi.security.SecurityScopes |
|
||||
|
|
||||
## OpenID Connect |
|
||||
|
|
||||
::: fastapi.security.OpenIdConnect |
|
||||
@ -1,13 +0,0 @@ |
|||||
# Statische Dateien – `StaticFiles` |
|
||||
|
|
||||
Sie können die `StaticFiles`-Klasse verwenden, um statische Dateien wie JavaScript, CSS, Bilder, usw. bereitzustellen. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu statischen Dateien](../tutorial/static-files.md). |
|
||||
|
|
||||
Sie können sie direkt von `fastapi.staticfiles` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.staticfiles import StaticFiles |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.staticfiles.StaticFiles |
|
||||
@ -1,36 +0,0 @@ |
|||||
# Statuscodes |
|
||||
|
|
||||
Sie können das Modul `status` von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import status |
|
||||
``` |
|
||||
|
|
||||
`status` wird direkt von Starlette bereitgestellt. |
|
||||
|
|
||||
Es enthält eine Gruppe benannter Konstanten (Variablen) mit ganzzahligen Statuscodes. |
|
||||
|
|
||||
Zum Beispiel: |
|
||||
|
|
||||
* 200: `status.HTTP_200_OK` |
|
||||
* 403: `status.HTTP_403_FORBIDDEN` |
|
||||
* usw. |
|
||||
|
|
||||
Es kann praktisch sein, schnell auf HTTP- (und WebSocket-)Statuscodes in Ihrer Anwendung zuzugreifen, indem Sie die automatische Vervollständigung für den Namen verwenden, ohne sich die Zahlen für die Statuscodes merken zu müssen. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu Response-Statuscodes](../tutorial/response-status-code.md). |
|
||||
|
|
||||
## Beispiel |
|
||||
|
|
||||
```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 |
|
||||
@ -1,13 +0,0 @@ |
|||||
# Templating – `Jinja2Templates` |
|
||||
|
|
||||
Sie können die `Jinja2Templates`-Klasse verwenden, um Jinja-Templates zu rendern. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu Templates](../advanced/templates.md). |
|
||||
|
|
||||
Sie können die Klasse direkt von `fastapi.templating` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.templating import Jinja2Templates |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.templating.Jinja2Templates |
|
||||
@ -1,13 +0,0 @@ |
|||||
# Testclient – `TestClient` |
|
||||
|
|
||||
Sie können die `TestClient`-Klasse verwenden, um FastAPI-Anwendungen zu testen, ohne eine tatsächliche HTTP- und Socket-Verbindung zu erstellen, Sie kommunizieren einfach direkt mit dem FastAPI-Code. |
|
||||
|
|
||||
Lesen Sie mehr darüber in der [FastAPI-Dokumentation über Testen](../tutorial/testing.md). |
|
||||
|
|
||||
Sie können sie direkt von `fastapi.testclient` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.testclient import TestClient |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.testclient.TestClient |
|
||||
@ -1,22 +0,0 @@ |
|||||
# `UploadFile`-Klasse |
|
||||
|
|
||||
Sie können *Pfadoperation-Funktionsparameter* als Parameter vom Typ `UploadFile` definieren, um Dateien aus dem Request zu erhalten. |
|
||||
|
|
||||
Sie können es direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import UploadFile |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.UploadFile |
|
||||
options: |
|
||||
members: |
|
||||
- file |
|
||||
- filename |
|
||||
- size |
|
||||
- headers |
|
||||
- content_type |
|
||||
- read |
|
||||
- write |
|
||||
- seek |
|
||||
- close |
|
||||
@ -1,64 +0,0 @@ |
|||||
# WebSockets |
|
||||
|
|
||||
Bei der Definition von WebSockets deklarieren Sie normalerweise einen Parameter vom Typ `WebSocket` und können damit Daten vom Client lesen und an ihn senden. Er wird direkt von Starlette bereitgestellt, Sie können ihn aber von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import WebSocket |
|
||||
``` |
|
||||
|
|
||||
!!! tip "Tipp" |
|
||||
Wenn Sie Abhängigkeiten definieren möchten, die sowohl mit HTTP als auch mit WebSockets kompatibel sein sollen, können Sie einen Parameter definieren, der eine `HTTPConnection` anstelle eines `Request` oder eines `WebSocket` akzeptiert. |
|
||||
|
|
||||
::: 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 |
|
||||
|
|
||||
Wenn ein Client die Verbindung trennt, wird eine `WebSocketDisconnect`-Exception ausgelöst, die Sie abfangen können. |
|
||||
|
|
||||
Sie können diese direkt von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi import WebSocketDisconnect |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.WebSocketDisconnect |
|
||||
|
|
||||
## WebSockets – zusätzliche Klassen |
|
||||
|
|
||||
Zusätzliche Klassen für die Handhabung von WebSockets. |
|
||||
|
|
||||
Werden direkt von Starlette bereitgestellt, Sie können sie jedoch von `fastapi` importieren: |
|
||||
|
|
||||
```python |
|
||||
from fastapi.websockets import WebSocketDisconnect, WebSocketState |
|
||||
``` |
|
||||
|
|
||||
::: fastapi.websockets.WebSocketDisconnect |
|
||||
|
|
||||
::: fastapi.websockets.WebSocketState |
|
||||
Some files were not shown because too many files changed in this diff
Loading…
Reference in new issue