Add public bounded flush API

Abierto
#145 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
45/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
elixir
Área
backend

Línea de trabajo

Comienza leyendo la implementación de PostHog.Sender y la especificación de flush referenciada de sdk-specs para comprender el comportamiento de la cola y el contrato requerido. Define la API pública PostHog.flush, su comportamiento con instancias con nombre y con timeouts; después, añade pruebas y documentación que muestren colas vacías, esperas acotadas, entrega inmediata e informes de estado.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement

Summary

Add a public bounded flush API.

Why

sdk-specs marks flush as applicable to both client and server SDKs. Backend users need deterministic delivery before process/request boundaries, tests, scripts, and serverless exits.

Current status

PostHog.Sender flushes on batch size, timer, and GenServer termination, but there is no public flush API. Python has a related issue about adding a max timeout to flush: https://github.com/PostHog/posthog-python/issues/79.

Suggested scope

  • Add a public PostHog.flush/1 or PostHog.flush/2 accepting a named instance and timeout.
  • Flush all sender queues immediately without waiting for threshold/timer.
  • Return safely when queues are empty.
  • Bound the wait with a timeout and return/report status rather than blocking indefinitely.
  • Preserve retryable failed events for future retry once retry queue support exists.
  • Add tests and docs.

References

Lenguaje dominante
Elixir
Estrellas
66
Forks
33
Merge medio
1 d 22 h
PR fusionados (30 d)
21

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de PostHog/posthog-elixir

Todos los issues de PostHog/posthog-elixir

Issues similares

Más issues de Elixir

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.