next_rails 1.0.4 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09652c9c25b1ed9f21f01ee7f65f73d25ad1f89b5d0c7e05f97b7255e96d753a'
-  data.tar.gz: 8eb4df05b36ed4f47aaeb78720a73e8a31561a1bf2437490d99e3123ce55a326
+  metadata.gz: 1fdec8942101c58f6081b681319339b6ed5703dd14af0f1d43498afb894bba26
+  data.tar.gz: 32bfa4c31e2d53b9100e4a46a3fbf053ff90b38d15256867b3a5f4b6e4fc0d44
 SHA512:
-  metadata.gz: 99a2723cd58752e9bea3c47a695dbefd5fab56cc3490bba5b336cf063b53880830a3a98eba8fb79cc1035713b1ead4f44c8ddadaa493bab36a7686ff053e61a4
-  data.tar.gz: ee60bfff4836d6f81f2e46f15c4113434881c8eed6266136a39bc797e0bed86fd59289928631c771a2ff03907145c97cc76a670b8cac033fac6bd5662c9496e9
+  metadata.gz: 0a030398c55b7e09de54ad9607745410c14d1a64e8fa753e32dd0c41b5555640a9af23f31f9f40cb550fb1b11b8c461adf95727e281d6d05250089dd9ee8b509
+  data.tar.gz: 8b7d02f997ca2b7db31ff7e2c131e72df4ccb979979f792ecdefdf0f8500f619fb78a8187f4be712a40503af9bf27bc143678bfa27b95e52594fdc537132b3a0

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,51 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG] "
+labels: bug
+assignees: ""
+---
+
+**IMPORTANT: please make sure you ask yourself all intro questions and fill all sections of the template.**
+
+**Before we start...:**
+
+- [ ] I checked the documentation and found no answer
+- [ ] I checked to make sure that this issue has not already been filed
+- [ ] I'm reporting the issue to the correct repository (for multi-repository projects)
+
+**Version, Branch, or Commit:**
+
+What branch/commit/version of "next_rails" you are using?
+
+**Expected behavior:**
+
+Please include a detailed description of the behavior you were expecting when you encountered this issue.
+
+**Actual behavior:**
+
+Please include a detailed description of the actual behavior of the application.
+
+**Steps to reproduce:**
+
+How do I achieve this behavior? Use the following format to provide a step-by-step guide:
+
+1. Step 1: ...
+2. Step 2: ...
+
+**Context and environment:**
+
+Provide any relevant information about your setup (Customize the list accordingly based on what info is relevant to this project)
+
+1. Version of the software the issue is being opened for.
+2. Operating System
+3. Operating System version
+4. Ruby version
+
+_Delete any information that is not relevant._
+
+**Logs**
+
+Include relevant log snippets or files here.
+
+**I will abide by the [code of conduct](https://github.com/fastruby/next_rails/blob/main/CODE_OF_CONDUCT.md)**

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,40 @@
+---
+name: Feature request
+about: Request a new feature
+title: "[REQUEST]"
+labels: enhancement
+assignees: ""
+---
+
+**IMPORTANT: please make sure you ask yourself all intro questions and fill all sections of the template.**
+
+**Before we start...:**
+
+- [ ] I checked the documentation and didn't find this feature
+- [ ] I checked to make sure that this feature has not already been requested
+
+**Branch/Commit:**
+
+Inform what branch/commit/version of "next_rails" you are using.
+
+**Describe the feature:**
+
+Please include a detailed description of the feature you are requesting and any detail on it’s expected behavior.
+
+> **As a \<role name\>** > **I do \<something\>** > **And then I do \<another action\>** > **And I see \<some result\>**
+
+**Problem:**
+
+Please include a detailed description of the problem this feature would solve.
+
+> **As a \<role name\>** > **I want to \<do something\>** > **So that I can achieve a \<goal\>**
+
+**Mockups:**
+
+Include any mockup idea related to the requested feature if it applies.
+
+**Resources:**
+
+If you have resources related to the implementation or research for this feature, add them here.
+
+**I will abide by the [code of conduct](https://github.com/fastruby/next_rails/blob/main/CODE_OF_CONDUCT.md)**

data/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "bundler"
+    directory: "/"
+    schedule:
+      interval: "daily"

data/.github/workflows/main.yml

@@ -0,0 +1,26 @@
+name: Run rake task
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [3.1, 2.7.5, 2.3, 2.2, 2.1.9, 2.0.0]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      - name: Run rake task
+        run: bundle exec rake

data/.travis.yml

@@ -6,4 +6,5 @@ rvm:
   - 2.5.8
   - 2.6.6
   - 2.7.2
+  - 3.0.2
 before_install: gem install bundler -v 1.16.1

data/CHANGELOG.md

@@ -1,13 +1,45 @@
-# main [(unreleased)](https://github.com/fastruby/next_rails/compare/v1.0.4...main)
+# main [(unreleased)](https://github.com/fastruby/next_rails/compare/v1.2.0...main)
+
+# v1.2.0 / 2022-08-12 [(commits)](https://github.com/fastruby/next_rails/compare/v1.1.0...v1.2.0)
+
+- [FEATURE: Support Ruby versions as old as Ruby 2.0](https://github.com/fastruby/next_rails/pull/54)
+
+- [FEATURE: Better documentation for contributing and releasing versions of this gem](https://github.com/fastruby/next_rails/pull/53)
+
+# v1.1.0 / 2022-06-30 [(commits)](https://github.com/fastruby/next_rails/compare/v1.0.5...v1.1.0)
+
+- [FEATURE: Try to find the latest **compatible** version of a gem if the latest version is not compatible with the desired Rails version when checking compatibility](https://github.com/fastruby/next_rails/pull/49)
+
+- [FEATURE: Added option --version to get the version of the gem being used](https://github.com/fastruby/next_rails/pull/38)
+
+- [Added github action workflow](https://github.com/fastruby/next_rails/pull/40)
+
+- [FEATURE: Add support to use DeprecationTracker with Minitest](Add support to use DeprecationTracker with Minitest)
+
+- [FEATURE: Add dependabot](https://github.com/fastruby/next_rails/pull/41)
+
+- [DOCUMENTATION: Update the code of conduct link in PR template](https://github.com/fastruby/next_rails/pull/46)
+
+- [DOCUMENTATION: Add FEATURE REQUEST and BUG REPORT templates ](https://github.com/fastruby/next_rails/pull/48)
+
+- [BUGFIX: Make behavior arguments optional](https://github.com/fastruby/next_rails/pull/44)
+
+- [FEATURE: Command line option to check for recommended ruby version for the desired Rails version](https://github.com/fastruby/next_rails/pull/39)
+
+# v1.0.5 / 2022-03-29 [(commits)](https://github.com/fastruby/next_rails/compare/v1.0.4...v1.0.5)
+
+- [FEATURE: Initialize the Gemfile.next.lock to avoid major version jumps when used without an initial Gemfile.next.lock](https://github.com/fastruby/next_rails/pull/25)
+- [FEATURE: Drop `actionview` dependency because it is not really used](https://github.com/fastruby/next_rails/pull/26)
+- [BUGFIX: If shitlist path does not exist, create it for the user of the gem](https://github.com/fastruby/next_rails/pull/37)
 
 # v1.0.4 / 2021-04-09 [(commits)](https://github.com/fastruby/next_rails/compare/v1.0.3...v1.0.4)
 
-* [BUGFIX] Fixes issue with `bundle_report` and `actionview` (by [@etagwerker][])
+- [BUGFIX: Fixes issue with `bundle_report` and `actionview`](https://github.com/fastruby/next_rails/pull/22)
 
 # v1.0.3 / 2021-04-05 [(commits)](https://github.com/fastruby/next_rails/compare/v1.0.2...v1.0.3)
 
-* [BUGFIX] Update README.md to better document this `ten_years_rails` fork (by [@etagwerker][])
-* [BUGFIX] Make ActionView an optional dependency (by [@manuca][])
+- [BUGFIX: Update README.md to better document this `ten_years_rails` fork](https://github.com/fastruby/next_rails/pull/11)
+- [BUGFIX: Make ActionView an optional dependency](https://github.com/fastruby/next_rails/pull/6)
 
 # v1.0.2 / 2020-01-20
 
@@ -15,4 +47,4 @@
 
 # v1.0.0 / 2019-07-24
 
-* Official Release
+- Official Release

data/CODEOWNERS

@@ -0,0 +1,4 @@
+# These code owners will be the default owners to everything in the repository.
+# Unless a posterior rule has precedence, they will be automatically requested
+# for review when a pull request is opened.
+*       @fastruby/black-bunny-brigade

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to make participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, and it also applies when
+an individual is representing the project or its community in public spaces.
+Examples of representing a project or community include using an official
+project e-mail address, posting via an official social media account, or acting
+as an appointed representative at an online or offline event. Representation of
+a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at oss@ombulabs.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

data/CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing to next_rails
+
+Have a fix for a problem you've been running into or an idea for a new feature you think would be useful? Bug reports and pull requests are welcome on GitHub at [https://github.com/fastruby/next_rails](https://github.com/fastruby/next_rails).
+
+Here's what you need to do:
+
+- Read and understand the [Code of Conduct](https://github.com/fastruby/next_rails/blob/main/CODE_OF_CONDUCT.md).
+- Fork this repo and clone your fork to somewhere on your machine.
+- [Ensure that you have a working environment](#setting-up-your-environment)
+- Read up on [run the tests](#running-all-tests).
+- Open a new branch and write a failing test for the feature or bug fix you plan on implementing.
+- [Update the changelog when applicable](#a-word-on-the-changelog).
+- Push to your fork and submit a pull request.
+- [Make sure the test suite passes on GitHub Actions and make any necessary changes to your branch to bring it to green.](#continuous-integration).
+
+## Setting up your environment
+To install the dependencies, run:
+
+```bash
+bin/setup
+```
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment with the gem.
+
+To install this gem onto your local machine, run:
+
+`bundle exec rake install`.
+
+### Running all tests
+
+To run all of the tests, simply run:
+
+```bash
+bundle exec rake
+```
+
+## A word on the changelog
+
+You may also notice that we have a changelog in the form of [CHANGELOG.md](CHANGELOG.md). We use a format based on [Keep A Changelog](https://keepachangelog.com/en/1.0.0/).
+
+The important things to keep in mind are:
+
+- If your PR closes any open GitHub issue, make sure you include `Closes #XXXX` in your comment.
+- New additions get added under the main (unreleased) heading;
+- Attach a link to the PR with the following format:
+
+* [<FEATURE | BUGFIX | CHORE>: Description of changes](github.com/link/to/pr).
+
+## When Submitting a Pull Request:
+
+* If your PR closes any open GitHub issues, please include `Closes #XXXX` in your comment.
+* Please include a summary of the change and which issue is fixed or which feature is introduced.
+* If changes to the behavior are made, clearly describe what are the changes and why.
+* If changes to the UI are made, please include screenshots of the before and after.
+
+## Continuous integration
+
+After opening your Pull Request, please make sure that all tests pass on the CI, to make sure your changes work in all possible environments. GitHub Actions will kick in after you push up a branch or open a PR.
+
+If the build fails, click on a failed job and scroll through its output to verify what is the problem. Push your changes to your branch until the build is green.

data/README.md

@@ -34,6 +34,8 @@ bundle_report outdated | head -n 5
 # Show gems that don't work with Rails 5.2.0
 bundle_report compatibility --rails-version=5.2.0
 bundle_report --help
+# Find minimum compatible ruby version with Rails 7.0.0
+bundle_report ruby_check --rails-version=7.0.0
 ```
 
 ### Deprecation tracking
@@ -54,7 +56,20 @@ RSpec.configure do |config|
 end
 ```
 
-We don't use MiniTest, so there isn't a prebuilt config for it but I suspect it's pretty similar to `DeprecationTracker.track_rspec`.
+If using minitest, add this somewhere close to the top of your `test_helper.rb`:
+
+```ruby
+# Tracker deprecation messages in each file
+if ENV["DEPRECATION_TRACKER"]
+  DeprecationTracker.track_minitest(
+    shitlist_path: "test/support/deprecation_warning.shitlist.json",
+    mode: ENV["DEPRECATION_TRACKER"],
+    transform_message: -> (message) { message.gsub("#{Rails.root}/", "") }
+  )
+end
+```
+
+> Keep in mind this is currently not compatible with the `minitest/parallel_fork` gem!
 
 Once you have that, you can start using deprecation tracking in your tests:
 
@@ -78,12 +93,21 @@ deprecations --help # For more options and examples
 
 Right now, the path to the shitlist is hardcoded so make sure you store yours at `spec/support/deprecations.shitlist.json`.
 
+#### `next_rails` command
+
+You can use `next_rails` to fetch the version of the gem installed.
+
+```bash
+next_rails --version
+next_rails --help # For more options and examples
+```
+
 ### Dual-boot Rails next
 
 This command helps you dual-boot your application.
 
 ```bash
-next --init         # Create Gemfile.next
+next --init         # Create Gemfile.next and Gemfile.next.lock
 vim Gemfile         # Tweak your dependencies conditionally using `next?`
 next bundle install # Install new gems
 next rails s        # Start server using Gemfile.next
@@ -105,6 +129,44 @@ Or install it yourself as:
 
     $ gem install next_rails
 
+## Setup
+
+Execute:
+
+    $ next --init
+
+Init will create a Gemfile.next and an initialized Gemfile.next.lock.
+The Gemfile.next.lock is initialized with the contents of your existing
+Gemfile.lock lock file. We initialize the Gemfile.next.lock to prevent
+major version jumps when running the next version of Rails.
+
+## Contributing
+
+Have a fix for a problem you've been running into or an idea for a new feature you think would be useful? Want to see how you can support `next_rails`?
+
+Take a look at the [Contributing document](CONTRIBUTING.md) for instructions to set up the repo on your machine!
+
+## Releases
+
+`next_rails` adheres to [semver](https://semver.org). So given a version number MAJOR.MINOR.PATCH, we will increment the:
+
+1. MAJOR version when you make incompatible API changes,
+2. MINOR version when you add functionality in a backwards compatible manner, and
+3. PATCH version when you make backwards compatible bug fixes.
+
+Here are the steps to release a new version:
+
+1. Update the `version.rb` file with the proper version number
+2. Update `CHANGELOG.md` to have the right headers
+3. Commit your changes to a `release/v-1-1-0` branch
+4. Push your changes and submit a pull request
+5. Merge your pull request to the `main` branch
+6. Git tag the latest version of the `main` branch (`git tag v1.1.0`)
+7. Push tags to GitHub (`git push --tags`)
+8. Build the gem (`gem build next_rails.gemspec`)
+9. Push the .gem package to Rubygems.org (`gem push next_rails-1.1.0.gem`)
+10. You are all done!
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/exe/bundle_report

@@ -17,6 +17,12 @@ at_exit do
       Examples:
         #{$0} compatibility --rails-version 5.0
         #{$0} outdated
+
+      ruby_check To find a compatible ruby version for the target rails version
+
+      Examples:
+        #{$0} ruby_check --rails-version 7.0.0
+
     EOS
 
     opts.separator ""
@@ -47,6 +53,7 @@ at_exit do
   report_type = ARGV.first
 
   case report_type
+  when "ruby_check" then NextRails::BundleReport.compatible_ruby_version(rails_version: options.fetch(:rails_version))
   when "outdated" then NextRails::BundleReport.outdated
   else
     NextRails::BundleReport.compatibility(rails_version: options.fetch(:rails_version, "5.0"), include_rails_gems: options.fetch(:include_rails_gems, false))

data/exe/next.sh

@@ -10,6 +10,13 @@ STRING
   mv Gemfile.tmp Gemfile
 
   ln -s Gemfile Gemfile.next
+
+  # Initialize the Gemfile.next.lock
+  # Prevents major version jumps when we start without a Gemfile.next.lock
+  if [ -f "Gemfile.lock" ] && [ ! -f "Gemfile.next.lock" ]; then
+    cp Gemfile.lock Gemfile.next.lock
+  fi
+
   echo <<-MESSAGE
 Created Gemfile.next (a symlink to your Gemfile). Your Gemfile has been modified to support dual-booting!
 

data/exe/next_rails

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+require "optparse"
+require "next_rails/version"
+
+options = {}
+option_parser = OptionParser.new do |opts|
+  opts.banner = <<-MESSAGE
+    Usage: #{__FILE__.to_s} [options]
+
+    Examples:
+      bin/next_rails --version info # Show the version of the gem installed
+  MESSAGE
+
+  opts.on("--version", "show version of the gem") do
+    options[:version] = true
+  end
+
+  opts.on_tail("-h", "--help", "Prints this help") do
+    puts opts
+    exit
+  end
+end
+
+option_parser.parse!
+
+if options.fetch(:version, false)
+  puts NextRails::VERSION
+  exit 2
+end

data/lib/deprecation_tracker.rb

@@ -27,8 +27,31 @@ class DeprecationTracker
     end
   end
 
+  module MinitestExtension
+    def self.new(deprecation_tracker)
+      @@deprecation_tracker = deprecation_tracker
+
+      Module.new do
+        def before_setup
+          test_file_name = method(name).source_location.first.to_s
+          @@deprecation_tracker.bucket = test_file_name.gsub(Rails.root.to_s, ".")
+          super
+        end
+      
+        def after_teardown
+          super
+          @@deprecation_tracker.bucket = nil
+        end
+      end
+    end
+  end
+
   # There are two forms of the `warn` method: one for class Kernel and one for instances of Kernel (i.e., every Object)
-  Object.prepend(KernelWarnTracker)
+  if Object.respond_to?(:prepend)
+    Object.prepend(KernelWarnTracker)
+  else
+    Object.extend(KernelWarnTracker)
+  end
 
   # Ruby 2.2 and lower doesn't appear to allow overriding of Kernel.warn using `singleton_class.prepend`.
   if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("2.3.0")
@@ -39,16 +62,24 @@ class DeprecationTracker
     end
   end
 
-  def self.track_rspec(rspec_config, opts = {})
+  def self.init_tracker(opts = {})
     shitlist_path = opts[:shitlist_path]
     mode = opts[:mode]
     transform_message = opts[:transform_message]
-    deprecation_tracker = DeprecationTracker.new(shitlist_path, transform_message)
+    deprecation_tracker = DeprecationTracker.new(shitlist_path, transform_message, mode)
     if defined?(ActiveSupport)
-      ActiveSupport::Deprecation.behavior << -> (message, _callstack, _deprecation_horizon, _gem_name) { deprecation_tracker.add(message) }
+      ActiveSupport::Deprecation.behavior << -> (message, _callstack = nil, _deprecation_horizon = nil, _gem_name = nil) {
+        deprecation_tracker.add(message)
+      }
     end
     KernelWarnTracker.callbacks << -> (message) { deprecation_tracker.add(message) }
 
+    deprecation_tracker
+  end
+
+  def self.track_rspec(rspec_config, opts = {})
+    deprecation_tracker = init_tracker(opts)
+
     rspec_config.around do |example|
       deprecation_tracker.bucket = example.metadata.fetch(:rerun_file_path)
 
@@ -60,21 +91,27 @@ class DeprecationTracker
     end
 
     rspec_config.after(:suite) do
-      if mode == "save"
-        deprecation_tracker.save
-      elsif mode == "compare"
-        deprecation_tracker.compare
-      end
+      deprecation_tracker.after_run
     end
   end
 
-  attr_reader :deprecation_messages, :shitlist_path, :transform_message
-  attr_reader :bucket
+  def self.track_minitest(opts = {})
+    tracker = init_tracker(opts)
 
-  def initialize(shitlist_path, transform_message = nil)
+    Minitest.after_run do
+      tracker.after_run
+    end
+
+    ActiveSupport::TestCase.include(MinitestExtension.new(tracker))
+  end
+
+  attr_reader :deprecation_messages, :shitlist_path, :transform_message, :bucket, :mode
+
+  def initialize(shitlist_path, transform_message = nil, mode = :save)
     @shitlist_path = shitlist_path
     @transform_message = transform_message || -> (message) { message }
     @deprecation_messages = {}
+    @mode = mode.to_sym
   end
 
   def add(message)
@@ -88,6 +125,14 @@ class DeprecationTracker
     @deprecation_messages[value] ||= [] unless value.nil?
   end
 
+  def after_run
+    if mode == :save
+      save
+    elsif mode == :compare
+      compare
+    end
+  end
+
   def compare
     shitlist = read_shitlist
 
@@ -130,11 +175,19 @@ class DeprecationTracker
 
   def save
     new_shitlist = create_temp_shitlist
+    create_if_shitlist_path_does_not_exist
     FileUtils.cp(new_shitlist.path, shitlist_path)
   ensure
     new_shitlist.delete if new_shitlist
   end
 
+  def create_if_shitlist_path_does_not_exist
+    dirname = File.dirname(shitlist_path)
+    unless File.directory?(dirname)
+      FileUtils.mkdir_p(dirname)
+    end
+  end
+
   def create_temp_shitlist
     temp_file = Tempfile.new("temp-deprecation-tracker-shitlist")
     temp_file.write(JSON.pretty_generate(normalized_deprecation_messages))
@@ -149,7 +202,12 @@ class DeprecationTracker
       hash[bucket] = messages.sort
     end
 
-    normalized.reject {|_key, value| value.empty? }.sort_by {|key, _value| key }.to_h
+    # not using `to_h` here to support older ruby versions
+    {}.tap do |h|
+      normalized.reject {|_key, value| value.empty? }.sort_by {|key, _value| key }.each do |k ,v|
+        h[k] = v
+      end
+    end
   end
 
   def read_shitlist

data/lib/next_rails/bundle_report.rb

@@ -2,51 +2,49 @@ require "colorize"
 require "cgi"
 require "erb"
 require "json"
+require "net/http"
 
 module NextRails
   class BundleReport
-    def self.compatibility(rails_version:, include_rails_gems:)
+    def self.compatibility(rails_version: nil, include_rails_gems: nil)
       incompatible_gems = NextRails::GemInfo.all.reject do |gem|
         gem.compatible_with_rails?(rails_version: rails_version) || (!include_rails_gems && gem.from_rails?)
-      end.sort_by do |gem|
-        [
-          gem.latest_version.compatible_with_rails?(rails_version: rails_version) ? 0 : 1,
-          gem.name
-        ].join("-")
-      end
+      end.sort_by { |gem| gem.name }
+
+      incompatible_gems.each { |gem| gem.find_latest_compatible(rails_version: rails_version) }
 
       incompatible_gems_by_state = incompatible_gems.group_by { |gem| gem.state(rails_version) }
 
-      template = <<~ERB
-        <% if incompatible_gems_by_state[:latest_compatible] -%>
-        <%= "=> Incompatible with Rails #{rails_version} (with new versions that are compatible):".white.bold %>
-        <%= "These gems will need to be upgraded before upgrading to Rails #{rails_version}.".italic %>
+      template = <<-ERB
+<% if incompatible_gems_by_state[:found_compatible] -%>
+<%= "=> Incompatible with Rails #{rails_version} (with new versions that are compatible):".white.bold %>
+<%= "These gems will need to be upgraded before upgrading to Rails #{rails_version}.".italic %>
 
-        <% incompatible_gems_by_state[:latest_compatible].each do |gem| -%>
-        <%= gem_header(gem) %> - upgrade to <%= gem.latest_version.version %>
-        <% end -%>
+<% incompatible_gems_by_state[:found_compatible].each do |gem| -%>
+<%= gem_header(gem) %> - upgrade to <%= gem.latest_compatible_version.version %>
+<% end -%>
 
-        <% end -%>
-        <% if incompatible_gems_by_state[:incompatible] -%>
-        <%= "=> Incompatible with Rails #{rails_version} (with no new compatible versions):".white.bold %>
-        <%= "These gems will need to be removed or replaced before upgrading to Rails #{rails_version}.".italic %>
+<% end -%>
+<% if incompatible_gems_by_state[:incompatible] -%>
+<%= "=> Incompatible with Rails #{rails_version} (with no new compatible versions):".white.bold %>
+<%= "These gems will need to be removed or replaced before upgrading to Rails #{rails_version}.".italic %>
 
-        <% incompatible_gems_by_state[:incompatible].each do |gem| -%>
-        <%= gem_header(gem) %> - new version, <%= gem.latest_version.version %>, is not compatible with Rails #{rails_version}
-        <% end -%>
+<% incompatible_gems_by_state[:incompatible].each do |gem| -%>
+<%= gem_header(gem) %> - new version, <%= gem.latest_version.version %>, is not compatible with Rails #{rails_version}
+<% end -%>
 
-        <% end -%>
-        <% if incompatible_gems_by_state[:no_new_version] -%>
-        <%= "=> Incompatible with Rails #{rails_version} (with no new versions):".white.bold %>
-        <%= "These gems will need to be upgraded by us or removed before upgrading to Rails #{rails_version}.".italic %>
-        <%= "This list is likely to contain internal gems, like Cuddlefish.".italic %>
+<% end -%>
+<% if incompatible_gems_by_state[:no_new_version] -%>
+<%= "=> Incompatible with Rails #{rails_version} (with no new versions):".white.bold %>
+<%= "These gems will need to be upgraded by us or removed before upgrading to Rails #{rails_version}.".italic %>
+<%= "This list is likely to contain internal gems, like Cuddlefish.".italic %>
 
-        <% incompatible_gems_by_state[:no_new_version].each do |gem| -%>
-        <%= gem_header(gem) %> - new version not found
-        <% end -%>
+<% incompatible_gems_by_state[:no_new_version].each do |gem| -%>
+<%= gem_header(gem) %> - new version not found
+<% end -%>
 
-        <% end -%>
-        <%= incompatible_gems.length.to_s.red %> gems incompatible with Rails <%= rails_version %>
+<% end -%>
+<%= incompatible_gems.length.to_s.red %> gems incompatible with Rails <%= rails_version %>
       ERB
 
       puts ERB.new(template, nil, "-").result(binding)
@@ -58,6 +56,45 @@ module NextRails
       header
     end
 
+    def self.compatible_ruby_version(rails_version)
+      # find all the versions of rails gem
+      uri = URI('https://rubygems.org/api/v1/versions/rails.json')
+      res = Net::HTTP.get_response(uri)
+      all_versions_res = JSON.parse(res.body)
+
+      # push all the versions in an array
+      all_versions = []
+      all_versions_res.each { |rv| all_versions << rv['number'] }
+
+      rv = rails_version[:rails_version]
+      matched_versions = all_versions.select { |h| h.start_with?(rv) }
+
+      # the list can either have the exact version or the latest version in the series of versions
+      # you are looking at
+      # ex: matched_versions = ["6.1.4.2", "6.1.4.1", "6.1.4"]
+      # if you have passed "6.1.4" and the list has the exact version, it will match and send
+      # the ruby version for it bu tif you had passed "6.1", then it will look for the
+      # latest version matching "6.1" which is "6.1.4.2" in this case and will return ruby
+      # version for it.
+      exact_version = matched_versions.include?(rv) ? rv : matched_versions[0]
+
+      if exact_version
+        uri = URI("https://rubygems.org/api/v2/rubygems/rails/versions/#{exact_version}.json")
+        res = Net::HTTP.get_response(uri)
+        ruby_version = JSON.parse(res.body)["ruby_version"]
+      else
+        ruby_version = nil
+      end
+
+
+      if ruby_version
+        puts "The required ruby version is #{ruby_version} for matched rails version #{exact_version}"
+        ruby_version
+      else
+        puts "Could not find a compatible ruby version"
+      end
+    end
+
     def self.outdated
       gems = NextRails::GemInfo.all
       out_of_date_gems = gems.reject(&:up_to_date?).sort_by(&:created_at)
@@ -67,15 +104,15 @@ module NextRails
       out_of_date_gems.each do |_gem|
         header = "#{_gem.name} #{_gem.version}"
 
-        puts <<~MESSAGE
-          #{header.bold.white}: released #{_gem.age} (latest version, #{_gem.latest_version.version}, released #{_gem.latest_version.age})
+        puts <<-MESSAGE
+#{header.bold.white}: released #{_gem.age} (latest version, #{_gem.latest_version.version}, released #{_gem.latest_version.age})
         MESSAGE
       end
 
       puts ""
-      puts <<~MESSAGE
-        #{"#{sourced_from_git.count}".yellow} gems are sourced from git
-        #{"#{out_of_date_gems.length}".red} of the #{gems.count} gems are out-of-date (#{percentage_out_of_date}%)
+      puts <<-MESSAGE
+#{"#{sourced_from_git.count}".yellow} gems are sourced from git
+#{"#{out_of_date_gems.length}".red} of the #{gems.count} gems are out-of-date (#{percentage_out_of_date}%)
       MESSAGE
     end
   end

data/lib/next_rails/gem_info.rb

@@ -28,13 +28,28 @@ module NextRails
       end
     end
 
+    RAILS_GEMS = [
+      "rails",
+      "activemodel",
+      "activerecord",
+      "actionmailer",
+      "actioncable",
+      "actionpack",
+      "actionview",
+      "activejob",
+      "activestorage",
+      "activesupport",
+      "railties",
+    ].freeze
+
     def self.all
       Gem::Specification.each.map do |gem_specification|
         new(gem_specification)
       end
     end
 
-    attr_reader :gem_specification, :version, :name
+    attr_reader :gem_specification, :version, :name, :latest_compatible_version
+
     def initialize(gem_specification)
       @gem_specification = gem_specification
       @version = gem_specification.version
@@ -57,59 +72,69 @@ module NextRails
       version == latest_version.version
     end
 
+    def from_rails?
+      RAILS_GEMS.include?(name)
+    end
+
     def state(rails_version)
       if compatible_with_rails?(rails_version: rails_version)
         :compatible
-      elsif latest_version.compatible_with_rails?(rails_version: rails_version)
-        :latest_compatible
-      elsif latest_version.version == "NOT FOUND"
+      elsif latest_compatible_version.version == "NOT FOUND"
         :no_new_version
+      elsif latest_compatible_version
+        :found_compatible
       else
         :incompatible
       end
     end
 
-    def latest_version
-      @latest_version ||= begin
-        latest_gem_specification = Gem.latest_spec_for(name)
-        if latest_gem_specification
-          GemInfo.new(latest_gem_specification)
-        else
-          NullGemInfo.new
-        end
-      end
+    def compatible_with_rails?(rails_version: nil)
+      unsatisfied_rails_dependencies(rails_version: rails_version).empty?
     end
 
-    def compatible_with_rails?(rails_version: Gem::Version.new("5.0"))
-      unsatisfied_rails_dependencies(rails_version: rails_version).empty?
+    def unsatisfied_rails_dependencies(rails_version: nil)
+      spec_compatible_with_rails?(specification: gem_specification, rails_version: rails_version)
     end
 
-    def unsatisfied_rails_dependencies(rails_version:)
-      rails_dependencies = gem_specification.runtime_dependencies.select {|dependency| rails_gems.include?(dependency.name) }
+    def find_latest_compatible(rails_version: nil)
+      dependency = Gem::Dependency.new(@name)
+      fetcher = Gem::SpecFetcher.new
 
-      rails_dependencies.reject do |rails_dependency|
-        rails_dependency.requirement.satisfied_by?(Gem::Version.new(rails_version))
+      # list all available data for released gems
+      list, errors = fetcher.available_specs(:released)
+
+      specs = []
+      # filter only specs for the current gem and older versions
+      list.each do |source, gem_tuples|
+        gem_tuples.each do |gem_tuple|
+          if gem_tuple.name == @name && gem_tuple.version > @version
+            specs << source.fetch_spec(gem_tuple)
+          end
+        end
       end
-    end
 
-    def from_rails?
-      rails_gems.include?(name)
+      # if nothing is found, consider gem incompatible
+      if specs.empty?
+        @latest_compatible_version = NullGemInfo.new
+        return
+      end
+
+      # if specs are found, look for the first one from that is compatible
+      # with the desired rails version starting from the end
+      specs.reverse.each do |spec|
+        if spec_compatible_with_rails?(specification: spec, rails_version: rails_version).empty?
+          @latest_compatible_version = spec
+          break
+        end
+      end
     end
 
-    private def rails_gems
-      [
-        "rails",
-        "activemodel",
-        "activerecord",
-        "actionmailer",
-        "actioncable",
-        "actionpack",
-        "actionview",
-        "activejob",
-        "activestorage",
-        "activesupport",
-        "railties",
-      ]
+    def spec_compatible_with_rails?(specification: nil, rails_version: nil)
+      rails_dependencies = specification.runtime_dependencies.select {|dependency| RAILS_GEMS.include?(dependency.name) }
+
+      rails_dependencies.reject do |rails_dependency|
+        rails_dependency.requirement.satisfied_by?(Gem::Version.new(rails_version))
+      end
     end
   end
 end

data/lib/next_rails/version.rb

@@ -1,3 +1,3 @@
 module NextRails
-  VERSION = "1.0.4"
+  VERSION = "1.2.0"
 end

data/next_rails.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
   spec.homepage     = "https://github.com/fastruby/next_rails"
   spec.license       = "MIT"
 
-  spec.required_ruby_version = ">= 2.3.0"
+  spec.required_ruby_version = ">= 2.0"
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
@@ -25,9 +25,10 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "colorize", ">= 0.8.1"
   spec.add_development_dependency "bundler", ">= 1.16", "< 3.0"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "simplecov", "~> 0.17.1"
   spec.add_development_dependency "timecop", "~> 0.9.1"
-  spec.add_development_dependency "actionview", "< 6.0"
+  spec.add_development_dependency "rexml", "3.1.7.3" # limited on purpose, new versions don't work with old rubies
+  spec.add_development_dependency "webmock", "3.14.0" # limited on purpose, new versions don't work with old rubies
 end

data/pull_request_template.md

@@ -0,0 +1,9 @@
+**IMPORTANT**: Please read the README before submitting pull requests for this project. Additionally, if your PR closes any open GitHub issues, make sure you include Closes #XXXX in your comment or use the option on the PR's sidebar to add related issues to auto-close the issue that your PR fixes.
+
+- [ ] Add an entry to `CHANGELOG.md` that links to this PR under the "main (unreleased)" heading.
+
+Description:
+
+Please include a summary of the change and which issue is fixed or which feature is introduced. If changes to the behavior are made, clearly describe what changes.
+
+I will abide by the [code of conduct](https://github.com/fastruby/next_rails/blob/main/CODE_OF_CONDUCT.md).

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: next_rails
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.2.0
 platform: ruby
 authors:
 - Ernesto Tagwerker
 - Luis Sagastume
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-04-09 00:00:00.000000000 Z
+date: 2022-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -49,16 +49,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -102,19 +102,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.9.1
 - !ruby/object:Gem::Dependency
-  name: actionview
+  name: rexml
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: 3.1.7.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.1.7.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: 3.14.0
 description: A set of handy tools to upgrade your Rails application and keep it up
   to date
 email:
@@ -126,13 +140,21 @@ executables:
 - gem-next-diff
 - next
 - next.sh
+- next_rails
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/ISSUE_TEMPLATE/bug_report.md"
+- ".github/ISSUE_TEMPLATE/feature_request.md"
+- ".github/dependabot.yml"
+- ".github/workflows/main.yml"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
 - CHANGELOG.md
+- CODEOWNERS
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -145,17 +167,19 @@ files:
 - exe/gem-next-diff
 - exe/next
 - exe/next.sh
+- exe/next_rails
 - lib/deprecation_tracker.rb
 - lib/next_rails.rb
 - lib/next_rails/bundle_report.rb
 - lib/next_rails/gem_info.rb
 - lib/next_rails/version.rb
 - next_rails.gemspec
+- pull_request_template.md
 homepage: https://github.com/fastruby/next_rails
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -163,15 +187,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
-signing_key:
+rubygems_version: 3.1.6
+signing_key: 
 specification_version: 4
 summary: A toolkit to upgrade your next Rails application
 test_files: []