FastComments.com

FastComments SDK de Python

Este es el SDK oficial de Python para FastComments.

SDK oficial de Python para la API de FastComments

Repositorio

Ver en GitHub

Agentes de codificación IA Internal Link

skills.sh

Da a tu agente de codificación el contexto de FastComments que necesita: widgets, configuración, Secure SSO, la API REST y los SDKs:

npx skills add fastcomments/skills

Funciona con Claude Code, Codex, Cursor, Copilot, Gemini y cualquier otro agente que soporte el skills CLI.

Instalación Internal Link

Instalar desde GitHub

Instala directamente desde una etiqueta de release (recomendado, totalmente reproducible):

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

Fija la etiqueta en lugar de una rama para que las compilaciones sean deterministas. La misma forma funciona en requirements.txt:

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

Cada GitHub Release etiquetado también tiene un wheel compilado adjunto si prefieres instalar un artefacto binario directamente.

Contenido de la Librería

Esta librería contiene dos módulos: el cliente de API generado y la librería principal de Python que contiene utilidades escritas a mano para facilitar el trabajo con la API, incluyendo soporte para SSO.

APIs Públicas vs Aseguradas

Para el cliente de API, hay tres clases: DefaultApi, PublicApi y ModerationApi. La DefaultApi contiene métodos que requieren tu clave de API, y la PublicApi contiene métodos que pueden realizarse directamente desde un navegador/dispositivo móvil/etc sin autenticación. La ModerationApi proporciona un extenso conjunto de APIs de moderación en vivo y rápidas. Cada método de ModerationApi acepta un parámetro sso y puede autenticarse mediante SSO o una cookie de sesión de FastComments.com.

Notas Internal Link

IDs de transmisión

Verás que se supone que debes pasar un broadcast_id en algunas llamadas a la API. Cuando recibas eventos, obtendrás este ID de vuelta, por lo que sabrás ignorar el evento si planeas aplicar cambios de forma optimista en el cliente (lo que probablemente querrás hacer porque ofrece la mejor experiencia). Pasa un UUID aquí. El ID debe ser lo suficientemente único como para no ocurrir dos veces en una sesión del navegador.

Requisitos Internal Link

  • Python >= 3.8

La instalación base es pure-stdlib y proporciona las utilidades SSO.
El cliente API generado (DefaultApi/PublicApi/ModerationApi) necesita el extra client, que incluye urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 y typing-extensions >= 4.0.0:

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

¿Necesita ayuda?

Si encuentra algún problema o tiene preguntas sobre el SDK de Python, por favor:

Contribuciones

¡Las contribuciones son bienvenidas! Por favor visite el repositorio de GitHub para las directrices de contribución.