Mustafid
4 days ago
committed by
GitHub
GitHub
1 changed files with 208 additions and 0 deletions
@ -0,0 +1,208 @@ |
|||
# Fitur |
|||
|
|||
## Fitur FastAPI |
|||
|
|||
**FastAPI** memberi Anda hal-hal berikut: |
|||
|
|||
### Berdasarkan standar terbuka |
|||
|
|||
* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> untuk pembuatan API, termasuk deklarasi <abbr title="juga dikenal sebagai: endpoint atau route">path</abbr> <abbr title="juga dikenal sebagai Metode HTTP, seperti POST, GET, PUT, DELETE">operasi</abbr>, parameter, request body, keamanan, dll. |
|||
* Dokumentasi model data otomatis dengan <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON Schema</strong></a> (karena OpenAPI sendiri didasarkan pada JSON Schema). |
|||
* Dirancang berdasarkan standar-standar ini setelah studi yang cermat, bukan sebagai lapisan tambahan yang dibuat belakangan. |
|||
* Hal ini juga memungkinkan penggunaan **pembuatan kode klien** secara otomatis dalam berbagai bahasa pemrograman. |
|||
|
|||
### Dokumentasi Otomatis |
|||
|
|||
Antarmuka pengguna web untuk dokumentasi dan eksplorasi API yang interaktif. Karena framework ini didasarkan pada OpenAPI, tersedia berbagai pilihan, dengan 2 di antaranya sudah disertakan secara bawaan. |
|||
|
|||
* <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank"><strong>Swagger UI</strong></a>, dengan eksplorasi interaktif, Anda bisa langsung memanggil dan menguji API dari peramban. |
|||
|
|||
 |
|||
|
|||
* Dokumentasi API alternatif dengan <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank"><strong>ReDoc</strong></a>. |
|||
|
|||
 |
|||
|
|||
### Hanya Python Modern |
|||
|
|||
Semuanya didasarkan pada deklarasi **tipe Python** standar (berkat Pydantic). Tidak ada sintaks baru yang perlu dipelajari. Cukup Python modern standar. |
|||
|
|||
Jika Anda membutuhkan penyegaran 2 menit tentang cara menggunakan tipe Python (bahkan jika Anda tidak menggunakan FastAPI), periksa tutorial singkat: [Python Types](python-types.md){.internal-link target=_blank}. |
|||
|
|||
Anda cukup menulis Python standar dengan tipe: |
|||
|
|||
```Python |
|||
from datetime import date |
|||
|
|||
from pydantic import BaseModel |
|||
|
|||
# Mendeklarasikan variabel sebagai string (str) |
|||
# dan mendapatkan dukungan editor di dalam fungsi tersebut |
|||
def main(user_id: str): |
|||
return user_id |
|||
|
|||
|
|||
# Sebuah model Pydantic |
|||
class User(BaseModel): |
|||
id: int |
|||
name: str |
|||
joined: date |
|||
``` |
|||
|
|||
Fungsi tersebut kemudian bisa digunakan seperti berikut: |
|||
|
|||
```Python |
|||
my_user: User = User(id=3, name="John Doe", joined="2018-07-19") |
|||
|
|||
second_user_data = { |
|||
"id": 4, |
|||
"name": "Mary", |
|||
"joined": "2018-11-30", |
|||
} |
|||
|
|||
my_second_user: User = User(**second_user_data) |
|||
``` |
|||
|
|||
/// info |
|||
|
|||
`**second_user_data` berarti: |
|||
|
|||
Ambil pasangan kunci dan nilai dari Kamus (Dicts) `second_user_data` secara langsung sebagai argumen kunci-nilai, setara dengan: `User(id=4, name="Mary", joined="2018-11-30")`. |
|||
|
|||
/// |
|||
|
|||
### Bantuan Editor |
|||
|
|||
Seluruh framework dirancang agar mudah dan intuitif untuk digunakan, semua keputusan telah diuji pada berbagai editor bahkan sebelum pengembangan dimulai, demi memastikan pengalaman pengembangan terbaik. |
|||
|
|||
Dalam survei pengembang Python, jelas bahwa <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank"> salah satu fitur yang paling banyak digunakan adalah "pelengkapan otomatis" (autocompletion)</a>. |
|||
|
|||
Seluruh framework **FastAPI** dirancang untuk memenuhi kebutuhan tersebut. Pelengkapan otomatis berfungsi di mana pun. |
|||
|
|||
Anda akan jarang perlu kembali ke dokumentasi. |
|||
|
|||
Berikut adalah contoh bagaimana editor Anda dapat membantu Anda: |
|||
|
|||
* Di <a href="https://code.visualstudio.com/" class="external-link" target="_blank">Visual Studio Code</a>: |
|||
|
|||
 |
|||
|
|||
* Di <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>: |
|||
|
|||
 |
|||
|
|||
Anda akan mendapatkan pelengkapan otomatis dalam kode yang mungkin sebelumnya Anda anggap mustahil. Contohnya, kunci `price` di dalam body JSON (yang bisa saja bersarang) yang berasal dari sebuah request. |
|||
|
|||
Tidak ada lagi kesalahan penulisan nama kunci, bolak-balik antara dokumentasi, atau scroll naik-turun untuk mencari apakah Anda pada akhirnya menggunakan `username` atau `user_name`. |
|||
|
|||
|
|||
### Ringkas |
|||
|
|||
Framework ini memiliki pengaturan **bawaan** yang masuk akal untuk segala hal, dengan konfigurasi opsional di setiap bagian. Semua parameter bisa disesuaikan dengan cermat untuk memenuhi kebutuhan Anda dan mendefinisikan API yang Anda inginkan. |
|||
|
|||
Namun secara bawaan, semuanya **berjalan begitu saja**. |
|||
|
|||
|
|||
### Validasi |
|||
|
|||
* Validasi untuk sebagian besar (atau semua?) **tipe data** Python, termasuk: |
|||
* Objek JSON (`dict`). |
|||
* Array JSON (`list`) yang mendefinisikan tipe item. |
|||
* String (`str`) field, yang mendefinisikan panjang minimal dan maksimal. |
|||
* Angka (`int`, `float`) dengan nilai minimal dan maksimal, dan lain-lain. |
|||
|
|||
* Validasi untuk tipe yang lebih kompleks, seperti: |
|||
* URL. |
|||
* Email. |
|||
* UUID. |
|||
* ...dan lainnya. |
|||
|
|||
Semua validasi ditangani oleh **Pydantic** yang sudah mapan dan tangguh. |
|||
|
|||
### Keamanan dan Otentikasi |
|||
|
|||
Keamanan dan otentikasi terintegrasi, tanpa kompromi dengan basis data atau model data apa pun. |
|||
|
|||
Semua skema keamanan yang didefinisikan dalam OpenAPI dapat didukung, termasuk: |
|||
|
|||
* HTTP Basic. |
|||
* **OAuth2** (juga dengan **JWT tokens**). Anda bisa melihat tutorial disini [OAuth2 with JWT](tutorial/security/oauth2-jwt.md){.internal-link target=_blank}. |
|||
* Kunci API di: |
|||
* Headers. |
|||
* Query parameters. |
|||
* Cookies, dll. |
|||
|
|||
Ditambah semua fitur keamanan dari Starlette (termasuk **session cookies**). |
|||
|
|||
Semua fitur ini dibangun sebagai alat dan komponen yang dapat digunakan kembali, mudah diintegrasikan dengan sistem Anda, penyimpanan data, basis data relasional, dan NoSQL, dll. |
|||
|
|||
|
|||
### Injeksi Dependensi (Dependency Injection) |
|||
|
|||
FastAPI menyertakan sistem <abbr title='juga dikenal sebagai "komponen", "resource", "service", "provider"'><strong>Injeksi Dependensi</strong></abbr> yang sangat mudah digunakan namun sangat kuat. |
|||
|
|||
* Bahkan dependensi dapat memiliki dependensi yang lain, menciptakan hierarki atau **"grafik" dependensi**. |
|||
* Semua **ditangani secara otomatis** oleh framework. |
|||
* Semua dependensi dapat meminta data dari request dan **menambah batasan operasi path** serta dokumentasi otomatis. |
|||
* **Validasi otomatis** bahkan untuk **parameter path operation** yang didefinisikan dalam dependensi. |
|||
* Dukungan untuk sistem otentikasi pengguna yang kompleks, **koneksi basis data**, dll. |
|||
* **Tidak ada kompromi** dengan basis data, frontend, dll., tetapi integrasi yang mudah dengan semuanya. |
|||
|
|||
|
|||
### "Plug-in" Tak Terbatas |
|||
|
|||
Atau dengan kata lain, tidak perlu "plug-in", cukup impor dan gunakan kode yang Anda butuhkan. |
|||
|
|||
Setiap integrasi dirancang agar sangat mudah digunakan (dengan dependensi) sehingga Anda dapat membuat "plug-in" untuk aplikasi Anda hanya dalam 2 baris kode menggunakan struktur dan sintaks yang sama dengan yang digunakan untuk **path operations** Anda. |
|||
|
|||
|
|||
### Teruji |
|||
|
|||
* 100% <abbr title="Jumlah kode yang diuji secara otomatis">cakupan pengujian</abbr>. |
|||
* 100% basis kode dengan <abbr title="Anotasi tipe Python, agar editor dan alat eksternal dapat memberikan dukungan yang lebih baik">anotasi tipe</abbr>. |
|||
* Digunakan dalam aplikasi produksi. |
|||
|
|||
|
|||
## Fitur Starlette |
|||
|
|||
**FastAPI** sepenuhnya kompatibel dengan (dan berbasis pada) <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong></a>. Jadi, kode Starlette tambahan apa pun yang Anda miliki juga akan berfungsi. |
|||
|
|||
`FastAPI` sebenarnya adalah sub-kelas dari `Starlette`. Jadi, jika Anda sudah tahu atau menggunakan Starlette, sebagian besar fungsionalitasnya akan bekerja dengan cara yang sama. |
|||
|
|||
Dengan **FastAPI**, Anda mendapatkan semua fitur **Starlette** (karena FastAPI hanyalah Starlette yang lebih canggih): |
|||
|
|||
* Performa yang sangat mengesankan. Ini adalah <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">salah satu framework Python tercepat yang tersedia, setara dengan **NodeJS** dan **Go**</a>. |
|||
* Dukungan **WebSocket**. |
|||
* Tugas latar belakang dalam proses.. |
|||
* Event startup dan shutdown. |
|||
* Klien pengujian yang dibangun di atas HTTPX. |
|||
* **CORS**, GZip, Static Files, Streaming responses. |
|||
* Dukungan **Sesi and Cookie**. |
|||
* 100% cakupan pengujian. |
|||
* 100% basis kode dengan anotasi tipe. |
|||
|
|||
|
|||
## Fitur Pydantic |
|||
|
|||
**FastAPI** sepenuhnya kompatibel dengan (dan berbasis pada) <a href="https://docs.pydantic.dev/" class="external-link" target="_blank"><strong>Pydantic</strong></a>. Jadi, kode Pydantic tambahan apa pun yang Anda miliki juga akan berfungsi. |
|||
|
|||
Termasuk pustaka eksternal yang juga berbasis Pydantic, seperti <abbr title="Object-Relational Mapper">ORM</abbr>, <abbr title="Object-Document Mapper">ODM</abbr> untuk basis data. |
|||
|
|||
Ini juga berarti bahwa dalam banyak kasus, Anda dapat meneruskan objek yang Anda dapatkan dari request **langsung ke basis data**, karena semuanya divalidasi secara otomatis. |
|||
|
|||
Hal yang sama berlaku sebaliknya, dalam banyak kasus Anda dapat langsung meneruskan objek yang Anda dapatkan dari basis data **langsung ke klien**. |
|||
|
|||
Dengan **FastAPI**, Anda mendapatkan semua fitur **Pydantic** (karena FastAPI berbasis pada Pydantic untuk semua penanganan data): |
|||
|
|||
* **Tidak membingungkan**: |
|||
* Tidak ada bahasa mikro definisi skema baru yang perlu dipelajari. |
|||
* Jika Anda tahu tipe Python, Anda tahu cara menggunakan Pydantic. |
|||
* Berfungsi dengan baik dengan **<abbr title="Integrated Development Environment, mirip dengan editor kode">IDE</abbr>/<abbr title="program yang memeriksa kesalahan kode">linter</abbr>/brain**: |
|||
* Karena struktur data Pydantic hanyalah instans dari kelas yang Anda definisikan; pelengkapan otomatis, linting, mypy, dan intuisi Anda akan berfungsi dengan baik dengan data yang telah divalidasi. |
|||
* Validasi **struktur kompleks**: |
|||
* Penggunaan model Pydantic hierarkis, `List` and `Dict` dari `typing` Python, dll. |
|||
* Dan validator memungkinkan skema data kompleks didefinisikan, diperiksa, dan didokumentasikan dengan jelas dan mudah sebagai JSON Schema. |
|||
* Anda dapat memiliki objek **JSON yang bersarang** dalam dan semuanya tervalidasi serta teranotasi. |
|||
* **Dapat diperluas**: |
|||
* Pydantic memungkinkan tipe data kustom didefinisikan atau Anda dapat memperluas validasi dengan metode pada model yang dihiasi dengan decorator validator. |
|||
* 100% cakupan pengujian. |
|||
Loading…
Reference in new issue