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

Instala directamente desde una etiqueta de lanzamiento (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 determinísticas. El mismo formato funciona en requirements.txt:

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

Cada GitHub Release etiquetado también tiene una rueda (wheel) adjunta si prefieres 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 incluye 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. DefaultApi contiene métodos que requieren tu clave API, y PublicApi contiene métodos que pueden ejecutarse directamente desde un navegador/dispositivo móvil/etc. sin autenticación. ModerationApi ofrece una amplia suite de APIs de moderación en tiempo real 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.