Closes #25 and #26 — one API redesign in two halves. Auto-registry (#25): Benchwarmer::Job.inherited registers each named subclass under its job_type in Benchwarmer::Job.registry. Queue, Worker, and Web default their registry to this global hash, so consuming apps never build one by hand; an explicit registry: still overrides it (the injected-registry test seam and per-app isolation both keep working). Anonymous classes (Class.new(Job)) have no name and are skipped. Named parameters (#26): base Job#initialize(**params) captures constructor kwargs. Queue#enqueue now accepts a Job class (positional args:), a Job instance (its kwargs become the payload), or a type string. Instance kwargs serialize into the args column as a JSON object; args: arrays serialize as JSON arrays. The worker parses the payload and dispatches Array -> perform(*args), Object -> perform(**symbolized). Args must be JSON-serializable — non-native values raise ArgumentError at enqueue time (JSON strict mode) instead of failing inside the worker. Ripple effects: Job#enqueue_child and Queue#schedule (type: accepts a class) get the same flexibility; retry copies args verbatim so object payloads round-trip; the web enqueue form accepts a JSON array OR object (422 only for a bare scalar) and defaults its registry to the auto-registry via a deferred read so late-defined jobs appear. examples/, tasks/dev.rake, and README updated to the new API — no hand-built registry anywhere. Breaking changes (pre-1.0): - Worker.new/Queue.new registry: is now optional (defaults to the global auto-registry) rather than required. - Queue#enqueue's first positional arg is now a class/instance/string (was a type string only) — strings still work. - Enqueue args are validated with JSON strict mode: values that aren't JSON-native (arbitrary objects, Time, Proc) now raise ArgumentError at enqueue time instead of being silently coerced to strings. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Commits

Commits on Jul 9, 2026

Redesign enqueue API: auto-registry + named-parameter jobs