本文講述了什么啟發(fā)了 FastAPI 的誕生，它與其他替代框架的對(duì)比，以及從中汲取的經(jīng)驗(yàn)。如果不是基于前人的成果，F(xiàn)astAPI 將不會(huì)存在。在 FastAPI 之前，前人已經(jīng)創(chuàng)建了許多工具 。幾年來(lái)，我一直在避免創(chuàng)建新框架。首先，我嘗試使用許多不同的框架，插件和工具來(lái)解決 FastAPI 涵蓋的所有功能。

　　但是有時(shí)候，沒(méi)有更好的辦法，除了創(chuàng)建具有所有這些功能的東西，從以前的工具中汲取最佳創(chuàng)意，并以最佳方式將它們組合起來(lái)，使用以前甚至沒(méi)有的語(yǔ)言功能（Python 3.6+類型提示）。

　　啟發(fā)過(guò) FastAPI 的框架

　　Django

　　Django 是最流行的 Python 框架，受到廣泛信任。它用于構(gòu)建 Instagram 之類的系統(tǒng)。

　　它與關(guān)系數(shù)據(jù)庫(kù)（例如 MySQL 或 PostgreSQL）相對(duì)緊密地結(jié)合在一起，因此，以NoSQL 數(shù)據(jù)庫(kù)（例如 Couchbase，MongoDB，Cassandra 等）作為 django 的主存儲(chǔ)引擎并不是一件容易的事。

　　Django REST Framework

　　Django REST Framework 是一個(gè)非常靈活的框架，用于構(gòu)建 Web API，以改善 Django 的 API 功能。

　　Mozilla，Red Hat 和 Eventbrite 等許多公司都使用它。

　　Django REST Framework 是第一個(gè)自動(dòng)生成 API 文檔的框架，自動(dòng)生成 API 的接口文檔是 FastAPI 框架誕生的緣由之一。

　　注意

　　Django REST Framework 框架的作者是 Tom Christie ，Tom Christie 也創(chuàng)造了 Starlette和 Uvicorn。FastAPI 正是建立在 Starlette 和 Uvicorn 的基礎(chǔ)之上。

　　啟發(fā) FastAPI 地方：有一個(gè)自動(dòng) API 文檔，Web 用戶界面可供用戶測(cè)試。

　　Flask

　　Flask 是一種輕量級(jí)的框架，它不包括數(shù)據(jù)庫(kù)集成，也沒(méi)有很多的附帶的功能，雖然這Django 那里是默認(rèn)提供的。

　　這個(gè)簡(jiǎn)單性和靈活的特性允許使用 NoSQL 數(shù)據(jù)庫(kù)作為主數(shù)據(jù)存儲(chǔ)。盡管文檔在某些方面有所技術(shù)性，但它非常簡(jiǎn)單，因此學(xué)習(xí)起來(lái)相對(duì)直觀。

　　它還常用于其他不需要數(shù)據(jù)庫(kù)，用戶管理或 Django 中預(yù)建功能的應(yīng)用程序。盡管其中許多功能都可以通過(guò)添加插件來(lái)實(shí)現(xiàn)。

　　各個(gè)模塊之前的解耦，使之成為一個(gè)“微框架”，可以通過(guò)擴(kuò)展為精確地提供所需的東西，這是我想要保留的一項(xiàng)關(guān)鍵功能。

　　考慮到 Flask 的簡(jiǎn)單性，它似乎很適合構(gòu)建 API。接下來(lái)要找到的是 Flask的 “ Django REST Framework”。

　　啟發(fā) FastAPI 地方：成為一個(gè)微框架。易于混合和匹配所需的工具和零件。擁有一個(gè)簡(jiǎn)單易用的路由系統(tǒng)。

　　Requests

　　FastAPI 實(shí)際上不是 Requests 的替代工具。它們的適用范圍非常不同。實(shí)際上，在FastAPI 應(yīng)用程序內(nèi)部使用 Requests 是很常見的。

　　但是，F(xiàn)astAPI 從 Requests 中獲得了很多啟發(fā)。Requests 是一個(gè)與API（作為客戶端）進(jìn)行交互的庫(kù)，而 FastAPI 是一個(gè)用于構(gòu)建 API（作為服務(wù)器）的庫(kù)。它們或多或少地處于相反的末端，彼此互補(bǔ)。Requests 具有非常簡(jiǎn)單直觀的設(shè)計(jì)，非常易于使用，并具有合理的默認(rèn)值。但同時(shí)，它非常強(qiáng)大且可自定義。

　　這就是為什么，如官方網(wǎng)站所述：

　　Requests 是有史以來(lái)下載次數(shù)最多的Python軟件包之一

　　您的使用方式非常簡(jiǎn)單。例如，要發(fā)出GET請(qǐng)求，您可以編寫：

　　response = requests.get（“http://example.com/some/url”）

　　FastAPI 對(duì)應(yīng)的 API 路徑操作如下所示：

　　@app.get（“/some/url”）

　　def read_url（）：

　　return {“message”： “Hello World”}

　　它們使用起來(lái)的相似之處如 requests.get（…） 和 @app.get（…）。

　　啟發(fā) FastAPI 地方：

　　擁有簡(jiǎn)單直觀的API。

　　直接，直觀地使用HTTP方法名稱（操作）。

　　具有合理的默認(rèn)值，功能強(qiáng)大的自定義。

　　Swagger / OpenAPI

　　我想要 Django REST Framework 的主要功能是自動(dòng) API 文檔。然后我發(fā)現(xiàn) API 文檔有一個(gè)標(biāo)準(zhǔn)叫 Swagger ，它使用 JSON 或 YAML 來(lái)描述。

　　并且 Swagger API 的 Web 用戶界面已經(jīng)被人創(chuàng)建出來(lái)了。因此，能夠?yàn)?API 生成Swagger 文檔將允許自動(dòng)使用此 Web 用戶界面。

　　在某個(gè)時(shí)候，Swagger 被授予 Linux Foundation，將其重命名為 OpenAPI。這就是為什么在談?wù)摪姹?2.0 時(shí)通常會(huì)說(shuō)“ Swagger”，對(duì)于版本3+來(lái)說(shuō)是“ OpenAPI”。

　　啟發(fā) FastAPI 地方：

　　為API規(guī)范采用開放標(biāo)準(zhǔn)，而不是使用自定義架構(gòu)。并集成基于標(biāo)準(zhǔn)的用戶界面工具：

　　Swagger UI

　　ReDoc

　　選擇這兩個(gè)是因?yàn)樗鼈兿喈?dāng)受歡迎且穩(wěn)定，但是通過(guò)快速搜索，您可以找到數(shù)十個(gè) OpenAPI 的其他替代用戶界面（可以與FastAPI一起使用）。

　　Flask REST frameworks

　　有幾個(gè) Flask REST frameworks ，但經(jīng)過(guò)調(diào)查和試用，我發(fā)現(xiàn)，不少項(xiàng)目都停產(chǎn)或放棄，還存在有一些長(zhǎng)期的問(wèn)題，使得它們并不適合解決前面的問(wèn)題。

　　Marshmallow

　　一個(gè)由 API 系統(tǒng)所需的主要功能是數(shù)據(jù)的序列化，就是把數(shù)據(jù)從編程語(yǔ)言中的對(duì)象轉(zhuǎn)稱成可以在網(wǎng)絡(luò)上傳輸?shù)膶?duì)象，比如數(shù)據(jù)庫(kù)中的數(shù)據(jù)轉(zhuǎn)換為 JSON 對(duì)象。將 Python 中的datetime 對(duì)象轉(zhuǎn)為字符串，等等。

　　另外一個(gè)功能就是數(shù)據(jù)的驗(yàn)證，確保傳入的參數(shù)是有效的，例如，有些字段是一個(gè) int，類型而不是字符串，這在檢測(cè)輸入數(shù)據(jù)是非常有用的。

　　如果沒(méi)有數(shù)據(jù)驗(yàn)證，你就必須用手工寫代碼來(lái)完成所有的檢查。

　　這兩點(diǎn)功能就是 Marshmallow 所提供的，這些是一個(gè)偉大的圖書館，之前我經(jīng)常使用它。

　　Marshmallow 產(chǎn)生之前 Python 還沒(méi)有加入類型提示。因此，定義一個(gè) schema 你需要引入 Marshmallow 特定的 utils 的和類。

　　啟發(fā) FastAPI 地方：

　　使用代碼來(lái)定義提供的數(shù)據(jù)類型和驗(yàn)證的 schema，驗(yàn)證都是自動(dòng)化的。

　　FastAPI 使用的框架

　　Pydantic

　　Pydantic 是一個(gè)庫(kù)，基于Python類型提示來(lái)定義數(shù)據(jù)驗(yàn)證，序列化和文檔（使用JSON模式）。這使其非常直觀。它可與 Marshmallow 媲美。盡管在基準(zhǔn)測(cè)試中它比Marshmallow 更快。并且由于它基于相同的Python類型提示，因此對(duì)編輯器的支持非常棒。

　　FastAPI 使用它來(lái)處理所有數(shù)據(jù)驗(yàn)證，數(shù)據(jù)序列化和自動(dòng)模型文檔（基于JSON Schema）。

　　然后，F(xiàn)astAPI 會(huì)獲取該 JSON Schema 數(shù)據(jù)并將其放入OpenAPI 中，除此之外它還會(huì)執(zhí)行其他所有操作。

　　Starlette

　　Starlette 是一種輕量級(jí)的 ASGI 框架/工具包，是構(gòu)建高性能 asyncio 服務(wù)的理想選擇。

　　它非常簡(jiǎn)單直觀。它的設(shè)計(jì)易于擴(kuò)展，并具有模塊化組件。

　　它具有：

　　令人印象深刻的性能。

　　WebSocket支持。

　　GraphQL支持。

　　處理中的后臺(tái)任務(wù)。

　　啟動(dòng)和關(guān)閉事件。

　　測(cè)試基于 requests 的客戶端。

　　CORS，GZip，靜態(tài)文件，流式響應(yīng)。

　　會(huì)話和 Cookie 支持。

　　100％ 的測(cè)試覆蓋率。

　　100％ 類型注釋的代碼庫(kù)。

　　零硬依賴性。

　　Starlette 是目前測(cè)試最快的 Python 框架。只有 Uvicorn 超越了它，Uvicorn 不是框架，而是服務(wù)器。

　　Starlette 提供了所有基本的 Web 微框架功能。但是它不提供自動(dòng)數(shù)據(jù)驗(yàn)證，序列化或API 文檔。

　　這是 FastAPI 在頂部添加的主要內(nèi)容之一，全部基于Python類型提示（使用Pydantic）。以及依賴注入系統(tǒng)，安全實(shí)用程序，OpenAPI 模式生成等。

　　技術(shù)細(xì)節(jié)：ASGI 是 Django 核心團(tuán)隊(duì)成員開發(fā)的新“標(biāo)準(zhǔn)”。盡管他們正在這樣做，但它仍然不是“ Python標(biāo)準(zhǔn)”（PEP）。但是，它已經(jīng)被多種工具用作“標(biāo)準(zhǔn)”。這可以大大提高互操作性，因?yàn)槟梢詫?Uvicorn 切換到任何其他 ASGI 服務(wù)器（例如 Daphne 或 Hypercorn），也可以添加與ASGI兼容的工具，例如 python-socketio。

　　FastAPI 使用它來(lái)處理所有核心 Web 部件。在頂部添加功能。類 FastAPI 本身直接繼承Starlette。因此，使用 Starlette 可以執(zhí)行的任何操作，都可以直接使用 FastAPI 進(jìn)行。

　　Uvicorn

　　Uvicorn 是基于 uvloop 和 httptools 構(gòu)建的如閃電般快速的 ASGI 服務(wù)器。它不是Web框架，而是服務(wù)器。例如，它不提供用于按路徑進(jìn)行路由的工具。那是像 Starlette（或FastAPI）這樣的框架可以提供的。它是 Starlette 和 FastAPI 的推薦服務(wù)器。

　　FastAPI 推薦它為主 Web服務(wù)器運(yùn)行 FastAPI 應(yīng)用程序。您可以將其與 Gunicorn 結(jié)合使用，以擁有異步多進(jìn)程服務(wù)器。在“ 部署” 部分中查看更多詳細(xì)信息。

　　編輯：黃飛