oban-bg/oban
67.2
Adequate · 13 November 2026
11.4k
lines of production code
Elixir
primary language
8
measurements over time
What this system is
Features
Add benchmarking framework for Oban performance testing
Introduces a new benchmarking suite in the \bench\ directory to measure Oban's performance characteristics. The suite includes benchmarks for engine comparison (Basic vs. Lite), bulk insertion throughput across multiple queue sizes, and the performance impact of unique job constraints at varying insertion volumes. This allows users to evaluate and compare Oban's efficiency under different workloads and configurations.
bench · high confidence
Add migration support for MySQL and SQLite databases
Oban now supports migrating job queues to MySQL (via MyXQL) and SQLite, in addition to the existing PostgreSQL support. New migration modules (Oban.Migrations.MyXQL, Oban.Migrations.SQLite, and Oban.Migrations.Postgres) have been added to handle schema creation and version tracking for these databases. The MySQL migration defines the oban\_jobs and oban\_peers tables with appropriate constraints and indexes, while the SQLite migration sets up the oban\_jobs table with text-based state handling and SQLite-specific timestamp defaults. This allows users to run Oban on MySQL and SQLite environments.
lib/oban/migrations · high confidence
Initial configuration for Oban with multi-database test support
The application now includes a primary configuration file that sets up the timezone database to use Tz, configures the logger to output at the warning level, and defines retry backoff and options for Oban jobs. It registers three Ecto repositories for testing purposes: a PostgreSQL repository (Oban.Test.Repo), a SQLite repository (Oban.Test.LiteRepo), and a MySQL repository (Oban.Test.DolphinRepo), each with specific connection and pool settings tailored for their respective database adapters.
config · high confidence
Introduce Oban.Cron plugin for periodic job scheduling
The new \Oban.Cron\ plugin allows you to define and run jobs on a cron-like schedule. You can configure a \crontab\ in your Oban configuration with a list of \{cron\_expression, Worker}\ tuples, and the plugin will automatically enqueue jobs at the specified intervals. It supports standard cron syntax, common nicknames like \@daily\, and per-entry timezone overrides. Jobs inserted by the cron plugin are marked with a \cron\ flag and store the original expression in the job's \meta\ field for identification.
lib/oban · high confidence
New Igniter task for installing Oban
A new \mix oban.install\ Igniter task has been added to automate the setup of Oban. It detects existing Ecto repositories (supporting Postgres, MySQL, and SQLite3 adapters) and configures Oban with sensible defaults, including a one-day job retention policy and a two-hour lifeline rescue timeout. The task handles configuration in \config.exs\ and \test.exs\, adds Oban to the application supervision tree, imports formatters, and generates the necessary database migration, while gracefully handling unsupported adapters or missing repos.
lib/mix · high confidence
New PG and Isolated notifier implementations added
Oban now includes two additional notifier backends: \Oban.Notifiers.PG\, which uses Distributed Erlang Process Groups for scalable, non-transactional broadcasting across clustered nodes, and \Oban.Notifiers.Isolated\, a lightweight GenServer that relays notifications locally without external dependencies. These new modules, along with a shared \Listeners\ registry for tracking channel subscriptions, provide alternatives to the existing \Postgres\ LISTEN/NOTIFY implementation, allowing users to choose a notifier that better fits their deployment topology (clustered vs. single-node) and consistency requirements.
lib/oban/notifiers · high confidence
New cron expression parser and time calculation engine
A new \Oban.Cron.Expression\ module has been introduced to handle cron expression parsing and validation. This change adds support for validating range bounds, rejecting impossible combinations, and correctly parsing step ranges. It also introduces \next\_at/2\ and \last\_at/2\ functions to calculate the next or previous matching datetime for a given cron expression, including support for timezone-aware lookups and \@reboot\ expressions. Users relying on cron scheduling will now benefit from stricter validation and more robust time calculations.
lib/oban/cron · high confidence
New engine implementations for MySQL and SQLite3
Added \Oban.Engines.Dolphin\ for MySQL support and \Oban.Engines.Lite\ for SQLite3 support, alongside a new \Oban.Engines.Basic\ module that serves as the shared foundation for these database-specific engines. These additions allow Oban to run on databases beyond PostgreSQL, with each engine implementing the \Oban.Engine\ behaviour to handle job fetching, staging, pruning, and unique constraints using database-appropriate SQL strategies.
lib/oban/engines · high confidence
New peer coordination strategies: Database, Global, and Isolated
Oban now supports three distinct peer implementations for leader election, allowing you to choose the coordination method that fits your deployment. The new \Oban.Peers.Database\ peer coordinates leadership via the \oban\_peers\ database table, making it suitable for environments without distributed Erlang clustering (and is the default for Basic and Dolphin engines). \Oban.Peers.Global\ uses distributed Erlang global locks for clusters, while \Oban.Peers.Isolated\ provides a non-coordinating mode where the local node is always considered the leader, useful for single-node or testing setups. Each peer exposes \leader?/2\ and \get\_leader/2\ for querying the current state.
lib/oban/peers · high confidence
New queue execution and lifecycle management components
Added new modules under Oban.Queues to handle job execution and queue lifecycle: Drainer for draining queues, Executor for running individual jobs with timeout and safety controls, Producer for dispatching jobs and handling signals (including pkill), Supervisor for managing the queue process tree, and Watchman for managing shutdown and draining waits.
lib/oban/queues · high confidence
Oban facade module restructured with comprehensive type specs and documentation
The \Oban\ module has been significantly expanded to serve as a robust facade for background job operations. This change introduces extensive type specifications for configuration options, queue states, and job handling, alongside a new documentation strategy that imports content from the README. It also establishes the \use Oban\ macro for creating application-specific facade modules, enabling easier integration and configuration via the application environment.
lib · high confidence
Behavioural changes
Deprecation of legacy plugin modules in lib/oban/plugins
The plugin modules located in lib/oban/plugins (Cron, Gossip, Lifeline, Pruner, Reindexer, and Repeater) have been deprecated. Cron, Lifeline, Pruner, and Reindexer now act as thin wrappers that delegate to their new top-level counterparts (Oban.Cron, Oban.Lifeline, Oban.Pruner, and Oban.Reindexer). Gossip and Repeater have been hollowed out; they log a warning on start and ignore initialization, as Gossip is no longer needed for queue monitoring and Repeater is superseded by the Stager's automatic polling behavior. Users should migrate to the new module names or remove the deprecated plugins entirely.
lib/oban/plugins · high confidence
PostgreSQL migration schema updated to v14 with new job states and indexes
The PostgreSQL migration module has been advanced to version 14, introducing a new 'suspended' job state and adding database indexes on the state combined with cancelled\_at and discarded\_at columns to improve query performance for these specific job statuses.
lib/oban/migrations/postgres · high confidence
Test coverage
Add tests for Oban core functionality and database support; Added Oban jobs table migration for PostgreSQL test support; Added comprehensive test suite for Oban core components; Added migration tests for MySQL, PostgreSQL, and SQLite adapters; Added tests for Oban Notifiers listeners and PG namespacing; Added tests for Oban engine behaviors; Added tests for Oban.Cron.Expression parsing and time calculations; Added tests for Oban.Queues.Executor and Watchman; Added tests for database, global, and isolated peer leadership; Added tests for deprecated Gossip and Repeater plugins; Added tests for the Oban Igniter installation task; New test support infrastructure for Oban testing; Removed property-based integration test for job execution.
Dependencies
Oban 2.24.1: Major dependency upgrade and documentation overhaul
This release updates the project to version 2.24.1 and raises the minimum supported Elixir version to 1.15. It performs a significant upgrade of core dependencies, including postgrex (to 0.22.4), ecto\_sql (to 3.14.0), and ecto\_sqlite3 (to 0.24.1), alongside updates to development tools like ex\_doc (to 0.40.4) and credo (to 1.7.19). The package license has been changed from MIT to Apache-2.0, and the documentation structure has been completely reorganized into categorized guides (Introduction, Learning, Advanced, Recipes, Testing, Upgrading) with a new logo and modular API reference.
(dependencies) · high confidence
Housekeeping
Add Credo linting configuration
The project now includes a \.credo.exs\ configuration file that defines the linting rules and checks applied during development and CI. This standardizes code quality enforcement by specifying consistency, design, readability, and warning checks for the codebase.
(repo-wide) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 68 → 67 (-0.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 97 → 97 (+0.0)
- Architecture 82 → 95 (+13.0)
- Maturity 51 → 51 (+0.2)
- Readiness 84 → 84 (+0.0)
- Security 81 → 76 (-5.2)
- Performance 80 → 80 (+0.0)
Resolved (2)
- Off-boarding risk: anonymized user #1
- Projects may be oversized for their cohesion
New (21)
- Edited copies of one member (3 members, 14+ corresponding lines) (lib/oban/engines/basic.ex)
- Edited copies of one member (3 members, 17+ corresponding lines) (lib/oban/engines/basic.ex)
- Edited copies of one member (3 members, 4+ corresponding lines) (lib/oban/engines/basic.ex)
- Edited copies of one member (4 members, 4+ corresponding lines) (lib/oban/engine.ex)
- Edited copies of one member (5 members, 14+ corresponding lines) (lib/oban/engines/basic.ex)
- Edited copies of one member (5 members, 3+ corresponding lines) (lib/oban/notifiers/isolated.ex)
- Edited copy of a member (10 corresponding lines) (lib/oban/engines/basic.ex)
- Edited copy of a member (10 corresponding lines) (lib/oban/engines/dolphin.ex)
- Edited copy of a member (10 corresponding lines) (lib/oban/migrations/myxql.ex)
- Edited copy of a member (11 corresponding lines) (lib/oban/lifeline.ex)
- Edited copy of a member (12 corresponding lines) (lib/oban/lifeline.ex)
- Edited copy of a member (13 corresponding lines) (lib/oban/pruner.ex)
- Edited copy of a member (16 corresponding lines) (lib/oban/notifiers/postgres.ex)
- Edited copy of a member (18 corresponding lines) (lib/oban/engines/dolphin.ex)
- Edited copy of a member (20 corresponding lines) (lib/oban/engines/basic.ex)
- Edited copy of a member (43 corresponding lines) (lib/oban/engines/dolphin.ex)
- Edited copy of a member (7 corresponding lines) (lib/oban/engine.ex)
- Edited copy of a member (9 corresponding lines) (lib/oban/cron/expression.ex)
- Edited copy of a member (9 corresponding lines) (lib/oban/engines/dolphin.ex)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- …and 1 more
Changes since last survey
- 6 commits — 3 feature/other, 3 fixes
By area
- lib/oban — 5 commits
- test/oban — 1 commit
Notable commits
- fix: Fix next_at/last_at across daylight saving changes
- fix: Fix timing race in eventual refute_enqueued test
- fix: Run fixed-hour cron once during fall back DST
- change: Raise default reindexer timeout to one hour
- change: Set inserted_at for jobs executed inline (#1527)
- change: Stabilize unique advisory lock keys across builds
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
oban-bg/oban was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 8bb7266b0d2a4ca185c104d0f090f1d3ab285f77 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.