FastComments.com

FastComments の Python SDK

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

FastComments API の公式 Python SDK

リポジトリ

GitHub で表示


インストール Internal Link

Install from GitHub

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

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

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

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

各タグ付けされた GitHub Release には、バイナリ成果物として直接インストールできるビルトホイールも添付されています。

Library Contents

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

Public vs Secured APIs

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

ベースインストールは純粋な標準ライブラリで、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.0.0"

お困りですか?

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

貢献

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