FastComments.com

FastComments SDK Python

Este é o SDK oficial em Python para o FastComments.

SDK oficial em Python para a API do FastComments

Repositório

Ver no GitHub


Agentes de codificação IA Internal Link

skills.sh

Forneça ao seu agente de codificação o contexto do FastComments que ele precisa - widgets, configuração, Secure SSO, a REST API e os SDKs:

npx skills add fastcomments/skills

Funciona com Claude Code, Codex, Cursor, Copilot, Gemini e todos os outros agentes que o skills CLI suporta.

Instalação Internal Link

Instalar 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.1.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.1.0

Cada Release do GitHub marcado também tem um wheel compilado anexado se você preferir instalar um artefato binário diretamente.

Conteúdo da Biblioteca

Esta biblioteca contém dois módulos: o cliente de 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 de 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.

Observações 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 é pure-stdlib e fornece as utilidades SSO. O cliente API gerado (DefaultApi/PublicApi/ModerationApi) precisa do extra client, que inclui 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.1.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.