gembrew 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cea714943b01c87fdc8175f290093cb509dc6df00eb84fb5081cda8db9714e8c
-  data.tar.gz: 3255bb06ae22d87e2a6f81e7cab6484cf6ac2fe832e881b53bde0b9c95e4be78
+  metadata.gz: 1b5f610bdf10a353ade54ab13743f154b56d0af7e5aceac0d6b3364135520f97
+  data.tar.gz: dd0daaec17e0f724b80f477b0f2c0ab68e5e02ebfef7248ca5cb8a4cd1164390
 SHA512:
-  metadata.gz: fc656e03acea77d7b449b4985cdf18a6f8fea25bce6c3f14df19c145a6d38e86059c02dc43e572ce776fcda64d6f2154bcc8c23d9de791b42aed87ed775e1795
-  data.tar.gz: 981ce3693cced89e212da3ab775ffef24875b8128a63e32ef9d32be123bbf9d24fe6d20c4648df8f50543c27b548bf8f6e0ad451cbe76032ea3b886730a1b2d8
+  metadata.gz: 6a09ac710d80edfb925b6e8935df241c05b3cec090f9ae21c24fb19ab9b0d7fcb04ef867c8b6959303e4d276d00f82acfe65b1d31acf40d3eb81c030a6567ca6
+  data.tar.gz: a458d322068a01abbb692df5919efb9be8bec07edcf1e518d569bfa019befde0dd3d03e7916b7656f831de5a6391b7b402ab47b47ffc1a749bf610fc2aa92fdb

data/README.md

@@ -20,38 +20,51 @@ gembrew build
 gembrew check
 ```
 
-`init` creates a tap repository containing `README.md`, `gembrew/`, and
-`Formula/`. It accepts an empty directory or an existing tap containing
-`Formula/`. Supplying a gem name also creates its first configuration. The gem
-name is optional, so `gembrew init` can prepare an empty tap or add Gembrew to
-an existing one. An existing `README.md` is never overwritten.
+`init` creates a tap repository containing `README.md`, `gembrew/`, `Formula/`,
+and a GitHub Actions workflow that uses Homebrew's `test-bot` on Linux, Apple
+Silicon, and Intel macOS. Pull requests test changed formulae; pushes, scheduled
+runs, and manual runs test every formula. It accepts an empty directory or an
+existing tap containing `Formula/`.
+Supplying a gem name also creates its first configuration. The gem name is
+optional, so `gembrew init` can prepare an empty tap or add Gembrew to an
+existing one. Existing README and workflow files are never overwritten.
 
 For example, `gembrew init example` generates:
 
 ```text
 README.md
+.github/
+  workflows/
+    test.yml
 gembrew/
-  example.yml
+  example/
+    formula.yml
+    test.rb
 Formula/
 ```
 
-`gembrew/example.yml` contains:
+`gembrew/example/formula.yml` contains the gem metadata and source:
 
 ```yaml
 gem: example
+version: "" # required
+source:
+  type: rubygems
+```
+
+`gembrew/example/test.rb` contains the generated default test:
 
-test: |-
-  system bin/"example", "--version"
+```ruby
+system bin/"example", "--version"
 ```
 
-Edit the configuration as needed, then generate `Formula/example.rb`:
+Edit these files as needed, then generate `Formula/example.rb`:
 
 ```shell
 gembrew build
 ```
 
-Each YAML file under `gembrew/` describes one formula. Add more published gems
-with:
+Each directory under `gembrew/` describes one formula. Add more published gems with:
 
 ```shell
 gembrew add another-gem
@@ -64,15 +77,15 @@ generate just one:
 gembrew build example
 ```
 
-The required settings are `gem` and exactly one of `test` or `test_from_file`.
+The required settings in `formula.yml` are `gem`, `version`, and `source`.
 The output defaults to `Formula/NAME.rb`, where `NAME` is the configuration
-filename. Relative paths are resolved from the tap root.
+directory name. Relative output paths are resolved from the tap root.
 
 ```yaml
 gem: example
-
-# Optional published gem version. The latest stable version is used by default.
 version: "1.2.3"
+source:
+  type: rubygems
 
 # Optional gem metadata overrides:
 desc: Example command-line application
@@ -80,16 +93,47 @@ homepage: https://example.com
 license: MIT
 executable: example
 
-# Optional output override. The default for gembrew/example.yml is shown here.
+# Optional additional Homebrew formula dependencies:
+dependencies:
+  - bash
+  - bash :macos_only
+  - libffi :system_on_macos
+
+# Optional output override. The default for gembrew/example is shown here.
 output: Formula/example.rb
+```
+
+Tag a dependency with `:system_on_macos` when macOS provides it and Homebrew
+should install its formula only on other platforms. Tag it with `:macos_only`
+when Homebrew should install it only on macOS.
 
-test: |-
-  system bin/"example", "--version"
+You may add these optional Ruby hook files beside `formula.yml`:
 
-# Use this instead of `test` to load the test body from another file:
-# test_from_file: support/test.rb
+```text
+install_extra.rb  Runs after the standard gem installation
+test.rb           Defines the formula test
 ```
 
+Gembrew generates a basic `COMMAND --version` test when `test.rb` is absent.
+`gembrew init GEM` and `gembrew add GEM` create that test file so it can be
+replaced with a meaningful functional test. Gembrew inserts `install_extra.rb`
+at the end of the formula's `install` method, after installing the gem and
+creating its executable wrapper.
+
+To build the root gem from a GitHub tag while continuing to fetch its
+dependencies from RubyGems, use:
+
+```yaml
+source:
+  type: github
+  repo: owner/repository
+  # tag: v1.2.3
+  # gemspec: example.gemspec
+```
+
+The tag defaults to `vVERSION`; the gemspec path defaults to
+`GEMNAME.gemspec`.
+
 Gembrew resolves the generic Ruby dependency graph and generates a Homebrew
 `resource` for every runtime dependency. Original `.gem` archives are reused
 from RubyGems' local cache when available. Downloaded archives are retained in
@@ -105,14 +149,16 @@ The repository is mounted as a local tap, so formulae can be addressed by gem
 name inside the shell:
 
 ```shell
-brew style example
-brew audit --new --online example
-brew install --build-from-source example
-brew test example
+brew style gembrew/tap/example
+brew audit --new --online gembrew/tap/example
+brew install --build-from-source gembrew/tap/example
+brew test gembrew/tap/example
+brew linkage --test gembrew/tap/example
 ```
 
-To test a published tap without mounting the local repository, open a pristine
-Homebrew shell:
+To use a stock, current Homebrew container without mounting the local
+repository or changing Homebrew's update, API, or cleanup behavior, open a
+pristine shell:
 
 ```shell
 gembrew shell --pristine
@@ -125,9 +171,10 @@ gembrew check
 ```
 
 This rebuilds every configured formula, then runs Homebrew style, online audit,
-source installation, and the formula test in disposable Homebrew containers.
-Use `gembrew check example` to check only one formula. Gembrew invokes Docker
-directly; the tap does not need generated container support files.
+source installation, the formula test, and linkage validation in disposable
+Homebrew containers. Use `gembrew check example` to check only one formula.
+Gembrew invokes Docker directly; the tap does not need generated container
+support files.
 
 ## Contributing / Support
 

data/lib/gembrew/adder.rb

@@ -18,18 +18,22 @@ module Gembrew
         raise Error, "Directory is not a Homebrew tap: #{project_path} (Formula/ does not exist)"
       end
 
-      config_directory.mkpath
-      raise Error, "Gem configuration already exists: #{config_path}" if config_path.exist?
+      gembrew_directory.mkpath
+      raise Error, "Gem configuration already exists: #{config_directory}" if config_directory.exist?
 
+      config_directory.mkpath
       config_path.write render
-      config_path
+      test_path.write %[system bin/"#{gem_name}", "--version"\n]
+      config_directory
     end
 
   private
 
     def formula_path = project_path/'Formula'
-    def config_directory = project_path/'gembrew'
-    def config_path = config_directory/"#{gem_name}.yml"
+    def gembrew_directory = project_path/'gembrew'
+    def config_directory = gembrew_directory/gem_name
+    def config_path = config_directory/'formula.yml'
+    def test_path = config_directory/'test.rb'
 
     def render
       template = Pathname(__dir__)/'templates/gembrew.yml.erb'

data/lib/gembrew/commands/build.rb

@@ -4,7 +4,7 @@ require 'gembrew/generator'
 module Gembrew
   module Commands
     class Build < MisterBin::Command
-      help 'Generate Homebrew formulae from gembrew/*.yml'
+      help 'Generate Homebrew formulae from gembrew/*/formula.yml'
 
       usage 'gembrew build [GEM]'
       usage 'gembrew build (-h|--help)'

data/lib/gembrew/commands/shell.rb

@@ -9,7 +9,7 @@ module Gembrew
       usage 'gembrew shell [--pristine]'
       usage 'gembrew shell (-h|--help)'
 
-      option '-p --pristine', 'Open without mounting the local tap'
+      option '-p --pristine', 'Open a stock, current Homebrew container'
 
       def run
         DockerShell.new.call pristine: args['--pristine']

data/lib/gembrew/config.rb

@@ -4,16 +4,23 @@ require 'gembrew/error'
 
 module Gembrew
   class Config
+    Dependency = Data.define(:name, :tags) do
+      def system_on_macos? = tags.include? :system_on_macos
+      def macos_only? = tags.include? :macos_only
+    end
+
+    DEPENDENCY_TAGS = %w[:macos_only :system_on_macos].freeze
     DIRECTORY = 'gembrew'
+    FILENAME = 'formula.yml'
     ALLOWED_KEYS = %w[
-      gem version output desc homepage license executable test test_from_file
+      gem version source output desc homepage license executable dependencies
     ].freeze
 
     attr_reader :path, :project_path
 
     def self.all(project_path = Pathname.pwd)
       project_path = Pathname(project_path).expand_path
-      paths = (project_path/DIRECTORY).glob('*.yml').sort
+      paths = (project_path/DIRECTORY).glob("*/#{FILENAME}").sort
       raise Error, "No gem configurations found in #{project_path/DIRECTORY}" if paths.empty?
 
       paths.map { |path| new path, project_path: project_path }
@@ -22,7 +29,7 @@ module Gembrew
     def self.find(name, project_path = Pathname.pwd)
       validate_name! name
       project_path = Pathname(project_path).expand_path
-      new project_path/DIRECTORY/"#{name}.yml", project_path: project_path
+      new project_path/DIRECTORY/name/FILENAME, project_path: project_path
     end
 
     def self.validate_name!(name)
@@ -38,26 +45,27 @@ module Gembrew
       validate
     end
 
-    def name = path.basename('.yml').to_s
+    def name = path.dirname.basename.to_s
     def gem_name = data.fetch('gem').to_s
     def version = data['version']&.to_s
+    def source = data.fetch('source')
+    def source_type = source.fetch('type')
+    def source_repo = source['repo']
+    def source_tag = source['tag'] || "v#{version}"
+    def source_gemspec = source['gemspec'] || "#{gem_name}.gemspec"
     def output_path = (project_path/(data['output'] || "Formula/#{name}.rb")).expand_path
     def description = data['desc']
     def homepage = data['homepage']
     def license = data['license']
     def executable = data['executable']
 
-    def test_body
-      @test_body ||= if data.has_key?('test')
-        data.fetch('test').to_s
-      else
-        test_path = project_path/data.fetch('test_from_file')
-        raise Error, "Test file does not exist: #{test_path}" unless test_path.file?
-
-        test_path.read
-      end
+    def dependencies
+      @dependencies ||= data.fetch('dependencies', []).map { |value| parse_dependency value }
     end
 
+    def install_extra_body = hook_body 'install_extra.rb'
+    def test_body = hook_body 'test.rb'
+
   private
 
     attr_reader :data
@@ -77,15 +85,87 @@ module Gembrew
       raise Error, "Unknown configuration keys: #{unknown_keys.join(', ')}" if unknown_keys.any?
 
       require_value 'gem'
-
-      return unless data.has_key?('test') == data.has_key?('test_from_file')
-
-      raise Error, 'Provide exactly one of test or test_from_file'
+      require_value 'version'
+      require_value 'source'
+      validate_source
+      validate_dependencies
     end
 
     def require_value(key)
       value = data[key]
       raise Error, "#{key} is required" if value.nil? || value.to_s.empty?
     end
+
+    def validate_source
+      raise Error, 'source must be a mapping' unless source.is_a?(Hash)
+
+      validate_source_keys
+      case source['type']&.to_s
+      when 'rubygems' then validate_rubygems_source
+      when 'github' then validate_github_source
+      else raise Error, 'source.type must be github or rubygems'
+      end
+    end
+
+    def validate_source_keys
+      unknown_keys = source.keys - %w[type repo tag gemspec]
+      raise Error, "Unknown source keys: #{unknown_keys.join(', ')}" if unknown_keys.any?
+    end
+
+    def validate_rubygems_source
+      extra_keys = source.keys - ['type']
+      raise Error, "source.#{extra_keys.first} is only valid for GitHub sources" if extra_keys.any?
+    end
+
+    def validate_github_source
+      repo = source['repo']&.to_s
+      raise Error, 'source.repo is required for GitHub sources' if repo.nil? || repo.empty?
+      raise Error, 'source.repo must be in owner/repository form' unless repo.match?(%r{\A[^/\s]+/[^/\s]+\z})
+
+      validate_relative_source_path 'gemspec' if source.has_key?('gemspec')
+      raise Error, 'source.tag must not be empty' if source.has_key?('tag') && source['tag'].to_s.empty?
+    end
+
+    def validate_relative_source_path(key)
+      value = source[key].to_s
+      path = Pathname(value)
+      valid = !value.empty? && !path.absolute? && path.each_filename.none?('..')
+      raise Error, "source.#{key} must be a relative path within the archive" unless valid
+    end
+
+    def validate_dependencies
+      return unless data.has_key?('dependencies')
+
+      raise Error, 'dependencies must be a sequence' unless data['dependencies'].is_a?(Array)
+
+      dependencies
+      names = dependencies.map(&:name)
+      duplicate = names.find { |name| names.count(name) > 1 }
+      raise Error, "dependency #{duplicate.inspect} is specified more than once" if duplicate
+    end
+
+    def parse_dependency(value)
+      raise Error, 'each dependency must be a name followed by optional tags' unless value.is_a?(String)
+
+      values = value.split
+      name = values.shift
+      unless name && !name.start_with?(':')
+        raise Error, 'dependency name must be a non-empty string'
+      end
+
+      invalid_tag = values.find { |tag| !tag.is_a?(String) || !DEPENDENCY_TAGS.include?(tag) }
+      raise Error, "unknown dependency tag: #{invalid_tag.inspect}" if invalid_tag
+      raise Error, "dependency #{name.inspect} has duplicate tags" unless values.uniq.length == values.length
+
+      Dependency.new(name:, tags: values.map { |tag| tag.delete_prefix(':').to_sym }.freeze)
+    end
+
+    def hook_body(filename)
+      hook_path = path.dirname/filename
+      return unless hook_path.file?
+
+      body = hook_path.read
+      body unless body.strip.empty?
+    end
   end
 end

data/lib/gembrew/docker_check.rb

@@ -24,14 +24,17 @@ module Gembrew
       <<~BASH
         caption() { printf '\\n\\033[1;34m==> gembrew: %s\\033[0m\\n' "$1"; }
         formula=#{formula}
+        qualified_formula="gembrew/tap/$formula"
         caption "styling $formula"
-        brew style "$formula"
+        brew style "$qualified_formula"
         caption "auditing $formula"
-        brew audit --new --online "$formula"
+        brew audit --new --online "$qualified_formula"
         caption "installing $formula"
-        brew install --build-from-source "$formula"
+        brew install --build-from-source "$qualified_formula"
         caption "testing $formula"
-        brew test "$formula"
+        brew test "$qualified_formula"
+        caption "checking linkage for $formula"
+        brew linkage --test "$qualified_formula"
       BASH
     end
   end

data/lib/gembrew/docker_runner.rb

@@ -14,6 +14,7 @@ module Gembrew
 
     def call(*command, interactive: false, pristine: false)
       docker_command = ['docker', 'run', '--rm', '--init', '--name', container_name]
+      docker_command << '--pull=always' if pristine
       docker_command << '-it' if interactive
       docker_command.concat environment(interactive: interactive, pristine: pristine)
       unless pristine
@@ -31,11 +32,15 @@ module Gembrew
     attr_reader :command_runner
 
     def environment(interactive:, pristine:)
-      result = %w[
-        --env HOMEBREW_NO_AUTO_UPDATE=1
-        --env HOMEBREW_NO_INSTALL_CLEANUP=1
-        --env HOMEBREW_NO_INSTALL_FROM_API=1
-      ]
+      result = if pristine
+        []
+      else
+        %w[
+          --env HOMEBREW_NO_AUTO_UPDATE=1
+          --env HOMEBREW_NO_INSTALL_CLEANUP=1
+          --env HOMEBREW_NO_INSTALL_FROM_API=1
+        ]
+      end
       prompt = pristine ? 'homebrew' : 'gembrew'
       result.push '--env', "PS1=\\n\\n#{prompt} $ " if interactive
       result

data/lib/gembrew/generator.rb

@@ -11,7 +11,7 @@ module Gembrew
     end
 
     def call
-      resolution = resolver.resolve(config.gem_name, config.version)
+      resolution = resolver.resolve(config.gem_name, config.version, source: config.source)
       output_path = config.output_path
       output_path.dirname.mkpath
       output_path.write renderer.render(formula_data(resolution))
@@ -35,14 +35,30 @@ module Gembrew
 
     def metadata(spec)
       {
-        description: config.description || spec.summary,
-        homepage:    config.homepage || inferred_homepage(spec),
-        license:     config.license || spec.license || spec.licenses.first,
-        executable:  config.executable || spec.executables.first || spec.name,
-        test_body:   config.test_body,
+        description:        config.description || spec.summary,
+        homepage:           config.homepage || inferred_homepage(spec),
+        license:            config.license || spec.license || spec.licenses.first,
+        executable:         executable(spec),
+        source_type:        config.source_type,
+        source_repo:        config.source_repo,
+        source_tag:         config.source_tag,
+        source_gemspec:     config.source_gemspec,
+        dependencies:       formula_dependencies,
+        install_extra_body: config.install_extra_body,
+        test_body:          config.test_body || %[system bin/#{executable(spec).inspect}, "--version"\n],
       }
     end
 
+    def executable(spec)
+      config.executable || spec.executables.first || spec.name
+    end
+
+    def formula_dependencies
+      ([Config::Dependency.new(name: 'ruby', tags: [])] + config.dependencies)
+        .uniq(&:name)
+        .sort_by(&:name)
+    end
+
     def formula_name(gem_name)
       gem_name.split(/[-_]/).map(&:capitalize).join
     end

data/lib/gembrew/github_archive_store.rb

@@ -0,0 +1,51 @@
+require 'fileutils'
+require 'open3'
+require 'pathname'
+require 'gembrew/error'
+require 'gembrew/reporter'
+
+module Gembrew
+  class GithubArchiveStore
+    def initialize(cache_path:, reporter: Reporter.new, command_runner: nil)
+      @cache_path = Pathname(cache_path)
+      @reporter = reporter
+      @command_runner = command_runner || method(:run_command)
+      @cache_path.mkpath
+    end
+
+    def fetch(repository, tag)
+      name = repository.tr '/', '-'
+      path = @cache_path/"#{name}-#{tag.tr '/', '-'}.tar.gz"
+      if path.file? && !path.empty?
+        reporter.archive :github_cache, repository, tag
+        return path
+      end
+
+      reporter.archive :downloading, repository, tag
+      url = "https://github.com/#{repository}/archive/refs/tags/#{tag}.tar.gz"
+      command_runner.call 'curl', '--fail', '--location', '--silent', '--show-error',
+        '--output', path.to_s, url, chdir: @cache_path
+      raise Error, "GitHub archive is empty: #{url}" unless path.file? && !path.empty?
+
+      path
+    end
+
+    def extract(archive, destination)
+      destination = Pathname(destination)
+      destination.mkpath
+      command_runner.call 'tar', '-xzf', archive.to_s, '-C', destination.to_s, chdir: destination
+      destination
+    end
+
+  private
+
+    attr_reader :reporter, :command_runner
+
+    def run_command(*command, chdir:)
+      result, status = Open3.capture2e(*command, chdir: chdir.to_s)
+      raise Error, result unless status.success?
+
+      result
+    end
+  end
+end

data/lib/gembrew/initializer.rb

@@ -20,6 +20,8 @@ module Gembrew
       formula_path.mkpath
       config_directory.mkpath
       readme_path.write render_readme unless readme_path.exist?
+      workflow_path.dirname.mkpath
+      workflow_path.write workflow_template.read unless workflow_path.exist?
       Adder.new(gem_name, project_path: project_path).call if gem_name
 
       project_path
@@ -39,6 +41,14 @@ module Gembrew
       project_path/'README.md'
     end
 
+    def workflow_path
+      project_path/'.github/workflows/test.yml'
+    end
+
+    def workflow_template
+      Pathname(__dir__)/'templates/test.yml'
+    end
+
     def entries
       @entries ||= project_path.children.reject { |path| path.basename.to_s == '.git' }
     end

data/lib/gembrew/reporter.rb

@@ -7,6 +7,7 @@ module Gembrew
     LABELS = {
       rubygems_cache: ['g', 'RubyGems cache'],
       gembrew_cache:  ['g', 'Gembrew cache'],
+      github_cache:   ['g', 'GitHub cache'],
       downloading:    %w[y Downloading],
     }.freeze
 

data/lib/gembrew/resolver.rb

@@ -6,6 +6,7 @@ require 'rubygems/package'
 require 'tmpdir'
 require 'gembrew/archive_store'
 require 'gembrew/error'
+require 'gembrew/github_archive_store'
 require 'gembrew/reporter'
 
 module Gembrew
@@ -15,21 +16,22 @@ module Gembrew
   class Resolver
     attr_reader :cache_root
 
-    def initialize(cache_root: nil, reporter: Reporter.new, command_runner: nil, archive_store: nil)
+    def initialize(cache_root: nil, reporter: Reporter.new, command_runner: nil, archive_store: nil,
+                   github_archive_store: nil)
       @cache_root = Pathname(cache_root || default_cache_root)
       @reporter = reporter
       @command_runner = command_runner || method(:run_command)
       @archive_store = archive_store || ArchiveStore.new(
         cache_path: @cache_root/'gems', reporter: reporter, command_runner: @command_runner
       )
+      @github_archive_store = github_archive_store
       temporary_root.mkpath
     end
 
-    def resolve(name, version = nil)
+    def resolve(name, version, source:)
       Dir.mktmpdir('build-', temporary_root.to_s) do |directory|
         temporary = Pathname(directory)
-        root_archive = archive_store.fetch(name, version, temporary)
-        root_spec = Gem::Package.new(root_archive.to_s).spec
+        root_archive, root_spec = root_source name, version, source, temporary
         dependencies = dependency_specs(lock(root_spec, temporary), root_spec)
 
         reporter.collecting dependencies.length
@@ -45,6 +47,57 @@ module Gembrew
 
     attr_reader :reporter, :command_runner, :archive_store
 
+    def github_archive_store
+      @github_archive_store ||= GithubArchiveStore.new(
+        cache_path: cache_root/'github', reporter: reporter, command_runner: command_runner
+      )
+    end
+
+    def root_source(name, version, source_config, temporary)
+      return rubygems_root_source(name, version, temporary) if source_config.fetch('type') == 'rubygems'
+
+      github_root_source name, version, source_config, temporary
+    end
+
+    def rubygems_root_source(name, version, temporary)
+      archive = archive_store.fetch(name, version, temporary)
+      [archive, Gem::Package.new(archive.to_s).spec]
+    end
+
+    def github_root_source(name, version, source_config, temporary)
+      repository = source_config.fetch('repo')
+      tag = source_config['tag'] || "v#{version}"
+      gemspec_path = source_config['gemspec'] || "#{name}.gemspec"
+      archive = github_archive_store.fetch repository, tag
+      root = github_project_root archive, temporary
+      spec = load_github_spec root/gemspec_path, gemspec_path
+      validate_github_spec spec, name, version
+
+      [archive, spec]
+    end
+
+    def github_project_root(archive, temporary)
+      extracted = github_archive_store.extract archive, temporary/'source'
+      roots = extracted.children.select(&:directory?)
+      raise Error, 'Expected one project directory in the GitHub archive' unless roots.one?
+
+      roots.first
+    end
+
+    def load_github_spec(gemspec, gemspec_path)
+      raise Error, "Gemspec not found in GitHub archive: #{gemspec_path}" unless gemspec.file?
+
+      spec = Dir.chdir(gemspec.dirname) { Gem::Specification.load(gemspec.basename.to_s) }
+      raise Error, "Could not load gemspec from GitHub archive: #{gemspec_path}" unless spec
+
+      spec
+    end
+
+    def validate_github_spec(spec, name, version)
+      raise Error, "Gemspec name #{spec.name} does not match configured gem #{name}" unless spec.name == name
+      raise Error, "GitHub gemspec version #{spec.version} does not match #{version}" unless spec.version == Gem::Version.new(version)
+    end
+
     def resource(spec, temporary, index, total)
       archive = archive_store.fetch spec.name, spec.version, temporary, index: index, total: total
       Resource.new spec.name, spec.version.to_s, Digest::SHA256.file(archive).hexdigest
@@ -62,10 +115,11 @@ module Gembrew
     def lock(root_spec, temporary)
       gemfile = temporary/'Gemfile'
       lockfile = temporary/'Gemfile.lock'
-      gemfile.write <<~RUBY
-        source "https://rubygems.org"
-        gem #{root_spec.name.inspect}, "= #{root_spec.version}"
-      RUBY
+      dependencies = root_spec.runtime_dependencies.map do |dependency|
+        requirements = dependency.requirement.requirements.map { |operator, version| "#{operator} #{version}" }
+        "gem #{dependency.name.inspect}, #{requirements.map(&:inspect).join(', ')}"
+      end
+      gemfile.write([[%[source "https://rubygems.org"]], dependencies, ['']].flatten.join("\n"))
 
       reporter.resolving root_spec.name, root_spec.version
       command_runner.call(

data/lib/gembrew/templates/README.md.erb

@@ -23,6 +23,11 @@ Install [Gembrew](https://github.com/DannyBen/gembrew):
 gem install gembrew
 ```
 
+The generated GitHub Actions workflow uses Homebrew's `test-bot` on Linux,
+Apple Silicon, and Intel macOS. Pull requests test changed formulae; pushes,
+and manual runs test every formula. Homebrew style checks apply only to files in
+`Formula/`; Gembrew's Ruby hook files are not standalone Homebrew formulae.
+
 Generate all formulae:
 
 ```shell
@@ -48,6 +53,14 @@ Add another Ruby gem:
 gembrew add another-gem
 ```
 
+Each gem has a `gembrew/NAME/formula.yml` configuration. You may add these
+optional Ruby hook files beside it:
+
+```text
+install_extra.rb  Runs after the standard gem installation
+test.rb           Defines the formula test
+```
+
 Open an interactive Homebrew environment:
 
 ```shell

data/lib/gembrew/templates/formula.rb.erb

@@ -1,16 +1,34 @@
-# Generated by Gembrew: https://github.com/dannyben/gembrew
-# Manual edits are not recommended. Update gembrew/*.yml and regenerate with:
-#   gem install gembrew
-#   gembrew build
-
 class <%= formula_name %> < Formula
   desc <%= description.inspect %>
   homepage <%= homepage.inspect %>
+<% if source_type == 'github' -%>
+  url "https://github.com/<%= source_repo %>/archive/refs/tags/<%= source_tag %>.tar.gz"
+<% else -%>
   url "https://rubygems.org/downloads/<%= gem_name %>-<%= version %>.gem"
+<% end -%>
   sha256 "<%= sha256 %>"
   license <%= license.inspect %>
 
-  depends_on "ruby"
+<% formula_dependencies = dependencies.reject { |dependency| dependency.system_on_macos? || dependency.macos_only? } -%>
+<% macos_dependencies = dependencies.select(&:system_on_macos?) -%>
+<% macos_only_dependencies = dependencies.select(&:macos_only?) -%>
+<% formula_dependencies.each do |dependency| -%>
+  depends_on <%= dependency.name.inspect %>
+<% end -%>
+<% if formula_dependencies.any? && (macos_dependencies.any? || macos_only_dependencies.any?) -%>
+
+<% end -%>
+<% macos_dependencies.each do |dependency| -%>
+  uses_from_macos <%= dependency.name.inspect %>
+<% end -%>
+<% if macos_only_dependencies.any? -%>
+
+  on_macos do
+<% macos_only_dependencies.each do |dependency| -%>
+    depends_on <%= dependency.name.inspect %>
+<% end -%>
+  end
+<% end -%>
 <% resources.each do |resource| -%>
 
   resource <%= resource.name.inspect %> do
@@ -27,13 +45,23 @@ class <%= formula_name %> < Formula
         "--ignore-dependencies", "--install-dir", libexec, "--no-document"
     end
 
+<% if source_type == 'github' -%>
+    system "gem", "build", "<%= source_gemspec %>"
+    system "gem", "install", "--ignore-dependencies", "<%= gem_name %>-#{version}.gem",
+      "--install-dir", libexec, "--no-document"
+<% else -%>
     system "gem", "install", cached_download,
       "--ignore-dependencies", "--install-dir", libexec, "--no-document"
+<% end -%>
 
     (bin/<%= executable.inspect %>).write_env_script libexec/"bin/<%= executable %>", GEM_HOME: ENV.fetch("GEM_HOME")
+<% if install_extra_body -%>
+
+<%= install_extra_body.lines(chomp: true).map { |line| line.strip.empty? ? '' : "    #{line}" }.join("\n") %>
+<% end -%>
   end
 
   test do
-<%= test_body.lines.map { |line| "    #{line}" }.join %>
+<%= test_body.lines(chomp: true).map { |line| line.strip.empty? ? '' : "    #{line}" }.join("\n") %>
   end
 end

data/lib/gembrew/templates/gembrew.yml.erb

@@ -1,14 +1,29 @@
 gem: <%= gem_name %>
+version: "" # required
 
-test: |-
-  system bin/"<%= gem_name %>", "--version"
+# Required source. Use the published RubyGem:
+source:
+  type: rubygems
 
-# Optional overrides:
-# version: "1.2.3"
+# Or replace the source above with a GitHub tag archive:
+# source:
+#   type: github
+#   repo: owner/repository          # required for GitHub
+#   tag: v1.2.3                    # optional; defaults to vVERSION
+#   gemspec: <%= gem_name %>.gemspec  # optional; defaults to GEMNAME.gemspec
+
+# Optional metadata and formula overrides:
 # desc: Example command-line application
 # homepage: https://example.com
 # license: MIT
 # executable: <%= gem_name %>
+# output: Formula/<%= gem_name %>.rb
+# dependencies:
+#   - bash
+#   - bash :macos_only
+#   - libffi :system_on_macos
 
-# To load the Homebrew test body from a Ruby file, replace `test` above with:
-# test_from_file: support/test.rb
+# Optional Ruby hook files:
+#
+#   install_extra.rb  Runs after the standard gem installation
+#   test.rb           Defines the formula test

data/lib/gembrew/templates/test.yml

@@ -0,0 +1,105 @@
+name: Test Formulae
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+  workflow_dispatch:
+
+permissions: {}
+
+defaults:
+  run:
+    shell: bash -xeuo pipefail {0}
+
+jobs:
+  test-bot:
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 60
+    container: ${{ fromJSON(toJSON(matrix.container)) }} # zizmor: ignore[unpinned-images]
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - macos-26
+          - macos-15-intel
+        include:
+          - os: ubuntu-latest
+            container:
+              image: ghcr.io/homebrew/brew:main
+              options: --privileged
+    permissions:
+      actions: read
+      checks: read
+      contents: read
+      pull-requests: read
+
+    steps:
+      - name: Set up Homebrew
+        id: set-up-homebrew
+        uses: Homebrew/actions/setup-homebrew@b35a29a0f83ee8b8ca07b219fc8db3d7bb88ab49 # 2026.08.10.2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Cache Homebrew Bundler gems
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ${{ steps.set-up-homebrew.outputs.gems-path }}
+          key: ${{ matrix.os }}-rubygems-${{ steps.set-up-homebrew.outputs.gems-hash }}
+          restore-keys: ${{ matrix.os }}-rubygems-
+
+      - name: Clean runner
+        run: brew test-bot --only-cleanup-before
+
+      - name: Set up test-bot
+        run: brew test-bot --only-setup
+
+      - name: Check tap syntax
+        run: |
+          tap="${GITHUB_REPOSITORY/homebrew-/}"
+          tap_path="${{ steps.set-up-homebrew.outputs.repository-path }}"
+          brew style "$tap_path/Formula"
+          brew readall --aliases --os=all --arch=all "$tap"
+          brew audit --except=installed --tap="$tap"
+
+      - name: Test changed formulae
+        if: github.event_name == 'pull_request'
+        run: brew test-bot --only-formulae
+
+      - name: Collect all formulae
+        id: all-formulae
+        if: github.event_name != 'pull_request'
+        run: |
+          shopt -s nullglob
+          tap_path="${{ steps.set-up-homebrew.outputs.repository-path }}"
+          paths=("$tap_path"/Formula/*.rb)
+
+          if (( ${#paths[@]} == 0 )); then
+            echo "No formulae found in $tap_path/Formula/"
+            exit 1
+          fi
+
+          formulae=()
+          for path in "${paths[@]}"; do
+            formula="${path##*/}"
+            formulae+=("${formula%.rb}")
+          done
+
+          joined=$(IFS=,; echo "${formulae[*]}")
+          echo "formulae=${joined}" >> "$GITHUB_OUTPUT"
+
+      - name: Test all formulae
+        if: github.event_name != 'pull_request'
+        run: >-
+          brew test-bot --only-formulae
+          --testing-formulae="${{ steps.all-formulae.outputs.formulae }}"
+
+      - name: Upload bottles as artifacts
+        if: always() && github.event_name == 'pull_request'
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: bottles_${{ matrix.os }}
+          path: "*.bottle.*"

data/lib/gembrew/version.rb

@@ -1,3 +1,3 @@
 module Gembrew
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/lib/gembrew.rb

@@ -6,6 +6,7 @@ require 'gembrew/docker_shell'
 require 'gembrew/docker_runner'
 require 'gembrew/error'
 require 'gembrew/generator'
+require 'gembrew/github_archive_store'
 require 'gembrew/initializer'
 require 'gembrew/reporter'
 require 'gembrew/renderer'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gembrew
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Danny Ben Shitrit
@@ -77,6 +77,7 @@ files:
 - lib/gembrew/docker_shell.rb
 - lib/gembrew/error.rb
 - lib/gembrew/generator.rb
+- lib/gembrew/github_archive_store.rb
 - lib/gembrew/initializer.rb
 - lib/gembrew/renderer.rb
 - lib/gembrew/reporter.rb
@@ -84,6 +85,7 @@ files:
 - lib/gembrew/templates/README.md.erb
 - lib/gembrew/templates/formula.rb.erb
 - lib/gembrew/templates/gembrew.yml.erb
+- lib/gembrew/templates/test.yml
 - lib/gembrew/version.rb
 homepage: https://github.com/DannyBen/gembrew
 licenses: