next_rails 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ef709432bba364ea112d6d8774d0c51b8bf1959b48ede86437b7ae801c7ea3b
-  data.tar.gz: f568512b09f8d16199ec4fb1800964f6a8067a3fb3d36eeaf48a335e117d56c5
+  metadata.gz: 683bb3cbd05a568e913cdbecabc84aa9046f534ebfee134eae53b5ae98d3690f
+  data.tar.gz: 83e65946157ab5de2ee05b9d73f735e6d638df7c14bda1ddaff6bd489dec1bd6
 SHA512:
-  metadata.gz: a2b296e5306c8ab34b7f5b38801785ecfb3a6039a6a48310533ffc02033634a9d67ca2c03f6531c0dc05725a44cffe06d9dc65071f947bc6ec5c6bdd2892a6f9
-  data.tar.gz: cba5e3a34b3127fdcb2bfa28775250b5d7b2f8e0bdb5fb453976c6304f34ca1e272c4b6abee61eb12fe01c0e0cb4c22ea838d7d94164c40f57d7e039ecd7db51
+  metadata.gz: 38021c508b777bbef26be6b897b43f60150ad1658b06d07795b370173c4e1b0f75307e78d95cc147737313d9f263966e0cf7b94370dbd998ba50ed94b31fcd72
+  data.tar.gz: 751730c5320f1fa4dcbdba5b26cd1d2deac911fa5de9abd42ced0224ebc9f811827b3dd4de9f2c63181187c32a6beb3a6956ca0b176f655b1a2ad6a382d125ec

data/CHANGELOG.md

@@ -1,9 +1,18 @@
-# main [(unreleased)](https://github.com/fastruby/next_rails/compare/v1.6.0...main)
+# main [(unreleased)](https://github.com/fastruby/next_rails/compare/v1.7.0...main)
 
 - [BUGFIX: example](https://github.com/fastruby/next_rails/pull/<number>)
 
 * Your changes/patches go here.
 
+# v1.7.0 / 2026-08-05 [(commits)](https://github.com/fastruby/next_rails/compare/v1.6.0...v1.7.0)
+
+- [FEATURE: Add support for SimpleCov 1.0](https://github.com/fastruby/next_rails/pull/196)
+- [FEATURE: Validate the DeprecationTracker mode at initialization, treating a blank mode as the default `save`](https://github.com/fastruby/next_rails/pull/186)
+- [BUGFIX: `bundle_report outdated` no longer confuses a locally-sourced (`path:`) gem with a same-named public gem on rubygems; local gems are excluded from the out-of-date check and counted separately](https://github.com/fastruby/next_rails/pull/189)
+- [BUGFIX: The `deprecations` executable no longer requires the undeclared `rainbow` gem, which made it fail to load on a clean install](https://github.com/fastruby/next_rails/pull/197)
+- [BUGFIX: `deprecations run` no longer raises `NoMethodError` before doing any work](https://github.com/fastruby/next_rails/pull/198)
+- [DOC: Explain `BUNDLE_GEMFILE` usage for the next Gemfile](https://github.com/fastruby/next_rails/pull/187)
+
 # v1.6.0 / 2026-05-07 [(commits)](https://github.com/fastruby/next_rails/compare/v1.5.0...v1.6.0)
 
 - [CHORE: Drop `rainbow` gem dependency in favor of a native `NextRails::Tint` ANSI wrapper](https://github.com/fastruby/next_rails/pull/183)

data/README.md

@@ -51,9 +51,49 @@ vim Gemfile
 next bundle install
 
 # Start your server using the next Gemfile
-next rails s
+next rails server
 ```
 
+### How `next` works (and using `BUNDLE_GEMFILE` directly)
+
+The `next` command is a thin wrapper. It runs your command with `BUNDLE_GEMFILE`
+set so Bundler reads the next dependency set instead of the default one. So these
+two are equivalent:
+
+```bash
+next rails server
+
+BUNDLE_GEMFILE=Gemfile.next rails server
+```
+
+Set `BUNDLE_GEMFILE=Gemfile.next` directly when you can't use the `next` wrapper,
+for example in CI jobs, IDE run configurations, Docker, or other tooling that
+calls Bundler on its own:
+
+```bash
+# Run the test suite against the next Gemfile in CI
+BUNDLE_GEMFILE=Gemfile.next bundle exec rspec
+
+# Export it for a whole shell session
+export BUNDLE_GEMFILE=Gemfile.next
+bundle install
+rails server
+```
+
+When updating `Gemfile.next.lock`, prefer a conservative update so you only bump
+what you intend to and keep the diff small:
+
+```bash
+# Update a single gem against the next Gemfile, leaving everything else pinned
+BUNDLE_GEMFILE=Gemfile.next bundle update rails --conservative
+```
+
+> [!IMPORTANT]
+> Whenever you update `Gemfile.lock`, update `Gemfile.next.lock` at the same time
+> (run the equivalent command with `BUNDLE_GEMFILE=Gemfile.next`). Keeping the two
+> lockfiles in sync avoids surprising differences between the current and next
+> dependency sets.
+
 ### Conditional code
 
 When your Gemfile targets two versions, you may need to branch application code as well:

data/exe/deprecations

@@ -1,12 +1,16 @@
 #!/usr/bin/env ruby
 require "json"
-require "rainbow"
 require "optparse"
 require "set"
+require_relative "../lib/next_rails/tint"
+require_relative "../lib/deprecation_tracker/valid_modes"
 require_relative "../lib/deprecation_tracker/shard_merger"
 
 def run_tests(deprecation_warnings, opts = {})
-  tracker_mode = opts[:tracker_mode]
+  tracker_mode = DeprecationTracker.sanitize_mode(opts[:tracker_mode])
+  if tracker_mode && !DeprecationTracker.valid_mode?(tracker_mode)
+    abort "Invalid --tracker-mode #{tracker_mode.inspect}. Must be one of: #{DeprecationTracker.valid_modes_display}."
+  end
   next_mode = opts[:next_mode]
   rspec_command = if next_mode
     "bin/next rspec"
@@ -29,11 +33,11 @@ def print_info(deprecation_warnings, opts = {})
     end
   end.sort_by {|message, data| data[:occurrences] }.reverse.to_h
 
-  puts Rainbow("Ten most common deprecation warnings:").underline
+  puts NextRails::Tint("Ten most common deprecation warnings:").underline
   frequency_by_message.take(10).each do |message, data|
-    puts Rainbow("Occurrences: #{data.fetch(:occurrences)}").bold
+    puts NextRails::Tint("Occurrences: #{data.fetch(:occurrences)}").bold
     puts "Test files: #{data.fetch(:test_files).to_a.join(" ")}" if verbose
-    puts Rainbow(message).red
+    puts NextRails::Tint(message).red
     puts "----------"
   end
 end
@@ -69,7 +73,7 @@ option_parser = OptionParser.new do |opts|
     options[:next] = next_mode
   end
 
-  opts.on("--tracker-mode MODE", "Set DEPRECATION_TRACKER in test mode. Options: save or compare") do |tracker_mode|
+  opts.on("--tracker-mode MODE", "Set DEPRECATION_TRACKER in test mode. Options: #{DeprecationTracker.valid_modes_display}") do |tracker_mode|
     options[:tracker_mode] = tracker_mode
   end
 
@@ -123,10 +127,10 @@ when "run", "info"
     print_info(deprecation_warnings, verbose: options[:verbose])
   end
 when nil
-  STDERR.puts Rainbow("Must pass a mode: run, info, or merge").red
+  STDERR.puts NextRails::Tint("Must pass a mode: run, info, or merge").red
   puts option_parser
   exit 1
 else
-  STDERR.puts Rainbow("Unknown mode: #{options[:mode]}").red
+  STDERR.puts NextRails::Tint("Unknown mode: #{options[:mode]}").red
   exit 1
 end

data/lib/deprecation_tracker/valid_modes.rb

@@ -0,0 +1,22 @@
+class DeprecationTracker
+  VALID_MODES = %i[save compare].freeze
+
+  # Human-readable list of valid modes for error messages and CLI help text.
+  def self.valid_modes_display
+    @valid_modes_display ||= VALID_MODES.map(&:to_s).join(", ")
+  end
+
+  def self.valid_mode?(mode)
+    mode && VALID_MODES.include?(mode.to_sym)
+  end
+
+  # Returns the mode as-is, or nil when it is blank. A blank DEPRECATION_TRACKER
+  # (e.g. `DEPRECATION_TRACKER= rspec`) is truthy in Ruby, so callers can use this
+  # to treat an empty value as unset and fall back to the default mode.
+  def self.sanitize_mode(mode)
+    return if mode.nil?
+
+    stripped = mode.to_s.strip
+    stripped.empty? ? nil : stripped
+  end
+end

data/lib/deprecation_tracker.rb

@@ -1,4 +1,4 @@
-require "next_rails/tint"
+require_relative "next_rails/tint"
 require "json"
 
 # A shitlist for deprecation warnings during test runs. It has two modes: "save" and "compare"
@@ -10,6 +10,8 @@ require "json"
 # Tracks deprecation warnings, grouped by spec file. After the test run, compare against shitlist of expected
 # deprecation warnings. If anything is added or removed, raise an error with a diff of the changes.
 #
+require_relative "deprecation_tracker/valid_modes"
+
 class DeprecationTracker
   UnexpectedDeprecations = Class.new(StandardError)
 
@@ -77,7 +79,7 @@ class DeprecationTracker
 
   def self.init_tracker(opts = {})
     shitlist_path = opts[:shitlist_path] || DEFAULT_PATH
-    mode = opts[:mode] || ENV["DEPRECATION_TRACKER"] || :save
+    mode = sanitize_mode(opts[:mode] || ENV["DEPRECATION_TRACKER"]) || :save
     transform_message = opts[:transform_message]
     node_index = opts[:node_index]
     deprecation_tracker = DeprecationTracker.new(shitlist_path, transform_message, mode, node_index: node_index)
@@ -141,6 +143,9 @@ class DeprecationTracker
     @transform_message = transform_message || -> (message) { message }
     @deprecation_messages = {}
     @mode = mode ? mode.to_sym : :save
+    unless self.class.valid_mode?(@mode)
+      raise ArgumentError, "mode must be one of: #{self.class.valid_modes_display}. Got: #{mode.inspect}"
+    end
     if @mode == :compare && node_index
       raise ArgumentError, "node_index cannot be used with compare mode"
     end

data/lib/next_rails/bundle_report.rb

@@ -63,22 +63,27 @@ module NextRails
 
     def outdated(format = nil)
       gems = NextRails::GemInfo.all
-      out_of_date_gems = gems.reject(&:up_to_date?).sort_by(&:created_at)
+      sourced_locally = gems.select(&:sourced_locally?)
       sourced_from_git = gems.select(&:sourced_from_git?)
 
+      # Locally-sourced gems (e.g. `path:` engines) are excluded from the
+      # out-of-date check: looking them up by name on rubygems can match an
+      # unrelated public gem with the same name and report a bogus upgrade.
+      out_of_date_gems = (gems - sourced_locally).reject(&:up_to_date?).sort_by(&:created_at)
+
       if format == 'json'
-        output_to_json(out_of_date_gems, gems.count, sourced_from_git.count)
+        output_to_json(out_of_date_gems, gems.count, sourced_from_git.count, sourced_locally.count)
       else
-        output_to_stdout(out_of_date_gems, gems.count, sourced_from_git.count)
+        output_to_stdout(out_of_date_gems, gems.count, sourced_from_git.count, sourced_locally.count)
       end
     end
 
-    def output_to_json(out_of_date_gems, total_gem_count, sourced_from_git_count)
-      obj = build_json(out_of_date_gems, total_gem_count, sourced_from_git_count)
+    def output_to_json(out_of_date_gems, total_gem_count, sourced_from_git_count, sourced_locally_count)
+      obj = build_json(out_of_date_gems, total_gem_count, sourced_from_git_count, sourced_locally_count)
       puts JSON.pretty_generate(obj)
     end
 
-    def build_json(out_of_date_gems, total_gem_count, sourced_from_git_count)
+    def build_json(out_of_date_gems, total_gem_count, sourced_from_git_count, sourced_locally_count)
       output = Hash.new { [] }
       out_of_date_gems.each do |gem|
         output[:outdated_gems] += [
@@ -95,12 +100,13 @@ module NextRails
       output.merge(
         {
           sourced_from_git_count: sourced_from_git_count,
+          sourced_locally_count: sourced_locally_count,
           total_gem_count: total_gem_count
         }
       )
     end
 
-    def output_to_stdout(out_of_date_gems, total_gem_count, sourced_from_git_count)
+    def output_to_stdout(out_of_date_gems, total_gem_count, sourced_from_git_count, sourced_locally_count)
       out_of_date_gems.each do |gem|
         header = "#{gem.name} #{gem.version}"
 
@@ -112,6 +118,7 @@ module NextRails
       percentage_out_of_date = ((out_of_date_gems.count / total_gem_count.to_f) * 100).round
       footer = <<-MESSAGE
         #{NextRails::Tint(sourced_from_git_count.to_s).yellow} gems are sourced from git
+        #{NextRails::Tint(sourced_locally_count.to_s).yellow} gems are sourced from a local path
         #{NextRails::Tint(out_of_date_gems.count.to_s).red} of the #{total_gem_count} gems are out-of-date (#{percentage_out_of_date}%)
       MESSAGE
 

data/lib/next_rails/gem_info.rb

@@ -66,6 +66,17 @@ module NextRails
       !!gem_specification.git_version
     end
 
+    def sourced_locally?
+      # Bundler defines Source::Path and patches Gem::Specification#source to return the
+      # gem's real source. Without Bundler loaded, #source is RubyGems' own and returns a
+      # Gem::Source::Installed, so no path source can exist; treat the gem as not local.
+      return false unless defined?(Bundler::Source::Path)
+
+      source = gem_specification.source
+      # Git sources subclass Path, so exclude them; they are reported via #sourced_from_git?.
+      source.is_a?(Bundler::Source::Path) && !source.is_a?(Bundler::Source::Git)
+    end
+
     def created_at
       @created_at ||= gem_specification.date
     end

data/lib/next_rails/tint.rb

@@ -13,6 +13,7 @@ module NextRails
     CODES = {
       bold: 1,
       italic: 3,
+      underline: 4,
       red: 31,
       green: 32,
       yellow: 33,

data/lib/next_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NextRails
-  VERSION = "1.6.0"
+  VERSION = "1.7.0"
 end

data/next_rails.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", ">= 1.16"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "simplecov", "~> 0.17.1"
+  spec.add_development_dependency "simplecov", ">= 0.17.1"
   spec.add_development_dependency "timecop", "~> 0.9.1"
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "rexml", "3.2.5" # limited on purpose, new versions don't work with old rubies

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: next_rails
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Ernesto Tagwerker
 - Luis Sagastume
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -57,14 +56,14 @@ dependencies:
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.17.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.17.1
 - !ruby/object:Gem::Dependency
@@ -176,6 +175,7 @@ files:
 - exe/next_rails
 - lib/deprecation_tracker.rb
 - lib/deprecation_tracker/shard_merger.rb
+- lib/deprecation_tracker/valid_modes.rb
 - lib/next_rails.rb
 - lib/next_rails/bundle_report.rb
 - lib/next_rails/bundle_report/cli.rb
@@ -191,7 +191,6 @@ homepage: https://github.com/fastruby/next_rails
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -206,8 +205,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A toolkit to upgrade your next Rails application
 test_files: []