From 56bb5cd1181856a633ae78fb40c79851251f57b2 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:03:18 -0600 Subject: [PATCH 01/14] Import the codebase from the private repo and prepare 0.1.0 Copies bundle_matrix-private at 7f54213 (origin/main), then: - Turn the e2e and appraisal-e2e CI jobs back on - Use an absolute URL for the README banner, so it shows on rubygems.org - Ship LICENSE.txt in the gem, matching the private repo - Date the 0.1.0 entry in the CHANGELOG Co-Authored-By: Claude Opus 5.5 --- .github/dependabot.yml | 22 ++ .github/workflows/main.yml | 162 +++++++++++ .gitignore | 11 + .rspec | 3 + .rubocop.yml | 7 + Appraisals | 69 +++++ BundleMatrix.webp | Bin 0 -> 285928 bytes CHANGELOG.md | 12 + CODE_OF_CONDUCT.md | 10 + Gemfile | 26 ++ Gemfile.lock | 284 ++++++++++++++++++ Guardfile | 49 ++++ LICENSE => LICENSE.txt | 12 +- README.md | 149 ++++++++++ Rakefile | 29 ++ SECURITY.md | 12 + Steepfile | 16 ++ bin/console | 11 + bin/release | 76 +++++ bin/setup | 8 + bundle_matrix.gemspec | 42 +++ docs/.boondoc-manifest | 15 + docs/ARCHITECTURE.md | 126 ++++++++ docs/BundleMatrix.md | 36 +++ docs/BundleMatrix/ArgvParser.md | 75 +++++ docs/BundleMatrix/ArgvParser/Switch.md | 38 +++ docs/BundleMatrix/Config.md | 71 +++++ docs/BundleMatrix/Discovery.md | 40 +++ docs/BundleMatrix/Error.md | 6 + docs/BundleMatrix/Hook.md | 17 ++ docs/BundleMatrix/Invocation.md | 106 +++++++ docs/BundleMatrix/Invocation/Option.md | 44 +++ docs/BundleMatrix/Planner.md | 39 +++ docs/BundleMatrix/Planner/Plan.md | 59 ++++ docs/BundleMatrix/ProjectSettings.md | 44 +++ docs/BundleMatrix/Runner.md | 42 +++ docs/BundleMatrix/SecondaryGemfile.md | 73 +++++ docs/README.md | 166 +++++++++++ gemfiles/bundler_2.6.9.gemfile | 12 + gemfiles/bundler_2.6.9.gemfile.lock | 48 ++++ gemfiles/bundler_2.7.2.gemfile | 12 + gemfiles/bundler_2.7.2.gemfile.lock | 48 ++++ gemfiles/bundler_4.0.24.gemfile | 12 + gemfiles/bundler_4.0.24.gemfile.lock | 60 ++++ gemfiles/bundler_4.1.0.beta3.gemfile | 12 + gemfiles/bundler_4.1.0.beta3.gemfile.lock | 60 ++++ gemfiles/gem_coop.gemfile | 17 ++ gemfiles/gem_coop.gemfile.lock | 233 +++++++++++++++ lib/bundle_matrix.rb | 21 ++ lib/bundle_matrix/argv_parser.rb | 160 +++++++++++ lib/bundle_matrix/bundle | 13 + lib/bundle_matrix/config.rb | 40 +++ lib/bundle_matrix/discovery.rb | 53 ++++ lib/bundle_matrix/hook.rb | 52 ++++ lib/bundle_matrix/invocation.rb | 71 +++++ lib/bundle_matrix/planner.rb | 124 ++++++++ lib/bundle_matrix/project_settings.rb | 32 +++ lib/bundle_matrix/runner.rb | 111 +++++++ lib/bundle_matrix/secondary_gemfile.rb | 57 ++++ lib/bundle_matrix/version.rb | 10 + plugins.rb | 7 + sig/bundle_matrix.rbs | 208 ++++++++++++++ sig_stubs/bundler.rbs | 78 +++++ spec/bundle_matrix/config_spec.rb | 129 +++++++++ spec/bundle_matrix/discovery_spec.rb | 123 ++++++++ spec/bundle_matrix/hook_spec.rb | 168 +++++++++++ spec/bundle_matrix/invocation_spec.rb | 251 ++++++++++++++++ spec/bundle_matrix/planner_spec.rb | 286 +++++++++++++++++++ spec/bundle_matrix/project_settings_spec.rb | 55 ++++ spec/bundle_matrix/runner_spec.rb | 165 +++++++++++ spec/bundle_matrix/secondary_gemfile_spec.rb | 90 ++++++ spec/bundle_matrix_spec.rb | 23 ++ spec/e2e/add_spec.rb | 68 +++++ spec/e2e/gems_rb_spec.rb | 22 ++ spec/e2e/install_spec.rb | 171 +++++++++++ spec/e2e/support/e2e_helper.rb | 24 ++ spec/e2e/support/gem_repo.rb | 60 ++++ spec/e2e/support/project.rb | 118 ++++++++ spec/e2e/update_spec.rb | 61 ++++ spec/spec_helper.rb | 34 +++ 80 files changed, 5400 insertions(+), 6 deletions(-) create mode 100644 .github/dependabot.yml create mode 100644 .github/workflows/main.yml create mode 100644 .gitignore create mode 100644 .rspec create mode 100644 .rubocop.yml create mode 100644 Appraisals create mode 100644 BundleMatrix.webp create mode 100644 CHANGELOG.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 Gemfile create mode 100644 Gemfile.lock create mode 100644 Guardfile rename LICENSE => LICENSE.txt (87%) create mode 100644 README.md create mode 100644 Rakefile create mode 100644 SECURITY.md create mode 100644 Steepfile create mode 100755 bin/console create mode 100755 bin/release create mode 100755 bin/setup create mode 100644 bundle_matrix.gemspec create mode 100644 docs/.boondoc-manifest create mode 100644 docs/ARCHITECTURE.md create mode 100644 docs/BundleMatrix.md create mode 100644 docs/BundleMatrix/ArgvParser.md create mode 100644 docs/BundleMatrix/ArgvParser/Switch.md create mode 100644 docs/BundleMatrix/Config.md create mode 100644 docs/BundleMatrix/Discovery.md create mode 100644 docs/BundleMatrix/Error.md create mode 100644 docs/BundleMatrix/Hook.md create mode 100644 docs/BundleMatrix/Invocation.md create mode 100644 docs/BundleMatrix/Invocation/Option.md create mode 100644 docs/BundleMatrix/Planner.md create mode 100644 docs/BundleMatrix/Planner/Plan.md create mode 100644 docs/BundleMatrix/ProjectSettings.md create mode 100644 docs/BundleMatrix/Runner.md create mode 100644 docs/BundleMatrix/SecondaryGemfile.md create mode 100644 docs/README.md create mode 100644 gemfiles/bundler_2.6.9.gemfile create mode 100644 gemfiles/bundler_2.6.9.gemfile.lock create mode 100644 gemfiles/bundler_2.7.2.gemfile create mode 100644 gemfiles/bundler_2.7.2.gemfile.lock create mode 100644 gemfiles/bundler_4.0.24.gemfile create mode 100644 gemfiles/bundler_4.0.24.gemfile.lock create mode 100644 gemfiles/bundler_4.1.0.beta3.gemfile create mode 100644 gemfiles/bundler_4.1.0.beta3.gemfile.lock create mode 100644 gemfiles/gem_coop.gemfile create mode 100644 gemfiles/gem_coop.gemfile.lock create mode 100644 lib/bundle_matrix.rb create mode 100644 lib/bundle_matrix/argv_parser.rb create mode 100644 lib/bundle_matrix/bundle create mode 100644 lib/bundle_matrix/config.rb create mode 100644 lib/bundle_matrix/discovery.rb create mode 100644 lib/bundle_matrix/hook.rb create mode 100644 lib/bundle_matrix/invocation.rb create mode 100644 lib/bundle_matrix/planner.rb create mode 100644 lib/bundle_matrix/project_settings.rb create mode 100644 lib/bundle_matrix/runner.rb create mode 100644 lib/bundle_matrix/secondary_gemfile.rb create mode 100644 lib/bundle_matrix/version.rb create mode 100644 plugins.rb create mode 100644 sig/bundle_matrix.rbs create mode 100644 sig_stubs/bundler.rbs create mode 100644 spec/bundle_matrix/config_spec.rb create mode 100644 spec/bundle_matrix/discovery_spec.rb create mode 100644 spec/bundle_matrix/hook_spec.rb create mode 100644 spec/bundle_matrix/invocation_spec.rb create mode 100644 spec/bundle_matrix/planner_spec.rb create mode 100644 spec/bundle_matrix/project_settings_spec.rb create mode 100644 spec/bundle_matrix/runner_spec.rb create mode 100644 spec/bundle_matrix/secondary_gemfile_spec.rb create mode 100644 spec/bundle_matrix_spec.rb create mode 100644 spec/e2e/add_spec.rb create mode 100644 spec/e2e/gems_rb_spec.rb create mode 100644 spec/e2e/install_spec.rb create mode 100644 spec/e2e/support/e2e_helper.rb create mode 100644 spec/e2e/support/gem_repo.rb create mode 100644 spec/e2e/support/project.rb create mode 100644 spec/e2e/update_spec.rb create mode 100644 spec/spec_helper.rb diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..7ba7ca0 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,22 @@ +version: 2 +updates: + - package-ecosystem: "bundler" + directory: "/" + schedule: + interval: "weekly" + cooldown: + default-days: 3 + groups: + bundler-dependencies: + patterns: + - "*" + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" + cooldown: + default-days: 3 + groups: + github-actions-dependencies: + patterns: + - "*" diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml new file mode 100644 index 0000000..680a8d7 --- /dev/null +++ b/.github/workflows/main.yml @@ -0,0 +1,162 @@ +name: Ruby + +on: + push: + branches: + - main + + pull_request: + +permissions: + contents: read + +jobs: + # Installs each gemfile's bundle once per Ruby, so the jobs below restore it from the cache. + # setup-ruby reads BUNDLE_GEMFILE, so each appraisal gets its own lockfile's gems and Bundler version. + install: + runs-on: ubuntu-latest + name: Install (Ruby ${{ matrix.ruby }}, ${{ matrix.gemfile }}) + strategy: + fail-fast: false + matrix: + ruby: &test_rubies + - '3.3' + - '3.4' + - '4.0.9' + gemfile: &gemfiles + - Gemfile + - gemfiles/bundler_2.6.9.gemfile + - gemfiles/bundler_2.7.2.gemfile + - gemfiles/bundler_4.0.24.gemfile + - gemfiles/bundler_4.1.0.beta3.gemfile + - gemfiles/gem_coop.gemfile + env: + BUNDLE_GEMFILE: ${{ matrix.gemfile }} + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - name: Set up Ruby and install gems + uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + + rubocop: + needs: install + runs-on: ubuntu-latest + name: RuboCop (Ruby ${{ matrix.ruby }}) + strategy: + matrix: + ruby: &rubies + - '4.0.9' + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - run: bundle exec rubocop + + types: + needs: install + runs-on: ubuntu-latest + name: RBS and Steep (Ruby ${{ matrix.ruby }}) + strategy: + matrix: + ruby: *rubies + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - run: bundle exec rake rbs steep + + rspec: + needs: install + runs-on: ubuntu-latest + name: RSpec (Ruby ${{ matrix.ruby }}) + strategy: + matrix: + ruby: *test_rubies + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - name: Run the unit specs with coverage + env: + COVERAGE: "true" + run: bundle exec rake spec + + e2e: + needs: install + runs-on: ubuntu-latest + name: RSpec E2E (Ruby ${{ matrix.ruby }}) + strategy: + matrix: + ruby: *test_rubies + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - run: bundle exec rake e2e + + # The appraisals leave out RuboCop, which the Rakefile loads, so this runs rspec directly + appraisal-rspec: + needs: install + runs-on: ubuntu-latest + name: RSpec (Ruby ${{ matrix.ruby }}, ${{ matrix.gemfile }}) + strategy: + fail-fast: false + matrix: + ruby: *test_rubies + gemfile: *gemfiles + exclude: + - gemfile: Gemfile + env: + BUNDLE_GEMFILE: ${{ matrix.gemfile }} + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - run: bundle exec rspec spec/bundle_matrix + + appraisal-e2e: + needs: install + runs-on: ubuntu-latest + name: RSpec E2E (Ruby ${{ matrix.ruby }}, ${{ matrix.gemfile }}) + strategy: + fail-fast: false + matrix: + ruby: *test_rubies + gemfile: *gemfiles + exclude: + - gemfile: Gemfile + env: + BUNDLE_GEMFILE: ${{ matrix.gemfile }} + steps: + - uses: actions/checkout@v7 + with: + persist-credentials: false + - uses: ruby/setup-ruby@v1 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - run: bundle exec rspec spec/e2e diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b04a8c8 --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +/.bundle/ +/.yardoc +/_yardoc/ +/coverage/ +/doc/ +/pkg/ +/spec/reports/ +/tmp/ + +# rspec failure tracking +.rspec_status diff --git a/.rspec b/.rspec new file mode 100644 index 0000000..34c5164 --- /dev/null +++ b/.rspec @@ -0,0 +1,3 @@ +--format documentation +--color +--require spec_helper diff --git a/.rubocop.yml b/.rubocop.yml new file mode 100644 index 0000000..e24a8de --- /dev/null +++ b/.rubocop.yml @@ -0,0 +1,7 @@ +inherit_gem: + sharp_style_rubocop: config/default.yml + +# The E2E specs describe a bundle command, not a class +RSpec/DescribeClass: + Exclude: + - 'spec/e2e/**/*' diff --git a/Appraisals b/Appraisals new file mode 100644 index 0000000..888a4b7 --- /dev/null +++ b/Appraisals @@ -0,0 +1,69 @@ +# frozen_string_literal: true + +# Appraisal2 rebuilds generated gemfiles from the parsed DSL, which drops +# comments, so keep the magic comment in the generated heading. +customize_gemfiles do + { + heading: "frozen_string_literal: true\n\nThis file was generated by Appraisal2" + } +end + +plugin "appraisal2-rubocop", require: "appraisal2/rubocop" + +# Appraisal2 copies the root Gemfile's rubygems.org source into every appraisal. +# The gem-coop appraisal sets its own global source, so drop the copied line +# to keep a single global source and avoid Bundler's warning. +# +# rubocop:disable-next Style/RedundantConstantBase +::Appraisal.transform_gemfile do |content, context| + next unless context.appraisal.name == "gem-coop" + + content.sub(%r{^source ["']https://rubygems\.org/?["']\n}, "") +end + +# Gems the Gemfile needs for development, not for running the specs against a Bundler version +DEV_GEMS = %w[ + appraisal2 + appraisal2-rubocop + guard + guard-rspec + guard-rubocop + guard-shell + guard-status + irb + ostruct + rbs + rubocop + simplecov + steep +].freeze + +JOE_GEMS = %w[ + boondoc + guard-boondoc + sharp_style_rubocop +].freeze + +# rubocop:disable-next Style/MethodCallWithArgsParentheses +def bundler_appraisal(version) + appraise "bundler-#{version}" do + (DEV_GEMS + JOE_GEMS).each { |name| remove_gem name } + + gem "bundler", version + end +end + +bundler_appraisal "2.6.9" +bundler_appraisal "2.7.2" +bundler_appraisal "4.0.24" +bundler_appraisal "4.1.0.beta3" + +appraise "gem-coop" do + source "https://gem.coop/" + + (DEV_GEMS + JOE_GEMS).each { |name| remove_gem name } + + source "https://gem.coop/@joe-sharp" do + JOE_GEMS.each { |name| gem name } + end +end diff --git a/BundleMatrix.webp b/BundleMatrix.webp new file mode 100644 index 0000000000000000000000000000000000000000..c5eae226979b3db5cfa5e322d68a5f182e83ef1d GIT binary patch literal 285928 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%0D2{OQfs1+@|? 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 Xp294OmLR?x9`sMGBY!?Yh`;~ 13.0" +gem "rbs", require: false +gem "rspec", "~> 3.0" +gem "rubocop" +gem "rubygems-generate_index", require: false +gem "sharp_style_rubocop" +gem "simplecov", require: false +gem "steep", require: false diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..7ab2bd6 --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,284 @@ +PATH + remote: . + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://rubygems.org/ + specs: + appraisal2 (3.2.6) + bundler (>= 1.17.3) + rake (>= 10) + thor (>= 0.14) + appraisal2-rubocop (1.0.5) + appraisal2 (>= 3.2.6) + rubocop (>= 1.0) + version_gem (~> 1.1, >= 1.1.15) + ast (2.4.3) + boondoc (0.2.1) + prism (>= 1.0, < 3) + thor (~> 1.2) + coderay (1.1.3) + concurrent-ruby (1.3.8) + csv (3.3.7) + diff-lcs (1.6.2) + erb (6.0.7) + ffi (1.17.4) + ffi (1.17.4-x86_64-darwin) + fileutils (1.8.1) + formatador (1.2.3) + reline + guard (2.20.2) + formatador (>= 0.2.4) + listen (>= 2.7, < 4.0) + logger (~> 1.6) + lumberjack (>= 1.0.12, < 2.0) + nenv (~> 0.1) + notiffany (~> 0.0) + pry (>= 0.13.0) + shellany (~> 0.0) + thor (>= 0.18.1) + guard-boondoc (0.1.1) + boondoc + guard (~> 2.20) + guard-compat (~> 1.2) + guard-compat (1.2.1) + guard-rspec (4.7.3) + guard (~> 2.1) + guard-compat (~> 1.1) + rspec (>= 2.99.0, < 4.0) + guard-rubocop (1.5.0) + guard (~> 2.0) + rubocop (< 2.0) + guard-shell (0.7.2) + guard (>= 2.0.0) + guard-compat (~> 1.0) + guard-status (0.1.0) + guard (~> 2.20) + guard-compat (~> 1.2) + io-console (0.9.5) + irb (1.18.0) + pp (>= 0.6.0) + prism (>= 1.3.0) + rdoc (>= 4.0.0) + reline (>= 0.4.2) + json (3.1.0) + language_server-protocol (3.17.0.6) + lint_roller (1.1.0) + listen (3.10.1) + logger + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + logger (1.7.0) + lumberjack (1.4.2) + method_source (1.1.0) + nenv (0.3.0) + notiffany (0.1.3) + nenv (~> 0.1) + shellany (~> 0.0) + ostruct (0.6.3) + parallel (2.3.0) + parser (3.3.13.0) + ast (~> 2.4.1) + racc + pp (0.6.4) + prettyprint + prettyprint (0.2.1) + prism (1.9.0) + pry (0.16.1) + coderay (~> 1.1) + method_source (~> 1.0) + reline (>= 0.6.0) + racc (1.8.1) + rainbow (3.1.1) + rake (13.4.2) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) + ffi (~> 1.0) + rbs (4.2.0) + logger + prism (>= 1.6.0) + tsort + rdoc (8.1.0) + erb + prism (>= 1.6.0) + rbs (>= 4.0.0) + tsort + regexp_parser (2.13.1) + reline (0.7.0) + io-console (~> 0.5) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.7) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.6) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.9) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.8) + rubocop (1.92.2) + json (>= 2.3) + language_server-protocol (~> 3.17.0.2) + lint_roller (~> 1.1.0) + parallel (>= 1.10) + parser (>= 3.3.0.2) + rainbow (>= 2.2.2, < 4.0) + regexp_parser (>= 2.11.3, < 3.0) + rubocop-ast (>= 1.49.0, < 2.0) + ruby-progressbar (~> 1.7) + unicode-display_width (>= 2.4.0, < 4.0) + rubocop-ast (1.50.0) + parser (>= 3.3.7.2) + prism (~> 1.7) + rubocop-performance (1.27.0) + lint_roller (~> 1.1) + rubocop (>= 1.89.0, < 2.0) + rubocop-ast (>= 1.47.1, < 2.0) + rubocop-rspec (3.10.2) + lint_roller (~> 1.1) + regexp_parser (>= 2.0) + rubocop (~> 1.86, >= 1.86.2) + ruby-progressbar (1.13.0) + rubygems-generate_index (1.2.0) + securerandom (0.4.1) + sharp_style_rubocop (0.1.5) + rubocop (~> 1.92) + rubocop-performance (~> 1.20) + rubocop-rspec (~> 3.0) + shellany (0.0.1) + simplecov (1.3.2) + steep (2.1.0) + concurrent-ruby (>= 1.1.10) + csv (>= 3.0.9) + fileutils (>= 1.1.0) + json (>= 2.1.0) + language_server-protocol (>= 3.17.0.4, < 4.0) + listen (~> 3.0) + logger (>= 1.3.0) + parser (>= 3.2) + prism (>= 0.25.0) + rainbow (>= 2.2.2, < 4.0) + rbs (~> 4.2) + securerandom (>= 0.1) + strscan (>= 1.0.0) + terminal-table (>= 2, < 5) + uri (>= 0.12.0) + strscan (3.1.8) + terminal-table (4.0.0) + unicode-display_width (>= 1.1.1, < 4) + thor (1.5.0) + tsort (0.2.0) + unicode-display_width (3.3.0) + unicode-emoji (~> 4.3) + unicode-emoji (4.3.0) + uri (1.1.2) + version_gem (1.1.17) + +PLATFORMS + ruby + x86_64-darwin-24 + +DEPENDENCIES + appraisal2 + appraisal2-rubocop + boondoc + bundle_matrix! + guard + guard-boondoc + guard-rspec + guard-rubocop + guard-shell + guard-status + irb + ostruct + rake (~> 13.0) + rbs + rspec (~> 3.0) + rubocop + rubygems-generate_index + sharp_style_rubocop + simplecov + steep + +CHECKSUMS + appraisal2 (3.2.6) sha256=6664d2404b9fe160dfbbed4dd9b78e7b9146402bc3468ff92ba78c1878bc318a + appraisal2-rubocop (1.0.5) sha256=91db38e8585dc2b07491eee6c288764511a6c6a0a5d06c339c91ab6a4164bea8 + ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383 + boondoc (0.2.1) sha256=3cfe5bd9b1ca5a2ab34a482d5b387778dad54eae575de5c90d850d1cb3599203 + bundle_matrix (0.1.0) + bundler (4.0.24) sha256=16ca64e20816a0cf151a948fb141d788602996d2b4d73577b74388fe84fa98bc + coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b + concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1 + csv (3.3.7) sha256=15a3f16f6628da8664d455eb634e7f22031bcf53044923caf56975109e71b9f8 + diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962 + erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92 + ffi (1.17.4) sha256=bcd1642e06f0d16fc9e09ac6d49c3a7298b9789bcb58127302f934e437d60acf + ffi (1.17.4-x86_64-darwin) sha256=aa70390523cf3235096cf64962b709b4cfbd5c082a2cb2ae714eb0fe2ccda496 + fileutils (1.8.1) sha256=2d541a1ee34a9ed5c4f054be8fb819a26b5d654488a31dc8806917cf448b9cc3 + formatador (1.2.3) sha256=19fa898133c2c26cdbb5d09f6998c1e137ad9427a046663e55adfe18b950d894 + guard (2.20.2) sha256=2d0574d35619669f2f71739a0313290810b9cf66b2263f5d97e815fcce598d4d + guard-boondoc (0.1.1) sha256=57bb57a8e81dd3f62518158df5a07af6c245e6460e0d91cf2cf7cf38cf1a83c2 + guard-compat (1.2.1) sha256=3ad21ab0070107f92edfd82610b5cdc2fb8e368851e72362ada9703443d646fe + guard-rspec (4.7.3) sha256=a47ba03cbd1e3c71e6ae8645cea97e203098a248aede507461a43e906e2f75ca + guard-rubocop (1.5.0) sha256=3041d796dcb5ee31e352de74732250826f5f235b4ff48df9dbf424a6dc736251 + guard-shell (0.7.2) sha256=c9cd104c597c51465f7bed623753f7f4cfb87cfbd0ff28bdda9a02f6605e436d + guard-status (0.1.0) sha256=4242b35622b04cd22e2df06777d5b05d295d6eddb712692d7bf4330c94be99ed + io-console (0.9.5) sha256=83dd9bbf4c4680416629245b39cd4212eb5f4d9a4ea91804870c1f6b846414d5 + irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3 + json (3.1.0) sha256=3ce7ccf8fde58960177a3a756c31f292a4c1e1dedee884547096a5b0604e3bd8 + language_server-protocol (3.17.0.6) sha256=5ef2c0c138f8267e1bc631d3328347d354f96724b0af22f2c79516120443b7f0 + lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87 + listen (3.10.1) sha256=4c3f32855657f348747da4dd2372ff3790d90a6b1d3e4f21a3706adb2d04783c + logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203 + lumberjack (1.4.2) sha256=40de5ae46321380c835031bcc1370f13bba304d29f2b5f5bb152061a5a191b95 + method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5 + nenv (0.3.0) sha256=d9de6d8fb7072228463bf61843159419c969edb34b3cef51832b516ae7972765 + notiffany (0.1.3) sha256=d37669605b7f8dcb04e004e6373e2a780b98c776f8eb503ac9578557d7808738 + ostruct (0.6.3) sha256=95a2ed4a4bd1d190784e666b47b2d3f078e4a9efda2fccf18f84ddc6538ed912 + parallel (2.3.0) sha256=f75a3e904101ce6a1ccb6b8dc800cbafd42166d83330192438dcf29395167a6f + parser (3.3.13.0) sha256=e02f9b63c2fe05b0c68f692ba4df89b3cb113b663964f75d988fbebfd6c3deca + pp (0.6.4) sha256=dfcb0fce700c41456265922884f9fe195d7fbb0674a3578e6c0f69588e82b570 + prettyprint (0.2.1) sha256=d555d57ea6d7cf001d4774b693546a6bd88bec1e778ddffb5c60b68ceec4b7d4 + prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85 + pry (0.16.1) sha256=d92d82c86e7f2dc34beec6d2892d5cf5ea517eea22eed3ceabb38ee62a98accc + racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f + rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a + rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701 + rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe + rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e + rbs (4.2.0) sha256=51f7b886dcc05bc09e10b901daa6a81829f6adc03101d6ca9ea4aac6103e0674 + rdoc (8.1.0) sha256=befc37880a5cfd36dcb176c748b5fd5ee39dd3536a75e81824e4972ce230f60a + regexp_parser (2.13.1) sha256=5aedb6b7c35688f51e86eef17a15374dfd287c83f4ca644b2c5f3ec50a33b44b + reline (0.7.0) sha256=5b012d8e55dbf9d450f12bde2cf7d15ff546ae80b3f8f3b30e570d431815583d + rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587 + rspec-core (3.13.7) sha256=c64ff16d9788119805cbc6a3f4b6d87cc22417c2d25976a3330de136896b5469 + rspec-expectations (3.13.6) sha256=bf538ca6d367ff5b0d85a87fdb5c0c6038f2cd1308a0eeba07476caa02d22f35 + rspec-mocks (3.13.9) sha256=ea5c7ff3054a6098ca6039aacef80aec69d5a8a3ef80be8fc88337359b672a30 + rspec-support (3.13.8) sha256=e4160030309b7e3e9d9863dfe720a35dfcc577162f5402cd68fc8c5258a0ffd6 + rubocop (1.92.2) sha256=14fb31eed143a0dc6f78186c550c1715e81cd38f59d05d1165050e445c1f5382 + rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db + rubocop-performance (1.27.0) sha256=eeeb1374d062a368ee1c787b70eb0b0cc4b184cb1f8565f424760946146d61ce + rubocop-rspec (3.10.2) sha256=0b3e2ecc592cd10ecbf0095bb58d1e357905276e069643523cc19eb7495f65e2 + ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33 + rubygems-generate_index (1.2.0) sha256=cb33b935545a38dba4ac1f20d391090d2bb017d0956537a8bbadc1fff23f0aab + securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1 + sharp_style_rubocop (0.1.5) sha256=bb75ff29653e6d64324df2c4ff794d5458c69183ef4c47ecf1c621a27862df11 + shellany (0.0.1) sha256=0e127a9132698766d7e752e82cdac8250b6adbd09e6c0a7fbbb6f61964fedee7 + simplecov (1.3.2) sha256=2a22ec1759f1b8db60881a2e038758956fc69ef93ed669be0bde0678de6d0e85 + steep (2.1.0) sha256=1daf53573283b0e6d404a7273cca41fe5c15b14ece05167934f5ffc179e171d9 + strscan (3.1.8) sha256=aae2db611a225559f21ffbb71765c9a4e60fd262534a9ea84f4f11c7f32f679e + terminal-table (4.0.0) sha256=f504793203f8251b2ea7c7068333053f0beeea26093ec9962e62ea79f94301d2 + thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73 + tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f + unicode-display_width (3.3.0) sha256=4b7aa66a4b11db50f6f7e98411215cd0dd10eaecb665d36eec5bcacb3fa0b613 + unicode-emoji (4.3.0) sha256=11c02fa73290378c066bb0562cd4c87d8e1b706fbbe0059ca12746a4244de8ce + uri (1.1.2) sha256=89292e98eabbef6248b0a0ed5e7e398e152f83f17560023a6d94a7f492b169fb + version_gem (1.1.17) sha256=70420b9675fbb77a7e7e7eb8ed6580dd4dd25be53b1454c1a79cc18f3c5a8dfd + +BUNDLED WITH + 4.0.24 diff --git a/Guardfile b/Guardfile new file mode 100644 index 0000000..5df2367 --- /dev/null +++ b/Guardfile @@ -0,0 +1,49 @@ +# frozen_string_literal: true + +# More info at https://github.com/guard/guard#readme + +# Prevent informational messages from Guard +logger level: :warn + +guard(:rubocop, + cli: "--format progress --format json --out tmp/rubocop.json ", + all_on_start: true, + all_after_pass: true) do + watch(/.+\.rb$/) + watch(/bin/) + watch(/Guardfile/) + watch(%r{(?:.+/)?\.rubocop(?:_todo)?\.yml$}) { |m| File.dirname(m[0]) } +end + +guard(:rspec, + cmd: "bundle exec rspec --exclude-pattern 'spec/e2e/**/*_spec.rb' " \ + "--format progress --format json --out tmp/rspec.json", + all_on_start: true, + all_after_pass: true) do + require "guard/rspec/dsl" + dsl = Guard::RSpec::Dsl.new(self) + + # RSpec files + rspec = dsl.rspec + watch(rspec.spec_helper) { rspec.spec_dir } + watch(rspec.spec_support) { rspec.spec_dir } + watch(%r{^spec/(?!e2e/).+_spec\.rb$}) + + # Ruby files + ruby = dsl.ruby + dsl.watch_spec_files_for(ruby.lib_files) + + # Golden files are compared by the generator spec + watch(%r{^spec/fixtures/}) { rspec.spec_dir } +end + +# Regenerates the Boondoc docs when the files they are built from change +guard :boondoc, status_file: "tmp/docs_status.txt" + +# One status line for the guards above, last so it runs after them +guard(:status, + segments: { + "RuboCop" => { rubocop: "tmp/rubocop.json" }, + "Tests" => { rspec: "tmp/rspec.json" }, + "Docs" => { file: "tmp/docs_status.txt" } + }) diff --git a/LICENSE b/LICENSE.txt similarity index 87% rename from LICENSE rename to LICENSE.txt index 1b37b3f..f4b21a6 100644 --- a/LICENSE +++ b/LICENSE.txt @@ -1,6 +1,6 @@ -MIT License +The MIT License (MIT) -Copyright (c) 2026 Joe Sharp +Copyright (c) 2026 joe-sharp Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal @@ -9,13 +9,13 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..7a41862 --- /dev/null +++ b/README.md @@ -0,0 +1,149 @@ +# BundleMatrix + +A Bundler plugin that repeats `bundle install`, `bundle update` and `bundle add` against every other gemfile in your project, so each lockfile stays in step with the main `Gemfile`. + +Projects that test against several dependency sets keep extra gemfiles (`ci.gemfile`, `gemfiles/rails7.gemfile`, engine Gemfiles, and so on). Without help, every one of them needs its own `BUNDLE_GEMFILE=… bundle install`. With bundle_matrix, running the command on the main `Gemfile` does that for you. + +![BundleMatrix](https://raw.githubusercontent.com/joe-sharp/bundle_matrix/main/BundleMatrix.webp) + +## Installation + +Install the plugin once for your user: + +```bash +bundle plugin install bundle_matrix +``` + +Or declare it in the project's `Gemfile`: + +```ruby +plugin "bundle_matrix" +``` + +## Usage + +Run the command on the main `Gemfile` as usual: + +```bash +bundle install +bundle update rails --conservative +bundle update --all +bundle add rack --group development +``` + +After the main run succeeds, each discovered gemfile is run with the same command and flags. Output is headed by the gemfile it applies to: + +``` +== bundle_matrix: gemfiles/rails7.gemfile -> bundle update rails --conservative +== bundle_matrix: engines/admin/Gemfile -> bundle install +``` + +Only `install`, `update` and `add` are fanned out. `bundle check`, `bundle exec` and similar commands are not, because Bundler does not run plugin hooks for them. + +Bundler's short forms work too: `bundle i`, `bundle ins`, `bundle a`, `bundle u`, and any other unambiguous prefix of a command name. + +A plain `bundle`, or `bundle` with only flags such as `bundle --jobs=4`, runs as `install` and fans out as `install`, but only while `default_cli_command` is unset or `install`. With it set to `cli_help`, those commands print help and nothing fans out. Bundler's documentation already names `cli_help` as the default, while its code still runs `install` and prints a notice that this will change. To keep fanning out whatever Bundler does, set the setting explicitly, or run `bundle install`: + +```bash +bundle config set default_cli_command install +``` + +## Which gemfiles are found + +The main gemfile is `Gemfile` in the project root, or the file named by `matrix.default_gemfile`. It is never treated as a secondary gemfile. Secondary gemfiles are found in: + +- `*.gemfile` in the project root, e.g. `ci.gemfile` with `ci.gemfile.lock` +- `*.gemfile` in `gemfiles/` +- any directories listed in `matrix.paths`, each contributing its `gems.rb`, or its `Gemfile` when it has no `gems.rb`, the order Bundler uses + +## Configuration + +Settings use `bundle config` or `BUNDLE_MATRIX__*` environment variables: + +| Setting | Default | Meaning | +| --- | --- | --- | +| `matrix.default_gemfile` | `Gemfile` | File name of the main gemfile in the project root. Fan-out starts only when the command runs on this file, e.g. `gems.rb` | +| `matrix.paths` | none | Extra directories or globs to search for a `gems.rb` or `Gemfile`, separated by commas, e.g. `engines/*,apps/admin` | +| `matrix.disabled` | `false` | Turn fan-out off | +| `matrix.fail_fast` | `false` | Stop at the first failing gemfile | +| `matrix.bundler_warnings` | `true` | Warn when a gemfile runs a different Bundler from the main Gemfile. Set it to `false` for projects that pin different Bundlers on purpose | + +```bash +bundle config set matrix.paths "engines/*,apps/admin" +``` + +For a project whose main file is `gems.rb`, set the main gemfile name once, and run the command on `gems.rb`: + +```bash +bundle config set matrix.default_gemfile gems.rb +bundle install +``` + +To skip the matrix for a single run, set `BUNDLE_MATRIX__DISABLED` on that command: + +```bash +BUNDLE_MATRIX__DISABLED=1 bundle install +``` + +`bundle config set matrix.disabled true` is the persistent version, and stays in effect until you change it back. + +## How each command is applied + +Flags are forwarded as typed, and Bundler's own option table decides what each flag means. The exceptions below are where a flag can't be applied to another gemfile as-is. + +- **`install`**: `--lockfile` and `--standalone` only apply to the main Gemfile, so they are not forwarded. +- **`update `**: only the named gems that appear in that gemfile's lockfile are updated. A gemfile with none of them is skipped. `--group` is limited to groups it declares. If it has no lockfile yet, `install` is run to create one. +- **`update --all`**, `--conservative`, `--patch`, `--minor`, `--major`, `--pre`, `--strict` and the rest: forwarded unchanged. +- **`add `**: gems the gemfile already declares, including through `eval_gemfile`, are not added again. If every gem is already declared, `install` is run to re-lock the gemfile. A relative `--path` is rewritten so it resolves from that gemfile's directory. +- `--gemfile` is never forwarded. The target is set through `BUNDLE_GEMFILE` instead. + +## Settings and Bundler versions + +Each gemfile is run the way `bundle` would run it on its own, with the project's settings: + +- The project's `.bundle/config` and the `BUNDLE_*` environment variables you set are passed on, so `frozen`, `without`, `jobs` and the rest apply to every gemfile. A relative `path`, `bin` or `cache_path` still resolves from the project root, so every gemfile shares the same `vendor/bundle`. A `.bundle/config` next to a secondary gemfile takes priority for that gemfile. +- `gemfile` and `lockfile` are not passed on, because they name the main Gemfile's own files. +- Each gemfile runs with the Bundler version in its own `BUNDLED WITH` line, and `install` installs that version first if it is missing. A `gem "bundler"` line in a gemfile that has no lockfile yet is not installed for you, so install that version yourself first. Bundler's `version` setting controls this: `bundle config set version system` keeps every gemfile on the running version, and `bundle config set version 4.0.23` pins one. `BUNDLER_VERSION` is not passed on, because it would hold every gemfile to one version. +- When a gemfile runs with a different Bundler from the main Gemfile, a one-line warning names both versions, and the run ends by suggesting either `bundle update --bundler`, which updates Bundler in every lockfile, or `bundle config set matrix.bundler_warnings false`, which turns these warnings off when each gemfile should keep its own Bundler. + +## How it uses Bundler + +bundle_matrix needs Bundler 2.6.9 or newer, below 4.2 and its prereleases, and is tested against 2.6.9, 2.7.2, 4.0.24 and 4.1.0.beta3. The upper bound moves up once a new Bundler minor has been tested. Under any other Bundler the plugin still runs, but prints a one-line warning that it is untested there, with a link to the issue tracker. + +Fan-out starts from Bundler's documented plugin hook, `after-install-all`, and each gemfile runs in its own `bundle` process. Everything else uses Bundler classes that work today but are not a plugin API, so a new Bundler release could change them: + +- Thor's command and option tables (`Bundler::CLI`), which decide what each flag means and which command was run (`ArgvParser`, `Invocation`). Command names such as `ins` are resolved by calling Thor's protected `normalize_command_name` with `send` +- `Bundler::Dsl` and `Bundler::LockfileParser`, which read each secondary gemfile and lockfile (`Planner`). `Bundler.definition` and `Bundler.locked_gems` only describe the main Gemfile, so they can't be used for the others. +- The settings' storage levels, through `Bundler.settings` (`ProjectSettings`) + +## Limitations + +- `bundle check` is not supported. Bundler only calls plugin hooks around installation. +- `bundle add --skip-install` never runs the hook, because no installation happens. +- Flags that Bundler does not know about are forwarded as-is, and any value after them is treated as a gem name. + +## Development + +Run `bin/setup`, then `rake`. The default task runs the unit specs, the end-to-end specs, RuboCop, `rake rbs`, which runs `rbs validate` on the signatures in `sig/` with the Bundler stubs in `sig_stubs/`, and `rake steep`, which type checks `lib/` against those signatures. Run `rake e2e` on its own for the end-to-end specs, which run real `bundle` commands and take longer. Run `COVERAGE=true bundle exec rake spec` to also write a coverage report to `coverage/index.html`. That run fails below 90% line coverage or 80% branch coverage, and CI runs it this way. + +Run `bundle exec guard` to re-run the unit specs and RuboCop on every change. It also regenerates the docs when the files they are built from change. + +`docs/` is generated by Boondoc, so edit `README.md` and the code comments rather than `docs/`. To regenerate it by hand, run `bundle exec boondoc` + +To try a change against a real project, install from a local checkout with `bundle plugin install bundle_matrix --path /path/to/bundle_matrix` (the directory must contain `plugins.rb`). + +## Contributing + +Bug reports and pull requests are welcome. Send issues and pull requests to https://github.com/joe-sharp/bundle_matrix. + +Run `bundle exec rake` before you open a pull request. The Development section above explains what it runs. + +A bug report should include: + +- the Bundler version, from `bundle -v` +- the command you ran, e.g. `bundle update rails --conservative` +- your gemfile layout: which gemfiles exist, where they are, and any `matrix.*` settings + +## License + +The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). diff --git a/Rakefile b/Rakefile new file mode 100644 index 0000000..a39c35d --- /dev/null +++ b/Rakefile @@ -0,0 +1,29 @@ +# frozen_string_literal: true + +require "bundler/gem_tasks" +require "rspec/core/rake_task" +require "rubocop/rake_task" + +RSpec::Core::RakeTask.new(:spec) { |t| t.exclude_pattern = "spec/e2e/**/*_spec.rb" } + +desc "Run the end-to-end specs, which run real bundle commands" +RSpec::Core::RakeTask.new(:e2e) { |t| t.pattern = "spec/e2e/**/*_spec.rb" } + +RuboCop::RakeTask.new + +desc "Validate the RBS signatures in sig/, with stubs for the Bundler types they name" +task :rbs do + sh "rbs", "-I", "sig", "-I", "sig_stubs", "validate" +end + +desc "Type check lib/ against the signatures in sig/ with Steep" +task :steep do + sh "steep", "check" +end + +# Replaces Bundler's release task. +Rake::Task["release"].clear +desc "Tag, push, build and publish the gemspec version, asking for a description if not given" +task(:release, [:description]) { |_, args| exec "bin/release", *[args.to_a.join(", ")].reject(&:empty?) } + +task default: %i[spec e2e rubocop rbs steep] diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..7a686de --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,12 @@ +# Security Policy + +## Supported Versions + +Only the latest release of bundle_matrix is supported with security fixes. + +## Reporting a Vulnerability + +Please don't report vulnerabilities in a public issue. Report them privately in either of these ways: + +- With GitHub's private vulnerability reporting, from the Security tab of https://github.com/joe-sharp/bundle_matrix. +- By email to joesharp13@gmail.com. diff --git a/Steepfile b/Steepfile new file mode 100644 index 0000000..2cd2078 --- /dev/null +++ b/Steepfile @@ -0,0 +1,16 @@ +# frozen_string_literal: true + +D = Steep::Diagnostic + +# Type checks lib/ against sig/. Bundler publishes no signatures, so sig_stubs/ declares the parts of its API we call. +target :lib do + signature "sig", "sig_stubs" + check "lib" + + library "pathname" + + # Annotating every empty [] and {} adds noise; the method signatures still check what they end up holding + configure_code_diagnostics(D::Ruby.default) do |hash| + hash[D::Ruby::UnannotatedEmptyCollection] = nil + end +end diff --git a/bin/console b/bin/console new file mode 100755 index 0000000..42d18a8 --- /dev/null +++ b/bin/console @@ -0,0 +1,11 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true + +require "bundler/setup" +require "bundle_matrix" + +# You can add fixtures and/or initialization code here to make experimenting +# with your gem easier. You can also use a different console, if you like. + +require "irb" +IRB.start(__FILE__) diff --git a/bin/release b/bin/release new file mode 100755 index 0000000..696fa42 --- /dev/null +++ b/bin/release @@ -0,0 +1,76 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true + +# Usage: bin/release [description] +# Releases v; the description is asked for if not given. + +require "bundler/gem_helper" +require "net/http" + +def ask(question) + print "#{question}: " + answer = $stdin.gets.to_s.strip + answer unless answer.empty? +end + +def run(*cmd) + puts "$ #{cmd.join(" ")}" + system(*cmd) || abort("Failed: #{cmd.join(" ")}") +end + +# Compact index lists every published version of the gem as the first word of each line. +def published?(host, name, version) + response = Net::HTTP.get_response(URI("#{host}/info/#{name}")) + case response + when Net::HTTPSuccess then response.body.each_line.any? { |line| line.split(" ", 2).first == version } + when Net::HTTPNotFound then false + else abort "Could not check #{host} for #{name} #{version}: #{response.code}" + end +end + +abort "GEM_HOST_API_KEY is not set" if ENV["GEM_HOST_API_KEY"].to_s.empty? +# Checked before switching branches, so a dirty tree is never carried over to main. +abort "Working tree is not clean" unless `git status --porcelain`.empty? + +run("git", "checkout", "main") +run("git", "pull", "--ff-only", "origin", "main") +abort "main does not match origin/main" unless `git rev-parse main`.strip == `git rev-parse origin/main`.strip + +# Loaded after checking out main, so the gemspec is main's. +helper = Bundler::GemHelper.new(File.expand_path("..", __dir__)) +name = helper.gemspec.name +version = helper.gemspec.version.to_s +tag = "v#{version}" + +description = ARGV.first || ask("Release description") or abort "A description is required" + +tag_exists = system("git", "rev-parse", "-q", "--verify", "refs/tags/#{tag}", out: File::NULL) +tag_commit = `git rev-parse "#{tag}^{commit}"`.strip if tag_exists +abort "#{tag} already exists but does not point at HEAD" if tag_exists && tag_commit != `git rev-parse HEAD`.strip + +puts "\nTag #{tag}: #{description}" +exit unless ask("Tag, push, build and publish? (y/N)").to_s.downcase.start_with?("y") + +if tag_exists + puts "#{tag} already exists at HEAD; not creating it again" +else + run "git", "tag", "-a", tag, "-m", description +end +# Pushing a tag that the remote already has at the same commit is a no-op. +run "git", "push", "origin", tag + +puts "$ gem build #{File.basename(helper.spec_path)}" +gem_file = helper.build_gem + +coop = "https://gem.coop/@joe-sharp" +if published?(coop, name, version) + puts "#{name} #{version} is already on #{coop}; skipping" +else + run("gem", "push", "--host", coop, gem_file) +end + +if published?(Gem.host, name, version) + puts "#{name} #{version} is already on #{Gem.host}; skipping" +else + run("gem", "push", gem_file) +end diff --git a/bin/setup b/bin/setup new file mode 100755 index 0000000..dce67d8 --- /dev/null +++ b/bin/setup @@ -0,0 +1,8 @@ +#!/usr/bin/env bash +set -euo pipefail +IFS=$'\n\t' +set -vx + +bundle install + +# Do any other automated setup that you need to do here diff --git a/bundle_matrix.gemspec b/bundle_matrix.gemspec new file mode 100644 index 0000000..83468b8 --- /dev/null +++ b/bundle_matrix.gemspec @@ -0,0 +1,42 @@ +# frozen_string_literal: true + +require_relative "lib/bundle_matrix/version" + +Gem::Specification.new do |spec| + spec.name = "bundle_matrix" + spec.version = BundleMatrix::VERSION + spec.authors = ["Joe Sharp"] + spec.email = ["joesharp13@gmail.com"] + + spec.summary = "Runs bundle install, update and add against every secondary gemfile too." + spec.description = "A Bundler plugin. After install, update or add on the main Gemfile, it replays the same " \ + "command, with the same flags, against *.gemfile files in the project root and gemfiles/, " \ + "and any extra directories configured with matrix.paths." + spec.homepage = "https://github.com/joe-sharp/bundle_matrix" + spec.license = "MIT" + spec.required_ruby_version = ">= 3.3.0" + spec.metadata["homepage_uri"] = spec.homepage + spec.metadata["source_code_uri"] = "#{spec.homepage}/tree/v#{BundleMatrix::VERSION}" + spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues" + spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md" + spec.metadata["rubygems_mfa_required"] = "true" + + # Specify which files should be added to the gem when it is released. + # Only the listed paths that are tracked in git go into the gem, so untracked files never get in. + spec.files = IO.popen( + %w[git ls-files -z -- lib sig plugins.rb README.md LICENSE.txt CHANGELOG.md], + chdir: __dir__, + err: IO::NULL + ) do |ls| + ls.readlines("\x0", chomp: true) + end + spec.bindir = "exe" + spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) } + spec.require_paths = ["lib"] + + # The plugin relies on Bundler internals that aren't a plugin API, so it only allows the tested range + spec.add_dependency "bundler", *BundleMatrix::TESTED_BUNDLER.as_list + + # For more information and examples about making a new gem, check out our + # guide at: https://guides.rubygems.org/make-your-own-gem/ +end diff --git a/docs/.boondoc-manifest b/docs/.boondoc-manifest new file mode 100644 index 0000000..c1cf46e --- /dev/null +++ b/docs/.boondoc-manifest @@ -0,0 +1,15 @@ +BundleMatrix.md +BundleMatrix/ArgvParser.md +BundleMatrix/ArgvParser/Switch.md +BundleMatrix/Config.md +BundleMatrix/Discovery.md +BundleMatrix/Error.md +BundleMatrix/Hook.md +BundleMatrix/Invocation.md +BundleMatrix/Invocation/Option.md +BundleMatrix/Planner.md +BundleMatrix/Planner/Plan.md +BundleMatrix/ProjectSettings.md +BundleMatrix/Runner.md +BundleMatrix/SecondaryGemfile.md +README.md diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..5991a53 --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,126 @@ +# How bundle_matrix works + +After `bundle install`, `bundle update` or `bundle add` succeeds on the main Gemfile, bundle_matrix runs the same command against every secondary gemfile in the project. Each one runs in its own `bundle` process. + +## Overview + +```mermaid +flowchart LR + cmd["bundle install,
update or add"] --> main["Bundler runs it on
the main Gemfile"] + main -->|"success"| hook["Hook
should it fan out?"] + hook --> parse["Invocation and ArgvParser
parse the command line"] + parse --> discover["Discovery
find the secondary
gemfiles"] + discover --> plan["Planner
one plan per gemfile"] + plan --> run["Runner
one bundle process
per gemfile"] +``` + +| Step | Files | +|------|-------| +| Hook: should it fan out? | `hook.rb` | +| Parse the command line | `invocation.rb`, `argv_parser.rb` | +| Read the `matrix.*` settings | `config.rb` | +| Find the secondary gemfiles | `discovery.rb` | +| Plan each gemfile | `planner.rb`, `secondary_gemfile.rb` | +| Run each gemfile | `runner.rb`, `project_settings.rb` | + +The hook (`hook.rb`) stops without doing anything when: + +- the command isn't `install`, `update` or `add` +- `BUNDLE_MATRIX_ACTIVE` is set, so this is already a child run +- `matrix.disabled` is set +- the command ran on a gemfile other than `matrix.default_gemfile` +- no secondary gemfiles were found + +Discovery (`discovery.rb`) looks for `*.gemfile` in the project root, `gemfiles/*.gemfile`, and each `matrix.paths` entry. A directory in `matrix.paths` contributes its `gems.rb`, or else its `Gemfile`. The main gemfile is never included. + +Every gemfile is planned before any of them runs. Planning starts by dropping `--gemfile`, then follows one of the three paths below. + +## Install + +```mermaid +flowchart LR + install["bundle install"] --> drop["drop --lockfile,
--standalone and --path"] + drop --> run["bundle install
with the other flags"] +``` + +Those three flags only make sense for the main Gemfile, or are ones Bundler no longer accepts (`--path` on Bundler 4). Each one dropped is noted in the output. + +## Update + +```mermaid +flowchart TD + update["bundle update"] --> full{"--all, or nothing named?"} + full -->|"no"| lock{"does this gemfile
have a lockfile?"} + full -->|"yes"| runAll["bundle update
with the same flags"] + lock -->|"no"| install["bundle install
to create one"] + lock -->|"yes"| match{"are any of the named gems
or groups in this gemfile?"} + match -->|"no"| skip["skip this gemfile"] + match -->|"yes"| runSome["bundle update
with only those"] +``` + +"Named" means gems, `--group`, `--source`, `--ruby` or `--bundler`. Gems are matched against this gemfile's lockfile (`gems.locked` for a `gems.rb`, otherwise `.lock`). Groups are matched against the groups this gemfile declares. An update with `--ruby` or `--bundler` is never skipped. + +## Add + +```mermaid +flowchart TD + add["bundle add gems"] --> declared{"does this gemfile
already declare them?"} + declared -->|"some are new"| addNew["bundle add
only the new gems"] + declared -->|"all of them"| install["bundle install
to re-lock"] +``` + +Declared gems include those pulled in by `eval_gemfile`. A relative `--path` is rewritten to be relative to the secondary gemfile's directory. + +## Running each gemfile + +```mermaid +flowchart TD + plan{"plan"} -->|"skip"| pass["pass"] + plan -->|"command"| child["child bundle process
in the gemfile's directory"] + plan -->|"could not plan"| fail["failure"] + child -->|"exit 0"| pass + child -->|"non-zero"| fail + fail -->|"matrix.fail_fast"| stop["stop here"] +``` + +Gemfiles run in sorted order. A gemfile that could not be planned is printed as an error and counts as a failure, and the others still run. If any failed, the run ends with `BundleMatrix::Error`, which names them and exits 1. + +The child is a separate process because Bundler keeps global state. It gets: + +- the project's `.bundle/config` and the user's `BUNDLE_*` variables, with relative paths made absolute +- `BUNDLE_GEMFILE` set to its gemfile +- `BUNDLE_MATRIX_ACTIVE=1`, so its own hook doesn't fan out again +- no `BUNDLER_VERSION`, so it runs the Bundler named in its own lockfile's `BUNDLED WITH` + +## Bundler version warnings + +- Before planning, the hook warns when the running Bundler is outside `TESTED_BUNDLER` in `version.rb`. +- Each plan that runs a command carries the Bundler named in its gemfile's lockfile. The runner warns for each one that differs from the main Bundler, when `matrix.bundler_warnings` is on and the `version` setting is `lockfile` or unset. With `system` or a pinned version, every gemfile runs the main Bundler, so nothing is warned. At the end it suggests `bundle update --bundler`, or `bundle config set matrix.bundler_warnings false` to turn these warnings off. + +## Development and CI + +```mermaid +flowchart LR + appraisals["Appraisals"] --> gemfiles["gemfiles/
one per Bundler version,
plus gem_coop"] + gemfiles --> install["CI install job
per gemfile"] + install --> checks["RuboCop, RBS,
Steep and RSpec"] + install --> appraisal["RSpec per
appraisal gemfile"] +``` + +- `rake` runs `spec`, `e2e`, `rubocop`, `rbs` and `steep`. Steep type checks `lib/` against `sig/`, and `sig_stubs/` declares the parts of Bundler's API the code calls, since Bundler publishes no signatures. +- `TESTED_BUNDLER` in `version.rb` sets the gemspec's Bundler dependency and the untested-Bundler warning. `spec/bundle_matrix_spec.rb` checks it against the `gemfiles/bundler_*.gemfile` files the Appraisals generate: every one is in range, and the range stops before the minor after the highest tested one. A new Bundler minor therefore needs the Appraisal and the range changed together. +- The E2E jobs in CI are disabled until the project moves to the public repo. + +## Bundler internals we rely on + +Parts of the plugin use Bundler code that is not a plugin API, so a Bundler release can change them. The Appraisals guard these: each `gemfiles/bundler_*.gemfile` installs one Bundler version and runs the RSpec suite against it, so a change that breaks one of these fails there. + +| Bundler internal | Used in | +|------------------|---------| +| Thor option tables: `Bundler::CLI.commands`, `Bundler::CLI.class_options`, and each option's `type`, `aliases` and `lazy_default` | `argv_parser.rb` (`table_for`, `switch_table`, `values_for`) | +| `Bundler::CLI.map`, the protected `normalize_command_name`, and the `default_cli_command` setting | `argv_parser.rb` (`split_command`, `default_command_used?`, `resolve_command`) | +| `Bundler::LockfileParser`, for `specs` and `bundler_version` | `secondary_gemfile.rb` | +| `Bundler::Dsl`, for `eval_gemfile` and `dependencies` | `secondary_gemfile.rb` | +| `Bundler.settings` `#all`, `#key_for` and `#locations` | `project_settings.rb` | +| `Bundler::SharedHelpers.relative_path_to` | `planner.rb` (`rewrite_path`) | +| The `version` setting, which decides whether each child uses its lockfile's Bundler | `runner.rb` (`other_bundler_for`) | diff --git a/docs/BundleMatrix.md b/docs/BundleMatrix.md new file mode 100644 index 0000000..ae9b36a --- /dev/null +++ b/docs/BundleMatrix.md @@ -0,0 +1,36 @@ +# Module: BundleMatrix + +- **Defined in:** [`lib/bundle_matrix.rb`](../lib/bundle_matrix.rb), [`lib/bundle_matrix/argv_parser.rb`](../lib/bundle_matrix/argv_parser.rb), [`lib/bundle_matrix/config.rb`](../lib/bundle_matrix/config.rb), [`lib/bundle_matrix/discovery.rb`](../lib/bundle_matrix/discovery.rb), [`lib/bundle_matrix/hook.rb`](../lib/bundle_matrix/hook.rb), [`lib/bundle_matrix/invocation.rb`](../lib/bundle_matrix/invocation.rb), [`lib/bundle_matrix/planner.rb`](../lib/bundle_matrix/planner.rb), [`lib/bundle_matrix/project_settings.rb`](../lib/bundle_matrix/project_settings.rb), [`lib/bundle_matrix/runner.rb`](../lib/bundle_matrix/runner.rb), [`lib/bundle_matrix/secondary_gemfile.rb`](../lib/bundle_matrix/secondary_gemfile.rb), [`lib/bundle_matrix/version.rb`](../lib/bundle_matrix/version.rb) + +A Bundler plugin that repeats `install`, `update` and `add` against every secondary gemfile in a project. + +## Namespaces + +- [`BundleMatrix::ArgvParser`](BundleMatrix/ArgvParser.md) — Finds the command in argv the way Bundler does, then splits the tokens after it into options, gems and unknown switches, using the switch table Bundler itself uses for that command. +- [`BundleMatrix::Config`](BundleMatrix/Config.md) — Reads the matrix.* settings, from `bundle config` or BUNDLE_MATRIX__* env vars. +- [`BundleMatrix::Discovery`](BundleMatrix/Discovery.md) — Finds the secondary gemfiles that follow the main Gemfile. +- [`BundleMatrix::Error`](BundleMatrix/Error.md) — Raised after the matrix run, when one or more secondary gemfiles failed +- [`BundleMatrix::Hook`](BundleMatrix/Hook.md) — Called by Bundler after `install`, `update` or `add` has finished. +- [`BundleMatrix::Invocation`](BundleMatrix/Invocation.md) — A parsed `bundle install\|update\|add` command line. +- [`BundleMatrix::Planner`](BundleMatrix/Planner.md) — Decides what to run against one secondary gemfile, given the command the user ran on the main Gemfile. +- [`BundleMatrix::ProjectSettings`](BundleMatrix/ProjectSettings.md) — The project's settings that a child run would otherwise lose: its .bundle/config, which a child doesn't read because it looks in its own gemfile's directory, and the BUNDLE_* variables the user set, which Bundler.with_unbundled_env strips. +- [`BundleMatrix::Runner`](BundleMatrix/Runner.md) — Runs each planned command in a separate `bundle` process. +- [`BundleMatrix::SecondaryGemfile`](BundleMatrix/SecondaryGemfile.md) — A secondary gemfile, and what its lockfile and declarations say about it. + +## Constants + +###
`TESTED_BUNDLER` + +```ruby +TESTED_BUNDLER = Gem::Requirement.new(">= 2.6.9", "< 4.2.a") +``` + +The Bundler versions the Appraisals test. The gemspec requires this range, and the hook warns outside it. +The lower bound is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. +The `.a` keeps 4.2 prereleases out too; raise it once a new Bundler minor has been tested. + +### `VERSION` + +```ruby +VERSION = "0.1.0" +``` diff --git a/docs/BundleMatrix/ArgvParser.md b/docs/BundleMatrix/ArgvParser.md new file mode 100644 index 0000000..668a428 --- /dev/null +++ b/docs/BundleMatrix/ArgvParser.md @@ -0,0 +1,75 @@ +# Class: BundleMatrix::ArgvParser + +- **Defined in:** [`lib/bundle_matrix/argv_parser.rb`](../../lib/bundle_matrix/argv_parser.rb) + +Finds the command in argv the way Bundler does, then splits the tokens after it into +options, gems and unknown switches, using the switch table Bundler itself uses for that command. +Every touch of Bundler::CLI is in this class, so the rest of the plugin only sees command names and tokens. + +## Namespaces + +- [`BundleMatrix::ArgvParser::Switch`](ArgvParser/Switch.md) — One switch Bundler accepts for a command; negated is true for its `--no-name` form + +## Constants + +### `INSTALL_ALIASES` + +```ruby +INSTALL_ALIASES = %w[install install_or_cli_help].freeze +``` + +## Class methods + +| Method | Summary | +| --- | --- | +| [`.call(command, tokens)`](#method-c-call) | | +| [`.split_command(argv)`](#method-c-split_command) | Returns the command Bundler would run (nil when unknown) and the tokens after it | +| [`.table_for(command)`](#method-c-table_for) | Bundler's global options (--retry, --verbose, --no-color) apply to every command, so they are added to its own. | + +### `.call` + +```ruby +def self.call(command, tokens) +``` + +**Returns:** + +- (`Array(Array<`[`Invocation::Option`](Invocation/Option.md)`>, Array, Array)`) + +### `.split_command` + +```ruby +def self.split_command(argv) +``` + +**Returns:** + +- (`Array(String, Array)`) — the command Bundler would run (nil when unknown) and the tokens after it + +### `.table_for` + +```ruby +def self.table_for(command) +``` + +Bundler's global options (--retry, --verbose, --no-color) apply to every command, so they are added to its own. +Thor's tables are not a plugin API, so a Bundler release can change them; the Appraisals cover each version. + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(table)`](#method-i-initialize) | | +| [`#call(tokens)`](#method-i-call) | | + +### `#initialize` + +```ruby +def initialize(table) +``` + +### `#call` + +```ruby +def call(tokens) +``` diff --git a/docs/BundleMatrix/ArgvParser/Switch.md b/docs/BundleMatrix/ArgvParser/Switch.md new file mode 100644 index 0000000..4ef71f3 --- /dev/null +++ b/docs/BundleMatrix/ArgvParser/Switch.md @@ -0,0 +1,38 @@ +# Class: BundleMatrix::ArgvParser::Switch + +- **Inherits:** `Data` +- **Defined in:** [`lib/bundle_matrix/argv_parser.rb`](../../../lib/bundle_matrix/argv_parser.rb) + +One switch Bundler accepts for a command; negated is true for its `--no-name` form + +## Attributes + +### `#name` + +```ruby +attr_reader :name +``` + +### `#negated` + +```ruby +attr_reader :negated +``` + +### `#option` + +```ruby +attr_reader :option +``` + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(name:, option:, negated: false)`](#method-i-initialize) | | + +### `#initialize` + +```ruby +def initialize(name:, option:, negated: false) +``` diff --git a/docs/BundleMatrix/Config.md b/docs/BundleMatrix/Config.md new file mode 100644 index 0000000..99b3e71 --- /dev/null +++ b/docs/BundleMatrix/Config.md @@ -0,0 +1,71 @@ +# Class: BundleMatrix::Config + +- **Defined in:** [`lib/bundle_matrix/config.rb`](../../lib/bundle_matrix/config.rb) + +Reads the matrix.* settings, from `bundle config` or BUNDLE_MATRIX__* env vars. + +## Constants + +### `DEFAULT_GEMFILE` + +```ruby +DEFAULT_GEMFILE = "Gemfile" +``` + +### `FALSE_VALUES` + +```ruby +FALSE_VALUES = %w[false 0 no].freeze +``` + +### `TRUE_VALUES` + +```ruby +TRUE_VALUES = %w[true 1 yes].freeze +``` + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#bundler_warnings?`](#method-i-bundler_warnings-3F) | Warn when a gemfile runs a different Bundler from the main one; on unless set to false, 0 or no | +| [`#default_gemfile`](#method-i-default_gemfile) | The file name of the main gemfile in the project root, e.g. | +| [`#disabled?`](#method-i-disabled-3F) | | +| [`#fail_fast?`](#method-i-fail_fast-3F) | | +| [`#paths`](#method-i-paths) | Extra directories (or globs) to search for a Gemfile, e.g. | + +### `#bundler_warnings?` + +```ruby +def bundler_warnings? +``` + +Warn when a gemfile runs a different Bundler from the main one; on unless set to false, 0 or no + +### `#default_gemfile` + +```ruby +def default_gemfile +``` + +The file name of the main gemfile in the project root, e.g. "gems.rb". Fan-out starts from it. + +### `#disabled?` + +```ruby +def disabled? +``` + +### `#fail_fast?` + +```ruby +def fail_fast? +``` + +### `#paths` + +```ruby +def paths +``` + +Extra directories (or globs) to search for a Gemfile, e.g. "engines/*,apps/admin". diff --git a/docs/BundleMatrix/Discovery.md b/docs/BundleMatrix/Discovery.md new file mode 100644 index 0000000..e96c9b4 --- /dev/null +++ b/docs/BundleMatrix/Discovery.md @@ -0,0 +1,40 @@ +# Class: BundleMatrix::Discovery + +- **Defined in:** [`lib/bundle_matrix/discovery.rb`](../../lib/bundle_matrix/discovery.rb) + +Finds the secondary gemfiles that follow the main Gemfile. + +## Constants + +### `DIRECTORY_GEMFILES` + +```ruby +DIRECTORY_GEMFILES = %w[gems.rb Gemfile].freeze +``` + +The gemfile a matrix.paths directory contributes, in Bundler's order + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(root, paths, default_gemfile:)`](#method-i-initialize) | default_gemfile is the main gemfile's file name in root; it is never returned, whatever its name | +| [`#gemfiles`](#method-i-gemfiles) | Returns sorted, unique, excluding the main gemfile | + +### `#initialize` + +```ruby +def initialize(root, paths, default_gemfile:) +``` + +default_gemfile is the main gemfile's file name in root; it is never returned, whatever its name + +### `#gemfiles` + +```ruby +def gemfiles +``` + +**Returns:** + +- (`Array`) — sorted, unique, excluding the main gemfile diff --git a/docs/BundleMatrix/Error.md b/docs/BundleMatrix/Error.md new file mode 100644 index 0000000..348024c --- /dev/null +++ b/docs/BundleMatrix/Error.md @@ -0,0 +1,6 @@ +# Class: BundleMatrix::Error + +- **Inherits:** `Bundler::BundlerError` +- **Defined in:** [`lib/bundle_matrix.rb`](../../lib/bundle_matrix.rb) + +Raised after the matrix run, when one or more secondary gemfiles failed diff --git a/docs/BundleMatrix/Hook.md b/docs/BundleMatrix/Hook.md new file mode 100644 index 0000000..d645f8f --- /dev/null +++ b/docs/BundleMatrix/Hook.md @@ -0,0 +1,17 @@ +# Module: BundleMatrix::Hook + +- **Defined in:** [`lib/bundle_matrix/hook.rb`](../../lib/bundle_matrix/hook.rb) + +Called by Bundler after `install`, `update` or `add` has finished. + +## Class methods + +| Method | Summary | +| --- | --- | +| [`.call(argv = ARGV)`](#method-c-call) | | + +### `.call` + +```ruby +def self.call(argv = ARGV) +``` diff --git a/docs/BundleMatrix/Invocation.md b/docs/BundleMatrix/Invocation.md new file mode 100644 index 0000000..78e0261 --- /dev/null +++ b/docs/BundleMatrix/Invocation.md @@ -0,0 +1,106 @@ +# Class: BundleMatrix::Invocation + +- **Inherits:** `Data.define(:command, :options, :gems, :unknown)` +- **Defined in:** [`lib/bundle_matrix/invocation.rb`](../../lib/bundle_matrix/invocation.rb) + +A parsed `bundle install|update|add` command line. + +Option names, aliases and value types come from Bundler's own Thor tables, +so every flag Bundler accepts is understood, and the raw tokens are kept +so they can be forwarded exactly as the user typed them. + +## Namespaces + +- [`BundleMatrix::Invocation::Option`](Invocation/Option.md) — negated is true for a `--no-name` switch, which unsets the option rather than setting it + +## Constants + +### `COMMANDS` + +```ruby +COMMANDS = %w[install update add].freeze +``` + +## Class methods + +| Method | Summary | +| --- | --- | +| [`.parse(argv)`](#method-c-parse) | Returns nil when the command is not one we fan out | + +### `.parse` + +```ruby +def self.parse(argv) +``` + +**Returns:** + +- ([`Invocation`](Invocation.md), `nil`) — nil when the command is not one we fan out + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#as(target, gems: [])`](#method-i-as) | The same flags, re-targeted at another command. | +| [`#option(name)`](#method-i-option) | | +| [`#option?(name)`](#method-i-option-3F) | `--no-name` does not count as setting the option | +| [`#replace_values(name, new_values)`](#method-i-replace_values) | Replaces an option's values, dropping the option when none are left. | +| [`#to_argv`](#method-i-to_argv) | | +| [`#values(name)`](#method-i-values) | | +| [`#with_gems(new_gems)`](#method-i-with_gems) | | +| [`#without(*names)`](#method-i-without) | | + +### `#as` + +```ruby +def as(target, gems: []) +``` + +The same flags, re-targeted at another command. Only options that command +understands are kept, and the gems are replaced. + +### `#option` + +```ruby +def option(name) +``` + +### `#option?` + +```ruby +def option?(name) +``` + +`--no-name` does not count as setting the option + +### `#replace_values` + +```ruby +def replace_values(name, new_values) +``` + +Replaces an option's values, dropping the option when none are left. + +### `#to_argv` + +```ruby +def to_argv +``` + +### `#values` + +```ruby +def values(name) +``` + +### `#with_gems` + +```ruby +def with_gems(new_gems) +``` + +### `#without` + +```ruby +def without(*names) +``` diff --git a/docs/BundleMatrix/Invocation/Option.md b/docs/BundleMatrix/Invocation/Option.md new file mode 100644 index 0000000..0369554 --- /dev/null +++ b/docs/BundleMatrix/Invocation/Option.md @@ -0,0 +1,44 @@ +# Class: BundleMatrix::Invocation::Option + +- **Inherits:** `Data` +- **Defined in:** [`lib/bundle_matrix/invocation.rb`](../../../lib/bundle_matrix/invocation.rb) + +negated is true for a `--no-name` switch, which unsets the option rather than setting it + +## Attributes + +### `#name` + +```ruby +attr_reader :name +``` + +### `#negated` + +```ruby +attr_reader :negated +``` + +### `#tokens` + +```ruby +attr_reader :tokens +``` + +### `#values` + +```ruby +attr_reader :values +``` + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(name:, tokens:, values:, negated: false)`](#method-i-initialize) | | + +### `#initialize` + +```ruby +def initialize(name:, tokens:, values:, negated: false) +``` diff --git a/docs/BundleMatrix/Planner.md b/docs/BundleMatrix/Planner.md new file mode 100644 index 0000000..9b13153 --- /dev/null +++ b/docs/BundleMatrix/Planner.md @@ -0,0 +1,39 @@ +# Class: BundleMatrix::Planner + +- **Defined in:** [`lib/bundle_matrix/planner.rb`](../../lib/bundle_matrix/planner.rb) + +Decides what to run against one secondary gemfile, given the command the +user ran on the main Gemfile. + +## Namespaces + +- [`BundleMatrix::Planner::Plan`](Planner/Plan.md) — invocation is nil when the gemfile should be skipped; notes explain why; error is set when planning failed; locked_bundler is the Bundler named in this gemfile's lockfile, set on every plan that runs a command + +## Constants + +### `MAIN_ONLY_INSTALL_OPTIONS` + +```ruby +MAIN_ONLY_INSTALL_OPTIONS = %w[lockfile standalone path].freeze +``` + +Install flags that only make sense for the main Gemfile, or that Bundler no longer accepts + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(invocation, gemfile, root)`](#method-i-initialize) | | +| [`#plan`](#method-i-plan) | | + +### `#initialize` + +```ruby +def initialize(invocation, gemfile, root) +``` + +### `#plan` + +```ruby +def plan +``` diff --git a/docs/BundleMatrix/Planner/Plan.md b/docs/BundleMatrix/Planner/Plan.md new file mode 100644 index 0000000..0275b2e --- /dev/null +++ b/docs/BundleMatrix/Planner/Plan.md @@ -0,0 +1,59 @@ +# Class: BundleMatrix::Planner::Plan + +- **Inherits:** `Data` +- **Defined in:** [`lib/bundle_matrix/planner.rb`](../../../lib/bundle_matrix/planner.rb) + +invocation is nil when the gemfile should be skipped; notes explain why; error is set when planning failed; +locked_bundler is the Bundler named in this gemfile's lockfile, set on every plan that runs a command + +## Attributes + +### `#error` + +```ruby +attr_reader :error +``` + +### `#invocation` + +```ruby +attr_reader :invocation +``` + +### `#locked_bundler` + +```ruby +attr_reader :locked_bundler +``` + +### `#notes` + +```ruby +attr_reader :notes +``` + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(invocation:, notes:, error: nil, locked_bundler: nil)`](#method-i-initialize) | | +| [`#failed?`](#method-i-failed-3F) | | +| [`#skipped?`](#method-i-skipped-3F) | | + +### `#initialize` + +```ruby +def initialize(invocation:, notes:, error: nil, locked_bundler: nil) +``` + +### `#failed?` + +```ruby +def failed? +``` + +### `#skipped?` + +```ruby +def skipped? +``` diff --git a/docs/BundleMatrix/ProjectSettings.md b/docs/BundleMatrix/ProjectSettings.md new file mode 100644 index 0000000..86c7579 --- /dev/null +++ b/docs/BundleMatrix/ProjectSettings.md @@ -0,0 +1,44 @@ +# Module: BundleMatrix::ProjectSettings + +- **Defined in:** [`lib/bundle_matrix/project_settings.rb`](../../lib/bundle_matrix/project_settings.rb) + +The project's settings that a child run would otherwise lose: its .bundle/config, +which a child doesn't read because it looks in its own gemfile's directory, and +the BUNDLE_* variables the user set, which Bundler.with_unbundled_env strips. +They are passed on as BUNDLE_* variables, so a gemfile's own .bundle/config still wins. +Settings#all and #locations are not a plugin API, so a Bundler release can change them. + +## Constants + +### `MAIN_ONLY` + +```ruby +MAIN_ONLY = %w[gemfile lockfile app_config bin_path].freeze +``` + +Settings that point at the main Gemfile's own files; each child sets these itself + +### `PATHS` + +```ruby +PATHS = %w[path bin cache_path].freeze +``` + +Settings holding a path relative to the project root, which a child would +otherwise resolve from its own directory + +## Class methods + +| Method | Summary | +| --- | --- | +| [`.env(root)`](#method-c-env) | Returns BUNDLE_* variables for a child run | + +### `.env` + +```ruby +def self.env(root) +``` + +**Returns:** + +- (`Hash{String => String}`) — BUNDLE_* variables for a child run diff --git a/docs/BundleMatrix/Runner.md b/docs/BundleMatrix/Runner.md new file mode 100644 index 0000000..7866feb --- /dev/null +++ b/docs/BundleMatrix/Runner.md @@ -0,0 +1,42 @@ +# Class: BundleMatrix::Runner + +- **Defined in:** [`lib/bundle_matrix/runner.rb`](../../lib/bundle_matrix/runner.rb) + +Runs each planned command in a separate `bundle` process. Bundler keeps +global state, so the secondary gemfiles can't be run in this process. + +## Constants + +### `BUNDLE` + +```ruby +BUNDLE = File.expand_path("bundle", __dir__) +``` + +Launched like a plain `bundle`, so RubyGems and Bundler pick each gemfile's Bundler version. +__dir__ is only nil inside eval, which Steep can't rule out. + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(root, fail_fast: false, bundler_warnings: true)`](#method-i-initialize) | bundler_warnings is false when the matrix.bundler_warnings setting turns off the Bundler version warnings | +| [`#run(plans)`](#method-i-run) | | + +### `#initialize` + +```ruby +def initialize(root, fail_fast: false, bundler_warnings: true) +``` + +bundler_warnings is false when the matrix.bundler_warnings setting turns off the Bundler version warnings + +### `#run` + +```ruby +def run(plans) +``` + +**Parameters:** + +- `plans` (`Hash{Pathname => `[`Planner::Plan`](Planner/Plan.md)`}`) diff --git a/docs/BundleMatrix/SecondaryGemfile.md b/docs/BundleMatrix/SecondaryGemfile.md new file mode 100644 index 0000000..b440005 --- /dev/null +++ b/docs/BundleMatrix/SecondaryGemfile.md @@ -0,0 +1,73 @@ +# Class: BundleMatrix::SecondaryGemfile + +- **Defined in:** [`lib/bundle_matrix/secondary_gemfile.rb`](../../lib/bundle_matrix/secondary_gemfile.rb) + +A secondary gemfile, and what its lockfile and declarations say about it. + +## Attributes + +### `#path` + +```ruby +attr_reader :path +``` + +## Instance methods + +| Method | Summary | +| --- | --- | +| [`#initialize(path)`](#method-i-initialize) | | +| [`#bundler_version`](#method-i-bundler_version) | The Bundler this gemfile's lockfile names in BUNDLED WITH, nil without a lockfile | +| [`#declared_groups`](#method-i-declared_groups) | | +| [`#declared_names`](#method-i-declared_names) | | +| [`#lock_names`](#method-i-lock_names) | Empty without a lockfile | +| [`#locked?`](#method-i-locked-3F) | | +| [`#lockfile`](#method-i-lockfile) | Bundler locks a gems.rb in gems.locked, and every other gemfile in .lock | + +### `#initialize` + +```ruby +def initialize(path) +``` + +### `#bundler_version` + +```ruby +def bundler_version +``` + +The Bundler this gemfile's lockfile names in BUNDLED WITH, nil without a lockfile + +### `#declared_groups` + +```ruby +def declared_groups +``` + +### `#declared_names` + +```ruby +def declared_names +``` + +### `#lock_names` + +```ruby +def lock_names +``` + +Empty without a lockfile + +### `#locked?` + +```ruby +def locked? +``` + +### `#lockfile` + +```ruby +def lockfile +``` + +Bundler locks a gems.rb in gems.locked, and every other gemfile in .lock diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..c055056 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,166 @@ +# BundleMatrix + +A Bundler plugin that repeats `bundle install`, `bundle update` and `bundle add` against every other gemfile in your project, so each lockfile stays in step with the main `Gemfile`. + +Projects that test against several dependency sets keep extra gemfiles (`ci.gemfile`, `gemfiles/rails7.gemfile`, engine Gemfiles, and so on). Without help, every one of them needs its own `BUNDLE_GEMFILE=… bundle install`. With bundle_matrix, running the command on the main `Gemfile` does that for you. + +![BundleMatrix](https://raw.githubusercontent.com/joe-sharp/bundle_matrix/main/BundleMatrix.webp) + +## Installation + +Install the plugin once for your user: + +```bash +bundle plugin install bundle_matrix +``` + +Or declare it in the project's `Gemfile`: + +```ruby +plugin "bundle_matrix" +``` + +## Usage + +Run the command on the main `Gemfile` as usual: + +```bash +bundle install +bundle update rails --conservative +bundle update --all +bundle add rack --group development +``` + +After the main run succeeds, each discovered gemfile is run with the same command and flags. Output is headed by the gemfile it applies to: + +``` +== bundle_matrix: gemfiles/rails7.gemfile -> bundle update rails --conservative +== bundle_matrix: engines/admin/Gemfile -> bundle install +``` + +Only `install`, `update` and `add` are fanned out. `bundle check`, `bundle exec` and similar commands are not, because Bundler does not run plugin hooks for them. + +Bundler's short forms work too: `bundle i`, `bundle ins`, `bundle a`, `bundle u`, and any other unambiguous prefix of a command name. + +A plain `bundle`, or `bundle` with only flags such as `bundle --jobs=4`, runs as `install` and fans out as `install`, but only while `default_cli_command` is unset or `install`. With it set to `cli_help`, those commands print help and nothing fans out. Bundler's documentation already names `cli_help` as the default, while its code still runs `install` and prints a notice that this will change. To keep fanning out whatever Bundler does, set the setting explicitly, or run `bundle install`: + +```bash +bundle config set default_cli_command install +``` + +## Which gemfiles are found + +The main gemfile is `Gemfile` in the project root, or the file named by `matrix.default_gemfile`. It is never treated as a secondary gemfile. Secondary gemfiles are found in: + +- `*.gemfile` in the project root, e.g. `ci.gemfile` with `ci.gemfile.lock` +- `*.gemfile` in `gemfiles/` +- any directories listed in `matrix.paths`, each contributing its `gems.rb`, or its `Gemfile` when it has no `gems.rb`, the order Bundler uses + +## Configuration + +Settings use `bundle config` or `BUNDLE_MATRIX__*` environment variables: + +| Setting | Default | Meaning | +| --- | --- | --- | +| `matrix.default_gemfile` | `Gemfile` | File name of the main gemfile in the project root. Fan-out starts only when the command runs on this file, e.g. `gems.rb` | +| `matrix.paths` | none | Extra directories or globs to search for a `gems.rb` or `Gemfile`, separated by commas, e.g. `engines/*,apps/admin` | +| `matrix.disabled` | `false` | Turn fan-out off | +| `matrix.fail_fast` | `false` | Stop at the first failing gemfile | +| `matrix.bundler_warnings` | `true` | Warn when a gemfile runs a different Bundler from the main Gemfile. Set it to `false` for projects that pin different Bundlers on purpose | + +```bash +bundle config set matrix.paths "engines/*,apps/admin" +``` + +For a project whose main file is `gems.rb`, set the main gemfile name once, and run the command on `gems.rb`: + +```bash +bundle config set matrix.default_gemfile gems.rb +bundle install +``` + +To skip the matrix for a single run, set `BUNDLE_MATRIX__DISABLED` on that command: + +```bash +BUNDLE_MATRIX__DISABLED=1 bundle install +``` + +`bundle config set matrix.disabled true` is the persistent version, and stays in effect until you change it back. + +## How each command is applied + +Flags are forwarded as typed, and Bundler's own option table decides what each flag means. The exceptions below are where a flag can't be applied to another gemfile as-is. + +- **`install`**: `--lockfile` and `--standalone` only apply to the main Gemfile, so they are not forwarded. +- **`update `**: only the named gems that appear in that gemfile's lockfile are updated. A gemfile with none of them is skipped. `--group` is limited to groups it declares. If it has no lockfile yet, `install` is run to create one. +- **`update --all`**, `--conservative`, `--patch`, `--minor`, `--major`, `--pre`, `--strict` and the rest: forwarded unchanged. +- **`add `**: gems the gemfile already declares, including through `eval_gemfile`, are not added again. If every gem is already declared, `install` is run to re-lock the gemfile. A relative `--path` is rewritten so it resolves from that gemfile's directory. +- `--gemfile` is never forwarded. The target is set through `BUNDLE_GEMFILE` instead. + +## Settings and Bundler versions + +Each gemfile is run the way `bundle` would run it on its own, with the project's settings: + +- The project's `.bundle/config` and the `BUNDLE_*` environment variables you set are passed on, so `frozen`, `without`, `jobs` and the rest apply to every gemfile. A relative `path`, `bin` or `cache_path` still resolves from the project root, so every gemfile shares the same `vendor/bundle`. A `.bundle/config` next to a secondary gemfile takes priority for that gemfile. +- `gemfile` and `lockfile` are not passed on, because they name the main Gemfile's own files. +- Each gemfile runs with the Bundler version in its own `BUNDLED WITH` line, and `install` installs that version first if it is missing. A `gem "bundler"` line in a gemfile that has no lockfile yet is not installed for you, so install that version yourself first. Bundler's `version` setting controls this: `bundle config set version system` keeps every gemfile on the running version, and `bundle config set version 4.0.23` pins one. `BUNDLER_VERSION` is not passed on, because it would hold every gemfile to one version. +- When a gemfile runs with a different Bundler from the main Gemfile, a one-line warning names both versions, and the run ends by suggesting either `bundle update --bundler`, which updates Bundler in every lockfile, or `bundle config set matrix.bundler_warnings false`, which turns these warnings off when each gemfile should keep its own Bundler. + +## How it uses Bundler + +bundle_matrix needs Bundler 2.6.9 or newer, below 4.2 and its prereleases, and is tested against 2.6.9, 2.7.2, 4.0.24 and 4.1.0.beta3. The upper bound moves up once a new Bundler minor has been tested. Under any other Bundler the plugin still runs, but prints a one-line warning that it is untested there, with a link to the issue tracker. + +Fan-out starts from Bundler's documented plugin hook, `after-install-all`, and each gemfile runs in its own `bundle` process. Everything else uses Bundler classes that work today but are not a plugin API, so a new Bundler release could change them: + +- Thor's command and option tables (`Bundler::CLI`), which decide what each flag means and which command was run (`ArgvParser`, `Invocation`). Command names such as `ins` are resolved by calling Thor's protected `normalize_command_name` with `send` +- `Bundler::Dsl` and `Bundler::LockfileParser`, which read each secondary gemfile and lockfile (`Planner`). `Bundler.definition` and `Bundler.locked_gems` only describe the main Gemfile, so they can't be used for the others. +- The settings' storage levels, through `Bundler.settings` (`ProjectSettings`) + +## Limitations + +- `bundle check` is not supported. Bundler only calls plugin hooks around installation. +- `bundle add --skip-install` never runs the hook, because no installation happens. +- Flags that Bundler does not know about are forwarded as-is, and any value after them is treated as a gem name. + +## Development + +Run `bin/setup`, then `rake`. The default task runs the unit specs, the end-to-end specs, RuboCop, `rake rbs`, which runs `rbs validate` on the signatures in `sig/` with the Bundler stubs in `sig_stubs/`, and `rake steep`, which type checks `lib/` against those signatures. Run `rake e2e` on its own for the end-to-end specs, which run real `bundle` commands and take longer. Run `COVERAGE=true bundle exec rake spec` to also write a coverage report to `coverage/index.html`. That run fails below 90% line coverage or 80% branch coverage, and CI runs it this way. + +Run `bundle exec guard` to re-run the unit specs and RuboCop on every change. It also regenerates the docs when the files they are built from change. + +`docs/` is generated by Boondoc, so edit `README.md` and the code comments rather than `docs/`. To regenerate it by hand, run `bundle exec boondoc` + +To try a change against a real project, install from a local checkout with `bundle plugin install bundle_matrix --path /path/to/bundle_matrix` (the directory must contain `plugins.rb`). + +## Contributing + +Bug reports and pull requests are welcome. Send issues and pull requests to https://github.com/joe-sharp/bundle_matrix. + +Run `bundle exec rake` before you open a pull request. The Development section above explains what it runs. + +A bug report should include: + +- the Bundler version, from `bundle -v` +- the command you ran, e.g. `bundle update rails --conservative` +- your gemfile layout: which gemfiles exist, where they are, and any `matrix.*` settings + +## License + +The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). + +## API reference + +- [`BundleMatrix`](BundleMatrix.md) — A Bundler plugin that repeats `install`, `update` and `add` against every secondary gemfile in a project. + - [`BundleMatrix::ArgvParser`](BundleMatrix/ArgvParser.md) — Finds the command in argv the way Bundler does, then splits the tokens after it into options, gems and unknown switches, using the switch table Bundler itself uses for that command. + - [`BundleMatrix::ArgvParser::Switch`](BundleMatrix/ArgvParser/Switch.md) — One switch Bundler accepts for a command; negated is true for its `--no-name` form + - [`BundleMatrix::Config`](BundleMatrix/Config.md) — Reads the matrix.* settings, from `bundle config` or BUNDLE_MATRIX__* env vars. + - [`BundleMatrix::Discovery`](BundleMatrix/Discovery.md) — Finds the secondary gemfiles that follow the main Gemfile. + - [`BundleMatrix::Error`](BundleMatrix/Error.md) — Raised after the matrix run, when one or more secondary gemfiles failed + - [`BundleMatrix::Hook`](BundleMatrix/Hook.md) — Called by Bundler after `install`, `update` or `add` has finished. + - [`BundleMatrix::Invocation`](BundleMatrix/Invocation.md) — A parsed `bundle install\|update\|add` command line. + - [`BundleMatrix::Invocation::Option`](BundleMatrix/Invocation/Option.md) — negated is true for a `--no-name` switch, which unsets the option rather than setting it + - [`BundleMatrix::Planner`](BundleMatrix/Planner.md) — Decides what to run against one secondary gemfile, given the command the user ran on the main Gemfile. + - [`BundleMatrix::Planner::Plan`](BundleMatrix/Planner/Plan.md) — invocation is nil when the gemfile should be skipped; notes explain why; error is set when planning failed; locked_bundler is the Bundler named in this gemfile's lockfile, set on every plan that runs a command + - [`BundleMatrix::ProjectSettings`](BundleMatrix/ProjectSettings.md) — The project's settings that a child run would otherwise lose: its .bundle/config, which a child doesn't read because it looks in its own gemfile's directory, and the BUNDLE_* variables the user set, which Bundler.with_unbundled_env strips. + - [`BundleMatrix::Runner`](BundleMatrix/Runner.md) — Runs each planned command in a separate `bundle` process. + - [`BundleMatrix::SecondaryGemfile`](BundleMatrix/SecondaryGemfile.md) — A secondary gemfile, and what its lockfile and declarations say about it. diff --git a/gemfiles/bundler_2.6.9.gemfile b/gemfiles/bundler_2.6.9.gemfile new file mode 100644 index 0000000..272bfc3 --- /dev/null +++ b/gemfiles/bundler_2.6.9.gemfile @@ -0,0 +1,12 @@ +# frozen_string_literal: true + +# This file was generated by Appraisal2 + +source "https://rubygems.org/" + +gem "bundler", "2.6.9" +gem "rake", "~> 13.0" +gem "rspec", "~> 3.0" +gem "rubygems-generate_index", require: false + +gemspec path: "../" diff --git a/gemfiles/bundler_2.6.9.gemfile.lock b/gemfiles/bundler_2.6.9.gemfile.lock new file mode 100644 index 0000000..0b863c3 --- /dev/null +++ b/gemfiles/bundler_2.6.9.gemfile.lock @@ -0,0 +1,48 @@ +PATH + remote: .. + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://rubygems.org/ + specs: + diff-lcs (1.6.2) + rake (13.4.2) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.7) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.6) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.9) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.8) + rubygems-generate_index (1.2.0) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + bundle_matrix! + bundler (= 2.6.9) + rake (~> 13.0) + rspec (~> 3.0) + rubygems-generate_index + +BUNDLED WITH + 2.6.9 diff --git a/gemfiles/bundler_2.7.2.gemfile b/gemfiles/bundler_2.7.2.gemfile new file mode 100644 index 0000000..3c5b105 --- /dev/null +++ b/gemfiles/bundler_2.7.2.gemfile @@ -0,0 +1,12 @@ +# frozen_string_literal: true + +# This file was generated by Appraisal2 + +source "https://rubygems.org/" + +gem "bundler", "2.7.2" +gem "rake", "~> 13.0" +gem "rspec", "~> 3.0" +gem "rubygems-generate_index", require: false + +gemspec path: "../" diff --git a/gemfiles/bundler_2.7.2.gemfile.lock b/gemfiles/bundler_2.7.2.gemfile.lock new file mode 100644 index 0000000..50843be --- /dev/null +++ b/gemfiles/bundler_2.7.2.gemfile.lock @@ -0,0 +1,48 @@ +PATH + remote: .. + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://rubygems.org/ + specs: + diff-lcs (1.6.2) + rake (13.4.2) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.7) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.6) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.9) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.8) + rubygems-generate_index (1.2.0) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + bundle_matrix! + bundler (= 2.7.2) + rake (~> 13.0) + rspec (~> 3.0) + rubygems-generate_index + +BUNDLED WITH + 2.7.2 diff --git a/gemfiles/bundler_4.0.24.gemfile b/gemfiles/bundler_4.0.24.gemfile new file mode 100644 index 0000000..fc91577 --- /dev/null +++ b/gemfiles/bundler_4.0.24.gemfile @@ -0,0 +1,12 @@ +# frozen_string_literal: true + +# This file was generated by Appraisal2 + +source "https://rubygems.org/" + +gem "bundler", "4.0.24" +gem "rake", "~> 13.0" +gem "rspec", "~> 3.0" +gem "rubygems-generate_index", require: false + +gemspec path: "../" diff --git a/gemfiles/bundler_4.0.24.gemfile.lock b/gemfiles/bundler_4.0.24.gemfile.lock new file mode 100644 index 0000000..532aa39 --- /dev/null +++ b/gemfiles/bundler_4.0.24.gemfile.lock @@ -0,0 +1,60 @@ +PATH + remote: .. + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://rubygems.org/ + specs: + diff-lcs (1.6.2) + rake (13.4.2) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.6) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.5) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.8) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.7) + rubygems-generate_index (1.2.0) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + bundle_matrix! + bundler (= 4.0.24) + rake (~> 13.0) + rspec (~> 3.0) + rubygems-generate_index + +CHECKSUMS + bundle_matrix (0.1.0) + bundler (4.0.24) sha256=16ca64e20816a0cf151a948fb141d788602996d2b4d73577b74388fe84fa98bc + diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962 + rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701 + rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587 + rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d + rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836 + rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47 + rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c + rubygems-generate_index (1.2.0) sha256=cb33b935545a38dba4ac1f20d391090d2bb017d0956537a8bbadc1fff23f0aab + +BUNDLED WITH + 4.0.24 diff --git a/gemfiles/bundler_4.1.0.beta3.gemfile b/gemfiles/bundler_4.1.0.beta3.gemfile new file mode 100644 index 0000000..0c34728 --- /dev/null +++ b/gemfiles/bundler_4.1.0.beta3.gemfile @@ -0,0 +1,12 @@ +# frozen_string_literal: true + +# This file was generated by Appraisal2 + +source "https://rubygems.org/" + +gem "bundler", "4.1.0.beta3" +gem "rake", "~> 13.0" +gem "rspec", "~> 3.0" +gem "rubygems-generate_index", require: false + +gemspec path: "../" diff --git a/gemfiles/bundler_4.1.0.beta3.gemfile.lock b/gemfiles/bundler_4.1.0.beta3.gemfile.lock new file mode 100644 index 0000000..083def9 --- /dev/null +++ b/gemfiles/bundler_4.1.0.beta3.gemfile.lock @@ -0,0 +1,60 @@ +PATH + remote: .. + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://rubygems.org/ + specs: + diff-lcs (1.6.2) + rake (13.4.2) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.7) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.6) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.9) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.8) + rubygems-generate_index (1.2.0) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + bundle_matrix! + bundler (= 4.1.0.beta3) + rake (~> 13.0) + rspec (~> 3.0) + rubygems-generate_index + +CHECKSUMS + bundle_matrix (0.1.0) + bundler (4.1.0.beta3) sha256=3a0dbbbb7c86af269517a9de67903472e219d3ae9edb3b6b4da7706cdc993d12 + diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962 + rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701 + rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587 + rspec-core (3.13.7) sha256=c64ff16d9788119805cbc6a3f4b6d87cc22417c2d25976a3330de136896b5469 + rspec-expectations (3.13.6) sha256=bf538ca6d367ff5b0d85a87fdb5c0c6038f2cd1308a0eeba07476caa02d22f35 + rspec-mocks (3.13.9) sha256=ea5c7ff3054a6098ca6039aacef80aec69d5a8a3ef80be8fc88337359b672a30 + rspec-support (3.13.8) sha256=e4160030309b7e3e9d9863dfe720a35dfcc577162f5402cd68fc8c5258a0ffd6 + rubygems-generate_index (1.2.0) sha256=cb33b935545a38dba4ac1f20d391090d2bb017d0956537a8bbadc1fff23f0aab + +BUNDLED WITH + 4.1.0.beta3 diff --git a/gemfiles/gem_coop.gemfile b/gemfiles/gem_coop.gemfile new file mode 100644 index 0000000..d646eb3 --- /dev/null +++ b/gemfiles/gem_coop.gemfile @@ -0,0 +1,17 @@ +# frozen_string_literal: true + +# This file was generated by Appraisal2 + +source "https://gem.coop/" + +gem "rake", "~> 13.0" +gem "rspec", "~> 3.0" +gem "rubygems-generate_index", require: false + +source "https://gem.coop/@joe-sharp" do + gem "boondoc" + gem "guard-boondoc" + gem "sharp_style_rubocop" +end + +gemspec path: "../" diff --git a/gemfiles/gem_coop.gemfile.lock b/gemfiles/gem_coop.gemfile.lock new file mode 100644 index 0000000..2d5ca32 --- /dev/null +++ b/gemfiles/gem_coop.gemfile.lock @@ -0,0 +1,233 @@ +PATH + remote: .. + specs: + bundle_matrix (0.1.0) + bundler (>= 2.6.9, < 4.2.a) + +GEM + remote: https://gem.coop/ + specs: + ast (2.4.3) + coderay (1.1.3) + diff-lcs (1.6.2) + ffi (1.17.4) + ffi (1.17.4-aarch64-linux-gnu) + ffi (1.17.4-aarch64-linux-musl) + ffi (1.17.4-arm-linux-gnu) + ffi (1.17.4-arm-linux-musl) + ffi (1.17.4-arm64-darwin) + ffi (1.17.4-x86-linux-gnu) + ffi (1.17.4-x86-linux-musl) + ffi (1.17.4-x86_64-darwin) + ffi (1.17.4-x86_64-linux-gnu) + ffi (1.17.4-x86_64-linux-musl) + formatador (1.2.3) + reline + guard (2.20.2) + formatador (>= 0.2.4) + listen (>= 2.7, < 4.0) + logger (~> 1.6) + lumberjack (>= 1.0.12, < 2.0) + nenv (~> 0.1) + notiffany (~> 0.0) + pry (>= 0.13.0) + shellany (~> 0.0) + thor (>= 0.18.1) + guard-compat (1.2.1) + io-console (0.9.5) + json (3.1.0) + language_server-protocol (3.17.0.6) + lint_roller (1.1.0) + listen (3.10.1) + logger + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + logger (1.7.0) + lumberjack (1.4.2) + method_source (1.1.0) + nenv (0.3.0) + notiffany (0.1.3) + nenv (~> 0.1) + shellany (~> 0.0) + parallel (2.3.0) + parser (3.3.13.0) + ast (~> 2.4.1) + racc + prism (1.9.0) + pry (0.16.1) + coderay (~> 1.1) + method_source (~> 1.0) + reline (>= 0.6.0) + racc (1.8.1) + rainbow (3.1.1) + rake (13.4.2) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) + ffi (~> 1.0) + regexp_parser (2.13.1) + reline (0.7.0) + io-console (~> 0.5) + rspec (3.13.2) + rspec-core (~> 3.13.0) + rspec-expectations (~> 3.13.0) + rspec-mocks (~> 3.13.0) + rspec-core (3.13.6) + rspec-support (~> 3.13.0) + rspec-expectations (3.13.5) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-mocks (3.13.8) + diff-lcs (>= 1.2.0, < 2.0) + rspec-support (~> 3.13.0) + rspec-support (3.13.7) + rubocop (1.92.2) + json (>= 2.3) + language_server-protocol (~> 3.17.0.2) + lint_roller (~> 1.1.0) + parallel (>= 1.10) + parser (>= 3.3.0.2) + rainbow (>= 2.2.2, < 4.0) + regexp_parser (>= 2.11.3, < 3.0) + rubocop-ast (>= 1.49.0, < 2.0) + ruby-progressbar (~> 1.7) + unicode-display_width (>= 2.4.0, < 4.0) + rubocop-ast (1.50.0) + parser (>= 3.3.7.2) + prism (~> 1.7) + rubocop-capybara (3.1.0) + lint_roller (~> 1.1) + rubocop (~> 1.89) + rubocop-minitest (0.41.0) + lint_roller (~> 1.1) + rubocop (>= 1.89.0, < 2.0) + rubocop-ast (>= 1.38.0, < 2.0) + rubocop-performance (1.27.0) + lint_roller (~> 1.1) + rubocop (>= 1.89.0, < 2.0) + rubocop-ast (>= 1.47.1, < 2.0) + rubocop-rake (0.7.1) + lint_roller (~> 1.1) + rubocop (>= 1.72.1) + rubocop-rspec (3.10.2) + lint_roller (~> 1.1) + regexp_parser (>= 2.0) + rubocop (~> 1.86, >= 1.86.2) + rubocop-thread_safety (0.8.0) + lint_roller (~> 1.1) + rubocop (~> 1.89) + rubocop-ast (>= 1.44.0, < 2.0) + ruby-progressbar (1.13.0) + rubygems-generate_index (1.2.0) + shellany (0.0.1) + thor (1.5.0) + unicode-display_width (3.3.0) + unicode-emoji (~> 4.3) + unicode-emoji (4.3.0) + +GEM + remote: https://gem.coop/@joe-sharp/ + specs: + boondoc (0.2.1) + prism (>= 1.0, < 3) + thor (~> 1.2) + guard-boondoc (0.1.1) + boondoc + guard (~> 2.20) + guard-compat (~> 1.2) + sharp_style_rubocop (0.1.6) + rubocop (~> 1.92) + rubocop-capybara (~> 3.1) + rubocop-minitest (~> 0.41) + rubocop-performance (~> 1.20) + rubocop-rake (~> 0.7) + rubocop-rspec (~> 3.0) + rubocop-thread_safety (~> 0.8) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + boondoc! + bundle_matrix! + guard-boondoc! + rake (~> 13.0) + rspec (~> 3.0) + rubygems-generate_index + sharp_style_rubocop! + +CHECKSUMS + ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383 + boondoc (0.2.1) sha256=3cfe5bd9b1ca5a2ab34a482d5b387778dad54eae575de5c90d850d1cb3599203 + bundle_matrix (0.1.0) + bundler (4.0.24) sha256=16ca64e20816a0cf151a948fb141d788602996d2b4d73577b74388fe84fa98bc + coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b + diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962 + ffi (1.17.4) sha256=bcd1642e06f0d16fc9e09ac6d49c3a7298b9789bcb58127302f934e437d60acf + ffi (1.17.4-aarch64-linux-gnu) sha256=b208f06f91ffd8f5e1193da3cae3d2ccfc27fc36fba577baf698d26d91c080df + ffi (1.17.4-aarch64-linux-musl) sha256=9286b7a615f2676245283aef0a0a3b475ae3aae2bb5448baace630bb77b91f39 + ffi (1.17.4-arm-linux-gnu) sha256=d6dbddf7cb77bf955411af5f187a65b8cd378cb003c15c05697f5feee1cb1564 + ffi (1.17.4-arm-linux-musl) sha256=9d4838ded0465bef6e2426935f6bcc93134b6616785a84ffd2a3d82bc3cf6f95 + ffi (1.17.4-arm64-darwin) sha256=19071aaf1419251b0a46852abf960e77330a3b334d13a4ab51d58b31a937001b + ffi (1.17.4-x86-linux-gnu) sha256=38e150df5f4ca555e25beca4090823ae09657bceded154e3c52f8631c1ed72cf + ffi (1.17.4-x86-linux-musl) sha256=fbeec0fc7c795bcf86f623bb18d31ea1820f7bd580e1703a3d3740d527437809 + ffi (1.17.4-x86_64-darwin) sha256=aa70390523cf3235096cf64962b709b4cfbd5c082a2cb2ae714eb0fe2ccda496 + ffi (1.17.4-x86_64-linux-gnu) sha256=9d3db14c2eae074b382fa9c083fe95aec6e0a1451da249eab096c34002bc752d + ffi (1.17.4-x86_64-linux-musl) sha256=3fdf9888483de005f8ef8d1cf2d3b20d86626af206cbf780f6a6a12439a9c49e + formatador (1.2.3) sha256=19fa898133c2c26cdbb5d09f6998c1e137ad9427a046663e55adfe18b950d894 + guard (2.20.2) sha256=2d0574d35619669f2f71739a0313290810b9cf66b2263f5d97e815fcce598d4d + guard-boondoc (0.1.1) sha256=57bb57a8e81dd3f62518158df5a07af6c245e6460e0d91cf2cf7cf38cf1a83c2 + guard-compat (1.2.1) sha256=3ad21ab0070107f92edfd82610b5cdc2fb8e368851e72362ada9703443d646fe + io-console (0.9.5) sha256=83dd9bbf4c4680416629245b39cd4212eb5f4d9a4ea91804870c1f6b846414d5 + json (3.1.0) sha256=3ce7ccf8fde58960177a3a756c31f292a4c1e1dedee884547096a5b0604e3bd8 + language_server-protocol (3.17.0.6) sha256=5ef2c0c138f8267e1bc631d3328347d354f96724b0af22f2c79516120443b7f0 + lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87 + listen (3.10.1) sha256=4c3f32855657f348747da4dd2372ff3790d90a6b1d3e4f21a3706adb2d04783c + logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203 + lumberjack (1.4.2) sha256=40de5ae46321380c835031bcc1370f13bba304d29f2b5f5bb152061a5a191b95 + method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5 + nenv (0.3.0) sha256=d9de6d8fb7072228463bf61843159419c969edb34b3cef51832b516ae7972765 + notiffany (0.1.3) sha256=d37669605b7f8dcb04e004e6373e2a780b98c776f8eb503ac9578557d7808738 + parallel (2.3.0) sha256=f75a3e904101ce6a1ccb6b8dc800cbafd42166d83330192438dcf29395167a6f + parser (3.3.13.0) sha256=e02f9b63c2fe05b0c68f692ba4df89b3cb113b663964f75d988fbebfd6c3deca + prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85 + pry (0.16.1) sha256=d92d82c86e7f2dc34beec6d2892d5cf5ea517eea22eed3ceabb38ee62a98accc + racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f + rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a + rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701 + rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe + rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e + regexp_parser (2.13.1) sha256=5aedb6b7c35688f51e86eef17a15374dfd287c83f4ca644b2c5f3ec50a33b44b + reline (0.7.0) sha256=5b012d8e55dbf9d450f12bde2cf7d15ff546ae80b3f8f3b30e570d431815583d + rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587 + rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d + rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836 + rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47 + rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c + rubocop (1.92.2) sha256=14fb31eed143a0dc6f78186c550c1715e81cd38f59d05d1165050e445c1f5382 + rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db + rubocop-capybara (3.1.0) sha256=1712900b04178272b643f7bffa385f7b1d157c4f83a0ad502ae10690e18f5096 + rubocop-minitest (0.41.0) sha256=c15bfe00134a30c8a00ce670b07ecc80440455ba277b8682cf0d515c98ee7426 + rubocop-performance (1.27.0) sha256=eeeb1374d062a368ee1c787b70eb0b0cc4b184cb1f8565f424760946146d61ce + rubocop-rake (0.7.1) sha256=3797f2b6810c3e9df7376c26d5f44f3475eda59eb1adc38e6f62ecf027cbae4d + rubocop-rspec (3.10.2) sha256=0b3e2ecc592cd10ecbf0095bb58d1e357905276e069643523cc19eb7495f65e2 + rubocop-thread_safety (0.8.0) sha256=71fe5e7894fb9acfbd4c2dcd394feabc35bd690f75b0bc846e1504d9e31f9034 + ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33 + rubygems-generate_index (1.2.0) sha256=cb33b935545a38dba4ac1f20d391090d2bb017d0956537a8bbadc1fff23f0aab + sharp_style_rubocop (0.1.6) sha256=624fa66fb1cea95d919092dd135f28ecf7d21319528f38e1486c84c2c64a4016 + shellany (0.0.1) sha256=0e127a9132698766d7e752e82cdac8250b6adbd09e6c0a7fbbb6f61964fedee7 + thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73 + unicode-display_width (3.3.0) sha256=4b7aa66a4b11db50f6f7e98411215cd0dd10eaecb665d36eec5bcacb3fa0b613 + unicode-emoji (4.3.0) sha256=11c02fa73290378c066bb0562cd4c87d8e1b706fbbe0059ca12746a4244de8ce + +BUNDLED WITH + 4.0.24 diff --git a/lib/bundle_matrix.rb b/lib/bundle_matrix.rb new file mode 100644 index 0000000..e2b3565 --- /dev/null +++ b/lib/bundle_matrix.rb @@ -0,0 +1,21 @@ +# frozen_string_literal: true + +require "bundler" +require_relative "bundle_matrix/version" +require_relative "bundle_matrix/config" +require_relative "bundle_matrix/project_settings" +require_relative "bundle_matrix/discovery" +require_relative "bundle_matrix/argv_parser" +require_relative "bundle_matrix/invocation" +require_relative "bundle_matrix/secondary_gemfile" +require_relative "bundle_matrix/planner" +require_relative "bundle_matrix/runner" +require_relative "bundle_matrix/hook" + +# A Bundler plugin that repeats `install`, `update` and `add` against every secondary gemfile in a project. +module BundleMatrix + # Raised after the matrix run, when one or more secondary gemfiles failed + class Error < Bundler::BundlerError + status_code(1) + end +end diff --git a/lib/bundle_matrix/argv_parser.rb b/lib/bundle_matrix/argv_parser.rb new file mode 100644 index 0000000..4deee15 --- /dev/null +++ b/lib/bundle_matrix/argv_parser.rb @@ -0,0 +1,160 @@ +# frozen_string_literal: true + +require "bundler/cli" + +module BundleMatrix + # Finds the command in argv the way Bundler does, then splits the tokens after it into + # options, gems and unknown switches, using the switch table Bundler itself uses for that command. + # Every touch of Bundler::CLI is in this class, so the rest of the plugin only sees command names and tokens. + class ArgvParser + Switch = Data.define(:name, :option, :negated) + + # One switch Bundler accepts for a command; negated is true for its `--no-name` form + class Switch + def initialize(name:, option:, negated: false) + super + end + end + + INSTALL_ALIASES = %w[install install_or_cli_help].freeze + + # @return [Array(String, Array)] the command Bundler would run (nil when unknown) and the tokens after it + def self.split_command(argv) + first, *rest = argv + return [resolve_command(first), rest] unless default_command_used?(first) + + command = resolve_command(Bundler.settings[:default_cli_command] || "install") + # Bundler runs install for its deprecated install_or_cli_help alias too + [INSTALL_ALIASES.include?(command) ? "install" : command, argv] + end + + # Bundler runs its default command when argv is empty or starts with a switch + # (`bundle`, `bundle --jobs=4`), and then every token is an argument. A mapped + # switch such as `-v` is still a command of its own. With default_cli_command unset, + # Bundler 4 still runs install here, with a notice that this will change. Its docs + # already name cli_help as the default, but the code does not, so this follows the code. + # The setting is read directly, because Bundler::CLI.default_command prints that notice again. + def self.default_command_used?(token) + token.nil? || (token.start_with?("-") && !Bundler::CLI.map.key?(token)) + end + private_class_method :default_command_used? + + # Thor has no public method for prefix lookup (`i`, `ins`, `a`, `u`), so this calls its protected + # normalize_command_name. The code already relies on Thor's tables, and calling the method keeps + # the result identical to Bundler's, where a copy could drift without anyone noticing. + def self.resolve_command(token) + return unless token + + Bundler::CLI.send(:normalize_command_name, token) + rescue Bundler::Thor::AmbiguousTaskError + # Bundler rejects an ambiguous name before installing, so the hook never sees one. This is only a safeguard. + nil + end + private_class_method :resolve_command + + # @return [Array(Array, Array, Array)] + def self.call(command, tokens) + new(table_for(command)).call(tokens) + end + + # Bundler's global options (--retry, --verbose, --no-color) apply to every command, so they are added to its own. + # Thor's tables are not a plugin API, so a Bundler release can change them; the Appraisals cover each version. + def self.table_for(command) + Bundler::CLI.class_options.merge(Bundler::CLI.commands.fetch(command).options) + end + + def initialize(table) + @switches = switch_table(table) + end + + def call(tokens) + switch_tokens, literal_gems = split_terminator(tokens) + options, gems, unknown = collect(switch_tokens.dup) + [options, gems + literal_gems, unknown] + end + + private + + def collect(rest) + options = [] + gems = [] + unknown = [] + + until rest.empty? + token = rest.shift + next gems << token unless switch?(token) + + option = read_option(token, rest) + option ? options << option : unknown << token + end + + [options, gems, unknown] + end + + def switch_table(table) + switches = table.each_with_object({}) do |(name, option), lookup| + lookup["--#{name}"] = Switch.new(name: name, option: option) + option.aliases.each { |alias_name| lookup[alias_name] = Switch.new(name: name, option: option) } + end + + table.each do |name, option| + next unless option.type == :boolean + + switches["--no-#{name}"] ||= Switch.new(name: name, option: option, negated: true) + end + + switches + end + + def switch?(token) + token.start_with?("-") && token != "-" + end + + # Everything after a bare `--` is a gem name, whatever it looks like + def split_terminator(tokens) + index = tokens.index("--") + return [tokens, []] unless index + + [tokens.take(index), tokens.drop(index + 1)] + end + + # Consumes the values that belong to a switch from the front of rest + def read_option(token, rest) + key, inline = split_switch(token) + switch = @switches[key] + return unless switch + + values, used = values_for(switch.option, inline, rest) + Invocation::Option.new( + name: switch.name, tokens: [token, *rest.shift(used)], values: values, negated: switch.negated + ) + end + + # `--name=value`, and `-jvalue` for single-dash switches + def split_switch(token) + key, separator, value = token.partition("=") + value = nil if separator.empty? + return [key, value] if @switches.key?(key) || !token.match?(/\A-[^-]/) + + short = token[0, 2].to_s + @switches.key?(short) ? [short, token[2..]] : [key, value] + end + + # @return [Array(Array, Integer)] the values and how many following tokens they used + def values_for(option, inline, rest) + return array_values(rest, [inline]) if option.type == :array && inline + return [[inline], 0] if inline + return [[], 0] if option.type == :boolean + return array_values(rest, []) if option.type == :array + return [[], 0] if rest.empty? || (option.lazy_default && switch?(rest.first)) + + [[rest.first], 1] + end + + # An array option takes every value up to the next switch, after any value given inline with `=` + def array_values(rest, leading) + values = rest.take_while { |token| !switch?(token) } + [leading + values, values.size] + end + end +end diff --git a/lib/bundle_matrix/bundle b/lib/bundle_matrix/bundle new file mode 100644 index 0000000..181e041 --- /dev/null +++ b/lib/bundle_matrix/bundle @@ -0,0 +1,13 @@ +# frozen_string_literal: true + +# The same as RubyGems' `bundle` binstub. Loading Bundler through RubyGems picks +# the Bundler version for each gemfile from BUNDLER_VERSION, the `version` +# setting or its lockfile's BUNDLED WITH line, as running `bundle` would. +# Kept in lib/ so it is not installed as an executable of this gem. +require "rubygems" + +if Gem.respond_to?(:activate_and_load_bin_path) + Gem.activate_and_load_bin_path("bundler", "bundle", ">= 0.a") +else + load Gem.activate_bin_path("bundler", "bundle", ">= 0.a") +end diff --git a/lib/bundle_matrix/config.rb b/lib/bundle_matrix/config.rb new file mode 100644 index 0000000..7b65784 --- /dev/null +++ b/lib/bundle_matrix/config.rb @@ -0,0 +1,40 @@ +# frozen_string_literal: true + +module BundleMatrix + # Reads the matrix.* settings, from `bundle config` or BUNDLE_MATRIX__* env vars. + class Config + TRUE_VALUES = %w[true 1 yes].freeze + FALSE_VALUES = %w[false 0 no].freeze + DEFAULT_GEMFILE = "Gemfile" + + # Extra directories (or globs) to search for a Gemfile, e.g. "engines/*,apps/admin". + def paths + Bundler.settings["matrix.paths"].to_s.split(",").map(&:strip).reject(&:empty?) + end + + # The file name of the main gemfile in the project root, e.g. "gems.rb". Fan-out starts from it. + def default_gemfile + value = Bundler.settings["matrix.default_gemfile"].to_s.strip + value.empty? ? DEFAULT_GEMFILE : value + end + + def disabled? + truthy?("matrix.disabled") + end + + def fail_fast? + truthy?("matrix.fail_fast") + end + + # Warn when a gemfile runs a different Bundler from the main one; on unless set to false, 0 or no + def bundler_warnings? + !FALSE_VALUES.include?(Bundler.settings["matrix.bundler_warnings"].to_s.downcase) + end + + private + + def truthy?(key) + TRUE_VALUES.include?(Bundler.settings[key].to_s.downcase) + end + end +end diff --git a/lib/bundle_matrix/discovery.rb b/lib/bundle_matrix/discovery.rb new file mode 100644 index 0000000..9bd4a55 --- /dev/null +++ b/lib/bundle_matrix/discovery.rb @@ -0,0 +1,53 @@ +# frozen_string_literal: true + +module BundleMatrix + # Finds the secondary gemfiles that follow the main Gemfile. + class Discovery + # The gemfile a matrix.paths directory contributes, in Bundler's order + DIRECTORY_GEMFILES = %w[gems.rb Gemfile].freeze + + # default_gemfile is the main gemfile's file name in root; it is never returned, whatever its name + def initialize(root, paths, default_gemfile:) + @root = Pathname(root).expand_path + @paths = paths + @default_gemfile = default_gemfile + end + + # @return [Array] sorted, unique, excluding the main gemfile + def gemfiles + found = glob("*.gemfile") + glob("gemfiles/*.gemfile") + configured_gemfiles + + found.map(&:expand_path).uniq.sort - [default_gemfile_path] + end + + private + + def default_gemfile_path + @root.join(@default_gemfile) + end + + # Patterns are relative to the root, so glob characters in the project's own path are not special + def glob(pattern) + Dir.glob(pattern, base: @root.to_s).map { |match| @root.join(match) } + end + + def configured_gemfiles + @paths.flat_map do |entry| + found = glob(entry).flat_map { |match| gemfiles_at(match) } + Bundler.ui.warn("bundle_matrix: matrix.paths entry #{entry.inspect} matched no Gemfile") if found.empty? + found + end + end + + def gemfiles_at(path) + if path.directory? + gemfile = DIRECTORY_GEMFILES.map { |name| path.join(name) }.find(&:file?) + gemfile ? [gemfile] : [] + elsif path.file? && path.basename.to_s.match?(/(gemfile|\Agems\.rb)\z/i) + [path] + else + [] + end + end + end +end diff --git a/lib/bundle_matrix/hook.rb b/lib/bundle_matrix/hook.rb new file mode 100644 index 0000000..c1526d9 --- /dev/null +++ b/lib/bundle_matrix/hook.rb @@ -0,0 +1,52 @@ +# frozen_string_literal: true + +module BundleMatrix + # Called by Bundler after `install`, `update` or `add` has finished. + module Hook + ISSUES_URL = "https://github.com/joe-sharp/bundle_matrix/issues" + + def self.call(argv = ARGV) + invocation = Invocation.parse(argv) + return unless invocation && !secondary_run? + + config = Config.new + return if config.disabled? || !default_gemfile?(config) + + root = Bundler.root + gemfiles = Discovery.new(root, config.paths, default_gemfile: config.default_gemfile).gemfiles + return if gemfiles.empty? + + warn_untested_bundler + + runner = Runner.new(root, fail_fast: config.fail_fast?, bundler_warnings: config.bundler_warnings?) + runner.run(plans_for(invocation, gemfiles, root)) + end + + def self.plans_for(invocation, gemfiles, root) + gemfiles.to_h do |gemfile| + [gemfile, Planner.new(invocation, gemfile, root).plan] + end + end + + # Fan-out still runs under an untested Bundler, but asks to hear about anything that breaks + def self.warn_untested_bundler + return if TESTED_BUNDLER.satisfied_by?(Gem::Version.new(Bundler::VERSION)) + + Bundler.ui.warn( + "bundle_matrix: not tested with Bundler #{Bundler::VERSION}; " \ + "if anything goes wrong, please open an issue at #{ISSUES_URL}" + ) + end + + def self.default_gemfile?(config) + Bundler.default_gemfile.basename.to_s == config.default_gemfile + end + + # Child runs set this, so they never fan out again + def self.secondary_run? + !ENV["BUNDLE_MATRIX_ACTIVE"].to_s.empty? + end + private_class_method :default_gemfile?, :secondary_run?, :plans_for, :warn_untested_bundler + private_constant :ISSUES_URL + end +end diff --git a/lib/bundle_matrix/invocation.rb b/lib/bundle_matrix/invocation.rb new file mode 100644 index 0000000..869247a --- /dev/null +++ b/lib/bundle_matrix/invocation.rb @@ -0,0 +1,71 @@ +# frozen_string_literal: true + +module BundleMatrix + # A parsed `bundle install|update|add` command line. + # + # Option names, aliases and value types come from Bundler's own Thor tables, + # so every flag Bundler accepts is understood, and the raw tokens are kept + # so they can be forwarded exactly as the user typed them. + class Invocation < Data.define(:command, :options, :gems, :unknown) + COMMANDS = %w[install update add].freeze + + Option = Data.define(:name, :tokens, :values, :negated) + + # negated is true for a `--no-name` switch, which unsets the option rather than setting it + class Option + def initialize(name:, tokens:, values:, negated: false) + super + end + end + + # @return [Invocation, nil] nil when the command is not one we fan out + def self.parse(argv) + command, tokens = ArgvParser.split_command(argv) + return unless command && COMMANDS.include?(command) + + options, gems, unknown = ArgvParser.call(command, tokens) + new(command: command, options: options, gems: gems, unknown: unknown) + end + + # `--no-name` does not count as setting the option + def option?(name) + options.any? { |opt| opt.name == name && !opt.negated } + end + + def option(name) + options.find { |opt| opt.name == name } + end + + def values(name) + option(name)&.values || [] + end + + def with_gems(new_gems) + with(gems: new_gems) + end + + def without(*names) + with(options: options.reject { |opt| names.include?(opt.name) }) + end + + # Replaces an option's values, dropping the option when none are left. + def replace_values(name, new_values) + rest = without(name) + return rest if new_values.empty? + + added = Option.new(name: name, tokens: ["--#{name}", *new_values], values: new_values) + rest.with(options: rest.options + [added]) + end + + # The same flags, re-targeted at another command. Only options that command + # understands are kept, and the gems are replaced. + def as(target, gems: []) + table = ArgvParser.table_for(target) + with(command: target, options: options.select { |opt| table.key?(opt.name) }, gems: gems, unknown: []) + end + + def to_argv + [command, *gems, *options.flat_map(&:tokens), *unknown] + end + end +end diff --git a/lib/bundle_matrix/planner.rb b/lib/bundle_matrix/planner.rb new file mode 100644 index 0000000..573da02 --- /dev/null +++ b/lib/bundle_matrix/planner.rb @@ -0,0 +1,124 @@ +# frozen_string_literal: true + +module BundleMatrix + # Decides what to run against one secondary gemfile, given the command the + # user ran on the main Gemfile. + class Planner + Plan = Data.define(:invocation, :notes, :error, :locked_bundler) + + # invocation is nil when the gemfile should be skipped; notes explain why; error is set when planning failed; + # locked_bundler is the Bundler named in this gemfile's lockfile, set on every plan that runs a command + class Plan + def initialize(invocation:, notes:, error: nil, locked_bundler: nil) + super + end + + def failed? + !error.nil? + end + + def skipped? + invocation.nil? && error.nil? + end + end + + # Install flags that only make sense for the main Gemfile, or that Bundler no longer accepts + MAIN_ONLY_INSTALL_OPTIONS = %w[lockfile standalone path].freeze + + def initialize(invocation, gemfile, root) + @invocation = invocation.without("gemfile") + @gemfile = SecondaryGemfile.new(gemfile) + @root = Pathname(root).expand_path + end + + def plan + case @invocation.command + when "install" then install_plan(@invocation) + when "update" then update_plan + when "add" then add_plan + else raise ArgumentError, "unknown command #{@invocation.command}" + end + rescue => e + # One gemfile that can't be read must not stop the others, so its error is reported as its own failure + Plan.new(invocation: nil, notes: [], error: e.message) + end + + private + + def install_plan(invocation, notes = []) + dropped = MAIN_ONLY_INSTALL_OPTIONS.select { |name| invocation.option?(name) } + notes += dropped.map { |name| "--#{name} is not forwarded to other gemfiles" } + run(invocation.without(*MAIN_ONLY_INSTALL_OPTIONS), notes) + end + + def update_plan + return run(@invocation) if full_update?(@invocation) + return install_instead("no lockfile yet") unless @gemfile.locked? + + narrow_update(@invocation) + end + + # Keeps only the named gems and groups that this gemfile's lockfile or dependencies know about + def narrow_update(invocation) + gems = invocation.gems & @gemfile.lock_names + groups = invocation.values("group") & @gemfile.declared_groups + if unmatched?(invocation, gems, groups) + return skip("none of #{requested(invocation).join(", ")} are in this gemfile") + end + + run(invocation.with_gems(gems).replace_values("group", groups)) + end + + # Named gems or groups were given, but none of them apply to this gemfile + def unmatched?(invocation, gems, groups) + requested(invocation).any? && gems.empty? && groups.empty? && + !invocation.option?("ruby") && !invocation.option?("bundler") + end + + def requested(invocation) + invocation.gems + invocation.values("group") + end + + def add_plan + declared = @gemfile.declared_names + already = @invocation.gems & declared + new_gems = @invocation.gems - declared + notes = already.map { |name| "#{name} is already declared, not added again" } + + if new_gems.empty? + return install_plan(@invocation.as("install"), notes + ["gems already declared, re-locking with install"]) + end + + run(rewrite_path(@invocation.with_gems(new_gems)), notes) + end + + def full_update?(invocation) + return true if invocation.option?("all") + + invocation.gems.empty? && invocation.values("source").empty? && invocation.values("group").empty? && + !invocation.option?("ruby") && !invocation.option?("bundler") + end + + def install_instead(reason) + install_plan(@invocation.as("install"), ["#{reason}, running install to create it"]) + end + + # A relative --path is written into the main Gemfile relative to the root, + # so it has to be rewritten to be relative to this gemfile instead. + def rewrite_path(invocation) + return invocation unless invocation.option?("path") + + absolute = File.expand_path(invocation.values("path").first, @root) + relative = Bundler::SharedHelpers.relative_path_to(absolute, from: @gemfile.path.dirname) + invocation.replace_values("path", [relative]) + end + + def run(invocation, notes = []) + Plan.new(invocation: invocation, notes: notes, locked_bundler: @gemfile.bundler_version) + end + + def skip(reason) + Plan.new(invocation: nil, notes: ["skipped, #{reason}"]) + end + end +end diff --git a/lib/bundle_matrix/project_settings.rb b/lib/bundle_matrix/project_settings.rb new file mode 100644 index 0000000..99899c2 --- /dev/null +++ b/lib/bundle_matrix/project_settings.rb @@ -0,0 +1,32 @@ +# frozen_string_literal: true + +module BundleMatrix + # The project's settings that a child run would otherwise lose: its .bundle/config, + # which a child doesn't read because it looks in its own gemfile's directory, and + # the BUNDLE_* variables the user set, which Bundler.with_unbundled_env strips. + # They are passed on as BUNDLE_* variables, so a gemfile's own .bundle/config still wins. + # Settings#all and #locations are not a plugin API, so a Bundler release can change them. + module ProjectSettings + # Settings that point at the main Gemfile's own files; each child sets these itself + MAIN_ONLY = %w[gemfile lockfile app_config bin_path].freeze + + # Settings holding a path relative to the project root, which a child would + # otherwise resolve from its own directory + PATHS = %w[path bin cache_path].freeze + + # @return [Hash{String => String}] BUNDLE_* variables for a child run + def self.env(root) + settings = Bundler.settings + user_env = Bundler.original_env + + (settings.all - MAIN_ONLY).each_with_object({}) do |name, env| + key = settings.key_for(name) + # Bundler gives .bundle/config priority over the environment + value = settings.locations(name)[:local] || user_env[key] + next if value.nil? + + env[key] = PATHS.include?(name) ? File.expand_path(value.to_s, root) : value.to_s + end + end + end +end diff --git a/lib/bundle_matrix/runner.rb b/lib/bundle_matrix/runner.rb new file mode 100644 index 0000000..23b2a84 --- /dev/null +++ b/lib/bundle_matrix/runner.rb @@ -0,0 +1,111 @@ +# frozen_string_literal: true + +module BundleMatrix + # Runs each planned command in a separate `bundle` process. Bundler keeps + # global state, so the secondary gemfiles can't be run in this process. + class Runner + # Launched like a plain `bundle`, so RubyGems and Bundler pick each gemfile's Bundler version. + # __dir__ is only nil inside eval, which Steep can't rule out. + BUNDLE = File.expand_path("bundle", __dir__) # steep:ignore + + # bundler_warnings is false when the matrix.bundler_warnings setting turns off the Bundler version warnings + def initialize(root, fail_fast: false, bundler_warnings: true) + @root = Pathname(root).expand_path + @fail_fast = fail_fast + @bundler_warnings = bundler_warnings + end + + # @param plans [Hash{Pathname => Planner::Plan}] + def run(plans) + failures = [] + other_bundler = false + + plans.each do |gemfile, plan| + label = gemfile.relative_path_from(@root) + # Only a plan that runs carries a locked_bundler, so a skipped or unplannable one never sets this + version = other_bundler_for(plan) + other_bundler ||= version + next if plan_passed?(gemfile, label, plan, version) + + failures << label + break if @fail_fast + end + + suggest_bundler_update if other_bundler + return if failures.empty? + + raise Error, "bundle_matrix: failed for #{failures.join(", ")}" + end + + private + + # @return [Boolean] true when the plan was skipped or its command succeeded + def plan_passed?(gemfile, label, plan, other_bundler) + if plan.failed? + report_unplanned(label, plan.error) + return false + end + + plan.notes.each { |note| say(label, note) } + # A plan that neither failed nor has a command was skipped + invocation = plan.invocation + return true unless invocation + + Bundler.ui.info("== bundle_matrix: #{label} -> bundle #{invocation.to_argv.join(" ")}") + warn_other_bundler(label, other_bundler) + success?(gemfile, invocation) + end + + def say(label, message) + Bundler.ui.info("== bundle_matrix: #{label}: #{message}") + end + + # A gemfile that could not be planned is a failure, and the other gemfiles still run + def report_unplanned(label, error) + Bundler.ui.error("== bundle_matrix: #{label}: could not plan: #{error}") + end + + # The Bundler a plan's lockfile switches to, when that is worth a warning; nil otherwise. + # A child switches only when the `version` setting is lockfile, the default. With `system` or a pinned + # version, every gemfile runs the same Bundler as the main one. + def other_bundler_for(plan) + version = plan.locked_bundler + return unless version && @bundler_warnings && [nil, "lockfile"].include?(Bundler.settings[:version]) + + version unless version == Gem::Version.new(Bundler::VERSION) + end + + def warn_other_bundler(label, version) + return unless version + + Bundler.ui.warn("bundle_matrix: #{label} uses Bundler #{version}, the main Gemfile uses #{Bundler::VERSION}") + end + + def suggest_bundler_update + Bundler.ui.warn( + "bundle_matrix: run `bundle update --bundler` to update Bundler in every lockfile, " \ + "or `bundle config set matrix.bundler_warnings false` to silence these warnings" + ) + end + + def success?(gemfile, invocation) + Bundler.unbundled_system( + child_env(gemfile), Gem.ruby, BUNDLE, *invocation.to_argv, chdir: gemfile.dirname.to_s + ) == true + end + + # BUNDLER_VERSION would hold every gemfile to one version, and it is left set in this + # process when Bundler restarted itself for the main lockfile, so it is cleared. + def child_env(gemfile) + project_env.merge( + "BUNDLE_GEMFILE" => gemfile.to_s, + "BUNDLE_MATRIX_ACTIVE" => "1", + "BUNDLER_VERSION" => nil + ) + end + + def project_env + @project_env ||= ProjectSettings.env(@root) + end + end +end diff --git a/lib/bundle_matrix/secondary_gemfile.rb b/lib/bundle_matrix/secondary_gemfile.rb new file mode 100644 index 0000000..c43f67e --- /dev/null +++ b/lib/bundle_matrix/secondary_gemfile.rb @@ -0,0 +1,57 @@ +# frozen_string_literal: true + +module BundleMatrix + # A secondary gemfile, and what its lockfile and declarations say about it. + class SecondaryGemfile + attr_reader :path + + def initialize(path) + @path = Pathname(path).expand_path + end + + # Bundler locks a gems.rb in gems.locked, and every other gemfile in .lock + def lockfile + return path.sub_ext(".locked") if path.basename.to_s == "gems.rb" + + Pathname("#{path}.lock") + end + + def locked? + lockfile.file? + end + + # The Bundler this gemfile's lockfile names in BUNDLED WITH, nil without a lockfile + def bundler_version + locked&.bundler_version + end + + # Empty without a lockfile + def lock_names + @lock_names ||= (locked&.specs || []).map(&:name).uniq + end + + def declared_names + declared.map(&:name) + end + + def declared_groups + declared.flat_map(&:groups).map(&:to_s).uniq + end + + private + + # nil when this gemfile has no lockfile yet. Bundler.locked_gems only reads the main Gemfile's lockfile, + # so LockfileParser, which is not a plugin API, reads this one. + def locked + return @locked if defined?(@locked) + + @locked = locked? ? Bundler::LockfileParser.new(lockfile.read) : nil + end + + # Dependencies declared by this gemfile, including those pulled in by eval_gemfile. + # Bundler.definition only describes the main Gemfile, so Dsl, which is not a plugin API, evaluates this one. + def declared + @declared ||= Bundler::Dsl.new.tap { |dsl| dsl.eval_gemfile(path) }.dependencies + end + end +end diff --git a/lib/bundle_matrix/version.rb b/lib/bundle_matrix/version.rb new file mode 100644 index 0000000..06f5aa1 --- /dev/null +++ b/lib/bundle_matrix/version.rb @@ -0,0 +1,10 @@ +# frozen_string_literal: true + +module BundleMatrix + VERSION = "0.1.0" + + # The Bundler versions the Appraisals test. The gemspec requires this range, and the hook warns outside it. + # The lower bound is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. + # The `.a` keeps 4.2 prereleases out too; raise it once a new Bundler minor has been tested. + TESTED_BUNDLER = Gem::Requirement.new(">= 2.6.9", "< 4.2.a") +end diff --git a/plugins.rb b/plugins.rb new file mode 100644 index 0000000..d17a498 --- /dev/null +++ b/plugins.rb @@ -0,0 +1,7 @@ +# frozen_string_literal: true + +require_relative "lib/bundle_matrix" + +Bundler::Plugin::API.hook(Bundler::Plugin::Events::GEM_AFTER_INSTALL_ALL) do |_dependencies| + BundleMatrix::Hook.call +end diff --git a/sig/bundle_matrix.rbs b/sig/bundle_matrix.rbs new file mode 100644 index 0000000..62051d0 --- /dev/null +++ b/sig/bundle_matrix.rbs @@ -0,0 +1,208 @@ +module BundleMatrix + VERSION: String + TESTED_BUNDLER: Gem::Requirement + + class Error < Bundler::BundlerError + def status_code: () -> Integer + end + + class ArgvParser + class Switch < Data + attr_reader name: String + attr_reader option: Bundler::Thor::Option + attr_reader negated: bool + + def self.new: (name: String, option: Bundler::Thor::Option, ?negated: bool) -> instance + def initialize: (name: String, option: Bundler::Thor::Option, ?negated: bool) -> void + end + + INSTALL_ALIASES: Array[String] + + @switches: Hash[String, Switch] + + def self.split_command: (Array[String] argv) -> [String?, Array[String]] + private def self.default_command_used?: (String? token) -> bool + private def self.resolve_command: (String? token) -> String? + def self.call: (String command, Array[String] tokens) -> [Array[Invocation::Option], Array[String], Array[String]] + def self.table_for: (String command) -> Hash[String, Bundler::Thor::Option] + + def initialize: (Hash[String, Bundler::Thor::Option] table) -> void + def call: (Array[String] tokens) -> [Array[Invocation::Option], Array[String], Array[String]] + + private + + def collect: (Array[String] rest) -> [Array[Invocation::Option], Array[String], Array[String]] + def switch_table: (Hash[String, Bundler::Thor::Option] table) -> Hash[String, Switch] + def switch?: (String token) -> bool + def split_terminator: (Array[String] tokens) -> [Array[String], Array[String]] + def read_option: (String token, Array[String] rest) -> Invocation::Option? + def split_switch: (String token) -> [String, String?] + def values_for: (Bundler::Thor::Option option, String? inline, Array[String] rest) -> [Array[String], Integer] + def array_values: (Array[String] rest, Array[String] leading) -> [Array[String], Integer] + end + + class Config + TRUE_VALUES: Array[String] + FALSE_VALUES: Array[String] + DEFAULT_GEMFILE: String + + def paths: () -> Array[String] + def default_gemfile: () -> String + def disabled?: () -> bool + def fail_fast?: () -> bool + def bundler_warnings?: () -> bool + + private + + def truthy?: (String key) -> bool + end + + class Discovery + DIRECTORY_GEMFILES: Array[String] + + @root: Pathname + @paths: Array[String] + @default_gemfile: String + + def initialize: (Pathname | String root, Array[String] paths, default_gemfile: String) -> void + def gemfiles: () -> Array[Pathname] + + private + + def default_gemfile_path: () -> Pathname + def glob: (String pattern) -> Array[Pathname] + def configured_gemfiles: () -> Array[Pathname] + def gemfiles_at: (Pathname path) -> Array[Pathname] + end + + class Invocation < Data + COMMANDS: Array[String] + + class Option < Data + attr_reader name: String + attr_reader tokens: Array[String] + attr_reader values: Array[String] + attr_reader negated: bool + + def self.new: (name: String, tokens: Array[String], values: Array[String], ?negated: bool) -> instance + def initialize: (name: String, tokens: Array[String], values: Array[String], ?negated: bool) -> void + end + + attr_reader command: String + attr_reader options: Array[Option] + attr_reader gems: Array[String] + attr_reader unknown: Array[String] + + def self.new: (command: String, options: Array[Option], gems: Array[String], unknown: Array[String]) -> instance + def self.parse: (Array[String] argv) -> Invocation? + + def with: (?command: String, ?options: Array[Option], ?gems: Array[String], ?unknown: Array[String]) -> Invocation + def option?: (String name) -> bool + def option: (String name) -> Option? + def values: (String name) -> Array[String] + def with_gems: (Array[String] new_gems) -> Invocation + def without: (*String names) -> Invocation + def replace_values: (String name, Array[String] new_values) -> Invocation + def as: (String target, ?gems: Array[String]) -> Invocation + def to_argv: () -> Array[String] + end + + class SecondaryGemfile + @locked: Bundler::LockfileParser? + @lock_names: Array[String]? + @declared: Array[Bundler::Dependency]? + + attr_reader path: Pathname + + def initialize: (Pathname | String path) -> void + def lockfile: () -> Pathname + def locked?: () -> bool + def bundler_version: () -> Gem::Version? + def lock_names: () -> Array[String] + def declared_names: () -> Array[String] + def declared_groups: () -> Array[String] + + private + + def locked: () -> Bundler::LockfileParser? + def declared: () -> Array[Bundler::Dependency] + end + + class Planner + class Plan < Data + attr_reader invocation: Invocation? + attr_reader notes: Array[String] + attr_reader error: String? + attr_reader locked_bundler: Gem::Version? + + def self.new: (invocation: Invocation?, notes: Array[String], ?error: String?, ?locked_bundler: Gem::Version?) -> instance + def initialize: (invocation: Invocation?, notes: Array[String], ?error: String?, ?locked_bundler: Gem::Version?) -> void + def failed?: () -> bool + def skipped?: () -> bool + end + + MAIN_ONLY_INSTALL_OPTIONS: Array[String] + + @invocation: Invocation + @gemfile: SecondaryGemfile + @root: Pathname + + def initialize: (Invocation invocation, Pathname | String gemfile, Pathname | String root) -> void + def plan: () -> Plan + + private + + def install_plan: (Invocation invocation, ?Array[String] notes) -> Plan + def update_plan: () -> Plan + def narrow_update: (Invocation invocation) -> Plan + def unmatched?: (Invocation invocation, Array[String] gems, Array[String] groups) -> bool + def requested: (Invocation invocation) -> Array[String] + def add_plan: () -> Plan + def full_update?: (Invocation invocation) -> bool + def install_instead: (String reason) -> Plan + def rewrite_path: (Invocation invocation) -> Invocation + def run: (Invocation invocation, ?Array[String] notes) -> Plan + def skip: (String reason) -> Plan + end + + module ProjectSettings + MAIN_ONLY: Array[String] + PATHS: Array[String] + + def self.env: (Pathname root) -> Hash[String, String] + end + + class Runner + BUNDLE: String + + @root: Pathname + @fail_fast: bool + @bundler_warnings: bool + @project_env: Hash[String, String]? + + def initialize: (Pathname | String root, ?fail_fast: bool, ?bundler_warnings: bool) -> void + def run: (Hash[Pathname, Planner::Plan] plans) -> void + + private + + def plan_passed?: (Pathname gemfile, Pathname label, Planner::Plan plan, Gem::Version? other_bundler) -> bool + def say: (Pathname label, String message) -> void + def report_unplanned: (Pathname label, String? error) -> void + def other_bundler_for: (Planner::Plan plan) -> Gem::Version? + def warn_other_bundler: (Pathname label, Gem::Version? version) -> void + def suggest_bundler_update: () -> void + def success?: (Pathname gemfile, Invocation invocation) -> bool + def child_env: (Pathname gemfile) -> Hash[String, String?] + def project_env: () -> Hash[String, String] + end + + module Hook + ISSUES_URL: String + + def self.call: (?Array[String] argv) -> void + private def self.plans_for: (Invocation invocation, Array[Pathname] gemfiles, Pathname root) -> Hash[Pathname, Planner::Plan] + private def self.warn_untested_bundler: () -> void + private def self.default_gemfile?: (Config config) -> bool + private def self.secondary_run?: () -> bool + end +end diff --git a/sig_stubs/bundler.rbs b/sig_stubs/bundler.rbs new file mode 100644 index 0000000..e2e4026 --- /dev/null +++ b/sig_stubs/bundler.rbs @@ -0,0 +1,78 @@ +# Stand-ins for the parts of Bundler that lib/ calls, so rbs and Steep can check against them. +# Bundler publishes no signatures. These cover only what the plugin uses, and are not a model of its API. +module Bundler + VERSION: String + + def self.settings: () -> Settings + def self.ui: () -> UI::Shell + def self.root: () -> Pathname + def self.default_gemfile: () -> Pathname + def self.original_env: () -> Hash[String, String] + def self.unbundled_system: (Hash[String, String?] env, *String command, chdir: String) -> bool? + + class BundlerError < StandardError + def self.status_code: (Integer code) -> void + end + + class Settings + # Values are strings, booleans or numbers, depending on the setting + def []: (String | Symbol name) -> untyped + def all: () -> Array[String] + def key_for: (String name) -> String + def locations: (String name) -> Hash[Symbol, untyped] + end + + module UI + class Shell + def info: (String message) -> void + def warn: (String message) -> void + def error: (String message) -> void + end + end + + class Dependency + def name: () -> String + def groups: () -> Array[Symbol] + end + + class LazySpecification + def name: () -> String + end + + class LockfileParser + def initialize: (String lockfile) -> void + def specs: () -> Array[LazySpecification] + def bundler_version: () -> Gem::Version? + end + + class Dsl + def eval_gemfile: (Pathname gemfile) -> void + def dependencies: () -> Array[Dependency] + end + + module SharedHelpers + def self.relative_path_to: (String destination, from: Pathname) -> String + end + + class Thor + class Option + def type: () -> Symbol + def aliases: () -> Array[String] + def lazy_default: () -> untyped + end + + class Command + def options: () -> Hash[String, Option] + end + + class AmbiguousTaskError < StandardError + end + + def self.class_options: () -> Hash[String, Option] + def self.commands: () -> Hash[String, Command] + def self.map: () -> Hash[String, String] + end + + class CLI < Thor + end +end diff --git a/spec/bundle_matrix/config_spec.rb b/spec/bundle_matrix/config_spec.rb new file mode 100644 index 0000000..b2a76c0 --- /dev/null +++ b/spec/bundle_matrix/config_spec.rb @@ -0,0 +1,129 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Config) do + let(:root) { Pathname(Dir.mktmpdir("bundle_matrix_root")).realpath } + let(:config) { described_class.new } + + after { FileUtils.remove_entry(root) } + + def settings(local_config: {}, env: {}) + root.join(".bundle").mkpath + root.join(".bundle", "config").write(local_config.map { |key, value| "#{key}: \"#{value}\"\n" }.join) + stub_const("ENV", isolated_env(env)) + allow(Bundler).to receive(:settings).and_return(Bundler::Settings.new(root.join(".bundle"))) + end + + # Keeps the developer's own BUNDLE_MATRIX__* vars and global Bundler config out of the spec. + # Bundler checks BUNDLE_CONFIG before BUNDLE_USER_CONFIG, so BUNDLE_CONFIG has to go too. + def isolated_env(env) + ENV.to_h + .reject { |key, _| key == "BUNDLE_CONFIG" || key.start_with?("BUNDLE_MATRIX__") } + .merge("BUNDLE_USER_CONFIG" => root.join("global_config").to_s, **env) + end + + it "splits matrix.paths on commas only, so a colon stays in the path" do + settings(local_config: { "BUNDLE_MATRIX__PATHS" => "engines/*, apps/admin,C:/engines" }) + + expect(config.paths).to eq(["engines/*", "apps/admin", "C:/engines"]) + end + + it "has no paths when matrix.paths is not set" do + settings + + expect(config.paths).to eq([]) + end + + it "drops empty entries and surrounding whitespace from matrix.paths" do + settings(local_config: { "BUNDLE_MATRIX__PATHS" => " a ,, b ," }) + + expect(config.paths).to eq(%w[a b]) + end + + it "uses Gemfile as the default gemfile when matrix.default_gemfile is not set" do + settings + + expect(config.default_gemfile).to eq("Gemfile") + end + + it "reads the default gemfile from bundle config" do + settings(local_config: { "BUNDLE_MATRIX__DEFAULT_GEMFILE" => "gems.rb" }) + + expect(config.default_gemfile).to eq("gems.rb") + end + + it "reads the default gemfile from BUNDLE_MATRIX__DEFAULT_GEMFILE" do + settings(env: { "BUNDLE_MATRIX__DEFAULT_GEMFILE" => "gems.rb" }) + + expect(config.default_gemfile).to eq("gems.rb") + end + + it "is neither disabled nor fail fast by default", :aggregate_failures do + settings + + expect(config).not_to be_disabled + expect(config).not_to be_fail_fast + end + + it "prefers bundle config over BUNDLE_MATRIX__* env vars" do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "true" }, env: { "BUNDLE_MATRIX__DISABLED" => "no" }) + + expect(config).to be_disabled + end + + it "is disabled with bundle config" do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "true" }) + + expect(config).to be_disabled + end + + it "is disabled with BUNDLE_MATRIX__DISABLED" do + settings(env: { "BUNDLE_MATRIX__DISABLED" => "1" }) + + expect(config).to be_disabled + end + + it "treats true and yes as on, regardless of case", :aggregate_failures do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "TRUE", "BUNDLE_MATRIX__FAIL_FAST" => "YES" }) + + expect(config).to be_disabled + expect(config).to be_fail_fast + end + + it "treats false as off" do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "false" }) + + expect(config).not_to be_disabled + end + + it "treats an empty value as off" do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "" }) + + expect(config).not_to be_disabled + end + + it "warns about other Bundler versions by default" do + settings + + expect(config).to be_bundler_warnings + end + + it "turns off Bundler version warnings when matrix.bundler_warnings is false, 0 or no", :aggregate_failures do + %w[false 0 NO].each do |value| + settings(local_config: { "BUNDLE_MATRIX__BUNDLER_WARNINGS" => value }) + expect(config).not_to be_bundler_warnings + end + end + + it "turns off Bundler version warnings with BUNDLE_MATRIX__BUNDLER_WARNINGS" do + settings(env: { "BUNDLE_MATRIX__BUNDLER_WARNINGS" => "false" }) + + expect(config).not_to be_bundler_warnings + end + + it "treats anything other than true, 1 or yes as off", :aggregate_failures do + settings(local_config: { "BUNDLE_MATRIX__DISABLED" => "no", "BUNDLE_MATRIX__FAIL_FAST" => "off" }) + + expect(config).not_to be_disabled + expect(config).not_to be_fail_fast + end +end diff --git a/spec/bundle_matrix/discovery_spec.rb b/spec/bundle_matrix/discovery_spec.rb new file mode 100644 index 0000000..f371c61 --- /dev/null +++ b/spec/bundle_matrix/discovery_spec.rb @@ -0,0 +1,123 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Discovery) do + let(:root) { Pathname(Dir.mktmpdir("bundle_matrix_root")).realpath } + + after { FileUtils.remove_entry(root) } + + def touch(*parts) + path = root.join(*parts) + path.dirname.mkpath + path.write("") + path + end + + def relative(gemfiles) + gemfiles.map { |path| path.relative_path_from(root).to_s } + end + + before do + touch("Gemfile") + touch("Gemfile.lock") + touch("ci.gemfile") + touch("ci.gemfile.lock") + touch("gemfiles", "rails7.gemfile") + touch("gemfiles", "rails7.gemfile.lock") + touch("engines", "admin", "Gemfile") + touch("engines", "api", "Gemfile") + touch("engines", "api.txt") + end + + it "finds *.gemfile in the root and in gemfiles/, but not lockfiles or the main Gemfile" do + found = described_class.new(root, [], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile gemfiles/rails7.gemfile]) + end + + it "finds gemfiles when the project path contains glob characters" do + touch("app[v2]", "ci.gemfile") + touch("app[v2]", "gemfiles", "rails.gemfile") + + found = described_class.new(root.join("app[v2]"), [], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[app[v2]/ci.gemfile app[v2]/gemfiles/rails.gemfile]) + end + + it "lists a gemfile once when matrix.paths entries overlap" do + found = described_class.new(root, ["engines/*", "engines/admin"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found).count("engines/admin/Gemfile")).to eq(1) + end + + it "finds Gemfiles in configured directories, with globs" do + found = described_class.new(root, ["engines/*"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile engines/admin/Gemfile engines/api/Gemfile gemfiles/rails7.gemfile]) + end + + it "accepts a gemfile path directly" do + touch("apps", "web.gemfile") + + found = described_class.new(root, ["apps/web.gemfile"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to include("apps/web.gemfile") + end + + it "never returns the main gemfile, even when its name ends in .gemfile" do + touch("foo.gemfile") + touch("foo.gemfile.lock") + + found = described_class.new(root, [], default_gemfile: "foo.gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile gemfiles/rails7.gemfile]) + end + + it "keeps Gemfile as a secondary when the main gemfile is named differently" do + touch("gems.rb") + + found = described_class.new(root, [], default_gemfile: "gems.rb").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile gemfiles/rails7.gemfile]) + end + + it "uses gems.rb in a configured directory that has no Gemfile" do + touch("engines", "web", "gems.rb") + + found = described_class.new(root, ["engines/web"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile engines/web/gems.rb gemfiles/rails7.gemfile]) + end + + it "uses a gems.rb named directly in matrix.paths" do + touch("engines", "web", "gems.rb") + + found = described_class.new(root, ["engines/web/gems.rb"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile engines/web/gems.rb gemfiles/rails7.gemfile]) + end + + it "prefers gems.rb over Gemfile in a configured directory, as Bundler does" do + touch("engines", "api", "gems.rb") + + found = described_class.new(root, ["engines/api"], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile engines/api/gems.rb gemfiles/rails7.gemfile]) + end + + it "skips the main gems.rb when matrix.paths points at the project root" do + touch("gems.rb") + root.join("Gemfile").delete + + found = described_class.new(root, ["."], default_gemfile: "gems.rb").gemfiles + + expect(relative(found)).not_to include("gems.rb") + end + + it "warns when a configured path matches nothing" do + allow(Bundler.ui).to receive(:warn) + + described_class.new(root, ["nowhere/*"], default_gemfile: "Gemfile").gemfiles + + expect(Bundler.ui).to have_received(:warn).with(%r{nowhere/\*}) + end +end diff --git a/spec/bundle_matrix/hook_spec.rb b/spec/bundle_matrix/hook_spec.rb new file mode 100644 index 0000000..18caa0e --- /dev/null +++ b/spec/bundle_matrix/hook_spec.rb @@ -0,0 +1,168 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Hook) do + let(:root) { Pathname("/project") } + let(:discovered) { [root.join("ci.gemfile"), root.join("gemfiles/rails7.gemfile")] } + + def config_double(**overrides) + defaults = { disabled?: false, paths: [], fail_fast?: false, bundler_warnings?: true, default_gemfile: "Gemfile" } + instance_double(BundleMatrix::Config, **defaults, **overrides) + end + + before do + allow(Bundler).to receive_messages(default_gemfile: root.join("Gemfile"), root: root) + allow(Bundler.ui).to receive(:warn) + allow(BundleMatrix::Runner).to receive(:new).and_return(instance_double(BundleMatrix::Runner, run: nil)) + allow(BundleMatrix::Discovery).to receive(:new).and_return( + instance_double(BundleMatrix::Discovery, gemfiles: [root.join("ci.gemfile")]) + ) + allow(BundleMatrix::Planner).to receive(:new).and_return(instance_double(BundleMatrix::Planner, plan: :ci_plan)) + allow(BundleMatrix::Config).to receive(:new).and_return(config_double) + stub_const("ENV", ENV.to_h.merge("BUNDLE_MATRIX_ACTIVE" => nil)) + end + + # The untested-Bundler warning, checked directly, since the hook only reaches it after finding gemfiles + describe "the untested Bundler warning" do + def warn_untested_bundler + described_class.send(:warn_untested_bundler) + end + + it "warns that a Bundler outside the tested range is untested, linking to the issue tracker" do + stub_const("Bundler::VERSION", "4.2.0") + + warn_untested_bundler + + expect(Bundler.ui).to have_received(:warn).with( + "bundle_matrix: not tested with Bundler 4.2.0; " \ + "if anything goes wrong, please open an issue at https://github.com/joe-sharp/bundle_matrix/issues" + ) + end + + it "treats a 4.2 prerelease as untested" do + stub_const("Bundler::VERSION", "4.2.0.beta1") + + warn_untested_bundler + + expect(Bundler.ui).to have_received(:warn) + end + + it "does not warn under a tested Bundler" do + %w[2.6.9 4.1.0.beta3].each do |version| + stub_const("Bundler::VERSION", version) + + warn_untested_bundler + end + + expect(Bundler.ui).not_to have_received(:warn) + end + + it "warns before fanning out, when the running Bundler is untested", :aggregate_failures do + stub_const("Bundler::VERSION", "4.2.0") + + described_class.call(%w[install]) + + expect(Bundler.ui).to have_received(:warn).with(a_string_including("not tested with Bundler 4.2.0")) + expect(BundleMatrix::Runner).to have_received(:new) + end + end + + it "does nothing when running inside a secondary run" do + stub_const("ENV", ENV.to_h.merge("BUNDLE_MATRIX_ACTIVE" => "1")) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + it "does nothing when the main Gemfile is not the default gemfile" do + allow(Bundler).to receive(:default_gemfile).and_return(root.join("ci.gemfile")) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + it "fans out from an overridden default gemfile", :aggregate_failures do + allow(Bundler).to receive(:default_gemfile).and_return(root.join("gems.rb")) + allow(BundleMatrix::Config).to receive(:new).and_return(config_double(default_gemfile: "gems.rb")) + + described_class.call(%w[install]) + + expect(BundleMatrix::Discovery).to have_received(:new).with(root, [], default_gemfile: "gems.rb") + expect(BundleMatrix::Runner).to have_received(:new) + end + + it "does nothing from Gemfile when the default gemfile is overridden" do + allow(BundleMatrix::Config).to receive(:new).and_return(config_double(default_gemfile: "gems.rb")) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + it "does nothing when disabled" do + allow(BundleMatrix::Config).to receive(:new).and_return(instance_double(BundleMatrix::Config, disabled?: true)) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + it "does nothing for commands other than install, update and add" do + described_class.call(%w[exec rspec]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + it "does nothing when there are no secondary gemfiles" do + allow(BundleMatrix::Discovery).to receive(:new).and_return(instance_double(BundleMatrix::Discovery, gemfiles: [])) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).not_to have_received(:new) + end + + { + "install" => %w[install], + "update" => %w[update --all], + "add" => %w[add rack] + }.each do |command, argv| + it "plans every discovered gemfile for #{command}", :aggregate_failures do + allow(BundleMatrix::Discovery).to receive(:new) + .and_return(instance_double(BundleMatrix::Discovery, gemfiles: discovered)) + + described_class.call(argv) + + discovered.each do |gemfile| + expect(BundleMatrix::Planner).to have_received(:new) + .with(having_attributes(command: command), gemfile, root) + end + end + end + + it "hands every gemfile's plan to the runner, with fail_fast from the config", :aggregate_failures do + runner = instance_double(BundleMatrix::Runner, run: nil) + allow(BundleMatrix::Runner).to receive(:new).and_return(runner) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).to have_received(:new).with(root, fail_fast: false, bundler_warnings: true) + expect(runner).to have_received(:run).with(root.join("ci.gemfile") => :ci_plan) + end + + it "passes fail_fast through to the runner when the config enables it" do + allow(BundleMatrix::Config).to receive(:new).and_return(config_double(fail_fast?: true)) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).to have_received(:new).with(root, fail_fast: true, bundler_warnings: true) + end + + it "passes bundler_warnings through to the runner when the config turns it off" do + allow(BundleMatrix::Config).to receive(:new).and_return(config_double(bundler_warnings?: false)) + + described_class.call(%w[install]) + + expect(BundleMatrix::Runner).to have_received(:new).with(root, fail_fast: false, bundler_warnings: false) + end +end diff --git a/spec/bundle_matrix/invocation_spec.rb b/spec/bundle_matrix/invocation_spec.rb new file mode 100644 index 0000000..a706c6b --- /dev/null +++ b/spec/bundle_matrix/invocation_spec.rb @@ -0,0 +1,251 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Invocation) do + def parse(*argv) + described_class.parse(argv) + end + + def thor_table(command) + Bundler::CLI.class_options.merge(Bundler::CLI.commands.fetch(command).options) + end + + # resolve_command is private to ArgvParser, and parse hides the name it resolved to + def resolve(token) + BundleMatrix::ArgvParser.send(:resolve_command, token) + end + + describe "command name resolution" do + it "returns exact command names", :aggregate_failures do + expect(resolve("install")).to eq("install") + expect(resolve("cache")).to eq("cache") + end + + it "resolves unambiguous prefixes", :aggregate_failures do + expect(resolve("ins")).to eq("install") + expect(resolve("a")).to eq("add") + expect(resolve("u")).to eq("update") + end + + it "resolves aliases to their target", :aggregate_failures do + expect(resolve("i")).to eq("install") + expect(resolve("ls")).to eq("list") + end + + it "returns nil for an ambiguous prefix", :aggregate_failures do + expect(resolve("in")).to be_nil + expect(parse("in")).to be_nil + end + + # Bundler 2.6.9 matches hidden commands by prefix, and 4.x does not, so only the parse result is the same + it "does not fan out for a hidden command reached by prefix" do + expect(parse("install_or")).to be_nil + end + + it "returns unknown names unchanged, for COMMANDS to filter out" do + expect(resolve("zz")).to eq("zz") + end + + it "returns nil when there is no token" do + expect(resolve(nil)).to be_nil + end + end + + describe ".parse" do + it "returns nil for commands bundle_matrix does not fan out", :aggregate_failures do + expect(parse("exec", "rspec")).to be_nil + expect(parse("check")).to be_nil + expect(parse("zz")).to be_nil + end + + it "treats `i` as install" do + expect(parse("i").command).to eq("install") + end + + it "accepts the unambiguous prefixes Bundler accepts", :aggregate_failures do + expect(parse("ins").command).to eq("install") + expect(parse("a", "rack").command).to eq("add") + expect(parse("u").command).to eq("update") + expect(parse("up").command).to eq("update") + end + + it "splits gems from options", :aggregate_failures do + invocation = parse("update", "rails", "--conservative", "rack") + + expect(invocation.gems).to eq(%w[rails rack]) + expect(invocation.option?("conservative")).to be(true) + end + + it "resolves aliases to the canonical option name", :aggregate_failures do + invocation = parse("update", "-j", "4", "-g", "dev") + + expect(invocation.option?("jobs")).to be(true) + expect(invocation.values("group")).to eq(%w[dev]) + end + + it "handles --name=value and short values attached to the flag", :aggregate_failures do + expect(parse("install", "--jobs=4").values("jobs")).to eq(%w[4]) + expect(parse("install", "-j4").values("jobs")).to eq(%w[4]) + end + + it "lets array options consume values up to the next switch", :aggregate_failures do + invocation = parse("update", "--group", "test", "dev", "--conservative", "rails") + + expect(invocation.values("group")).to eq(%w[test dev]) + expect(invocation.gems).to eq(%w[rails]) + end + + it "reads the values after an array option given inline with =", :aggregate_failures do + invocation = parse("update", "--group=test", "dev", "--conservative", "rails") + + expect(invocation.values("group")).to eq(%w[test dev]) + expect(invocation.gems).to eq(%w[rails]) + end + + it "does not count --no-name as setting the option, but still forwards it", :aggregate_failures do + invocation = parse("update", "--no-all", "rails") + + expect(invocation.option?("all")).to be(false) + expect(invocation.to_argv).to eq(%w[update rails --no-all]) + end + + it "still counts --no-color as setting the option, because it is a real option" do + expect(parse("install", "--no-color").option?("no-color")).to be(true) + end + + it "only consumes a value for a lazy-default option when one is present", :aggregate_failures do + expect(parse("update", "--bundler", "--all").values("bundler")).to eq([]) + expect(parse("update", "--bundler", "4.0.1").values("bundler")).to eq(%w[4.0.1]) + end + + it "keeps unknown switches for forwarding" do + expect(parse("install", "--some-future-flag").unknown).to eq(%w[--some-future-flag]) + end + + it "understands Bundler's global options, so their values are not read as gems", :aggregate_failures do + expect(parse("install", "--retry", "3").values("retry")).to eq(%w[3]) + expect(parse("update", "-r", "3").values("retry")).to eq(%w[3]) + expect(parse("update", "--retry", "3").gems).to eq([]) + expect(parse("update", "--verbose", "--all").option?("verbose")).to be(true) + end + + it "keeps global options when it is re-targeted at install", :aggregate_failures do + forwarded = parse("update", "--retry", "3", "--all").as("install") + + expect(forwarded.to_argv).to eq(%w[install --retry 3]) + end + + it "treats everything after -- as a gem name" do + expect(parse("add", "--strict", "--", "rails").gems).to eq(%w[rails]) + end + + # rubocop:disable-next RSpec/ExampleLength + it "matches Thor's own parsing for the gems and options it recognises", :aggregate_failures do + samples = [ + %w[update rails --conservative], + %w[update --group test dev rails], + %w[update --all --patch --jobs 2], + %w[install --local --jobs=2 --standalone dev test], + %w[add rails -v 1.0 -g dev --strict], + %w[add rails --skip-install], + %w[install --retry 3 --jobs 2], + %w[update --verbose --all], + %w[update --group=test dev --conservative rails] + ] + + no_values = [true, false, nil] + + samples.each do |argv| + command, *tokens = argv + thor = Bundler::Thor::Options.new(thor_table(command)) + thor_options = thor.parse(tokens) + invocation = parse(*argv) + + expect(invocation.gems).to eq(Array(thor.remaining)), "gems differ for #{argv.join(" ")}" + expect(invocation.options.map(&:name)).to( + match_array(thor_options.keys.map(&:to_s)), "options differ for #{argv.join(" ")}" + ) + thor_options.each do |name, value| + next if no_values.include?(value) + + expect(invocation.values(name.to_s)).to eq(Array(value).map(&:to_s)), + "values differ for --#{name} in #{argv.join(" ")}" + end + end + end + end + + describe "when no command is given" do + before do + allow(Bundler.settings).to receive(:[]).and_call_original + allow(Bundler.settings).to receive(:[]).with(:default_cli_command).and_return(nil) + end + + def default_command_is(name) + allow(Bundler.settings).to receive(:[]).with(:default_cli_command).and_return(name) + end + + it "fans out a bare bundle as install" do + expect(parse).to have_attributes(command: "install", gems: []) + end + + it "fans out switches as install options", :aggregate_failures do + invocation = parse("--jobs=4") + + expect(invocation.command).to eq("install") + expect(invocation.values("jobs")).to eq(%w[4]) + expect(invocation.to_argv).to eq(%w[install --jobs=4]) + end + + it "fans out when default_cli_command is install" do + default_command_is("install") + + expect(parse("--jobs=4").command).to eq("install") + end + + it "fans out when default_cli_command is install_or_cli_help, which Bundler runs as install" do + skip "this Bundler has no install_or_cli_help" unless Bundler::CLI.all_commands.key?("install_or_cli_help") + + default_command_is("install_or_cli_help") + + expect(parse("--jobs=4").command).to eq("install") + end + + it "does not fan out when default_cli_command is cli_help, which only prints help", :aggregate_failures do + default_command_is("cli_help") + + expect(parse).to be_nil + expect(parse("--jobs=4")).to be_nil + end + + it "does not treat a mapped switch such as -v as the default command" do + expect(parse("-v")).to be_nil + end + + # Bundler rejects this form before any hook runs, so it never fans out. Parsing it the same way keeps us honest. + it "reads a command after leading switches as an argument, as Bundler does" do + expect(parse("--verbose", "install").to_argv).to eq(%w[install install --verbose]) + end + end + + describe "#to_argv" do + it "re-emits every token the user supplied" do + argv = %w[update rails --conservative --group test dev --bundler 4.0.1 --unknown-thing] + + expect(parse(*argv).to_argv).to eq(argv) + end + end + + describe "#as" do + # rubocop:disable-next RSpec/ExampleLength + it "keeps only the options the target command understands", :aggregate_failures do + invocation = parse("update", "rails", "--conservative", "--group", "dev", "--jobs", "2") + install = invocation.as("install") + + expect(install.command).to eq("install") + expect(install.gems).to eq([]) + expect(install.option?("conservative")).to be(false) + expect(install.option?("group")).to be(false) + expect(install.option?("jobs")).to be(true) + end + end +end diff --git a/spec/bundle_matrix/planner_spec.rb b/spec/bundle_matrix/planner_spec.rb new file mode 100644 index 0000000..71ce0c2 --- /dev/null +++ b/spec/bundle_matrix/planner_spec.rb @@ -0,0 +1,286 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Planner) do + let(:root) { Pathname(Dir.mktmpdir("bundle_matrix_root")).realpath } + let(:gemfile) { root.join("gemfiles", "old.gemfile") } + + after { FileUtils.remove_entry(root) } + + def write(path, contents) + path.dirname.mkpath + path.write(contents) + end + + # Bundler added install --lockfile after 2.6 + def bundler_has_install_option?(name) + Bundler::CLI.commands.fetch("install").options.key?(name) + end + + def lock_for(*gems) + specs = gems.map { |name| " #{name} (1.0.0)" }.join("\n") + deps = gems.map { |name| " #{name}" }.join("\n") + + <<~LOCK + GEM + remote: https://rubygems.org/ + specs: + #{specs} + + PLATFORMS + ruby + + DEPENDENCIES + #{deps} + LOCK + end + + def plan_for(argv, gemfile_contents: "gem \"rake\"\n", lock: nil) + write(root.join("Gemfile"), "source \"https://rubygems.org\"\ngem \"rake\"\n") + write(gemfile, gemfile_contents) + write(Pathname("#{gemfile}.lock"), lock) if lock + + invocation = BundleMatrix::Invocation.parse(argv) + described_class.new(invocation, gemfile, root).plan + end + + def locked_by(version) + "#{lock_for("rake")}\nBUNDLED WITH\n #{version}\n" + end + + context "when the secondary is a gems.rb" do + let(:gemfile) { root.join("engines", "web", "gems.rb") } + + it "reads its lockfile from gems.locked" do + write(root.join("engines", "web", "gems.locked"), lock_for("rake")) + + plan = plan_for(%w[update rake --conservative]) + + expect(plan.invocation.to_argv).to eq(%w[update rake --conservative]) + end + end + + it "reports a gemfile it cannot evaluate as an error instead of raising", :aggregate_failures do + plan = plan_for(%w[add rack], gemfile_contents: "raise \"boom\"\n") + + expect(plan.invocation).to be_nil + expect(plan.error).to include("boom") + end + + it "reports a command it does not plan as an error instead of returning nil", :aggregate_failures do + invocation = BundleMatrix::Invocation.new(command: "exec", options: [], gems: [], unknown: []) + plan = described_class.new(invocation, gemfile, root).plan + + expect(plan.error).to eq("unknown command exec") + expect(plan).to be_failed + end + + context "when the plan's outcome is checked" do + it "is neither failed nor skipped when it runs a command", :aggregate_failures do + plan = plan_for(%w[install]) + + expect(plan).not_to be_failed + expect(plan).not_to be_skipped + end + + it "is skipped when there is nothing to run", :aggregate_failures do + plan = plan_for(%w[update rack], lock: lock_for("rake")) + + expect(plan).to be_skipped + expect(plan).not_to be_failed + end + + it "is failed when planning raised, and not skipped", :aggregate_failures do + plan = plan_for(%w[add rack], gemfile_contents: "raise \"boom\"\n") + + expect(plan).to be_failed + expect(plan).not_to be_skipped + end + end + + context "when the plan runs a command" do + it "records the Bundler the lockfile names, even when it is the running one", :aggregate_failures do + expect(plan_for(%w[install], lock: locked_by("2.5.23")).locked_bundler).to eq(Gem::Version.new("2.5.23")) + expect(plan_for(%w[install], lock: locked_by(Bundler::VERSION)).locked_bundler) + .to eq(Gem::Version.new(Bundler::VERSION)) + end + + it "records no Bundler for a gemfile without a lockfile" do + expect(plan_for(%w[install]).locked_bundler).to be_nil + end + + it "records no Bundler for a gemfile that is skipped" do + expect(plan_for(%w[update rack], lock: locked_by("2.5.23")).locked_bundler).to be_nil + end + end + + context "when the command is install" do + it "removes --gemfile, which is set through BUNDLE_GEMFILE instead" do + plan = plan_for(%w[install --gemfile Gemfile --jobs 4]) + + expect(plan.invocation.to_argv).to eq(%w[install --jobs 4]) + end + + it "drops --lockfile given inline with =", :aggregate_failures do + skip "Bundler #{Bundler::VERSION} has no install --lockfile" unless bundler_has_install_option?("lockfile") + + plan = plan_for(%w[install --lockfile=other.lock]) + + expect(plan.invocation.to_argv).to eq(%w[install]) + expect(plan.notes).to eq(["--lockfile is not forwarded to other gemfiles"]) + end + + it "drops --standalone, which only makes sense for the main Gemfile", :aggregate_failures do + plan = plan_for(%w[install --standalone --jobs 2]) + + expect(plan.invocation.to_argv).to eq(%w[install --jobs 2]) + expect(plan.notes).to eq(["--standalone is not forwarded to other gemfiles"]) + end + + it "drops --lockfile and --standalone, which only make sense for the main Gemfile", :aggregate_failures do + skip "Bundler #{Bundler::VERSION} has no install --lockfile" unless bundler_has_install_option?("lockfile") + + plan = plan_for(%w[install --lockfile other.lock --standalone --jobs 2]) + + expect(plan.invocation.to_argv).to eq(%w[install --jobs 2]) + expect(plan.notes).to eq([ + "--lockfile is not forwarded to other gemfiles", + "--standalone is not forwarded to other gemfiles" + ]) + end + end + + context "when the command is update" do + it "runs a bare update in full, even without a lockfile" do + expect(plan_for(%w[update]).invocation.to_argv).to eq(%w[update]) + end + + it "forwards --all and --conservative untouched" do + plan = plan_for(%w[update --all --conservative]) + + expect(plan.invocation.to_argv).to eq(%w[update --all --conservative]) + end + + it "forwards --patch and --conservative with named gems" do + plan = plan_for(%w[update rake --patch --conservative], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update rake --patch --conservative]) + end + + it "keeps only the named gems that appear in the secondary lockfile" do + plan = plan_for(%w[update rake rack --conservative], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update rake --conservative]) + end + + it "narrows the update for --no-all instead of running a full update" do + plan = plan_for(%w[update --no-all rake --conservative], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update rake --no-all --conservative]) + end + + it "skips the gemfile when none of the named gems are locked" do + plan = plan_for(%w[update rack], lock: lock_for("rake")) + + expect(plan.invocation).to be_nil + end + + it "runs install instead of a targeted update when there is no lockfile yet", :aggregate_failures do + plan = plan_for(%w[update rake --jobs 3]) + + expect(plan.invocation.to_argv).to eq(%w[install --jobs 3]) + expect(plan.notes).to eq(["no lockfile yet, running install to create it"]) + end + + it "removes --gemfile from the install it runs instead" do + plan = plan_for(%w[update rake --gemfile Gemfile --jobs 3]) + + expect(plan.invocation.to_argv).to eq(%w[install --jobs 3]) + end + + it "keeps only declared groups" do + gemfile_contents = "group :dev do\n gem \"rake\"\nend\n" + plan = plan_for(%w[update --group dev test], gemfile_contents: gemfile_contents, lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update --group dev]) + end + + it "removes --gemfile, which is set through BUNDLE_GEMFILE instead" do + plan = plan_for(%w[update --gemfile Gemfile --all]) + + expect(plan.invocation.to_argv).to eq(%w[update --all]) + end + + it "forwards --bundler, so every lockfile's Bundler is updated" do + plan = plan_for(%w[update --bundler], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update --bundler]) + end + end + + context "when the command is add" do + it "adds gems the secondary does not declare" do + plan = plan_for(%w[add rack --group dev], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[add rack --group dev]) + end + + it "forwards --version" do + plan = plan_for(["add", "rack", "--version", "~> 1.0"]) + + expect(plan.invocation.to_argv).to eq(["add", "rack", "--version", "~> 1.0"]) + end + + it "runs install instead when the secondary declares the gem itself", :aggregate_failures do + plan = plan_for(%w[add rake --version 13.0]) + + expect(plan.invocation.to_argv).to eq(%w[install]) + expect(plan.notes).to include("rake is already declared, not added again") + end + + it "runs install instead when every gem is already declared, e.g. via eval_gemfile" do + plan = plan_for(%w[add rake --group dev --quiet], gemfile_contents: "eval_gemfile \"../Gemfile\"\n") + + expect(plan.invocation.to_argv).to eq(%w[install --quiet]) + end + + it "notes the main-only flags it drops from that install", :aggregate_failures do + plan = plan_for(%w[add rake --path vendor/rake --quiet], gemfile_contents: "eval_gemfile \"../Gemfile\"\n") + + expect(plan.invocation.to_argv).to eq(%w[install --quiet]) + expect(plan.notes).to eq([ + "rake is already declared, not added again", + "gems already declared, re-locking with install", + "--path is not forwarded to other gemfiles" + ]) + end + + it "keeps an absolute --path pointing at the same place from the secondary gemfile's directory" do + plan = plan_for(%w[add rack --path /opt/rack], lock: lock_for("rake")) + + expect(File.expand_path(plan.invocation.values("path").first, gemfile.dirname)).to eq("/opt/rack") + end + + it "rewrites a relative --path so it resolves from the secondary gemfile's directory" do + plan = plan_for(%w[add local_gem --path vendor/local_gem]) + + expect(plan.invocation.values("path")).to eq(["../vendor/local_gem"]) + end + + it "keeps the absolute --path when no relative path exists, e.g. across Windows drives" do + allow_any_instance_of(Pathname).to receive(:relative_path_from).and_raise(ArgumentError) # rubocop:disable RSpec/AnyInstance + plan = plan_for(%w[add local_gem --path vendor/local_gem]) + + expect(plan.invocation.values("path")).to eq([root.join("vendor", "local_gem").to_s]) + end + + context "when the gemfile is in the project root" do + let(:gemfile) { root.join("ci.gemfile") } + + it "forwards a relative --path unchanged" do + plan = plan_for(%w[add local_gem --path vendor/local_gem]) + + expect(plan.invocation.values("path")).to eq(["vendor/local_gem"]) + end + end + end +end diff --git a/spec/bundle_matrix/project_settings_spec.rb b/spec/bundle_matrix/project_settings_spec.rb new file mode 100644 index 0000000..5fc0701 --- /dev/null +++ b/spec/bundle_matrix/project_settings_spec.rb @@ -0,0 +1,55 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::ProjectSettings) do + let(:root) { Pathname(Dir.mktmpdir("bundle_matrix_root")).realpath } + let(:user_env) { {} } + + after { FileUtils.remove_entry(root) } + + # Keeps the developer's own BUNDLE_* variables and global Bundler config out of the spec + # rubocop:disable-next Metrics/AbcSize + def env_with(local_config) + root.join(".bundle").mkpath + root.join(".bundle", "config").write(local_config.map { |key, value| "#{key}: \"#{value}\"\n" }.join) + stub_const("ENV", isolated_env.merge(user_env)) + allow(Bundler).to receive_messages(settings: Bundler::Settings.new(root.join(".bundle")), original_env: user_env) + described_class.env(root) + end + + def isolated_env + ENV.to_h + .reject { |key, _| key == "BUNDLE_CONFIG" || key.start_with?("BUNDLE_") } + .merge("BUNDLE_USER_CONFIG" => root.join("global_config").to_s) + end + + it "passes on the project's .bundle/config" do + env = env_with("BUNDLE_FROZEN" => "true", "BUNDLE_WITHOUT" => "development:test") + + expect(env).to include("BUNDLE_FROZEN" => "true", "BUNDLE_WITHOUT" => "development:test") + end + + # Bundler.settings lists the keys from ENV, and the values the user set come from Bundler.original_env + it "passes on BUNDLE_* variables the user set in the original environment" do + user_env["BUNDLE_JOBS"] = "4" + + expect(env_with({})).to include("BUNDLE_JOBS" => "4") + end + + it "prefers .bundle/config over the user's BUNDLE_* variables" do + user_env["BUNDLE_FROZEN"] = "false" + + expect(env_with("BUNDLE_FROZEN" => "true")).to include("BUNDLE_FROZEN" => "true") + end + + it "expands relative paths from the project root" do + env = env_with("BUNDLE_PATH" => "vendor/bundle", "BUNDLE_BIN" => "/usr/local/bin") + + expect(env).to include("BUNDLE_PATH" => root.join("vendor/bundle").to_s, "BUNDLE_BIN" => "/usr/local/bin") + end + + it "leaves out settings that point at the main Gemfile's own files" do + env = env_with("BUNDLE_GEMFILE" => "Gemfile", "BUNDLE_LOCKFILE" => "Gemfile.next.lock", "BUNDLE_JOBS" => "4") + + expect(env.keys).to eq(["BUNDLE_JOBS"]) + end +end diff --git a/spec/bundle_matrix/runner_spec.rb b/spec/bundle_matrix/runner_spec.rb new file mode 100644 index 0000000..867815d --- /dev/null +++ b/spec/bundle_matrix/runner_spec.rb @@ -0,0 +1,165 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::Runner) do + let(:root) { Pathname("/project") } + let(:ci) { root.join("ci.gemfile") } + let(:rails7) { root.join("gemfiles", "rails7.gemfile") } + let(:runner) { described_class.new(root) } + let(:child_envs) { [] } + let(:broken) { BundleMatrix::Planner::Plan.new(invocation: nil, notes: [], error: "Gemfile syntax error") } + + def plan(argv, notes = [], locked_bundler: nil) + BundleMatrix::Planner::Plan.new( + invocation: argv && BundleMatrix::Invocation.parse(argv), notes: notes, locked_bundler: locked_bundler + ) + end + + before do + allow(Bundler.ui).to receive(:info) + allow(Bundler.ui).to receive(:warn) + allow(Bundler.ui).to receive(:error) + allow(Bundler.settings).to receive(:[]).and_call_original + allow(Bundler.settings).to receive(:[]).with(:version).and_return(nil) + allow(BundleMatrix::ProjectSettings).to receive(:env).and_return({}) + allow(Bundler).to receive(:unbundled_system) { |env, *| child_envs << env }.and_return(true) + end + + it "runs each gemfile through the bundled launcher, from that gemfile's directory" do + runner.run(rails7 => plan(%w[install --jobs 4])) + + env = hash_including("BUNDLE_GEMFILE" => rails7.to_s, "BUNDLE_MATRIX_ACTIVE" => "1") + expect(Bundler).to have_received(:unbundled_system) + .with(env, Gem.ruby, described_class::BUNDLE, "install", "--jobs", "4", chdir: rails7.dirname.to_s) + end + + it "prints a header naming each gemfile and the command run against it" do + runner.run(rails7 => plan(%w[install --jobs 4])) + + expect(Bundler.ui).to have_received(:info) + .with("== bundle_matrix: gemfiles/rails7.gemfile -> bundle install --jobs 4") + end + + it "launches through RubyGems, so each gemfile gets its lockfile's Bundler version" do + expect(File.read(described_class::BUNDLE)).to include('activate_and_load_bin_path("bundler", "bundle"') + end + + it "clears BUNDLER_VERSION so it does not hold every gemfile to one version" do + runner.run(ci => plan(%w[install])) + + expect(child_envs.first).to include("BUNDLER_VERSION" => nil) + end + + it "passes on the project's settings, but sets the gemfile itself" do + allow(BundleMatrix::ProjectSettings).to receive(:env).with(root) + .and_return("BUNDLE_FROZEN" => "true", "BUNDLE_GEMFILE" => root.join("Gemfile").to_s) + + runner.run(ci => plan(%w[install])) + + expect(child_envs.first).to include("BUNDLE_FROZEN" => "true", "BUNDLE_GEMFILE" => ci.to_s) + end + + it "prints a plan's notes and does not run a skipped plan", :aggregate_failures do + runner.run(ci => plan(nil, ["skipped, no rails here"])) + + expect(Bundler.ui).to have_received(:info).with("== bundle_matrix: ci.gemfile: skipped, no rails here") + expect(Bundler).not_to have_received(:unbundled_system) + end + + it "runs every gemfile and then raises naming each that failed", :aggregate_failures do + allow(Bundler).to receive(:unbundled_system).and_return(false, false) + + expect { runner.run(ci => plan(%w[install]), rails7 => plan(%w[install])) } + .to raise_error(BundleMatrix::Error, "bundle_matrix: failed for ci.gemfile, gemfiles/rails7.gemfile") + expect(Bundler).to have_received(:unbundled_system).twice + end + + it "reports a gemfile that could not be planned as an error, and still runs the others", :aggregate_failures do + expect { runner.run(ci => broken, rails7 => plan(%w[install])) } + .to raise_error(BundleMatrix::Error, "bundle_matrix: failed for ci.gemfile") + message = "== bundle_matrix: ci.gemfile: could not plan: Gemfile syntax error" + expect(Bundler.ui).to have_received(:error).with(message) + expect(Bundler.ui).not_to have_received(:info).with(a_string_including("could not plan")) + expect(Bundler).to have_received(:unbundled_system).once + end + + it "stops at a gemfile that could not be planned with fail_fast", :aggregate_failures do + runner = described_class.new(root, fail_fast: true) + allow(Bundler).to receive(:unbundled_system).and_return(true) + + expect { runner.run(ci => broken, rails7 => plan(%w[install])) }.to raise_error(BundleMatrix::Error) + expect(Bundler).not_to have_received(:unbundled_system) + end + + it "stops at the first failure with fail_fast", :aggregate_failures do + runner = described_class.new(root, fail_fast: true) + allow(Bundler).to receive(:unbundled_system).and_return(false) + + expect { runner.run(ci => plan(%w[install]), rails7 => plan(%w[install])) } + .to raise_error(BundleMatrix::Error, "bundle_matrix: failed for ci.gemfile") + expect(Bundler).to have_received(:unbundled_system).once + end + + context "when a gemfile's lockfile names a different Bundler" do + let(:suggestion) do + "bundle_matrix: run `bundle update --bundler` to update Bundler in every lockfile, " \ + "or `bundle config set matrix.bundler_warnings false` to silence these warnings" + end + + def other_bundler_plan(version) + plan(%w[install], locked_bundler: Gem::Version.new(version)) + end + + it "warns with both versions for each such gemfile, then suggests updating once", :aggregate_failures do + runner.run(ci => other_bundler_plan("2.5.23"), rails7 => other_bundler_plan("2.4.22")) + + expect(Bundler.ui).to have_received(:warn) + .with("bundle_matrix: ci.gemfile uses Bundler 2.5.23, the main Gemfile uses #{Bundler::VERSION}") + expect(Bundler.ui).to have_received(:warn) + .with("bundle_matrix: gemfiles/rails7.gemfile uses Bundler 2.4.22, the main Gemfile uses #{Bundler::VERSION}") + expect(Bundler.ui).to have_received(:warn).with(suggestion).once + end + + it "still suggests updating when a gemfile fails", :aggregate_failures do + allow(Bundler).to receive(:unbundled_system).and_return(false) + + expect { runner.run(ci => other_bundler_plan("2.5.23")) }.to raise_error(BundleMatrix::Error) + expect(Bundler.ui).to have_received(:warn).with(suggestion) + end + + it "does not warn when the lockfile names the running Bundler" do + runner.run(ci => plan(%w[install], locked_bundler: Gem::Version.new(Bundler::VERSION))) + + expect(Bundler.ui).not_to have_received(:warn) + end + + it "does not warn or suggest updating for a plan without a lockfile" do + runner.run(ci => plan(%w[install])) + + expect(Bundler.ui).not_to have_received(:warn) + end + + it "does not warn when bundler_warnings is off" do + described_class.new(root, bundler_warnings: false).run(ci => other_bundler_plan("2.5.23")) + + expect(Bundler.ui).not_to have_received(:warn) + end + + it "warns when the version setting is lockfile, as well as when it is unset", :aggregate_failures do + allow(Bundler.settings).to receive(:[]).with(:version).and_return("lockfile") + + runner.run(ci => other_bundler_plan("2.5.23")) + + expect(Bundler.ui).to have_received(:warn).with(a_string_including("uses Bundler 2.5.23")) + end + + it "does not warn when the version setting keeps every gemfile on the main Bundler", :aggregate_failures do + %w[system 4.0.24].each do |setting| + allow(Bundler.settings).to receive(:[]).with(:version).and_return(setting) + + runner.run(ci => other_bundler_plan("2.5.23")) + end + + expect(Bundler.ui).not_to have_received(:warn) + end + end +end diff --git a/spec/bundle_matrix/secondary_gemfile_spec.rb b/spec/bundle_matrix/secondary_gemfile_spec.rb new file mode 100644 index 0000000..df8d61c --- /dev/null +++ b/spec/bundle_matrix/secondary_gemfile_spec.rb @@ -0,0 +1,90 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix::SecondaryGemfile) do + let(:root) { Pathname(Dir.mktmpdir("bundle_matrix_root")).realpath } + let(:gemfile) { root.join("gemfiles", "old.gemfile") } + + after { FileUtils.remove_entry(root) } + + def write(path, contents) + path.dirname.mkpath + path.write(contents) + end + + def lock_for(*gems) + specs = gems.map { |name| " #{name} (1.0.0)" }.join("\n") + deps = gems.map { |name| " #{name}" }.join("\n") + + <<~LOCK + GEM + remote: https://rubygems.org/ + specs: + #{specs} + + PLATFORMS + ruby + + DEPENDENCIES + #{deps} + LOCK + end + + describe "#lockfile" do + it "is .lock for a Gemfile-style gemfile" do + expect(described_class.new(gemfile).lockfile).to eq(root.join("gemfiles", "old.gemfile.lock")) + end + + it "is gems.locked for a gems.rb" do + expect(described_class.new(root.join("engines", "web", "gems.rb")).lockfile) + .to eq(root.join("engines", "web", "gems.locked")) + end + end + + describe "#locked?" do + it "is false until the lockfile exists", :aggregate_failures do + secondary = described_class.new(gemfile) + + expect(secondary).not_to be_locked + write(Pathname("#{gemfile}.lock"), lock_for("rake")) + expect(secondary).to be_locked + end + end + + describe "#bundler_version" do + it "reads the BUNDLED WITH line of the lockfile" do + write(Pathname("#{gemfile}.lock"), "#{lock_for("rake")}\nBUNDLED WITH\n 2.5.23\n") + + expect(described_class.new(gemfile).bundler_version).to eq(Gem::Version.new("2.5.23")) + end + + it "is nil without a lockfile" do + expect(described_class.new(gemfile).bundler_version).to be_nil + end + end + + describe "#lock_names" do + it "lists the gems the lockfile specifies" do + write(Pathname("#{gemfile}.lock"), lock_for("rake", "rack")) + + expect(described_class.new(gemfile).lock_names).to contain_exactly("rake", "rack") + end + end + + describe "declarations" do + it "lists the gems and groups this gemfile declares", :aggregate_failures do + write(gemfile, "gem \"rake\"\ngroup :dev do\n gem \"rack\"\nend\n") + + secondary = described_class.new(gemfile) + + expect(secondary.declared_names).to eq(%w[rake rack]) + expect(secondary.declared_groups).to eq(%w[default dev]) + end + + it "includes the gems pulled in by eval_gemfile" do + write(root.join("Gemfile"), "gem \"rake\"\n") + write(gemfile, "eval_gemfile \"../Gemfile\"\ngem \"rack\"\n") + + expect(described_class.new(gemfile).declared_names).to eq(%w[rake rack]) + end + end +end diff --git a/spec/bundle_matrix_spec.rb b/spec/bundle_matrix_spec.rb new file mode 100644 index 0000000..1062a7d --- /dev/null +++ b/spec/bundle_matrix_spec.rb @@ -0,0 +1,23 @@ +# frozen_string_literal: true + +RSpec.describe(BundleMatrix) do + # The Bundler versions the Appraisals generate gemfiles for, from the file names + let(:tested) do + Dir.glob(File.join(__dir__, "..", "gemfiles", "bundler_*.gemfile")).map do |path| + Gem::Version.new(File.basename(path, ".gemfile").delete_prefix("bundler_")) + end + end + + it "accepts every Bundler the Appraisals test", :aggregate_failures do + expect(tested).not_to be_empty + expect(tested).to all(satisfy { |version| BundleMatrix::TESTED_BUNDLER.satisfied_by?(version) }) + end + + it "excludes the minor after the highest tested one", :aggregate_failures do + highest = tested.max + next_minor = Gem::Version.new("#{highest.segments[0]}.#{highest.segments[1] + 1}.a") + + expect(BundleMatrix::TESTED_BUNDLER.satisfied_by?(highest)).to be(true) + expect(BundleMatrix::TESTED_BUNDLER.satisfied_by?(next_minor)).to be(false) + end +end diff --git a/spec/e2e/add_spec.rb b/spec/e2e/add_spec.rb new file mode 100644 index 0000000..c6f82a3 --- /dev/null +++ b/spec/e2e/add_spec.rb @@ -0,0 +1,68 @@ +# frozen_string_literal: true + +require_relative "support/e2e_helper" + +RSpec.describe("bundle add", :e2e) do + before do + project.gemfile("Gemfile", %(gem "hermoine", "1.0.0"\n)) + project.gemfile("ci.gemfile", %(gem "hermoine", "1.0.0"\n)) + project.gemfile("gemfiles/rails.gemfile", %(gem "harry"\n)) + project.bundle!("install") + end + + def declarations(gemfile, name) + project.read(gemfile).lines.grep(/^\s*gem "#{name}"/) + end + + # rubocop:disable-next RSpec/ExampleLength + it "adds the gem to every gemfile and locks it", :aggregate_failures do + project.bundle!("add", "ron") + + expect(declarations("Gemfile", "ron").size).to eq(1) + expect(declarations("ci.gemfile", "ron").size).to eq(1) + expect(declarations("gemfiles/rails.gemfile", "ron").size).to eq(1) + expect(project.locked("ci.gemfile")).to include("ron" => "1.2.0") + expect(project.locked("gemfiles/rails.gemfile")).to include("ron" => "1.2.0", "harry" => "2.0.0") + end + + # rubocop:disable-next RSpec/ExampleLength + it "fails naming a secondary gemfile that fails, and keeps the gem in the main Gemfile", :aggregate_failures do + project.gemfile("gemfiles/rails.gemfile", %(gem "harry", "~> 1.0"\n)) + + result = project.bundle("add", "ron", "--version", "1.2.0") + + expect(result).not_to be_success + expect(result.stderr).to include("bundle_matrix: failed for gemfiles/rails.gemfile") + expect(declarations("Gemfile", "ron").size).to eq(1) + expect(project.locked("ci.gemfile")).to include("ron" => "1.2.0") + end + + context "when the run does not fan out" do + let(:secondaries) { %w[ci.gemfile gemfiles/rails.gemfile] } + + def snapshot + secondaries.flat_map { |gemfile| [project.read(gemfile), project.read("#{gemfile}.lock")] } + end + + it "leaves every secondary gemfile untouched when the main add fails", :aggregate_failures do + before = snapshot + + result = project.bundle("add", "missing_gem") + + expect(result).not_to be_success + expect(result.output).not_to include("== bundle_matrix") + expect(snapshot).to eq(before) + end + + # Bundler fires no after-install hook when nothing is installed + it "does nothing with --skip-install", :aggregate_failures do + before = snapshot + + output = project.bundle!("add", "ron", "--skip-install").output + + expect(output).not_to include("== bundle_matrix") + expect(declarations("Gemfile", "ron").size).to eq(1) + expect(snapshot).to eq(before) + end + end +end diff --git a/spec/e2e/gems_rb_spec.rb b/spec/e2e/gems_rb_spec.rb new file mode 100644 index 0000000..7ec6c61 --- /dev/null +++ b/spec/e2e/gems_rb_spec.rb @@ -0,0 +1,22 @@ +# frozen_string_literal: true + +require_relative "support/e2e_helper" + +RSpec.describe("bundle install with a gems.rb main file", :e2e) do + before do + project.config("matrix.default_gemfile", "gems.rb") + project.gemfile("gems.rb", %(gem "harry", "~> 1.0.0"\n)) + project.gemfile("ci.gemfile", %(gem "harry", "~> 1.0"\ngem "hermoine", "1.0.0"\n)) + project.gemfile("engines/web/gems.rb", %(gem "ron", "1.0.0"\n)) + project.config("matrix.paths", "engines/*") + end + + it "fans out from gems.rb and locks each file in its own lockfile", :aggregate_failures do + output = project.bundle!("install").output + + expect(output).to include(header("ci.gemfile", "install"), header("engines/web/gems.rb", "install")) + expect(project).to exist("gems.locked") + expect(project.read("ci.gemfile.lock")).to include("hermoine") + expect(project.read("engines/web/gems.locked")).to include("ron") + end +end diff --git a/spec/e2e/install_spec.rb b/spec/e2e/install_spec.rb new file mode 100644 index 0000000..8defdc3 --- /dev/null +++ b/spec/e2e/install_spec.rb @@ -0,0 +1,171 @@ +# frozen_string_literal: true + +require_relative "support/e2e_helper" + +RSpec.describe("bundle install", :e2e) do + before do + project.gemfile("Gemfile", %(gem "harry", "~> 1.0.0"\n)) + project.gemfile("ci.gemfile", %(gem "harry", "~> 1.0"\ngem "hermoine", "1.0.0"\n)) + project.gemfile("gemfiles/rails.gemfile", %(gem "ron", "1.0.0"\n)) + end + + context "when every gemfile resolves" do + it "locks the main Gemfile and every secondary gemfile with its own gems", :aggregate_failures do + project.bundle!("install") + + expect(project.locked("Gemfile")).to include("harry" => "1.0.1") + expect(project.locked("ci.gemfile")).to eq("harry" => "1.1.0", "hermoine" => "1.0.0") + expect(project.locked("gemfiles/rails.gemfile")).to eq("ron" => "1.0.0") + end + + it "treats `bundle i` as install", :aggregate_failures do + output = project.bundle!("i").output + + expect(output).to include(header("ci.gemfile", "install")) + expect(project).to be_lockfile("ci.gemfile") + end + + it "is idempotent" do + project.bundle!("install") + before = %w[Gemfile ci.gemfile gemfiles/rails.gemfile].map { |gemfile| project.read("#{gemfile}.lock") } + + project.bundle!("install") + + expect(%w[Gemfile ci.gemfile gemfiles/rails.gemfile].map { |gemfile| project.read("#{gemfile}.lock") }) + .to eq(before) + end + end + + # Bundler's own default_cli_command decides what a bare `bundle` runs, so these pin the plugin to it + context "when bundle runs without a command" do + it "fans out as install when default_cli_command is not set", :aggregate_failures do + output = project.bundle!.output + + expect(output).to include(header("ci.gemfile", "install")) + expect(project).to be_lockfile("ci.gemfile") + end + + it "fans out as install for switches only, such as --jobs=4", :aggregate_failures do + output = project.bundle!("--jobs=4").output + + expect(output).to include(header("ci.gemfile", "install --jobs=4")) + expect(project).to be_lockfile("ci.gemfile") + end + + it "fans out when default_cli_command is install" do + project.config("default_cli_command", "install") + + project.bundle! + + expect(project).to be_lockfile("ci.gemfile") + end + + it "does not fan out when default_cli_command is cli_help", :aggregate_failures do + project.config("default_cli_command", "cli_help") + + project.bundle! + + expect(project).not_to be_lockfile("ci.gemfile") + expect(project).not_to be_lockfile("gemfiles/rails.gemfile") + end + end + + it "also installs each Gemfile in the directories set by matrix.paths", :aggregate_failures do + project.gemfile("engines/admin/Gemfile", %(gem "hermoine", "1.0.0"\n)) + project.config("matrix.paths", "engines/*") + + output = project.bundle!("install").output + + expect(output).to include(header("engines/admin/Gemfile", "install")) + expect(project.locked("engines/admin/Gemfile")).to eq("hermoine" => "1.0.0") + end + + # Each child runs from its own gemfile's directory, so Bundler would otherwise resolve these there + context "with project settings" do + it "resolves a relative path from the project root for every gemfile", :aggregate_failures do + project.bundle!("install") + + expect(Dir.glob(project.root.join("vendor/bundle/ruby/*/gems/ron-1.0.0"))).not_to be_empty + expect(project).not_to exist("gemfiles/vendor") + end + + it "applies without to every gemfile", :aggregate_failures do + project.gemfile("ci.gemfile", %(gem "harry", "~> 1.0"\ngroup :test do\n gem "hermoine", "1.0.0"\nend\n)) + project.config("without", "test") + + project.bundle!("install") + + expect(project.locked("ci.gemfile")).to include("hermoine" => "1.0.0") + expect(Dir.glob(project.root.join("vendor/bundle/ruby/*/gems/hermoine-*"))).to be_empty + end + end + + # rubocop:disable-next RSpec/ExampleLength + it "runs the other gemfiles when a secondary gemfile fails, then fails naming it", :aggregate_failures do + project.gemfile("ci.gemfile", %(gem "harry", "~> 9.0"\n)) + + result = project.bundle("install") + + expect(result).not_to be_success + expect(result.stderr).to include("bundle_matrix: failed for ci.gemfile") + expect(project).to be_lockfile("Gemfile") + expect(project).to be_lockfile("gemfiles/rails.gemfile") + end + + # rubocop:disable-next RSpec/ExampleLength + it "fails an out of date frozen secondary gemfile, and still runs the others", :aggregate_failures do + project.bundle!("install") + locked_before = project.read("ci.gemfile.lock") + project.gemfile("ci.gemfile", %(gem "harry", "~> 1.0"\ngem "hermoine", "1.0.0"\ngem "ron", "1.0.0"\n)) + project.config("frozen", true) + + result = project.bundle("install") + + expect(result).not_to be_success + expect(result.stderr).to include("bundle_matrix: failed for ci.gemfile") + expect(result.output).to include(header("gemfiles/rails.gemfile", "install")) + expect(project.read("ci.gemfile.lock")).to eq(locked_before) + end + + context "when the run does not fan out" do + it "does nothing when the main install fails", :aggregate_failures do + project.gemfile("Gemfile", %(gem "harry", "~> 9.0"\n)) + + result = project.bundle("install") + + expect(result).not_to be_success + expect(result.output).not_to include("== bundle_matrix") + expect(project).not_to be_lockfile("ci.gemfile") + end + + it "does nothing when disabled", :aggregate_failures do + project.config("matrix.disabled", true) + + output = project.bundle!("install").output + + expect(output).not_to include("== bundle_matrix") + expect(project).not_to be_lockfile("ci.gemfile") + end + + it "does nothing when BUNDLE_MATRIX__DISABLED is set", :aggregate_failures do + output = project.bundle!("install", env: { "BUNDLE_MATRIX__DISABLED" => "1" }).output + + expect(output).not_to include("== bundle_matrix") + expect(project).not_to be_lockfile("ci.gemfile") + end + + # rubocop:disable-next RSpec/ExampleLength + it "does nothing when BUNDLE_GEMFILE names a secondary gemfile", :aggregate_failures do + project.bundle!("install") + project.gemfile("gemfiles/rack.gemfile", %(gem "harry"\n)) + # Control run: the same command without BUNDLE_GEMFILE does fan out to rack.gemfile + expect(project.bundle!("install").output).to include(header("gemfiles/rack.gemfile", "install")) + project.root.join("gemfiles/rack.gemfile.lock").delete + + output = project.bundle!("install", env: { "BUNDLE_GEMFILE" => project.root.join("ci.gemfile").to_s }).output + + expect(output).not_to include("== bundle_matrix") + expect(project).not_to be_lockfile("gemfiles/rack.gemfile") + end + end +end diff --git a/spec/e2e/support/e2e_helper.rb b/spec/e2e/support/e2e_helper.rb new file mode 100644 index 0000000..6d708ad --- /dev/null +++ b/spec/e2e/support/e2e_helper.rb @@ -0,0 +1,24 @@ +# frozen_string_literal: true + +require_relative "gem_repo" +require_relative "project" + +module E2E + # Shared setup for the E2E specs: a fresh project per example. + module Helpers + def project + @project ||= Project.new + end + + # The line Runner prints before running a command against a secondary gemfile + def header(gemfile, command) + "== bundle_matrix: #{gemfile} -> bundle #{command}" + end + end +end + +RSpec.configure do |config| + config.include(E2E::Helpers, :e2e) + config.after(:each, :e2e) { @project&.cleanup } + config.after(:suite) { E2E::GemRepo.cleanup } +end diff --git a/spec/e2e/support/gem_repo.rb b/spec/e2e/support/gem_repo.rb new file mode 100644 index 0000000..13a0862 --- /dev/null +++ b/spec/e2e/support/gem_repo.rb @@ -0,0 +1,60 @@ +# frozen_string_literal: true + +require "rubygems/indexer" +require "rubygems/package" + +module E2E + # A local gem server on disk, so the suite resolves real versions without the network. + module GemRepo + # name => { version => runtime dependencies } + GEMS = { + "harry" => { "1.0.0" => {}, "1.0.1" => {}, "1.1.0" => {}, "2.0.0" => {} }, + "hermoine" => { "1.0.0" => {}, "1.1.0" => { "harry" => ">= 1.1" } }, + "ron" => { "1.0.0" => {}, "1.2.0" => { "harry" => ">= 2.0" } } + }.freeze + + def self.uri + "file://#{dir}" + end + + def self.dir + @dir ||= build + end + + def self.cleanup + FileUtils.rm_rf(@dir) if @dir + @dir = nil + end + + def self.build + dir = Dir.mktmpdir("bundle_matrix-gems") + gems_dir = File.join(dir, "gems") + FileUtils.mkdir_p(gems_dir) + + Gem::DefaultUserInteraction.use_ui(Gem::SilentUI.new) do + Dir.chdir(gems_dir) do + GEMS.each do |name, versions| + versions.each { |version, deps| Gem::Package.build(spec(name, version, deps)) } + end + end + Gem::Indexer.new(dir).generate_index + end + dir + end + + def self.spec(name, version, deps) + Gem::Specification.new do |s| + s.name = name + s.version = version + s.summary = "Fixture gem for the bundle_matrix E2E suite" + s.authors = ["bundle_matrix"] + s.homepage = "https://example.com/#{name}" + s.license = "MIT" + s.required_ruby_version = ">= 3.2" + s.files = [] + deps.each { |dep, requirement| s.add_dependency(dep, requirement) } + end + end + private_class_method :build, :spec + end +end diff --git a/spec/e2e/support/project.rb b/spec/e2e/support/project.rb new file mode 100644 index 0000000..68bbd77 --- /dev/null +++ b/spec/e2e/support/project.rb @@ -0,0 +1,118 @@ +# frozen_string_literal: true + +require "open3" +require "yaml" + +module E2E + # A throwaway project with the plugin declared in its main Gemfile. Commands run + # in a real `bundle` process, isolated from the developer's own Bundler setup. + class Project + PLUGIN_ROOT = File.expand_path("../../..", __dir__) + + Result = Data.define(:stdout, :stderr, :status) do + def success? + status.success? + end + + def output + stdout + stderr + end + end + + attr_reader :root + + def initialize + @root = Pathname(Dir.mktmpdir("bundle_matrix-project")).realpath + @home = Pathname(Dir.mktmpdir("bundle_matrix-home")) + # Every gemfile installs into the project's own vendor/bundle, never the developer's gems + config("path", "vendor/bundle") + end + + def cleanup + FileUtils.rm_rf([@root, @home]) + end + + # Writes a gemfile using the fixture gem repo. The main Gemfile also declares the plugin. + def gemfile(path, body = "") + plugin = %w[Gemfile gems.rb].include?(path) ? %(plugin "bundle_matrix", path: "#{PLUGIN_ROOT}"\n) : "" + write(path, %(source "#{GemRepo.uri}"\n#{plugin}#{body})) + end + + # A gem on disk, for `path:` sources + def path_gem(dir, name, version = "1.0.0") + write(File.join(dir, "#{name}.gemspec"), <<~RUBY) + Gem::Specification.new do |s| + s.name = #{name.inspect} + s.version = #{version.inspect} + s.summary = "Path fixture gem" + s.authors = ["bundle_matrix"] + s.files = [] + end + RUBY + end + + def write(path, content) + file = @root.join(path) + file.dirname.mkpath + file.write(content) + end + + def read(path) + @root.join(path).read + end + + def exist?(path) + @root.join(path).exist? + end + + # Sets a value in .bundle/config, in the project root or next to a secondary gemfile + def config(key, value, dir: ".") + file = @root.join(dir, ".bundle", "config") + settings = file.file? ? YAML.safe_load(file.read) : {} + settings["BUNDLE_#{key.upcase.gsub(".", "__")}"] = value.to_s + file.dirname.mkpath + file.write(YAML.dump(settings)) + end + + # @return [Hash{String => String}] gem name => locked version, empty without a lockfile + def locked(gemfile) + lockfile = @root.join("#{gemfile}.lock") + return {} unless lockfile.file? + + Bundler::LockfileParser.new(lockfile.read).specs.to_h { |spec| [spec.name, spec.version.to_s] } + end + + def lockfile?(gemfile) + @root.join("#{gemfile}.lock").file? + end + + def bundle(*args, env: {}) + Bundler.with_unbundled_env do + stdout, stderr, status = Open3.capture3( + isolated_env.merge(env), Gem.ruby, BundleMatrix::Runner::BUNDLE, *args, chdir: @root.to_s + ) + Result.new(stdout: stdout, stderr: stderr, status: status) + end + end + + # Like #bundle, but fails the example with Bundler's output when the command fails + def bundle!(*args, env: {}) + bundle(*args, env: env).tap do |result| + raise "bundle #{args.join(" ")} failed:\n#{result.output}" unless result.success? + end + end + + private + + def isolated_env + { + "HOME" => @home.to_s, + "BUNDLE_USER_HOME" => @home.join(".bundle").to_s, + "BUNDLE_GEMFILE" => nil, + "BUNDLE_APP_CONFIG" => nil, + "BUNDLER_VERSION" => nil, + "BUNDLE_MATRIX_ACTIVE" => nil + } + end + end +end diff --git a/spec/e2e/update_spec.rb b/spec/e2e/update_spec.rb new file mode 100644 index 0000000..3390335 --- /dev/null +++ b/spec/e2e/update_spec.rb @@ -0,0 +1,61 @@ +# frozen_string_literal: true + +require_relative "support/e2e_helper" + +RSpec.describe("bundle update", :e2e) do + # Locks every gem at 1.0.0, then loosens the requirements so there is something to update + before do + write_gemfiles("1.0.0") + project.bundle!("install") + write_gemfiles(">= 1.0") + end + + def write_gemfiles(requirement) + project.gemfile("Gemfile", %(gem "harry", "#{requirement}"\n)) + project.gemfile("ci.gemfile", %(gem "harry", "#{requirement}"\ngem "hermoine", "#{requirement}"\n)) + project.gemfile("gemfiles/rails.gemfile", %(gem "ron", "#{requirement}"\n)) + end + + it "updates a named gem in every lockfile that has it, and skips the rest", :aggregate_failures do + output = project.bundle!("update", "harry").output + + expect(output).to include("gemfiles/rails.gemfile: skipped, none of harry are in this gemfile") + expect(project.locked("Gemfile")).to include("harry" => "2.0.0") + expect(project.locked("ci.gemfile")).to eq("harry" => "2.0.0", "hermoine" => "1.0.0") + expect(project.locked("gemfiles/rails.gemfile")).to eq("ron" => "1.0.0") + end + + it "updates every gem in every gemfile with --all", :aggregate_failures do + project.bundle!("update", "--all") + + expect(project.locked("ci.gemfile")).to eq("harry" => "2.0.0", "hermoine" => "1.1.0") + expect(project.locked("gemfiles/rails.gemfile")).to eq("harry" => "2.0.0", "ron" => "1.2.0") + end + + # A gemfile's own .bundle/config wins over the project's, so only this gemfile is frozen + # rubocop:disable-next RSpec/ExampleLength + it "updates the other gemfiles when a secondary gemfile fails, then fails naming it", :aggregate_failures do + project.gemfile("engines/admin/Gemfile", %(gem "harry", "1.0.0"\n)) + project.config("matrix.paths", "engines/*") + project.bundle!("install") + project.gemfile("engines/admin/Gemfile", %(gem "harry"\n)) + project.config("frozen", true, dir: "engines/admin") + + result = project.bundle("update", "--all") + + expect(result).not_to be_success + expect(result.stderr).to include("bundle_matrix: failed for engines/admin/Gemfile") + expect(project.locked("Gemfile")).to include("harry" => "2.0.0") + expect(project.locked("gemfiles/rails.gemfile")).to include("ron" => "1.2.0") + end + + it "does nothing when the main update fails", :aggregate_failures do + before = project.read("ci.gemfile.lock") + + result = project.bundle("update", "nonexistent") + + expect(result).not_to be_success + expect(result.output).not_to include("== bundle_matrix") + expect(project.read("ci.gemfile.lock")).to eq(before) + end +end diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb new file mode 100644 index 0000000..d0b23e9 --- /dev/null +++ b/spec/spec_helper.rb @@ -0,0 +1,34 @@ +# frozen_string_literal: true + +if ENV["COVERAGE"] == "true" + require "simplecov" + + SimpleCov.start do + enable_coverage :branch # track branches as well as lines + track_files "lib/**/*.rb" # report on these files, even if never loaded + add_filter "/spec/" + minimum_coverage line: 90, branch: 80 # SimpleCov 0.22 spelling of coverage :line / :branch minimums + maximum_coverage_drop 1 # fail if coverage drops more than 1 point from last run + end +end + +require "bundle_matrix" +require "fileutils" +require "tmpdir" + +RSpec.configure do |config| + # Enable flags like --only-failures and --next-failure + config.example_status_persistence_file_path = ".rspec_status" + + # Disable RSpec exposing methods globally on `Module` and `main` + config.disable_monkey_patching! + + config.expect_with(:rspec) do |c| + c.syntax = :expect + end + + # Stubs must name methods that exist, and examples must not depend on the order they run in + config.mock_with(:rspec) { |mocks| mocks.verify_partial_doubles = true } + config.order = :random + Kernel.srand(config.seed) +end From 83d9cca0c9517f18dd3d585baa26e5641fab660d Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:29:00 -0600 Subject: [PATCH 02/14] Only read declared groups when --group is given narrow_update read the secondary gemfile's declared groups on every update, which evaluates the whole gemfile. A gemfile that raises when evaluated then failed a plain 'bundle update ' that never needed its groups. Co-Authored-By: Claude Haiku 5.5 --- lib/bundle_matrix/planner.rb | 10 +++++++++- spec/bundle_matrix/planner_spec.rb | 7 +++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/lib/bundle_matrix/planner.rb b/lib/bundle_matrix/planner.rb index 573da02..c1b6327 100644 --- a/lib/bundle_matrix/planner.rb +++ b/lib/bundle_matrix/planner.rb @@ -61,7 +61,7 @@ def update_plan # Keeps only the named gems and groups that this gemfile's lockfile or dependencies know about def narrow_update(invocation) gems = invocation.gems & @gemfile.lock_names - groups = invocation.values("group") & @gemfile.declared_groups + groups = narrow_groups(invocation) if unmatched?(invocation, gems, groups) return skip("none of #{requested(invocation).join(", ")} are in this gemfile") end @@ -69,6 +69,14 @@ def narrow_update(invocation) run(invocation.with_gems(gems).replace_values("group", groups)) end + # Declared groups are only read when --group was given, because reading them evaluates the whole gemfile + def narrow_groups(invocation) + requested_groups = invocation.values("group") + return [] if requested_groups.empty? + + requested_groups & @gemfile.declared_groups + end + # Named gems or groups were given, but none of them apply to this gemfile def unmatched?(invocation, gems, groups) requested(invocation).any? && gems.empty? && groups.empty? && diff --git a/spec/bundle_matrix/planner_spec.rb b/spec/bundle_matrix/planner_spec.rb index 71ce0c2..b3ba29e 100644 --- a/spec/bundle_matrix/planner_spec.rb +++ b/spec/bundle_matrix/planner_spec.rb @@ -204,6 +204,13 @@ def locked_by(version) expect(plan.invocation.to_argv).to eq(%w[update --group dev]) end + it "does not evaluate the gemfile when no group was given" do + plan = plan_for(%w[update rake], gemfile_contents: "gem ENV.fetch(\"BUNDLE_MATRIX_SPEC_UNSET\")\n", lock: lock_for("rake")) + + expect(plan).not_to be_failed + expect(plan.invocation.to_argv).to eq(%w[update rake]) + end + it "removes --gemfile, which is set through BUNDLE_GEMFILE instead" do plan = plan_for(%w[update --gemfile Gemfile --all]) From 8c47788dfffc21f7f1e8e36d939095d1f11dd9a9 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:29:24 -0600 Subject: [PATCH 03/14] Read repeated options from their last copy, as Bundler does Bundler's Thor keeps the last occurrence of a repeated switch, but option and option? used the first. The plan then judged a flag by a value Bundler never used, and replace_values forwarded the wrong --group or --path to every child. Co-Authored-By: Claude Haiku 5.5 --- docs/BundleMatrix/Invocation.md | 4 +++- lib/bundle_matrix/invocation.rb | 6 ++++-- spec/bundle_matrix/invocation_spec.rb | 6 ++++++ 3 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/BundleMatrix/Invocation.md b/docs/BundleMatrix/Invocation.md index 78e0261..d1ca09d 100644 --- a/docs/BundleMatrix/Invocation.md +++ b/docs/BundleMatrix/Invocation.md @@ -42,7 +42,7 @@ def self.parse(argv) | Method | Summary | | --- | --- | | [`#as(target, gems: [])`](#method-i-as) | The same flags, re-targeted at another command. | -| [`#option(name)`](#method-i-option) | | +| [`#option(name)`](#method-i-option) | Bundler keeps the last copy of a repeated option, so that is the one that counts | | [`#option?(name)`](#method-i-option-3F) | `--no-name` does not count as setting the option | | [`#replace_values(name, new_values)`](#method-i-replace_values) | Replaces an option's values, dropping the option when none are left. | | [`#to_argv`](#method-i-to_argv) | | @@ -65,6 +65,8 @@ understands are kept, and the gems are replaced. def option(name) ``` +Bundler keeps the last copy of a repeated option, so that is the one that counts + ### `#option?` ```ruby diff --git a/lib/bundle_matrix/invocation.rb b/lib/bundle_matrix/invocation.rb index 869247a..52c6743 100644 --- a/lib/bundle_matrix/invocation.rb +++ b/lib/bundle_matrix/invocation.rb @@ -29,11 +29,13 @@ def self.parse(argv) # `--no-name` does not count as setting the option def option?(name) - options.any? { |opt| opt.name == name && !opt.negated } + opt = option(name) + !opt.nil? && !opt.negated end + # Bundler keeps the last copy of a repeated option, so that is the one that counts def option(name) - options.find { |opt| opt.name == name } + options.reverse_each.find { |opt| opt.name == name } end def values(name) diff --git a/spec/bundle_matrix/invocation_spec.rb b/spec/bundle_matrix/invocation_spec.rb index a706c6b..1799286 100644 --- a/spec/bundle_matrix/invocation_spec.rb +++ b/spec/bundle_matrix/invocation_spec.rb @@ -101,6 +101,12 @@ def resolve(token) expect(invocation.gems).to eq(%w[rails]) end + it "reads a repeated option the way Bundler does, from its last copy", :aggregate_failures do + expect(parse("update", "--group", "dev", "--group", "test").values("group")).to eq(%w[test]) + expect(parse("add", "foo", "--path", "a", "--path", "b").values("path")).to eq(%w[b]) + expect(parse("update", "--all", "--no-all").option?("all")).to be(false) + end + it "does not count --no-name as setting the option, but still forwards it", :aggregate_failures do invocation = parse("update", "--no-all", "rails") From 4fc6ab43731b0a021e775995b8a1235a5d659257 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:29:45 -0600 Subject: [PATCH 04/14] Narrow --source gems to the secondary lockfile --source takes gem names, but its values were forwarded unfiltered, and unmatched? ignored them. A gemfile without the named gem ran 'bundle update --source' and failed, and one with it was skipped when only --source named it. Co-Authored-By: Claude Haiku 5.5 --- lib/bundle_matrix/planner.rb | 12 +++++++----- spec/bundle_matrix/planner_spec.rb | 12 ++++++++++++ 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/lib/bundle_matrix/planner.rb b/lib/bundle_matrix/planner.rb index c1b6327..e1bcb2b 100644 --- a/lib/bundle_matrix/planner.rb +++ b/lib/bundle_matrix/planner.rb @@ -61,12 +61,14 @@ def update_plan # Keeps only the named gems and groups that this gemfile's lockfile or dependencies know about def narrow_update(invocation) gems = invocation.gems & @gemfile.lock_names + # --source names gems too, so it is narrowed to the lockfile the same way + sources = invocation.values("source") & @gemfile.lock_names groups = narrow_groups(invocation) - if unmatched?(invocation, gems, groups) + if unmatched?(invocation, [*gems, *sources, *groups]) return skip("none of #{requested(invocation).join(", ")} are in this gemfile") end - run(invocation.with_gems(gems).replace_values("group", groups)) + run(invocation.with_gems(gems).replace_values("source", sources).replace_values("group", groups)) end # Declared groups are only read when --group was given, because reading them evaluates the whole gemfile @@ -78,13 +80,13 @@ def narrow_groups(invocation) end # Named gems or groups were given, but none of them apply to this gemfile - def unmatched?(invocation, gems, groups) - requested(invocation).any? && gems.empty? && groups.empty? && + def unmatched?(invocation, matched) + requested(invocation).any? && matched.empty? && !invocation.option?("ruby") && !invocation.option?("bundler") end def requested(invocation) - invocation.gems + invocation.values("group") + invocation.gems + invocation.values("source") + invocation.values("group") end def add_plan diff --git a/spec/bundle_matrix/planner_spec.rb b/spec/bundle_matrix/planner_spec.rb index b3ba29e..20f29f1 100644 --- a/spec/bundle_matrix/planner_spec.rb +++ b/spec/bundle_matrix/planner_spec.rb @@ -211,6 +211,18 @@ def locked_by(version) expect(plan.invocation.to_argv).to eq(%w[update rake]) end + it "keeps only the --source gems that this gemfile's lockfile has" do + plan = plan_for(%w[update --source rake mygem], lock: lock_for("rake")) + + expect(plan.invocation.to_argv).to eq(%w[update --source rake]) + end + + it "skips a gemfile whose lockfile has none of the --source gems" do + plan = plan_for(%w[update --source mygem], lock: lock_for("rake")) + + expect(plan).to be_skipped + end + it "removes --gemfile, which is set through BUNDLE_GEMFILE instead" do plan = plan_for(%w[update --gemfile Gemfile --all]) From 6d0ef55a5de1e47487a49e079a8ea139396f2256 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:30:04 -0600 Subject: [PATCH 05/14] Put dash-leading gems after a -- terminator in the child argv Gems that came after a bare -- were merged into the gem list, and to_argv printed them before the options with no terminator. A gem such as -weird was then read by the child as an unknown switch. Co-Authored-By: Claude Haiku 5.5 --- lib/bundle_matrix/invocation.rb | 6 +++++- spec/bundle_matrix/invocation_spec.rb | 9 +++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/lib/bundle_matrix/invocation.rb b/lib/bundle_matrix/invocation.rb index 52c6743..17e6f91 100644 --- a/lib/bundle_matrix/invocation.rb +++ b/lib/bundle_matrix/invocation.rb @@ -67,7 +67,11 @@ def as(target, gems: []) end def to_argv - [command, *gems, *options.flat_map(&:tokens), *unknown] + flags = [*options.flat_map(&:tokens), *unknown] + return [command, *gems, *flags] unless gems.any? { |gem| gem.start_with?("-") } + + # A gem that starts with a dash would be read as a switch, so the gems go after a `--` that ends the switches + [command, *flags, "--", *gems] end end end diff --git a/spec/bundle_matrix/invocation_spec.rb b/spec/bundle_matrix/invocation_spec.rb index 1799286..cad3622 100644 --- a/spec/bundle_matrix/invocation_spec.rb +++ b/spec/bundle_matrix/invocation_spec.rb @@ -75,6 +75,15 @@ def resolve(token) expect(invocation.option?("conservative")).to be(true) end + it "forwards a gem that starts with a dash after a -- terminator, so it is not read as a switch", :aggregate_failures do + expect(parse("add", "--", "-weird").to_argv).to eq(%w[add -- -weird]) + expect(parse("add", "rack", "--", "-weird").to_argv).to eq(%w[add -- rack -weird]) + end + + it "keeps gems before the options when none starts with a dash" do + expect(parse("update", "rails", "--conservative").to_argv).to eq(%w[update rails --conservative]) + end + it "resolves aliases to the canonical option name", :aggregate_failures do invocation = parse("update", "-j", "4", "-g", "dev") From 1dd5cf5e59736e6d0e5b121e468b425fdc6fe5ba Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:31:11 -0600 Subject: [PATCH 06/14] Require only the minimum Bundler in the gemspec The gemspec pinned bundler to the tested range, so a user on a newer Bundler could not install the plugin, and the untested-Bundler warning could never run. The gemspec now requires MIN_BUNDLER as a lower bound, and TESTED_BUNDLER only drives the warning. Co-Authored-By: Claude Haiku 5.5 --- Gemfile.lock | 2 +- bundle_matrix.gemspec | 5 +++-- docs/ARCHITECTURE.md | 2 +- docs/BundleMatrix.md | 14 +++++++++++--- gemfiles/bundler_2.6.9.gemfile.lock | 2 +- gemfiles/bundler_2.7.2.gemfile.lock | 2 +- gemfiles/bundler_4.0.24.gemfile.lock | 2 +- gemfiles/bundler_4.1.0.beta3.gemfile.lock | 2 +- gemfiles/gem_coop.gemfile.lock | 2 +- lib/bundle_matrix/version.rb | 9 ++++++--- spec/bundle_matrix_spec.rb | 9 +++++++++ 11 files changed, 36 insertions(+), 15 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 7ab2bd6..cd4ab26 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -2,7 +2,7 @@ PATH remote: . specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://rubygems.org/ diff --git a/bundle_matrix.gemspec b/bundle_matrix.gemspec index 83468b8..9286274 100644 --- a/bundle_matrix.gemspec +++ b/bundle_matrix.gemspec @@ -34,8 +34,9 @@ Gem::Specification.new do |spec| spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) } spec.require_paths = ["lib"] - # The plugin relies on Bundler internals that aren't a plugin API, so it only allows the tested range - spec.add_dependency "bundler", *BundleMatrix::TESTED_BUNDLER.as_list + # The plugin relies on Bundler internals that aren't a plugin API, so it needs the oldest Bundler it runs under. + # Newer Bundlers are allowed, and the hook warns when it runs under one that has not been tested. + spec.add_dependency "bundler", ">= #{BundleMatrix::MIN_BUNDLER}" # For more information and examples about making a new gem, check out our # guide at: https://guides.rubygems.org/make-your-own-gem/ diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 5991a53..8a25e53 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -108,7 +108,7 @@ flowchart LR ``` - `rake` runs `spec`, `e2e`, `rubocop`, `rbs` and `steep`. Steep type checks `lib/` against `sig/`, and `sig_stubs/` declares the parts of Bundler's API the code calls, since Bundler publishes no signatures. -- `TESTED_BUNDLER` in `version.rb` sets the gemspec's Bundler dependency and the untested-Bundler warning. `spec/bundle_matrix_spec.rb` checks it against the `gemfiles/bundler_*.gemfile` files the Appraisals generate: every one is in range, and the range stops before the minor after the highest tested one. A new Bundler minor therefore needs the Appraisal and the range changed together. +- `MIN_BUNDLER` in `version.rb` sets the gemspec's Bundler dependency, a lower bound only, so a newer Bundler can still install the plugin. `TESTED_BUNDLER` in the same file sets the untested-Bundler warning. `spec/bundle_matrix_spec.rb` checks `TESTED_BUNDLER` against the `gemfiles/bundler_*.gemfile` files the Appraisals generate: every one is in range, and the range stops before the minor after the highest tested one. A new Bundler minor therefore needs the Appraisal and the range changed together. - The E2E jobs in CI are disabled until the project moves to the public repo. ## Bundler internals we rely on diff --git a/docs/BundleMatrix.md b/docs/BundleMatrix.md index ae9b36a..2494b1e 100644 --- a/docs/BundleMatrix.md +++ b/docs/BundleMatrix.md @@ -19,14 +19,22 @@ A Bundler plugin that repeats `install`, `update` and `add` against every second ## Constants +### `MIN_BUNDLER` + +```ruby +MIN_BUNDLER = "2.6.9" +``` + +The oldest Bundler the plugin runs under. The gemspec requires it, and nothing newer is refused. +It is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. + ### `TESTED_BUNDLER` ```ruby -TESTED_BUNDLER = Gem::Requirement.new(">= 2.6.9", "< 4.2.a") +TESTED_BUNDLER = Gem::Requirement.new(">= #{MIN_BUNDLER}", "< 4.2.a") ``` -The Bundler versions the Appraisals test. The gemspec requires this range, and the hook warns outside it. -The lower bound is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. +The Bundler versions the Appraisals test. The hook warns outside this range, not the gemspec. The `.a` keeps 4.2 prereleases out too; raise it once a new Bundler minor has been tested. ### `VERSION` diff --git a/gemfiles/bundler_2.6.9.gemfile.lock b/gemfiles/bundler_2.6.9.gemfile.lock index 0b863c3..8f90b19 100644 --- a/gemfiles/bundler_2.6.9.gemfile.lock +++ b/gemfiles/bundler_2.6.9.gemfile.lock @@ -2,7 +2,7 @@ PATH remote: .. specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://rubygems.org/ diff --git a/gemfiles/bundler_2.7.2.gemfile.lock b/gemfiles/bundler_2.7.2.gemfile.lock index 50843be..31a4778 100644 --- a/gemfiles/bundler_2.7.2.gemfile.lock +++ b/gemfiles/bundler_2.7.2.gemfile.lock @@ -2,7 +2,7 @@ PATH remote: .. specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://rubygems.org/ diff --git a/gemfiles/bundler_4.0.24.gemfile.lock b/gemfiles/bundler_4.0.24.gemfile.lock index 532aa39..74ec2d1 100644 --- a/gemfiles/bundler_4.0.24.gemfile.lock +++ b/gemfiles/bundler_4.0.24.gemfile.lock @@ -2,7 +2,7 @@ PATH remote: .. specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://rubygems.org/ diff --git a/gemfiles/bundler_4.1.0.beta3.gemfile.lock b/gemfiles/bundler_4.1.0.beta3.gemfile.lock index 083def9..63e944f 100644 --- a/gemfiles/bundler_4.1.0.beta3.gemfile.lock +++ b/gemfiles/bundler_4.1.0.beta3.gemfile.lock @@ -2,7 +2,7 @@ PATH remote: .. specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://rubygems.org/ diff --git a/gemfiles/gem_coop.gemfile.lock b/gemfiles/gem_coop.gemfile.lock index 2d5ca32..8ec3923 100644 --- a/gemfiles/gem_coop.gemfile.lock +++ b/gemfiles/gem_coop.gemfile.lock @@ -2,7 +2,7 @@ PATH remote: .. specs: bundle_matrix (0.1.0) - bundler (>= 2.6.9, < 4.2.a) + bundler (>= 2.6.9) GEM remote: https://gem.coop/ diff --git a/lib/bundle_matrix/version.rb b/lib/bundle_matrix/version.rb index 06f5aa1..d39e8f8 100644 --- a/lib/bundle_matrix/version.rb +++ b/lib/bundle_matrix/version.rb @@ -3,8 +3,11 @@ module BundleMatrix VERSION = "0.1.0" - # The Bundler versions the Appraisals test. The gemspec requires this range, and the hook warns outside it. - # The lower bound is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. + # The oldest Bundler the plugin runs under. The gemspec requires it, and nothing newer is refused. + # It is where Bundler::SharedHelpers.relative_path_to, which Planner uses, first appeared. + MIN_BUNDLER = "2.6.9" + + # The Bundler versions the Appraisals test. The hook warns outside this range, not the gemspec. # The `.a` keeps 4.2 prereleases out too; raise it once a new Bundler minor has been tested. - TESTED_BUNDLER = Gem::Requirement.new(">= 2.6.9", "< 4.2.a") + TESTED_BUNDLER = Gem::Requirement.new(">= #{MIN_BUNDLER}", "< 4.2.a") end diff --git a/spec/bundle_matrix_spec.rb b/spec/bundle_matrix_spec.rb index 1062a7d..0febe5e 100644 --- a/spec/bundle_matrix_spec.rb +++ b/spec/bundle_matrix_spec.rb @@ -20,4 +20,13 @@ expect(BundleMatrix::TESTED_BUNDLER.satisfied_by?(highest)).to be(true) expect(BundleMatrix::TESTED_BUNDLER.satisfied_by?(next_minor)).to be(false) end + + it "lets the gemspec install under a Bundler newer than the tested range", :aggregate_failures do + gemspec = Gem::Specification.load(File.join(__dir__, "..", "bundle_matrix.gemspec")) + requirement = gemspec.dependencies.find { |dependency| dependency.name == "bundler" }.requirement + + expect(requirement.satisfied_by?(Gem::Version.new("4.2.0"))).to be(true) + expect(requirement.satisfied_by?(Gem::Version.new(BundleMatrix::MIN_BUNDLER))).to be(true) + expect(requirement.satisfied_by?(Gem::Version.new("2.6.8"))).to be(false) + end end From 2bb3c1cd35df02bffb4fb4a7c32c3d64e1b6753c Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:31:53 -0600 Subject: [PATCH 07/14] Check disabled and child runs before parsing the command Invocation.parse relies on Thor internals and ran before the matrix.disabled and BUNDLE_MATRIX_ACTIVE checks. A parse error then broke every bundle install, even with the plugin disabled and in the child runs. Co-Authored-By: Claude Haiku 5.5 --- docs/BundleMatrix/Hook.md | 4 +++- lib/bundle_matrix/hook.rb | 9 ++++++--- spec/bundle_matrix/hook_spec.rb | 12 ++++++++++++ 3 files changed, 21 insertions(+), 4 deletions(-) diff --git a/docs/BundleMatrix/Hook.md b/docs/BundleMatrix/Hook.md index d645f8f..a180594 100644 --- a/docs/BundleMatrix/Hook.md +++ b/docs/BundleMatrix/Hook.md @@ -8,10 +8,12 @@ Called by Bundler after `install`, `update` or `add` has finished. | Method | Summary | | --- | --- | -| [`.call(argv = ARGV)`](#method-c-call) | | +| [`.call(argv = ARGV)`](#method-c-call) | Checked before parsing, so a disabled plugin or a child run never depends on how Bundler's CLI parses | ### `.call` ```ruby def self.call(argv = ARGV) ``` + +Checked before parsing, so a disabled plugin or a child run never depends on how Bundler's CLI parses diff --git a/lib/bundle_matrix/hook.rb b/lib/bundle_matrix/hook.rb index c1526d9..89200e3 100644 --- a/lib/bundle_matrix/hook.rb +++ b/lib/bundle_matrix/hook.rb @@ -5,12 +5,15 @@ module BundleMatrix module Hook ISSUES_URL = "https://github.com/joe-sharp/bundle_matrix/issues" + # Checked before parsing, so a disabled plugin or a child run never depends on how Bundler's CLI parses def self.call(argv = ARGV) - invocation = Invocation.parse(argv) - return unless invocation && !secondary_run? + return if secondary_run? config = Config.new - return if config.disabled? || !default_gemfile?(config) + return if config.disabled? + + invocation = Invocation.parse(argv) + return unless invocation && default_gemfile?(config) root = Bundler.root gemfiles = Discovery.new(root, config.paths, default_gemfile: config.default_gemfile).gemfiles diff --git a/spec/bundle_matrix/hook_spec.rb b/spec/bundle_matrix/hook_spec.rb index 18caa0e..28f3064 100644 --- a/spec/bundle_matrix/hook_spec.rb +++ b/spec/bundle_matrix/hook_spec.rb @@ -108,6 +108,18 @@ def warn_untested_bundler expect(BundleMatrix::Runner).not_to have_received(:new) end + # Thor's tables can change in a Bundler release, so a parse that fails must not break installs that never fan out + it "does not parse the command when disabled or in a secondary run", :aggregate_failures do + allow(BundleMatrix::Invocation).to receive(:parse).and_raise(NoMethodError) + allow(BundleMatrix::Config).to receive(:new).and_return(instance_double(BundleMatrix::Config, disabled?: true)) + + expect { described_class.call(%w[install]) }.not_to raise_error + + stub_const("ENV", ENV.to_h.merge("BUNDLE_MATRIX_ACTIVE" => "1")) + expect { described_class.call(%w[install]) }.not_to raise_error + expect(BundleMatrix::Invocation).not_to have_received(:parse) + end + it "does nothing for commands other than install, update and add" do described_class.call(%w[exec rspec]) From 0e967444b7f2985898ddbc38b51ad5bb2f93dd3f Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:32:42 -0600 Subject: [PATCH 08/14] Rewrite every relative path flag for the secondary gemfile Only add --path was rewritten. A relative --binstubs or --target-rbconfig was forwarded as typed, and the child resolved it from the gemfile's own directory instead of the project root. Install binstubs and target-rbconfig now get the same rewrite. Co-Authored-By: Claude Haiku 5.5 --- docs/BundleMatrix/Planner.md | 8 ++++++++ lib/bundle_matrix/planner.rb | 27 ++++++++++++++++++--------- spec/bundle_matrix/planner_spec.rb | 28 ++++++++++++++++++++++++++++ 3 files changed, 54 insertions(+), 9 deletions(-) diff --git a/docs/BundleMatrix/Planner.md b/docs/BundleMatrix/Planner.md index 9b13153..f558d1f 100644 --- a/docs/BundleMatrix/Planner.md +++ b/docs/BundleMatrix/Planner.md @@ -19,6 +19,14 @@ MAIN_ONLY_INSTALL_OPTIONS = %w[lockfile standalone path].freeze Install flags that only make sense for the main Gemfile, or that Bundler no longer accepts +### `PATH_OPTIONS` + +```ruby +PATH_OPTIONS = %w[binstubs path target-rbconfig].freeze +``` + +Options whose values are paths. A child resolves a relative one from its own gemfile's directory, so each is rewritten + ## Instance methods | Method | Summary | diff --git a/lib/bundle_matrix/planner.rb b/lib/bundle_matrix/planner.rb index e1bcb2b..0ddc5bf 100644 --- a/lib/bundle_matrix/planner.rb +++ b/lib/bundle_matrix/planner.rb @@ -25,6 +25,9 @@ def skipped? # Install flags that only make sense for the main Gemfile, or that Bundler no longer accepts MAIN_ONLY_INSTALL_OPTIONS = %w[lockfile standalone path].freeze + # Options whose values are paths. A child resolves a relative one from its own gemfile's directory, so each is rewritten + PATH_OPTIONS = %w[binstubs path target-rbconfig].freeze + def initialize(invocation, gemfile, root) @invocation = invocation.without("gemfile") @gemfile = SecondaryGemfile.new(gemfile) @@ -99,7 +102,7 @@ def add_plan return install_plan(@invocation.as("install"), notes + ["gems already declared, re-locking with install"]) end - run(rewrite_path(@invocation.with_gems(new_gems)), notes) + run(@invocation.with_gems(new_gems), notes) end def full_update?(invocation) @@ -113,18 +116,24 @@ def install_instead(reason) install_plan(@invocation.as("install"), ["#{reason}, running install to create it"]) end - # A relative --path is written into the main Gemfile relative to the root, - # so it has to be rewritten to be relative to this gemfile instead. - def rewrite_path(invocation) - return invocation unless invocation.option?("path") + # A relative path is relative to the root in the main run, so it has to be rewritten to be relative to + # this gemfile's directory, where the child runs. + def rewrite_paths(invocation) + PATH_OPTIONS.reduce(invocation) do |rewritten, name| + values = rewritten.values(name) + next rewritten if values.empty? + + rewritten.replace_values(name, values.map { |value| relative_to_gemfile(value) }) + end + end - absolute = File.expand_path(invocation.values("path").first, @root) - relative = Bundler::SharedHelpers.relative_path_to(absolute, from: @gemfile.path.dirname) - invocation.replace_values("path", [relative]) + def relative_to_gemfile(value) + absolute = File.expand_path(value, @root) + Bundler::SharedHelpers.relative_path_to(absolute, from: @gemfile.path.dirname) end def run(invocation, notes = []) - Plan.new(invocation: invocation, notes: notes, locked_bundler: @gemfile.bundler_version) + Plan.new(invocation: rewrite_paths(invocation), notes: notes, locked_bundler: @gemfile.bundler_version) end def skip(reason) diff --git a/spec/bundle_matrix/planner_spec.rb b/spec/bundle_matrix/planner_spec.rb index 20f29f1..33a7047 100644 --- a/spec/bundle_matrix/planner_spec.rb +++ b/spec/bundle_matrix/planner_spec.rb @@ -300,6 +300,34 @@ def locked_by(version) expect(plan.invocation.values("path")).to eq(["vendor/local_gem"]) end + + it "forwards relative install paths unchanged" do + plan = plan_for(%w[install --binstubs bin --target-rbconfig cfg/rbconfig.rb]) + + expect(plan.invocation.values("binstubs")).to eq(["bin"]) + expect(plan.invocation.values("target-rbconfig")).to eq(["cfg/rbconfig.rb"]) + end + end + end + + context "when a flag takes a path relative to the project root" do + it "rewrites --binstubs so it resolves from the secondary gemfile's directory" do + plan = plan_for(%w[install --binstubs bin]) + + expect(plan.invocation.values("binstubs")).to eq(["../bin"]) + end + + it "rewrites --target-rbconfig the same way", :aggregate_failures do + plan = plan_for(%w[install --target-rbconfig cfg/rbconfig.rb --jobs 2]) + + expect(plan.invocation.values("target-rbconfig")).to eq(["../cfg/rbconfig.rb"]) + expect(plan.invocation.option?("jobs")).to be(true) + end + + it "leaves a --binstubs given without a directory alone" do + plan = plan_for(%w[install --binstubs]) + + expect(plan.invocation.to_argv).to eq(%w[install --binstubs]) end end end From 324635fd52343f8e4b375ffe8ebcea7d3c1d81be Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:34:24 -0600 Subject: [PATCH 09/14] Say that install --path still reaches the other gemfiles The note claimed --path is not forwarded, but Bundler 2 saves it to .bundle/config, and ProjectSettings passes that on as BUNDLE_PATH to every child. The note now says that, which is also accurate on Bundler 4, where --path is not saved. Co-Authored-By: Claude Haiku 5.5 --- docs/BundleMatrix/Planner.md | 3 ++- lib/bundle_matrix/planner.rb | 13 +++++++++++-- spec/bundle_matrix/planner_spec.rb | 10 ++++++---- 3 files changed, 19 insertions(+), 7 deletions(-) diff --git a/docs/BundleMatrix/Planner.md b/docs/BundleMatrix/Planner.md index f558d1f..f1c6aa6 100644 --- a/docs/BundleMatrix/Planner.md +++ b/docs/BundleMatrix/Planner.md @@ -25,7 +25,8 @@ Install flags that only make sense for the main Gemfile, or that Bundler no long PATH_OPTIONS = %w[binstubs path target-rbconfig].freeze ``` -Options whose values are paths. A child resolves a relative one from its own gemfile's directory, so each is rewritten +Options whose values are paths. A child resolves a relative one from its own gemfile's directory, +so each is rewritten to be relative to that directory instead ## Instance methods diff --git a/lib/bundle_matrix/planner.rb b/lib/bundle_matrix/planner.rb index 0ddc5bf..b010acd 100644 --- a/lib/bundle_matrix/planner.rb +++ b/lib/bundle_matrix/planner.rb @@ -25,7 +25,8 @@ def skipped? # Install flags that only make sense for the main Gemfile, or that Bundler no longer accepts MAIN_ONLY_INSTALL_OPTIONS = %w[lockfile standalone path].freeze - # Options whose values are paths. A child resolves a relative one from its own gemfile's directory, so each is rewritten + # Options whose values are paths. A child resolves a relative one from its own gemfile's directory, + # so each is rewritten to be relative to that directory instead PATH_OPTIONS = %w[binstubs path target-rbconfig].freeze def initialize(invocation, gemfile, root) @@ -50,10 +51,18 @@ def plan def install_plan(invocation, notes = []) dropped = MAIN_ONLY_INSTALL_OPTIONS.select { |name| invocation.option?(name) } - notes += dropped.map { |name| "--#{name} is not forwarded to other gemfiles" } + notes += dropped.map { |name| dropped_note(name) } run(invocation.without(*MAIN_ONLY_INSTALL_OPTIONS), notes) end + # Bundler 2 saves --path to .bundle/config, which ProjectSettings passes on, so it still reaches other gemfiles + def dropped_note(name) + return "--#{name} is not forwarded to other gemfiles" unless name == "path" + + "--path is not forwarded to other gemfiles, but a path Bundler saved in .bundle/config " \ + "reaches them as BUNDLE_PATH" + end + def update_plan return run(@invocation) if full_update?(@invocation) return install_instead("no lockfile yet") unless @gemfile.locked? diff --git a/spec/bundle_matrix/planner_spec.rb b/spec/bundle_matrix/planner_spec.rb index 33a7047..4d6a68e 100644 --- a/spec/bundle_matrix/planner_spec.rb +++ b/spec/bundle_matrix/planner_spec.rb @@ -204,8 +204,9 @@ def locked_by(version) expect(plan.invocation.to_argv).to eq(%w[update --group dev]) end - it "does not evaluate the gemfile when no group was given" do - plan = plan_for(%w[update rake], gemfile_contents: "gem ENV.fetch(\"BUNDLE_MATRIX_SPEC_UNSET\")\n", lock: lock_for("rake")) + it "does not evaluate the gemfile when no group was given", :aggregate_failures do + gemfile_contents = "gem ENV.fetch(\"BUNDLE_MATRIX_SPEC_UNSET\")\n" + plan = plan_for(%w[update rake], gemfile_contents: gemfile_contents, lock: lock_for("rake")) expect(plan).not_to be_failed expect(plan.invocation.to_argv).to eq(%w[update rake]) @@ -269,7 +270,8 @@ def locked_by(version) expect(plan.notes).to eq([ "rake is already declared, not added again", "gems already declared, re-locking with install", - "--path is not forwarded to other gemfiles" + "--path is not forwarded to other gemfiles, but a path Bundler saved in .bundle/config " \ + "reaches them as BUNDLE_PATH" ]) end @@ -301,7 +303,7 @@ def locked_by(version) expect(plan.invocation.values("path")).to eq(["vendor/local_gem"]) end - it "forwards relative install paths unchanged" do + it "forwards relative install paths unchanged", :aggregate_failures do plan = plan_for(%w[install --binstubs bin --target-rbconfig cfg/rbconfig.rb]) expect(plan.invocation.values("binstubs")).to eq(["bin"]) From 27527e43d8eb9311f4b52a1af0003533e53a4d42 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:35:04 -0600 Subject: [PATCH 10/14] Exclude the main gemfile by file, not by path Discovery removed the main gemfile by comparing expanded path strings. A symlink to it, or the same file reached another way, stayed in the list, so the main Gemfile was installed or updated twice. Co-Authored-By: Claude Haiku 5.5 --- lib/bundle_matrix/discovery.rb | 7 ++++++- spec/bundle_matrix/discovery_spec.rb | 8 ++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/lib/bundle_matrix/discovery.rb b/lib/bundle_matrix/discovery.rb index 9bd4a55..6b02032 100644 --- a/lib/bundle_matrix/discovery.rb +++ b/lib/bundle_matrix/discovery.rb @@ -17,7 +17,7 @@ def initialize(root, paths, default_gemfile:) def gemfiles found = glob("*.gemfile") + glob("gemfiles/*.gemfile") + configured_gemfiles - found.map(&:expand_path).uniq.sort - [default_gemfile_path] + found.map(&:expand_path).uniq.sort.reject { |path| main_gemfile?(path) } end private @@ -26,6 +26,11 @@ def default_gemfile_path @root.join(@default_gemfile) end + # Compares files, not paths, so a symlink to the main gemfile is excluded too + def main_gemfile?(path) + File.identical?(path, default_gemfile_path) + end + # Patterns are relative to the root, so glob characters in the project's own path are not special def glob(pattern) Dir.glob(pattern, base: @root.to_s).map { |match| @root.join(match) } diff --git a/spec/bundle_matrix/discovery_spec.rb b/spec/bundle_matrix/discovery_spec.rb index f371c61..d0857cf 100644 --- a/spec/bundle_matrix/discovery_spec.rb +++ b/spec/bundle_matrix/discovery_spec.rb @@ -72,6 +72,14 @@ def relative(gemfiles) expect(relative(found)).to eq(%w[ci.gemfile gemfiles/rails7.gemfile]) end + it "never returns a symlink to the main gemfile, which is the same file" do + File.symlink(root.join("Gemfile"), root.join("linked.gemfile")) + + found = described_class.new(root, [], default_gemfile: "Gemfile").gemfiles + + expect(relative(found)).to eq(%w[ci.gemfile gemfiles/rails7.gemfile]) + end + it "keeps Gemfile as a secondary when the main gemfile is named differently" do touch("gems.rb") From f421ca2478178b259967311990ba4da650148995 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:35:13 -0600 Subject: [PATCH 11/14] Build the gem before pushing the release tag The tag was pushed before the gem was built. A build failure, such as an invalid gemspec, left a public tag for a version that was never released, and the source_code_uri metadata pointed at it. The build now runs first, and the tag is only created and pushed after it succeeds. Co-Authored-By: Claude Haiku 5.5 --- bin/release | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/bin/release b/bin/release index 696fa42..dae2cce 100755 --- a/bin/release +++ b/bin/release @@ -51,6 +51,10 @@ abort "#{tag} already exists but does not point at HEAD" if tag_exists && tag_co puts "\nTag #{tag}: #{description}" exit unless ask("Tag, push, build and publish? (y/N)").to_s.downcase.start_with?("y") +# Built before the tag is pushed, so a build failure does not leave a public tag for a version never released +puts "$ gem build #{File.basename(helper.spec_path)}" +gem_file = helper.build_gem + if tag_exists puts "#{tag} already exists at HEAD; not creating it again" else @@ -59,9 +63,6 @@ end # Pushing a tag that the remote already has at the same commit is a no-op. run "git", "push", "origin", tag -puts "$ gem build #{File.basename(helper.spec_path)}" -gem_file = helper.build_gem - coop = "https://gem.coop/@joe-sharp" if published?(coop, name, version) puts "#{name} #{version} is already on #{coop}; skipping" From 116551d508ea9bc5a40a18a75319e2446d739dce Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:35:39 -0600 Subject: [PATCH 12/14] Fix rubocop offenses in the hook and invocation specs Shorten one example name and split the disabled and secondary-run parse checks into two examples, so each stays within the style limits. Co-Authored-By: Claude Haiku 5.5 --- spec/bundle_matrix/hook_spec.rb | 7 +++++-- spec/bundle_matrix/invocation_spec.rb | 2 +- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/spec/bundle_matrix/hook_spec.rb b/spec/bundle_matrix/hook_spec.rb index 28f3064..a07a8cc 100644 --- a/spec/bundle_matrix/hook_spec.rb +++ b/spec/bundle_matrix/hook_spec.rb @@ -109,15 +109,18 @@ def warn_untested_bundler end # Thor's tables can change in a Bundler release, so a parse that fails must not break installs that never fan out - it "does not parse the command when disabled or in a secondary run", :aggregate_failures do + it "does not parse the command when disabled" do allow(BundleMatrix::Invocation).to receive(:parse).and_raise(NoMethodError) allow(BundleMatrix::Config).to receive(:new).and_return(instance_double(BundleMatrix::Config, disabled?: true)) expect { described_class.call(%w[install]) }.not_to raise_error + end + it "does not parse the command in a secondary run" do + allow(BundleMatrix::Invocation).to receive(:parse).and_raise(NoMethodError) stub_const("ENV", ENV.to_h.merge("BUNDLE_MATRIX_ACTIVE" => "1")) + expect { described_class.call(%w[install]) }.not_to raise_error - expect(BundleMatrix::Invocation).not_to have_received(:parse) end it "does nothing for commands other than install, update and add" do diff --git a/spec/bundle_matrix/invocation_spec.rb b/spec/bundle_matrix/invocation_spec.rb index cad3622..a751c20 100644 --- a/spec/bundle_matrix/invocation_spec.rb +++ b/spec/bundle_matrix/invocation_spec.rb @@ -75,7 +75,7 @@ def resolve(token) expect(invocation.option?("conservative")).to be(true) end - it "forwards a gem that starts with a dash after a -- terminator, so it is not read as a switch", :aggregate_failures do + it "forwards a dash-leading gem after -- so it is not read as a switch", :aggregate_failures do expect(parse("add", "--", "-weird").to_argv).to eq(%w[add -- -weird]) expect(parse("add", "rack", "--", "-weird").to_argv).to eq(%w[add -- rack -weird]) end From eabc2fc1f35806d5e119ccf2f49add453ed019be Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:36:24 -0600 Subject: [PATCH 13/14] Update RBS signatures for the new helpers and constants Steep reported the new Planner, Discovery and version members as undeclared, and still listed the removed rewrite_path. The signatures now match the code. Co-Authored-By: Claude Haiku 5.5 --- sig/bundle_matrix.rbs | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/sig/bundle_matrix.rbs b/sig/bundle_matrix.rbs index 62051d0..5cb4a6f 100644 --- a/sig/bundle_matrix.rbs +++ b/sig/bundle_matrix.rbs @@ -1,5 +1,6 @@ module BundleMatrix VERSION: String + MIN_BUNDLER: String TESTED_BUNDLER: Gem::Requirement class Error < Bundler::BundlerError @@ -70,6 +71,7 @@ module BundleMatrix private def default_gemfile_path: () -> Pathname + def main_gemfile?: (Pathname path) -> bool def glob: (String pattern) -> Array[Pathname] def configured_gemfiles: () -> Array[Pathname] def gemfiles_at: (Pathname path) -> Array[Pathname] @@ -142,6 +144,7 @@ module BundleMatrix end MAIN_ONLY_INSTALL_OPTIONS: Array[String] + PATH_OPTIONS: Array[String] @invocation: Invocation @gemfile: SecondaryGemfile @@ -153,14 +156,17 @@ module BundleMatrix private def install_plan: (Invocation invocation, ?Array[String] notes) -> Plan + def dropped_note: (String name) -> String def update_plan: () -> Plan def narrow_update: (Invocation invocation) -> Plan - def unmatched?: (Invocation invocation, Array[String] gems, Array[String] groups) -> bool + def narrow_groups: (Invocation invocation) -> Array[String] + def unmatched?: (Invocation invocation, Array[String] matched) -> bool def requested: (Invocation invocation) -> Array[String] def add_plan: () -> Plan def full_update?: (Invocation invocation) -> bool def install_instead: (String reason) -> Plan - def rewrite_path: (Invocation invocation) -> Invocation + def rewrite_paths: (Invocation invocation) -> Invocation + def relative_to_gemfile: (String value) -> String def run: (Invocation invocation, ?Array[String] notes) -> Plan def skip: (String reason) -> Plan end From a28a10dae6f7b918409cbf726df4e09640ca88b5 Mon Sep 17 00:00:00 2001 From: joe-sharp Date: Sun, 8 Nov 2026 12:58:01 -0600 Subject: [PATCH 14/14] Push the release tag last, after both gem pushes The tag was pushed before the gem was published, so a failed publish left a public tag for a version that was not released. The release now builds, creates the tag locally, pushes the gem to RubyGems and gem.coop, and pushes the tag only at the end. A rerun reuses the local tag and skips versions already published. Co-Authored-By: Claude Haiku 5.5 --- bin/release | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/bin/release b/bin/release index dae2cce..2fd1890 100755 --- a/bin/release +++ b/bin/release @@ -51,7 +51,7 @@ abort "#{tag} already exists but does not point at HEAD" if tag_exists && tag_co puts "\nTag #{tag}: #{description}" exit unless ask("Tag, push, build and publish? (y/N)").to_s.downcase.start_with?("y") -# Built before the tag is pushed, so a build failure does not leave a public tag for a version never released +# Built first, so a build failure stops the release before anything is tagged or published puts "$ gem build #{File.basename(helper.spec_path)}" gem_file = helper.build_gem @@ -60,8 +60,12 @@ if tag_exists else run "git", "tag", "-a", tag, "-m", description end -# Pushing a tag that the remote already has at the same commit is a no-op. -run "git", "push", "origin", tag + +if published?(Gem.host, name, version) + puts "#{name} #{version} is already on #{Gem.host}; skipping" +else + run("gem", "push", gem_file) +end coop = "https://gem.coop/@joe-sharp" if published?(coop, name, version) @@ -70,8 +74,6 @@ else run("gem", "push", "--host", coop, gem_file) end -if published?(Gem.host, name, version) - puts "#{name} #{version} is already on #{Gem.host}; skipping" -else - run("gem", "push", gem_file) -end +# Last, so the tag only goes public once the gem is out. +# Pushing a tag the remote already has at the same commit is a no-op. +run "git", "push", "origin", tag