puma-release 0.1.0

data/test/unit/repo_files_test.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+class RepoFilesTest < Minitest::Test
+  def test_current_version_reads_puma_const
+    temp_repo do |repo|
+      repo.join("lib/puma/const.rb").write("PUMA_VERSION = VERSION = \"7.2.0\"\nCODE_NAME = \"On The Corner\"\n")
+      repo.join("History.md").write("## 7.2.0 / 2026-01-20\n\n* Bugfixes\n  * One thing ([#1])\n")
+      context = OpenStruct.new(version_file: repo.join("lib/puma/const.rb"), history_file: repo.join("History.md"))
+
+      assert_equal "7.2.0", PumaRelease::RepoFiles.new(context).current_version
+    end
+  end
+
+  def test_update_version_replaces_codename_for_minor_release
+    temp_repo do |repo|
+      repo.join("lib/puma/const.rb").write("PUMA_VERSION = VERSION = \"7.2.0\"\nCODE_NAME = \"On The Corner\"\n")
+      repo.join("History.md").write("")
+      context = OpenStruct.new(version_file: repo.join("lib/puma/const.rb"), history_file: repo.join("History.md"))
+
+      PumaRelease::RepoFiles.new(context).update_version!("7.3.0", "minor")
+
+      content = repo.join("lib/puma/const.rb").read
+      assert_includes content, 'PUMA_VERSION = VERSION = "7.3.0"'
+      assert_includes content, 'CODE_NAME = "INSERT CODENAME HERE"'
+    end
+  end
+
+  def test_release_name_includes_codename_for_dot_zero_releases
+    temp_repo do |repo|
+      repo.join("lib/puma/const.rb").write("PUMA_VERSION = VERSION = \"7.3.0\"\nCODE_NAME = \"Shiny New Codename\"\n")
+      repo.join("History.md").write("")
+      context = OpenStruct.new(version_file: repo.join("lib/puma/const.rb"), history_file: repo.join("History.md"))
+
+      assert_equal "v7.3.0 - Shiny New Codename", PumaRelease::RepoFiles.new(context).release_name("7.3.0")
+    end
+  end
+
+  def test_release_name_omits_codename_for_patch_releases
+    temp_repo do |repo|
+      repo.join("lib/puma/const.rb").write("PUMA_VERSION = VERSION = \"7.3.1\"\nCODE_NAME = \"Shiny New Codename\"\n")
+      repo.join("History.md").write("")
+      context = OpenStruct.new(version_file: repo.join("lib/puma/const.rb"), history_file: repo.join("History.md"))
+
+      assert_equal "v7.3.1", PumaRelease::RepoFiles.new(context).release_name("7.3.1")
+    end
+  end
+
+  def test_update_security_updates_supported_versions_for_major_release
+    temp_repo do |repo|
+      repo.join("SECURITY.md").write(<<~MD)
+        # Security Policy
+
+        ## Supported Versions
+
+        | Version       | Supported  |
+        | :------------ | :--------: |
+        | Latest release in 7.x | ✅ |
+        | Latest release in 6.x | ✅ |
+        | All other releases    | ❌ |
+
+        ## Reporting a Vulnerability
+
+        Contact [Evan Phoenix.](https://github.com/evanphx)
+      MD
+      context = OpenStruct.new(security_file: repo.join("SECURITY.md"))
+
+      PumaRelease::RepoFiles.new(context).update_security!("8.0.0")
+
+      content = repo.join("SECURITY.md").read
+      assert_includes content, "Latest release in 8.x"
+      assert_includes content, "Latest release in 7.x"
+      refute_includes content, "Latest release in 6.x"
+    end
+  end
+
+  def test_update_security_preserves_rest_of_file
+    temp_repo do |repo|
+      repo.join("SECURITY.md").write(<<~MD)
+        # Security Policy
+
+        ## Supported Versions
+
+        | Version       | Supported  |
+        | :------------ | :--------: |
+        | Latest release in 7.x | ✅ |
+        | Latest release in 6.x | ✅ |
+        | All other releases    | ❌ |
+
+        ## Reporting a Vulnerability
+
+        Contact [Evan Phoenix.](https://github.com/evanphx)
+      MD
+      context = OpenStruct.new(security_file: repo.join("SECURITY.md"))
+
+      PumaRelease::RepoFiles.new(context).update_security!("8.0.0")
+
+      content = repo.join("SECURITY.md").read
+      assert_includes content, "# Security Policy"
+      assert_includes content, "All other releases"
+      assert_includes content, "Contact [Evan Phoenix.](https://github.com/evanphx)"
+    end
+  end
+
+  def test_prepend_history_section_inserts_new_entry_and_refs
+    temp_repo do |repo|
+      repo.join("lib/puma/const.rb").write("PUMA_VERSION = VERSION = \"7.2.0\"\n")
+      repo.join("History.md").write("## 7.2.0 / 2026-01-20\n\n* Bugfixes\n  * Existing ([#1])\n\n[#1]:https://example.test/1\n")
+      context = OpenStruct.new(version_file: repo.join("lib/puma/const.rb"), history_file: repo.join("History.md"))
+
+      PumaRelease::RepoFiles.new(context).prepend_history_section!("7.2.1", "* Bugfixes\n  * New fix ([#2])", "[#2]:https://example.test/2")
+
+      updated = repo.join("History.md").read
+      assert_includes updated, "## 7.2.1 / #{Date.today.strftime("%Y-%m-%d")}"
+      assert_match(/\[#2\]:https:\/\/example\.test\/2\n\[#1\]:https:\/\/example\.test\/1/, updated)
+    end
+  end
+end

data/test/unit/run_test.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+class RunTest < Minitest::Test
+  class FakeUI
+    attr_reader :infos
+
+    def initialize
+      @infos = []
+    end
+
+    def info(message)
+      infos << message
+    end
+  end
+
+  def test_returns_complete_without_prompt_when_release_is_already_complete
+    ui = FakeUI.new
+    context = OpenStruct.new(ui:)
+    run = PumaRelease::Commands::Run.allocate
+    run.instance_variable_set(:@context, context)
+
+    detector = Object.new
+    def detector.next_step = :complete
+    run.define_singleton_method(:stage_detector) { detector }
+    run.define_singleton_method(:confirm_step) { flunk "confirm_step should not be called for a complete release" }
+
+    assert_equal :complete, run.call
+    assert_equal ["The current release is already complete. No action needed."], ui.infos
+  end
+end

data/test/unit/shell_test.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "stringio"
+require_relative "../test_helper"
+
+class ShellTest < Minitest::Test
+  def test_stream_output_yields_chunks_without_waiting_for_newline
+    shell = PumaRelease::Shell.new(env: {}, cwd: Dir.pwd)
+    chunks = []
+    times = []
+    started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    original_stdout = $stdout
+    $stdout = StringIO.new
+
+    shell.stream_output(
+      Gem.ruby, "-e",
+      "STDOUT.write('a'); STDOUT.flush; sleep 0.2; STDOUT.write('b'); STDOUT.flush"
+    ) do |chunk|
+      chunks << chunk
+      times << Process.clock_gettime(Process::CLOCK_MONOTONIC) - started_at
+    end
+
+    assert_equal "ab", chunks.join
+    assert_operator times.first, :<, 0.15
+    assert_operator times.last, :>=, 0.15
+  ensure
+    $stdout = original_stdout
+  end
+end

data/test/unit/stage_detector_test.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+class StageDetectorTest < Minitest::Test
+  def test_returns_wait_for_merge_on_release_branch
+    detector = build_detector(current_branch: "release-v7.2.1")
+
+    assert_equal :wait_for_merge, detector.next_step
+  end
+
+  def test_returns_build_after_release_pr_is_merged_but_before_tag_exists
+    detector = build_detector(last_tag: "v7.2.0", current_version: "7.2.1")
+
+    assert_equal :build, detector.next_step
+  end
+
+  def test_returns_github_when_release_is_still_pending
+    detector = build_detector(release: {"isDraft" => true, "assets" => []})
+
+    assert_equal :github, detector.next_step
+  end
+
+  def test_returns_complete_when_release_is_published_and_there_are_no_new_commits
+    detector = build_detector(release: published_release, commits_since: 0)
+
+    assert_equal :complete, detector.next_step
+  end
+
+  def test_returns_github_when_release_is_missing_but_tag_is_current
+    detector = build_detector(release: nil, commits_since: 0)
+
+    assert_equal :github, detector.next_step
+  end
+
+  def test_returns_prepare_when_release_is_missing_and_new_commits_exist
+    detector = build_detector(release: nil, commits_since: 3)
+
+    assert_equal :prepare, detector.next_step
+  end
+
+  private
+
+  def build_detector(current_branch: "main", last_tag: "v7.2.1", current_version: "7.2.1", release: nil, open_release_pr: nil, commits_since: 0)
+    git_repo = Object.new
+    git_repo.define_singleton_method(:current_branch) { current_branch }
+    git_repo.define_singleton_method(:last_tag) { last_tag }
+    git_repo.define_singleton_method(:release_tag) { |version| "v#{version}" }
+    git_repo.define_singleton_method(:commits_since) { |_tag| commits_since }
+
+    github = Object.new
+    github.define_singleton_method(:open_release_pr) { open_release_pr }
+    github.define_singleton_method(:release) { |_tag| release }
+
+    PumaRelease::StageDetector.new(
+      OpenStruct.new(shell: FakeShell.new),
+      git_repo:,
+      repo_files: OpenStruct.new(current_version:),
+      github:
+    )
+  end
+
+  def published_release
+    {
+      "isDraft" => false,
+      "assets" => [
+        {"name" => "puma-7.2.1.gem"},
+        {"name" => "puma-7.2.1-java.gem"}
+      ]
+    }
+  end
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: puma-release
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nate Berkopec
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Standalone CLI for running Puma's release process against a Puma checkout.
+email:
+- nate.berkopec@gmail.com
+executables:
+- puma-release
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/puma-release
+- lib/puma_release.rb
+- lib/puma_release/agent_client.rb
+- lib/puma_release/build_support.rb
+- lib/puma_release/changelog_generator.rb
+- lib/puma_release/changelog_validator.rb
+- lib/puma_release/ci_checker.rb
+- lib/puma_release/cli.rb
+- lib/puma_release/commands/build.rb
+- lib/puma_release/commands/github.rb
+- lib/puma_release/commands/prepare.rb
+- lib/puma_release/commands/run.rb
+- lib/puma_release/context.rb
+- lib/puma_release/contributor_resolver.rb
+- lib/puma_release/error.rb
+- lib/puma_release/events.rb
+- lib/puma_release/git_repo.rb
+- lib/puma_release/github_client.rb
+- lib/puma_release/link_reference_builder.rb
+- lib/puma_release/options.rb
+- lib/puma_release/release_range.rb
+- lib/puma_release/repo_files.rb
+- lib/puma_release/shell.rb
+- lib/puma_release/stage_detector.rb
+- lib/puma_release/ui.rb
+- lib/puma_release/upgrade_guide_writer.rb
+- lib/puma_release/version.rb
+- lib/puma_release/version_recommender.rb
+- test/test_helper.rb
+- test/unit/agent_client_test.rb
+- test/unit/build_command_test.rb
+- test/unit/build_support_test.rb
+- test/unit/changelog_validator_test.rb
+- test/unit/context_test.rb
+- test/unit/contributor_resolver_test.rb
+- test/unit/git_repo_test.rb
+- test/unit/github_client_test.rb
+- test/unit/github_command_test.rb
+- test/unit/options_test.rb
+- test/unit/prepare_test.rb
+- test/unit/repo_files_test.rb
+- test/unit/run_test.rb
+- test/unit/shell_test.rb
+- test/unit/stage_detector_test.rb
+homepage: https://github.com/nateberkopec/puma-release
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Automate Puma releases
+test_files: []