mirror of https://github.com/tiangolo/fastapi.git
81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
# Samouczek
|
|
|
|
Ten samouczek pokaże Ci, krok po kroku, jak używać większości funkcji **FastAPI**.
|
|
|
|
Każda część korzysta z poprzednich, ale jest jednocześnie osobnym tematem. Możesz przejść bezpośrednio do każdego rozdziału, jeśli szukasz rozwiązania konkretnego problemu.
|
|
|
|
Samouczek jest tak zbudowany, żeby służył jako punkt odniesienia w przyszłości.
|
|
|
|
Możesz wracać i sprawdzać dokładnie to czego potrzebujesz.
|
|
|
|
## Wykonywanie kodu
|
|
|
|
Wszystkie fragmenty kodu mogą być skopiowane bezpośrednio i użyte (są poprawnymi i przetestowanymi plikami).
|
|
|
|
Żeby wykonać każdy przykład skopiuj kod to pliku `main.py` i uruchom `uvicorn` za pomocą:
|
|
|
|
<div class="termy">
|
|
|
|
```console
|
|
$ uvicorn main:app --reload
|
|
|
|
<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
|
|
<span style="color: green;">INFO</span>: Started reloader process [28720]
|
|
<span style="color: green;">INFO</span>: Started server process [28722]
|
|
<span style="color: green;">INFO</span>: Waiting for application startup.
|
|
<span style="color: green;">INFO</span>: Application startup complete.
|
|
```
|
|
|
|
</div>
|
|
|
|
**BARDZO zalecamy** pisanie bądź kopiowanie kodu, edycję, a następnie wykonywanie go lokalnie.
|
|
|
|
Użycie w Twoim edytorze jest tym, co pokazuje prawdziwe korzyści z FastAPI, pozwala zobaczyć jak mało kodu musisz napisać, wszystkie funkcje, takie jak kontrola typów, <abbr title="auto-complete, autocompletion, IntelliSense">automatyczne uzupełnianie</abbr>, itd.
|
|
|
|
---
|
|
|
|
## Instalacja FastAPI
|
|
|
|
Jako pierwszy krok zainstaluj FastAPI.
|
|
|
|
Na potrzeby samouczka możesz zainstalować również wszystkie opcjonalne biblioteki:
|
|
|
|
<div class="termy">
|
|
|
|
```console
|
|
$ pip install "fastapi[all]"
|
|
|
|
---> 100%
|
|
```
|
|
|
|
</div>
|
|
|
|
...wliczając w to `uvicorn`, który będzie służył jako serwer wykonujacy Twój kod.
|
|
|
|
!!! note
|
|
Możesz również wykonać instalację "krok po kroku".
|
|
|
|
Prawdopodobnie zechcesz to zrobić, kiedy będziesz wdrażać swoją aplikację w środowisku produkcyjnym:
|
|
|
|
```
|
|
pip install fastapi
|
|
```
|
|
|
|
Zainstaluj też `uvicorn`, który będzie służył jako serwer:
|
|
|
|
```
|
|
pip install "uvicorn[standard]"
|
|
```
|
|
|
|
Tak samo możesz zainstalować wszystkie dodatkowe biblioteki, których chcesz użyć.
|
|
|
|
## Zaawansowany poradnik
|
|
|
|
Jest też **Zaawansowany poradnik**, który możesz przeczytać po lekturze tego **Samouczka**.
|
|
|
|
**Zaawansowany poradnik** opiera się na tym samouczku, używa tych samych pojęć, żeby pokazać Ci kilka dodatkowych funkcji.
|
|
|
|
Najpierw jednak powinieneś przeczytać **Samouczek** (czytasz go teraz).
|
|
|
|
Ten rozdział jest zaprojektowany tak, że możesz stworzyć kompletną aplikację używając tylko informacji tutaj zawartych, a następnie rozszerzać ją na różne sposoby, w zależności od potrzeb, używając kilku dodatkowych pomysłów z **Zaawansowanego poradnika**.
|