FastComments.com

SDK do FastComments para Python

Este é o SDK oficial em Python para o FastComments.

SDK oficial em Python para a API do FastComments

Repositório

Ver no GitHub


Instalação Internal Link

Instalar a partir do GitHub

Instale diretamente a partir de uma tag de release (recomendado, totalmente reproduzível):

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

Fixe a tag em vez de um branch para que as builds sejam determinísticas. O mesmo formato funciona em requirements.txt:

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

Cada release marcado no GitHub Release também tem um wheel compilado anexado, caso você prefira instalar um artefato binário diretamente.

Conteúdo da Biblioteca

Esta biblioteca contém dois módulos: o cliente API gerado e a biblioteca principal Python que contém utilitários escritos à mão para facilitar o trabalho com a API, incluindo suporte a SSO.

APIs Públicas vs Seguras

Para o cliente API, há três classes, DefaultApi, PublicApi e ModerationApi. O DefaultApi contém métodos que requerem sua chave de API, e o PublicApi contém métodos que podem ser chamados diretamente de um navegador/dispositivo móvel/etc sem autenticação. O ModerationApi fornece um conjunto extenso de APIs de moderação ao vivo e rápidas. Cada método do ModerationApi aceita um parâmetro sso e pode autenticar via SSO ou um cookie de sessão do FastComments.com.

Notas Internal Link

IDs de Broadcast

Você verá que deve passar um broadcast_id em algumas chamadas de API. Quando você receber eventos, receberá esse ID de volta, assim você saberá ignorar o evento se planejar aplicar alterações de forma otimista no cliente (o que provavelmente você vai querer fazer, já que oferece a melhor experiência). Passe um UUID aqui. O ID deve ser suficientemente único para não ocorrer duas vezes em uma sessão do navegador.

Requisitos Internal Link

  • Python >= 3.8

A instalação base é puro-stdlib e fornece as utilidades SSO. O cliente API gerado (DefaultApi/PublicApi/ModerationApi) precisa do extra client, que traz urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 e typing-extensions >= 4.0.0:

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

Precisa de ajuda?

Se você encontrar algum problema ou tiver dúvidas sobre o SDK do Python, por favor:

Contribuindo

Contribuições são bem-vindas! Por favor, visite o repositório do GitHub para obter as diretrizes de contribuição.