FastComments.com

FastComments の Python SDK

これは FastComments の公式 Python SDK です。

FastComments API の公式 Python SDK

リポジトリ

GitHub で表示


インストール Internal Link

GitHub からインストール

リリースタグから直接インストールします(推奨、完全に再現可能):

pip install git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0

ビルドが決定的になるように、ブランチではなくタグを固定してください。同じ形式は requirements.txt でも機能します:

fastcomments @ git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0

各タグ付き GitHub Release には、直接バイナリアーティファクトをインストールしたい場合に備えて、ビルド済みの wheel が添付されています。

ライブラリの内容

このライブラリには、生成された API クライアントと、API の利用を容易にする手書きユーティリティ(SSO サポートを含む)を含むコア Python ライブラリの 2 つのモジュールが含まれています。

パブリック API と保護された API

API クライアントには、DefaultApiPublicApiModerationApi の 3 つのクラスがあります。DefaultApi には API キーが必要なメソッドが含まれ、PublicApi には認証なしでブラウザやモバイルデバイスなどから直接呼び出せるメソッドが含まれます。ModerationApi は、ライブかつ高速なモデレーション API の包括的なスイートを提供します。すべての ModerationApi メソッドは sso パラメータを受け取り、SSO または FastComments.com のセッションクッキーで認証できます。

注意事項 Internal Link

ブロードキャストID

一部のAPI呼び出しでは broadcast_id を渡す必要があることが分かるでしょう。イベントを受信すると、このIDが返されるので、クライアント側で楽観的に変更を適用する予定がある場合にそのイベントを無視すべきかを判断できます(ユーザー体験が最も良いため、おそらくそうするでしょう)。ここにはUUIDを渡してください。そのIDは、同じブラウザセッション内で重複しない程度に十分一意である必要があります。

要件 Internal Link


  • Python >= 3.8

ベースインストールは pure-stdlib で、SSO ユーティリティを提供します。生成された API クライアント(DefaultApi/PublicApi/ModerationApi)は client エクストラが必要で、 urllib3 >= 1.25.3python-dateutil >= 2.8.2pydantic >= 2.0.0、および typing-extensions >= 4.0.0 を取得します:

pip install "fastcomments[client] @ git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0"

お困りですか?

Python SDK に関して問題が発生したり質問がある場合は、次をご利用ください:

貢献

貢献は歓迎します!貢献ガイドラインについてはGitHubリポジトリをご覧ください。