diff --git a/docs/pl/docs/index.md b/docs/pl/docs/index.md
index 95fb7ae212518..4a300ae632dbc 100644
--- a/docs/pl/docs/index.md
+++ b/docs/pl/docs/index.md
@@ -1,12 +1,8 @@
-
-{!../../../docs/missing-translation.md!}
-
-
- FastAPI framework, high performance, easy to learn, fast to code, ready for production
+ FastAPI to szybki, prosty w nauce i gotowy do użycia w produkcji framework
@@ -22,29 +18,28 @@
---
-**Documentation**: https://fastapi.tiangolo.com
+**Dokumentacja**: https://fastapi.tiangolo.com
-**Source Code**: https://github.com/tiangolo/fastapi
+**Kod żródłowy**: https://github.com/tiangolo/fastapi
---
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints.
+FastAPI to nowoczesny, wydajny framework webowy do budowania API z użyciem Pythona 3.6+ bazujący na standardowym typowaniu Pythona.
-The key features are:
+Kluczowe cechy:
-* **Fast**: Very high performance, on par with **NodeJS** and **Go** (thanks to Starlette and Pydantic). [One of the fastest Python frameworks available](#performance).
+* **Wydajność**: FastAPI jest bardzo wydajny, na równi z **NodeJS** oraz **Go** (dzięki Starlette i Pydantic). [Jeden z najszybszych dostępnych frameworków Pythonowych](#wydajnosc).
+* **Szybkość kodowania**: Przyśpiesza szybkość pisania nowych funkcjonalności o około 200% do 300%. *
+* **Mniejsza ilość błędów**: Zmniejsza ilość ludzkich (dewelopera) błędy o około 40%. *
+* **Intuicyjność**: Wspaniałe wsparcie dla edytorów kodu. Dostępne wszędzie automatyczne uzupełnianie kodu. Krótszy czas debugowania.
+* **Łatwość**: Zaprojektowany by być prosty i łatwy do nauczenia. Mniej czasu spędzonego na czytanie dokumentacji.
+* **Kompaktowość**: Minimalizacja powtarzającego się kodu. Wiele funkcjonalności dla każdej deklaracji parametru. Mniej błędów.
+* **Solidność**: Kod gotowy dla środowiska produkcyjnego. Wraz z automatyczną interaktywną dokumentacją.
+* **Bazujący na standardach**: Oparty na (i w pełni kompatybilny z) otwartych standardach API: OpenAPI (wcześniej znane jako Swagger) oraz JSON Schema.
-* **Fast to code**: Increase the speed to develop features by about 200% to 300%. *
-* **Fewer bugs**: Reduce about 40% of human (developer) induced errors. *
-* **Intuitive**: Great editor support. Completion everywhere. Less time debugging.
-* **Easy**: Designed to be easy to use and learn. Less time reading docs.
-* **Short**: Minimize code duplication. Multiple features from each parameter declaration. Fewer bugs.
-* **Robust**: Get production-ready code. With automatic interactive documentation.
-* **Standards-based**: Based on (and fully compatible with) the open standards for APIs: OpenAPI (previously known as Swagger) and JSON Schema.
+* oszacowania bazowane na testach wykonanych przez wewnętrzny zespół deweloperów, budujących aplikacie używane na środowisku produkcyjnym.
-* estimation based on tests on an internal development team, building production applications.
-
-## Sponsors
+## Sponsorzy
@@ -59,9 +54,9 @@ The key features are:
-Other sponsors
+Inni sponsorzy
-## Opinions
+## Opinie
"_[...] I'm using **FastAPI** a ton these days. [...] I'm actually planning to use it for all of my team's **ML services at Microsoft**. Some of them are getting integrated into the core **Windows** product and some **Office** products._"
@@ -101,24 +96,24 @@ The key features are:
---
-## **Typer**, the FastAPI of CLIs
+## **Typer**, FastAPI aplikacji konsolowych
-If you are building a CLI app to be used in the terminal instead of a web API, check out **Typer**.
+Jeżeli tworzysz aplikacje CLI, która ma być używana w terminalu zamiast API, sprawdź **Typer**.
-**Typer** is FastAPI's little sibling. And it's intended to be the **FastAPI of CLIs**. ⌨️ 🚀
+**Typer** to młodsze rodzeństwo FastAPI. Jego celem jest pozostanie **FastAPI aplikacji konsolowych** . ⌨️ 🚀
-## Requirements
+## Wymagania
Python 3.6+
-FastAPI stands on the shoulders of giants:
+FastAPI oparty jest na:
-* Starlette for the web parts.
-* Pydantic for the data parts.
+* Starlette dla części webowej.
+* Pydantic dla części obsługujących dane.
-## Installation
+## Instalacja
@@ -130,7 +125,7 @@ $ pip install fastapi
-You will also need an ASGI server, for production such as Uvicorn or Hypercorn.
+Na serwerze produkcyjnym będziesz także potrzebował serwera ASGI, np. Uvicorn lub Hypercorn.
@@ -142,11 +137,11 @@ $ pip install uvicorn[standard]
-## Example
+## Przykład
-### Create it
+### Stwórz
-* Create a file `main.py` with:
+* Utwórz plik o nazwie `main.py` z:
```Python
from typing import Optional
@@ -167,9 +162,9 @@ def read_item(item_id: int, q: Optional[str] = None):
```
-Or use async def...
+Albo użyj async def...
-If your code uses `async` / `await`, use `async def`:
+Jeżeli twój kod korzysta z `async` / `await`, użyj `async def`:
```Python hl_lines="9 14"
from typing import Optional
@@ -189,15 +184,15 @@ async def read_item(item_id: int, q: Optional[str] = None):
return {"item_id": item_id, "q": q}
```
-**Note**:
+**Przypis**:
-If you don't know, check the _"In a hurry?"_ section about `async` and `await` in the docs.
+Jeżeli nie znasz, sprawdź sekcję _"In a hurry?"_ o `async` i `await` w dokumentacji.
-### Run it
+### Uruchom
-Run the server with:
+Uruchom serwer używając:
@@ -214,54 +209,53 @@ INFO: Application startup complete.
-About the command uvicorn main:app --reload...
-
-The command `uvicorn main:app` refers to:
+O komendzie uvicorn main:app --reload...
+Komenda `uvicorn main:app` odnosi się do:
-* `main`: the file `main.py` (the Python "module").
-* `app`: the object created inside of `main.py` with the line `app = FastAPI()`.
-* `--reload`: make the server restart after code changes. Only do this for development.
+* `main`: plik `main.py` ("moduł" w Pythonie).
+* `app`: obiekt stworzony w `main.py` w lini `app = FastAPI()`.
+* `--reload`: spraw by serwer resetował się po każdej zmianie w kodzie. Używaj tego tylko w środowisku deweloperskim.
-### Check it
+### Wypróbuj
-Open your browser at http://127.0.0.1:8000/items/5?q=somequery.
+Otwórz link http://127.0.0.1:8000/items/5?q=somequery w przeglądarce.
-You will see the JSON response as:
+Zobaczysz następującą odpowiedź JSON:
```JSON
{"item_id": 5, "q": "somequery"}
```
-You already created an API that:
+Właśnie stworzyłeś API które:
-* Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`.
-* Both _paths_ take `GET` operations (also known as HTTP _methods_).
-* The _path_ `/items/{item_id}` has a _path parameter_ `item_id` that should be an `int`.
-* The _path_ `/items/{item_id}` has an optional `str` _query parameter_ `q`.
+* Otrzymuje żądania HTTP w _ścieżce_ `/` i `/items/{item_id}`.
+* Obie _ścieżki_ używają operacji `GET` (znane także jako _metody_ HTTP).
+* _Ścieżka_ `/items/{item_id}` ma _parametr ścieżki_ `item_id` który powinien być obiektem typu `int`.
+* _Ścieżka_ `/items/{item_id}` ma opcjonalny _parametr zapytania_ typu `str` o nazwie `q`.
-### Interactive API docs
+### Interaktywna dokumentacja API
-Now go to http://127.0.0.1:8000/docs.
+Otwórz teraz stronę http://127.0.0.1:8000/docs.
-You will see the automatic interactive API documentation (provided by Swagger UI):
+Zobaczysz automatyczną interaktywną dokumentację API (dostarczoną z pomocą Swagger UI):
-### Alternative API docs
+### Alternatywna dokumentacja API
-And now, go to http://127.0.0.1:8000/redoc.
+Otwórz teraz http://127.0.0.1:8000/redoc.
-You will see the alternative automatic documentation (provided by ReDoc):
+Zobaczysz alternatywną, lecz wciąż automatyczną dokumentację (wygenerowaną z pomocą ReDoc):
-## Example upgrade
+## Aktualizacja przykładu
-Now modify the file `main.py` to receive a body from a `PUT` request.
+Zmodyfikuj teraz plik `main.py`, aby otrzmywał treść (body) żądania `PUT`.
-Declare the body using standard Python types, thanks to Pydantic.
+Zadeklaruj treść żądania, używając standardowych typów w Pythonie dzięki Pydantic.
```Python hl_lines="4 9-12 25-27"
from typing import Optional
@@ -293,175 +287,175 @@ def update_item(item_id: int, item: Item):
return {"item_name": item.name, "item_id": item_id}
```
-The server should reload automatically (because you added `--reload` to the `uvicorn` command above).
+Serwer powinien przeładować się automatycznie (ponieważ dodałeś `--reload` do komendy `uvicorn` powyżej).
-### Interactive API docs upgrade
+### Zaktualizowana interaktywna dokumentacja API
-Now go to http://127.0.0.1:8000/docs.
+Wejdź teraz na http://127.0.0.1:8000/docs.
-* The interactive API documentation will be automatically updated, including the new body:
+* Interaktywna dokumentacja API zaktualizuje sie automatycznie, także z nową treścią żądania (body):
-* Click on the button "Try it out", it allows you to fill the parameters and directly interact with the API:
+* Kliknij przycisk "Try it out" (wypróbuj), pozwoli Ci to wypełnić parametry i bezpośrednio użyć API:
-* Then click on the "Execute" button, the user interface will communicate with your API, send the parameters, get the results and show them on the screen:
+* Kliknij potem przycisk "Execute" (wykonaj), interfejs użytkownika połączy się z API, wyśle parametry, otrzyma odpowiedź i wyświetli ją na ekranie:
-### Alternative API docs upgrade
+### Zaktualizowana alternatywna dokumentacja API
-And now, go to http://127.0.0.1:8000/redoc.
+Otwórz teraz http://127.0.0.1:8000/redoc.
-* The alternative documentation will also reflect the new query parameter and body:
+* Alternatywna dokumentacja również pokaże zaktualizowane parametry i treść żądania (body):
-### Recap
+### Podsumowanie
-In summary, you declare **once** the types of parameters, body, etc. as function parameters.
+Podsumowując, musiałeś zadeklarować typy parametrów, treści żądania (body) itp. tylko **raz**, i są one dostępne jako parametry funkcji.
-You do that with standard modern Python types.
+Robisz to tak samo jak ze standardowymi typami w Pythonie.
-You don't have to learn a new syntax, the methods or classes of a specific library, etc.
+Nie musisz sie uczyć żadnej nowej składni, metod lub klas ze specyficznych bibliotek itp.
-Just standard **Python 3.6+**.
+Po prostu standardowy **Python 3.6+**.
-For example, for an `int`:
+Na przykład, dla danych typu `int`:
```Python
item_id: int
```
-or for a more complex `Item` model:
+albo dla bardziej złożonego obiektu `Item`:
```Python
item: Item
```
-...and with that single declaration you get:
+...i z pojedyńczą deklaracją otrzymujesz:
-* Editor support, including:
- * Completion.
- * Type checks.
-* Validation of data:
- * Automatic and clear errors when the data is invalid.
- * Validation even for deeply nested JSON objects.
-* Conversion of input data: coming from the network to Python data and types. Reading from:
+* Wsparcie edytorów kodu, wliczając:
+ * Auto-uzupełnianie.
+ * Sprawdzanie typów.
+* Walidacja danych:
+ * Automatyczne i przejrzyste błędy gdy dane są niepoprawne.
+ * Walidacja nawet dla głęboko zagnieżdżonych obiektów JSON.
+* Konwersja danych wejściowych: przychodzących z sieci na Pythonowe typy. Pozwala na przetwarzanie danych:
* JSON.
- * Path parameters.
- * Query parameters.
- * Cookies.
- * Headers.
- * Forms.
- * Files.
-* Conversion of output data: converting from Python data and types to network data (as JSON):
- * Convert Python types (`str`, `int`, `float`, `bool`, `list`, etc).
- * `datetime` objects.
- * `UUID` objects.
- * Database models.
- * ...and many more.
-* Automatic interactive API documentation, including 2 alternative user interfaces:
+ * Parametrów ścieżki.
+ * Parametrów zapytania.
+ * Dane cookies.
+ * Dane nagłówków (headers).
+ * Formularze.
+ * Pliki.
+* Konwersja danych wyjściowych: wychodzących z Pythona do sieci (jako JSON):
+ * Przetwarzanie Pythonowych typów (`str`, `int`, `float`, `bool`, `list`, itp).
+ * Obiekty `datetime`.
+ * Obiekty `UUID`.
+ * Modele baz danych.
+ * ...i wiele więcej.
+* Automatyczne interaktywne dokumentacje API, wliczając 2 alternatywne interfejsy użytkownika:
* Swagger UI.
* ReDoc.
---
-Coming back to the previous code example, **FastAPI** will:
-
-* Validate that there is an `item_id` in the path for `GET` and `PUT` requests.
-* Validate that the `item_id` is of type `int` for `GET` and `PUT` requests.
- * If it is not, the client will see a useful, clear error.
-* Check if there is an optional query parameter named `q` (as in `http://127.0.0.1:8000/items/foo?q=somequery`) for `GET` requests.
- * As the `q` parameter is declared with `= None`, it is optional.
- * Without the `None` it would be required (as is the body in the case with `PUT`).
-* For `PUT` requests to `/items/{item_id}`, Read the body as JSON:
- * Check that it has a required attribute `name` that should be a `str`.
- * Check that it has a required attribute `price` that has to be a `float`.
- * Check that it has an optional attribute `is_offer`, that should be a `bool`, if present.
- * All this would also work for deeply nested JSON objects.
-* Convert from and to JSON automatically.
-* Document everything with OpenAPI, that can be used by:
- * Interactive documentation systems.
- * Automatic client code generation systems, for many languages.
-* Provide 2 interactive documentation web interfaces directly.
+Wracając do poprzedniego przykładu, **FastAPI** :
+
+* Potwierdzi, że w ścieżce jest `item_id` dla żądań `GET` i `PUT`.
+* Potwierdzi, że `item_id` jest typu `int` dla żądań `GET` i `PUT`.
+ * Jeżeli nie jest, odbiorca zobaczy przydatną, przejrzystą wiadomość z błędem.
+* Sprawdzi czy w ścieżce jest opcjonalny parametr zapytania `q` (np. `http://127.0.0.1:8000/items/foo?q=somequery`) dla żądania `GET`.
+ * Jako że parametr `q` jest zadeklarowany jako `= None`, jest on opcjonalny.
+ * Gdyby tego `None` nie było, parametr ten byłby wymagany (tak jak treść żądania w żądaniu `PUT`).
+* Dla żądania `PUT` z ścieżką `/items/{item_id}`, odczyta treść żądania jako JSON:
+ * Sprawdzi czy posiada wymagany atrybut `name`, który powinien być typu `str`.
+ * Sprawdzi czy posiada wymagany atrybut `price`, który musi być typu `float`.
+ * Sprawdzi czy posiada opcjonalny atrybut `is_offer`, który (jeżeli obecny) powinien być typu `bool`.
+ * To wszystko będzie również działać dla głęboko zagnieżdżonych obiektów JSON.
+* Automatycznie konwertuje z i do JSON.
+* Dokumentuje wszystko w OpenAPI, które może być używane przez:
+ * Interaktywne systemy dokumentacji.
+ * Systemy automatycznego generowania kodu klienckiego, dla wielu języków.
+* Dostarczy bezpośrednio 2 interaktywne dokumentacje webowe.
---
-We just scratched the surface, but you already get the idea of how it all works.
+To dopiero początek, ale już masz mniej-więcej pojęcie jak to wszystko działa.
-Try changing the line with:
+Spróbuj zmienić linijkę:
```Python
return {"item_name": item.name, "item_id": item_id}
```
-...from:
+...z:
```Python
... "item_name": item.name ...
```
-...to:
+...na:
```Python
... "item_price": item.price ...
```
-...and see how your editor will auto-complete the attributes and know their types:
+...i zobacz jak edytor kodu automatycznie uzupełni atrybuty i będzie znał ich typy:
-For a more complete example including more features, see the Tutorial - User Guide.
+Dla bardziej kompletnych przykładów posiadających więcej funkcjonalności, zobacz Tutorial - User Guide.
-**Spoiler alert**: the tutorial - user guide includes:
+**Uwaga Spoiler**: tutorial - user guide zawiera:
-* Declaration of **parameters** from other different places as: **headers**, **cookies**, **form fields** and **files**.
-* How to set **validation constraints** as `maximum_length` or `regex`.
-* A very powerful and easy to use **Dependency Injection** system.
-* Security and authentication, including support for **OAuth2** with **JWT tokens** and **HTTP Basic** auth.
-* More advanced (but equally easy) techniques for declaring **deeply nested JSON models** (thanks to Pydantic).
-* Many extra features (thanks to Starlette) as:
- * **WebSockets**
+* Deklaracje **parametrów** z innych miejsc takich jak: **nagłówki**, **pliki cookies**, **formularze** i **pliki**.
+* Jak ustawić **ograniczenia walidacyjne** takie jak `maksymalna długość` lub `regex`.
+* Potężny i łatwy w użyciu system **Dependency Injection**.
+* Zabezpieczenia i autentykacja, wliczając wsparcie dla **OAuth2** z **tokenami JWT** oraz autoryzacją **HTTP Basic**.
+* Bardziej zaawansowane (ale równie proste) techniki deklarowania **głęboko zagnieżdżonych modeli JSON** (dzięki Pydantic).
+* Wiele dodatkowych funkcji (dzięki Starlette) takie jak:
+ * **WebSockety**
* **GraphQL**
- * extremely easy tests based on `requests` and `pytest`
+ * bardzo proste testy bazujące na `requests` oraz `pytest`
* **CORS**
- * **Cookie Sessions**
- * ...and more.
+ * **Sesje cookie**
+ * ...i więcej.
-## Performance
+## Wydajność
-Independent TechEmpower benchmarks show **FastAPI** applications running under Uvicorn as one of the fastest Python frameworks available, only below Starlette and Uvicorn themselves (used internally by FastAPI). (*)
+Niezależne benchmarki TechEmpower pokazują, że **FastAPI** (uruchomiony na serwerze Uvicorn) jest jednym z najszybszych dostępnych Pythonowych frameworków, zaraz po Starlette i Uvicorn (używanymi wewnątrznie przez FastAPI). (*)
-To understand more about it, see the section Benchmarks.
+Aby dowiedzieć się o tym więcej, zobacz sekcję Benchmarks.
-## Optional Dependencies
+## Opcjonalne zależności
-Used by Pydantic:
+Używane przez Pydantic:
-* ujson - for faster JSON "parsing".
-* email_validator - for email validation.
+* ujson - dla szybszego "parsowania" danych JSON.
+* email_validator - dla walidacji adresów email.
-Used by Starlette:
+Używane przez Starlette:
-* requests - Required if you want to use the `TestClient`.
-* aiofiles - Required if you want to use `FileResponse` or `StaticFiles`.
-* jinja2 - Required if you want to use the default template configuration.
-* python-multipart - Required if you want to support form "parsing", with `request.form()`.
-* itsdangerous - Required for `SessionMiddleware` support.
-* pyyaml - Required for Starlette's `SchemaGenerator` support (you probably don't need it with FastAPI).
-* graphene - Required for `GraphQLApp` support.
-* ujson - Required if you want to use `UJSONResponse`.
+* requests - Wymagane jeżeli chcesz korzystać z `TestClient`.
+* aiofiles - Wymagane jeżeli chcesz korzystać z `FileResponse` albo `StaticFiles`.
+* jinja2 - Wymagane jeżeli chcesz używać domyślnej konfiguracji szablonów.
+* python-multipart - Wymagane jeżelich chcesz wsparcie "parsowania" formularzy, używając `request.form()`.
+* itsdangerous - Wymagany dla wsparcia `SessionMiddleware`.
+* pyyaml - Wymagane dla wsparcia `SchemaGenerator` z Starlette (z FastAPI prawdopodobnie tego nie potrzebujesz).
+* graphene - Wymagane dla wsparcia `GraphQLApp`.
+* ujson - Wymagane jeżeli chcesz korzystać z `UJSONResponse`.
-Used by FastAPI / Starlette:
+Używane przez FastAPI / Starlette:
-* uvicorn - for the server that loads and serves your application.
-* orjson - Required if you want to use `ORJSONResponse`.
+* uvicorn - jako serwer, który ładuje i obsługuje Twoją aplikację.
+* orjson - Wymagane jeżeli chcesz używać `ORJSONResponse`.
-You can install all of these with `pip install fastapi[all]`.
+Możesz zainstalować wszystkie te aplikacje przy pomocy `pip install fastapi[all]`.
-## License
+## Licencja
-This project is licensed under the terms of the MIT license.
+Ten projekt jest na licencji MIT.