Shopify/job-iteration
76.3
Strong · 6 November 2026
1.7k
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Add Tapioca compiler for JobIteration jobs
Introduces a new DSL compiler that automatically generates RBI type signatures for Active Job classes inheriting from JobIteration::Iteration. This compiler extracts method parameters from the \build\_enumerator\ method, expands FixedHash types into individual keyword arguments, and generates signatures for \perform\_later\, \perform\_now\, and \perform\ methods, ensuring correct parameter ordering and handling of generic type members.
lib/tapioca · high confidence
Introduce job-iteration v1.15.1 with batch processing, CSV support, and queue interruption adapters
This release adds the ability to iterate over ActiveRecord relations in batches (yielding relations rather than individual records) via \ActiveRecordBatchEnumerator\, and introduces a \CsvEnumerator\ for processing CSV files. It also adds built-in interruption adapters for Sidekiq, GoodJob, DelayedJob, Resque, SolidQueue, and AWS SQS, allowing long-running iteration jobs to pause and re-enqueue gracefully during worker shutdowns. The library now supports composite primary keys, parallel iteration across multiple job instances, and custom timezones for date/datetime serialization. Version is bumped to 1.15.1.
lib/job-iteration · high confidence
Support for composite primary keys in batch enumeration
The batch enumerator now correctly handles models with composite primary keys. A new ColumnManager utility ensures that all primary key columns are included in the plucked data, allowing records to be efficiently queried and processed even when the primary key consists of multiple columns.
_lib/job-iteration/active\_record\_batch\enumerator · high confidence
Behavioural changes
Major library restructuring and new configuration capabilities
The library has been refactored from the nested Job::Iteration namespace to the top-level JobIteration module, introducing a new Railtie and dedicated components for enumeration, interruption handling, and logging. Users gain new global configuration options, including max\_job\_runtime for limiting job execution time, default\_retry\_backoff for controlling resume delays, and the ability to register custom interruption adapters or replace the default enumerator builder. The module now integrates with ActiveJob's logging infrastructure via ActiveSupport::Notifications and includes a deprecation mechanism for legacy settings.
lib · high confidence
New test runner and enhanced setup script with MySQL support
The repository now includes a new \bin/test\ script that allows users to run tests with flexible options: running all tests, targeting a specific file, or filtering by test name. The previous \bin/console\ script has been removed. Additionally, \bin/setup\ has been updated to automatically check for MySQL installation, start the MySQL server if needed, and create the \job\_iteration\_test\ database if it does not already exist, streamlining the local development environment setup.
bin · high confidence
Update development environment and code style configuration
The development environment now targets Ruby 4.0.6 and enforces the Shopify Ruby style guide via RuboCop. Configuration files have been updated to include RuboCop settings (inheriting from rubocop-shopify, including gemfiles, excluding specific files), YARD documentation options, and a new dev.yml for local setup. The legacy Travis CI configuration has been removed, and the README has been expanded to document the library's features, supported queue adapters, and usage examples.
(repo-wide) · high confidence
Test coverage
Added CI matrix consistency tests and comprehensive test suite setup; Added Sidekiq test support initialization; Added integration tests for Resque and Sidekiq job interruption; Added test support fixtures for job iteration and CSV processing; Added tests for the JobIteration Tapioca compiler; Added unit tests for JobIteration enumerators and helpers.
Dependencies
New Rails gemfile for CI testing
A new gemfile (gemfiles/rails\_gems.gemfile) has been added to support CI testing across different Rails versions. It dynamically resolves gem requirements based on the RAILS\_VERSION environment variable, supporting edge versions from the main branch and specific minor versions (e.g., 7.1, 7.2). The file evaluates the main Gemfile after setting up these requirements, enabling flexible testing of the gem against various Rails versions.
gemfiles · high confidence
Update dependencies and require Ruby 3.1+ and ActiveJob 7.1+
The gem now requires Ruby 3.1 or later and ActiveJob 7.1 or later, dropping support for older versions. The Gemfile has been refactored to conditionally pin versions for Sidekiq, Resque, connection\_pool, Sorbet, and Tapioca based on the Ruby and Rails versions in use, ensuring compatibility with newer dependency releases (e.g., Sidekiq 8.0.9+ for Ruby 3.2+). Development dependencies have been updated to include the latest versions of tools like RuboCop, Mocha, and RSpec-compatible testing libraries, and the Gemfile.lock is now committed to the repository.
(dependencies) · 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 74 → 76 (+2.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 76 → 76 (+0.0)
- Architecture 98 → 98 (+0.0)
- Maturity 70 → 74 (+4.4)
- Readiness 75 → 76 (+1.1)
- Security 79 → 82 (+3.1)
Resolved (30)
- Critical CVE: [GHSA redacted] (Gemfile.lock)
- Documentation: no contributor guidance (README.md)
- Documentation: no installation or build instructions (README.md)
- Documentation: no usage examples (README.md)
- Duplicate registration mechanism for interruption adapters. One method exists on the main JobIteration class, and another exists on the dedicated InterruptionAdapters collection class. This creates confusion about which entry point to use.
- High CVE: [GHSA redacted] (Gemfile.lock)
- High CVE: [GHSA redacted] (Gemfile.lock)
- High CVE: [GHSA redacted] (Gemfile.lock)
- High CVE: [GHSA redacted] (Gemfile.lock)
- High CVE: [GHSA redacted] (Gemfile.lock)
- Low CVE: [GHSA redacted] (Gemfile.lock)
- Low CVE: [GHSA redacted] (Gemfile.lock)
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Off-boarding risk: anonymized user #1
- Outdated: connection_pool
- Outdated: delayed_job
- Outdated: globalid
- …and 10 more
New (1)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 8 commits — 8 feature/other, 0 fixes
By area
- (root) — 4 commits
- (repo) — 3 commits
- test/unit — 1 commit
Notable commits
- change: Add overridable default policy for parallel enqueue errors
- change: Limit enumerator wrapper test inventory to public builders
- change: Link parallel policy hook changelog entry to its PR
- change: Merge pull request #751 from Shopify/celina-bump-gems-10-20-26
- change: Merge pull request #753 from justinbicknellshopify/justinbicknell/parallel-enqueue-policy-hook
- change: Merge pull request #757 from Shopify/celina-bump-job-iteration-1-17-0
- change: Release Job Iteration 1.17.0
- change: bump dependencies
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
Shopify/job-iteration 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 6 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 0caf1a72657df3e6e072175a838a48ec7f3eee80 — the exact code this score is about.
- Scored under rubric-2026.11.2 — 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.2+preprod-5c4e66d9318b.