fn_registry/functions/infra/job_worker_pool.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
job_worker_pool	function	go	infra	1.0.0	impure	func JobWorkerPool(ctx context.Context, q *JobQueue, n int, handler JobHandler, opts ...WorkerOption) error	Lanza n workers concurrentes que comparten la misma cola y handler. Usa errgroup para concurrencia estructurada y soporta graceful shutdown via context. Bloquea hasta que todos los workers terminen.	job queue worker pool concurrency errgroup async background infra graceful-shutdown pendiente-usar	job_worker_go_infra	job_queue_go_infra		false	error_go_core	context fmt golang.org/x/sync/errgroup	name desc ctx context que al cancelarse detiene todos los workers; si uno falla, los demas tambien se detienen name desc q cola de jobs compartida por todos los workers name desc n numero de workers concurrentes (debe ser > 0) name desc handler funcion de procesamiento compartida por todos los workers name desc opts opciones aplicadas a cada worker: WithPollInterval, WithJobTypes	primer error no-context de cualquier worker, o ctx.Err() si todos terminaron por cancelacion	true	concurrency_multiples_goroutines_dequeue	functions/infra/job_queue_test.go	functions/infra/job_worker_pool.go

Ejemplo

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

// 5 workers procesando emails en paralelo
err := JobWorkerPool(ctx, q, 5, func(job Job) error {
    return sendEmail(job)
}, WithPollInterval(100*time.Millisecond))

Notas

Usa golang.org/x/sync/errgroup. Si un worker retorna un error no-context, errgroup cancela el context derivado y todos los demas workers se detienen. El graceful shutdown ocurre al cancelar el context original.