appraisal-run 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3fe2d0f598707dfac6d652a257c8883cca3eca8910d474e1cc2026114e78f8b4
+  data.tar.gz: b066f980ee3c24962243ffe99764a645343795e840b2aac9f0b18c03376abbf6
+SHA512:
+  metadata.gz: 90a3709daabb49372375756dab532f34cccb9bcd6f621a353509b935ad3e8ce7d6c73e27d009b9d67e7fb563ab3a99ed58a537a73ecf8f4595e09ccb1bc1651f
+  data.tar.gz: 07a579fffd8afcd4378e12533e27b741b498bc3c17aa3ee763f0ffc750d25bbfa0c8a9d5ede639904015ed359959dbfac3e9f12802c2b9680ed4c2e1ea4a9169

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0
+
+* Birthday!

data/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "debug"
+  gem "rake"
+end
+
+group :test do
+  gem "rspec"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Cameron Dutro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+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 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.

data/README.md

@@ -0,0 +1,55 @@
+## appraisal-run
+
+Builds individual Docker containers from each of your gemfiles and runs the given command.
+
+## Intro
+
+appraisal-run is a super simple CLI tool for running commands inside Docker containers. It's designed to operate across multiple gemfiles, such as the ones produced by the [Appraisal](https://github.com/thoughtbot/appraisal) tool.
+
+Appraisal doesn't really have a way to run commands across all your gemfiles. It can _install_ gems from each gemfile, but often you need to specify a version of Ruby as well. Appraisal does not come with a mechanism for running installs across multiple versions of Ruby. That's where appraisal-run comes in.
+
+## Usage
+
+The following examples use the following Appraisal file:
+
+```ruby
+appraise 'rails-7.2' do
+  ruby '~> 3.3'
+  gem 'rails', '~> 7.2.0'
+end
+
+appraise 'rails-8.0' do
+  ruby '~> 3.4'
+  gem 'rails', '~> 8.0.0'
+end
+```
+
+Use the `ruby` gemfile method to lock each generated gemfile to a particular version of Ruby. If no ruby version is specified, appraisal-run will use the version of the currently running ruby executable.
+
+After running `appraisal generate`, there should be two gemfiles in the gemfiles/ directory.
+
+Make sure you have [Docker](https://www.docker.com/) (or [Podman](https://podman.io/)) installed. If you're using Podman, make sure you have the Docker compatibility settings turned on so the `docker` executable is available.
+
+Finally, install appraisal-run by adding it to your gemfile or installing it via `gem install`, and run it like so:
+
+```
+appraisal-run gemfiles/*.gemfile -- bundle exec rake
+```
+
+The appraisal-run executable accepts a list of gemfile paths as arguments. The command to run in each container is specified after an `--` argument separator.
+
+appraisal-run will iterate over each gemfile and:
+
+1. pull the Docker image for the appropriate version of Ruby.
+1. run `bundle install` inside a new container. Gems from the bundle are installed into vendor/bundle so they can be re-used across invocations.
+1. run the specified command.
+
+appraisal-run mounts the current working directory inside the container so it has access to your project's code, tests, etc.
+
+## License
+
+Licensed under the MIT license. See LICENSE for details.
+
+## Authors
+
+* Cameron C. Dutro: http://github.com/camertron

data/Rakefile

@@ -0,0 +1,4 @@
+require "bundler"
+require "rubygems/package_task"
+
+Bundler::GemHelper.install_tasks

data/appraisal-run.gemspec

@@ -0,0 +1,17 @@
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require "appraisal-run/version"
+
+Gem::Specification.new do |s|
+  s.name     = "appraisal-run"
+  s.version  = ::AppraisalRun::VERSION
+  s.authors  = ["Cameron Dutro"]
+  s.email    = ["camertron@gmail.com"]
+  s.homepage = "http://github.com/camertron/appraisal-run"
+  s.description = s.summary = "Builds individual Docker containers from each of your gemfiles and runs the given command."
+  s.platform = Gem::Platform::RUBY
+
+  s.require_path = "lib"
+  s.executables << "appraisal-run"
+
+  s.files = Dir["{lib}/**/*", "Gemfile", "LICENSE", "CHANGELOG.md", "README.md", "Rakefile", "appraisal-run.gemspec"]
+end

data/bin/appraisal-run

@@ -0,0 +1,41 @@
+#! /usr/bin/env ruby
+
+require "appraisal-run"
+
+module AppraisalRun
+  class CLI
+    def initialize(argv)
+      @argv = argv
+    end
+
+    def gemfile_paths
+      @gemfile_paths ||= begin
+        idx = @argv.index("--")
+        @argv[0...idx]
+      end
+    end
+
+    def cmd
+      @cmd ||= begin
+        idx = @argv.index("--")
+        @argv[(idx + 1)..-1].join(" ")
+      end
+    end
+
+    def run!
+      gemfile_paths.each do |gemfile_path|
+        gemfile = Gemfile.load(gemfile_path)
+        ruby_version = gemfile.ruby_version&.gsub(/[^\d\.]*/, "")
+        ruby_version ||= RUBY_VERSION
+        ruby_tag = "ruby:#{ruby_version}"
+        docker_run_prefix = "docker run --rm -t -v \"#{Dir.getwd}:/src\" -w /src -e \"BUNDLE_GEMFILE=#{gemfile_path}\" -e \"BUNDLE_PATH=/src/vendor/bundle\" #{ruby_tag} "
+
+        system("docker pull #{ruby_tag}")
+        system("#{docker_run_prefix} bundle install")
+        system("#{docker_run_prefix} #{cmd}")
+      end
+    end
+  end
+end
+
+AppraisalRun::CLI.new(ARGV).run!

data/lib/appraisal-run/gemfile.rb

@@ -0,0 +1,44 @@
+require 'set'
+
+module AppraisalRun
+  class Gemfile
+    def self.load(gemfile_path)
+      new(gemfile_path)
+    end
+
+    attr_reader :ruby_version
+
+    def initialize(gemfile_path)
+      @gemfile_path = gemfile_path
+      instance_eval(File.read(gemfile_path), gemfile_path, 0)
+    end
+
+    def ruby(version)
+      @ruby_version = version
+    end
+
+    # this is probably the wrong thing to do
+    def git_source(*)
+    end
+
+    def gem(*)
+    end
+
+    def path(*)
+    end
+
+    def source(*)
+    end
+
+    def group(*)
+    end
+
+    def gemspec(*)
+    end
+
+    def eval_gemfile(path)
+      path = File.expand_path(path)
+      instance_eval(File.read(path), path, 0)
+    end
+  end
+end

data/lib/appraisal-run/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AppraisalRun
+  VERSION = "1.0.0"
+end

data/lib/appraisal-run.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AppraisalRun
+  autoload :Gemfile, "appraisal-run/gemfile"
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: appraisal-run
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Cameron Dutro
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Builds individual Docker containers from each of your gemfiles and runs
+  the given command.
+email:
+- camertron@gmail.com
+executables:
+- appraisal-run
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- appraisal-run.gemspec
+- bin/appraisal-run
+- lib/appraisal-run.rb
+- lib/appraisal-run/gemfile.rb
+- lib/appraisal-run/version.rb
+homepage: http://github.com/camertron/appraisal-run
+licenses: []
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Builds individual Docker containers from each of your gemfiles and runs the
+  given command.
+test_files: []