FastComments.com

SDK de FastComments para Python


Este es el SDK oficial de Python para FastComments.

SDK oficial de Python para la API de FastComments

Repositorio

Ver en GitHub


Instalación Internal Link

Instalar desde GitHub

Instale directamente desde una etiqueta de lanzamiento (recomendado, totalmente reproducible):

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

Fije la etiqueta en lugar de una rama para que las compilaciones sean determinísticas. La misma forma funciona en requirements.txt:

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

Cada GitHub Release etiquetado también tiene una rueda construida adjunta si prefiere instalar un artefacto binario directamente.

Contenido de la Biblioteca

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

APIs Públicas vs Seguras

Para el cliente API, hay tres clases, DefaultApi, PublicApi y ModerationApi. La DefaultApi contiene métodos que requieren su clave API, y la PublicApi contiene métodos que pueden ejecutarse directamente desde un navegador/dispositivo móvil/etc sin autenticación. La ModerationApi proporciona una suite extensa de APIs de moderación en tiempo real y rápidas. Cada método de ModerationApi acepta un parámetro sso y puede autenticarse vía SSO o mediante 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 pura-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.0.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.