appraisal2 3.1.0 → 3.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f60cf90f788c79484aa1f01d218259c1cbb9459afe960a368e3de03bd84b7088
-  data.tar.gz: 8b96fc10c341d3c395e8e6c210ad4a3c98d36cc60d4e92c82ed13ce4cf774c72
+  metadata.gz: 3d481193174340b780721b42c394394bf59ec02b500763672941eb04b201ae7e
+  data.tar.gz: ad5c78564e102538e77bf3ba913488eff00617bc89cb8bf23e8bd13d2a3f6ad7
 SHA512:
-  metadata.gz: 967d0442aafbbead64cb127c57eab72ecc48f85d9d820619f6eb142ff2aaf3c7d6510bddd32c2c8f6524ea072ebfb7e7fc593719276b2f80259948aba1396c5e
-  data.tar.gz: 45bba8cce0a182a5eacb7614e0e239906d76f8905c9fe057ac8e91cdb013d17fe48e3ddd1c730b61c907c7c0f6ef1b10b42f1eab10063366a1dc72ff9cb47bbc
+  metadata.gz: acabfebc3adbd64a88022766260dd2684a0f12fbe3fc1f1b29f0f26d7754ffd16b7aa72ef718d3613601b67b3e37f0a10cc20c2063da9b37725066558e4aebbd
+  data.tar.gz: 1e715cd4474da8c8956fa1b6f6aeb542fe6c010c959f891f0bb85d62bc2bd6b757f27e6d4cfd0537062e4f563ee7111e53d8cb12fd2d48f2b9216ed770f1884c

data/CHANGELOG.md

@@ -30,6 +30,43 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.1.2] - 2026-06-11
+
+- TAG: [v3.1.2][3.1.2t]
+- COVERAGE: 90.21% -- 820/909 lines in 29 files
+- BRANCH COVERAGE: 80.71% -- 159/197 branches in 29 files
+- 42.25% documented
+
+### Added
+
+- Support for Bundlers cooldown feature (#31)
+- Added released `gem_mine` fixture-scaffold dependency wiring for acceptance
+  specs that need temporary throwaway gems.
+
+### Fixed
+
+- Cleaned up per-process scaffold roots after acceptance spec runs so generated
+  dummy gem projects do not accumulate under `tmp/spec-process-*`.
+- Isolated Git bare-repository config for acceptance specs so Bundler can use
+  its per-process local git cache on machines with stricter global Git config.
+- Corrected the gemspec public author email to use `floss@galtzo.com`.
+
+## [3.1.1] - 2026-06-06
+
+- TAG: [v3.1.1][3.1.1t]
+- COVERAGE: 90.23% -- 822/911 lines in 29 files
+- BRANCH COVERAGE: 80.51% -- 157/195 branches in 29 files
+- 42.25% documented
+
+### Added
+
+- Added the `plugin` Appraisals DSL for generator-only companion gems that
+  should be loaded while Appraisal2 generates gemfiles without being serialized
+  into generated appraisal gemfiles.
+- Added the `generator_only` root Gemfile DSL for dependencies that Bundler
+  should install in the active generator bundle but Appraisal2 should not
+  serialize into generated appraisal gemfiles.
+
 ## [3.1.0] - 2026-06-06
 
 - TAG: [v3.1.0][3.1.0t]
@@ -338,14 +375,18 @@ Please file a bug if you notice a violation of semantic versioning.
 - Initial release as a hard fork of [appraisal v3.0.0.rc1](https://github.com/thoughtbot/appraisal/commit/602cdd9b5f8cb8f36992733422f69312b172f427) with many improvements - by @pboling
   - support for `eval_gemfile`
   - support for Ruby 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6 (all removed, or planned-to-be, in thoughtbot's `appraisal`)
-    - NOTE: The [setup-ruby GH Action](https://github.com/ruby/setup-ruby) only ships support for Ruby 2.3+, so older Rubies are no longer tested in CI. Compatibility is assumed thanks to [![Enforced Code Style Linter](https://img.shields.io/badge/code_style_%26_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white)](https://github.com/rubocop-lts/rubocop-lts) enforcing the syntax for the oldest supported Ruby, which is Ruby v1.8. File a bug if you find something broken.
+    - NOTE: The [setup-ruby GH Action](https://github.com/ruby/setup-ruby) only ships support for Ruby 2.3+, so older Rubies are no longer tested in CI. Compatibility is assumed thanks to [![Enforced Code Style Linter](https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white)](https://github.com/rubocop-lts/rubocop-lts) enforcing the syntax for the oldest supported Ruby, which is Ruby v1.8. File a bug if you find something broken.
   - Support for JRuby 9.4+
   - updated and improved documentation
   - maintainability tracked with QLTY.sh and the reek gem
   - code coverage tracked with Coveralls, QLTY.sh, and the kettle-soup-cover gem
   - other minor fixes and improvements
 
-[Unreleased]: https://github.com/appraisal-rb/appraisal2/compare/v3.1.0...HEAD
+[Unreleased]: https://github.com/appraisal-rb/appraisal2/compare/v3.1.2...HEAD
+[3.1.2]: https://github.com/appraisal-rb/appraisal2/compare/v3.1.1...v3.1.2
+[3.1.2t]: https://github.com/appraisal-rb/appraisal2/releases/tag/v3.1.2
+[3.1.1]: https://github.com/appraisal-rb/appraisal2/compare/v3.1.0...v3.1.1
+[3.1.1t]: https://github.com/appraisal-rb/appraisal2/releases/tag/v3.1.1
 [3.1.0]: https://github.com/appraisal-rb/appraisal2/compare/v3.0.9...v3.1.0
 [3.1.0t]: https://github.com/appraisal-rb/appraisal2/releases/tag/v3.1.0
 [3.0.9]: https://github.com/appraisal-rb/appraisal2/compare/v3.0.8...v3.0.9

data/LICENSE.md

@@ -47,3 +47,4 @@ Choose the option that best fits your use case:
 - Copyright (c) 2024 Joe Sharp
 - Copyright (c) 2024 Sebastian Cohnen
 - Copyright (c) 2024 Yevhenii Ponomarenko
+- Copyright (c) 2026 Richard Kramer

data/README.md

@@ -62,7 +62,7 @@ Appraisal2 adds:
 | Works with MRI Ruby 4 | [![Ruby 4.0 Compat][💎ruby-4.0i]][🚎11-c-wf] [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
 | Works with MRI Ruby 3 | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]|
 | Works with MRI Ruby 2 | ![Ruby 2.0 Compat][💎ruby-2.0i] ![Ruby 2.1 Compat][💎ruby-2.1i] ![Ruby 2.2 Compat][💎ruby-2.2i] ![Ruby 2.3 Compat][💎ruby-2.3i] <br/> [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
-| Works with MRI Ruby 1 | ![Ruby 1.9 Compat][💎ruby-1.9i]|
+| Works with MRI Ruby 1 | ![Ruby 1.8 Compat][💎ruby-1.8i] ![Ruby 1.9 Compat][💎ruby-1.9i]|
 | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
 | Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
 | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
@@ -178,6 +178,47 @@ This is intended for plugin gems that need deterministic generated output, such
 as style normalization of appraisal gemfiles, without monkey-patching Appraisal2
 internals.
 
+### Generator Plugins
+
+Use `plugin` in `Appraisals` for companion gems that must be loaded while
+Appraisal2 evaluates and generates appraisal gemfiles, but must not be written
+as dependencies in the generated appraisal gemfiles.
+
+```ruby
+plugin "appraisal2-rubocop",
+  :require => "appraisal2/rubocop",
+  :optional => true
+```
+
+`plugin` requires the requested path in the active generator bundle. It does not
+call `gem`, and it is not serialized into `gemfiles/*.gemfile`. This keeps
+generator-only tooling out of appraisals that target older Rubies, while still
+allowing modern generator workflows to load hooks such as
+`Appraisal.transform_gemfile`.
+
+Set `:optional => true` when some workflows evaluate `Appraisals` without the
+plugin dependency installed. This is useful when a CI matrix uses one generator
+bundle for old-Ruby appraisals and another modern workflow provides the plugin.
+
+If the generator bundle needs dependencies that must not be copied into every
+generated appraisal gemfile, wrap those root Gemfile declarations with
+`generator_only` for Appraisal2 and leave the Bundler branch unchanged:
+
+```ruby
+if respond_to?(:generator_only)
+  generator_only do
+    eval_gemfile "gemfiles/modular/style.gemfile"
+  end
+else
+  eval_gemfile "gemfiles/modular/style.gemfile"
+end
+```
+
+Bundler evaluates the `else` branch while installing the active generator
+bundle. Appraisal2 evaluates the `generator_only` branch while parsing the root
+Gemfile, but intentionally does not serialize that block into generated
+appraisal gemfiles.
+
 ## 🔧 Basic Usage
 
 Once you've configured the appraisals you want to use, you need to install the
@@ -533,6 +574,7 @@ See [LICENSE.md][📄license] for the official copyright notice.
 - Copyright (c) 2024 Joe Sharp
 - Copyright (c) 2024 Sebastian Cohnen
 - Copyright (c) 2024 Yevhenii Ponomarenko
+- Copyright (c) 2026 Richard Kramer
 
 </details>
 
@@ -696,6 +738,7 @@ Thanks for RTFM. ☺️
 [🚎14-🔓️-wfi]: https://github.com/appraisal-rb/appraisal2/actions/workflows/unlocked_deps.yml/badge.svg
 [🚎15-🪪-wf]: https://github.com/appraisal-rb/appraisal2/actions/workflows/license-eye.yml
 [🚎15-🪪-wfi]: https://github.com/appraisal-rb/appraisal2/actions/workflows/license-eye.yml/badge.svg
+[💎ruby-1.8i]: https://img.shields.io/badge/Ruby-1.8_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
 [💎ruby-1.9i]: https://img.shields.io/badge/Ruby-1.9_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
 [💎ruby-2.0i]: https://img.shields.io/badge/Ruby-2.0_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
 [💎ruby-2.1i]: https://img.shields.io/badge/Ruby-2.1_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
@@ -750,7 +793,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.894-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.909-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/appraisal-rb/appraisal2/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
@@ -758,7 +801,7 @@ Thanks for RTFM. ☺️
 [📄license-ref]: MIT.md
 [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
 [📄license-compat]: https://www.apache.org/legal/resolved.html#category-a
-[📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-✓-259D6C.svg?style=flat&logo=Apache
+[📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
 
 [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
 [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
@@ -778,7 +821,7 @@ Thanks for RTFM. ☺️
 | Package | appraisal2 |
 | Description | 🔍️ Appraisal2 integrates with bundler and rake to test your library against different versions of dependencies in repeatable scenarios called "appraisals." |
 | Homepage | https://github.com/appraisal-rb/appraisal2 |
-| Source | https://github.com/appraisal-rb/appraisal2/tree/v3.1.0 |
+| Source | https://github.com/appraisal-rb/appraisal2/tree/v3.1.1 |
 | License | `MIT` |
 | Funding | https://github.com/sponsors/pboling, https://issuehunt.io/u/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/appraisal-rb, https://patreon.com/galtzo, https://polar.sh/pboling, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/appraisal2, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/lib/appraisal/appraisal_file.rb

@@ -41,6 +41,16 @@ module Appraisal
       Customize.new(args)
     end
 
+    def plugin(name, *args)
+      options = args.last.is_a?(Hash) ? args.last : {}
+      require_path = options.key?(:require) ? options[:require] : name
+      optional = options.key?(:optional) ? options[:optional] : false
+
+      require require_path if require_path
+    rescue LoadError
+      raise unless optional
+    end
+
     private
 
     def run(definitions)

data/lib/appraisal/bundler_dsl.rb

@@ -44,6 +44,10 @@ module Appraisal
       @eval_gemfile << [path, contents]
     end
 
+    def generator_only(&_block)
+      nil
+    end
+
     def gem(name, *requirements)
       @dependencies.add(name, substitute_git_source(requirements))
     end
@@ -72,13 +76,13 @@ module Appraisal
 
     alias_method :platform, :platforms
 
-    def source(source, &block)
+    def source(source, options = {}, &block)
       if block_given?
         @source_blocks[source] ||=
           Source.new(source).tap { |g| g.git_sources = @git_sources.dup }
         @source_blocks[source].run(&block)
       else
-        @sources << source
+        @sources << [source, options]
       end
     end
 
@@ -127,7 +131,9 @@ module Appraisal
     alias_method :eval_gemfile_entry_for_dup, :eval_gemfile_entry
 
     def source_entry
-      @sources.uniq.map { |source| "source #{source.inspect}" }.join("\n")
+      @sources.uniq.map do |(src, opts)|
+        opts.empty? ? "source #{src.inspect}" : "source #{src.inspect}, #{Utils.format_string(opts)}"
+      end.join("\n")
     end
 
     alias_method :source_entry_for_dup, :source_entry

data/lib/appraisal/version.rb

@@ -2,7 +2,7 @@
 
 module Appraisal
   module Version
-    VERSION = "3.1.0"
+    VERSION = "3.1.2"
   end
   VERSION = Version::VERSION # Traditional constant location
 end

data/lib/appraisal2/version.rb

@@ -2,7 +2,7 @@
 
 module Appraisal2
   module Version
-    VERSION = "3.1.0"
+    VERSION = "3.1.2"
   end
   VERSION = Version::VERSION # Traditional Constant Location
 end

data/lib/appraisal2.rb

@@ -1,13 +1,8 @@
 # frozen_string_literal: true
 
-require "version_gem"
 require_relative "appraisal2/version"
 
 require "appraisal/version"
 require "appraisal/task"
 
 Appraisal::Task.new
-
-Appraisal2::Version.class_eval do
-  extend VersionGem::Basic
-end

metadata

@@ -1,12 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: appraisal2
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.2
 platform: ruby
 authors:
-- Peter Boling
-- Joe Ferris
-- Prem Sichanugrist
+- Peter H. Boling
 bindir: exe
 cert_chain:
 - |
@@ -81,46 +79,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.14'
-- !ruby/object:Gem::Dependency
-  name: version_gem
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.10
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.10
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.8
+        version: 2.2.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.8
+        version: 2.2.3
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -164,7 +142,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.3
+        version: 2.0.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -174,7 +152,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.3
+        version: 2.0.5
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -184,7 +162,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.1
+        version: 3.1.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -194,7 +172,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.1
+        version: 3.1.2
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -375,7 +353,7 @@ description: "\U0001F50D️ Appraisal2 integrates with bundler and rake to test
   library against different versions of dependencies in repeatable scenarios called
   \"appraisals.\""
 email:
-- galtzo@floss.com
+- floss@galtzo.com
 executables:
 - appraisal
 extensions: []
@@ -437,10 +415,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://appraisal2.galtzo.com
-  source_code_uri: https://github.com/appraisal-rb/appraisal2/tree/v3.1.0
-  changelog_uri: https://github.com/appraisal-rb/appraisal2/blob/v3.1.0/CHANGELOG.md
+  source_code_uri: https://github.com/appraisal-rb/appraisal2/tree/v3.1.2
+  changelog_uri: https://github.com/appraisal-rb/appraisal2/blob/v3.1.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/appraisal-rb/appraisal2/issues
-  documentation_uri: https://www.rubydoc.info/gems/appraisal2/3.1.0
+  documentation_uri: https://www.rubydoc.info/gems/appraisal2/3.1.2
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/appraisal-rb/appraisal2/wiki
   news_uri: https://www.railsbling.com/tags/appraisal2