reissue 0.4.9 → 0.4.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec1bcd720b385fc4a7b4ee0ef635d143e6390ed2e5ead9c11b7101648277263f
-  data.tar.gz: 5c8ba418790813a599ae0f9f96249e69bb146f23883c0369082c6a954f9491f8
+  metadata.gz: 2716a8e3df4f6b34bcdaa93f2aeac3ad9ebbe46489c55181a2414bcbd2bc6e58
+  data.tar.gz: 8c0090f0e3aef87175c72e4847193f3eb847e0d7307fe21ae89382561cf1ee66
 SHA512:
-  metadata.gz: 6d386f5dfb8255426d831e405ed1f831134f0bdf653e40028f64731c6d72b15296cdad6014ed83417bd3e79aa50c016d0b4097450cbe388cbca49d4fa3b20984
-  data.tar.gz: f98faa91fd66fa1d3080257ff9ab31fbd32dc941e172ce2dbe7f397ef3206e6f04ed6f5463b9a750996c460d455d7b7a8213ad8b654151cf57592137e39ac84b
+  metadata.gz: 26336e98efff7be479a552d34fabb965109b23fc9e4acc92977ad090dc13813eca62759b7619e87871126164c5001903ba3c7ec85edb8e9fd794b498a7d8301c
+  data.tar.gz: 43e043210fd8315c6f0cd6ff8c9c7e7e85025b452e00f9c9de316baa9f31a8f39151182dbc34d875061d79f6a4d7911382f4554f6ec99a9ea37f2f31aa7fa8b1

data/CHANGELOG.md

@@ -5,10 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [0.4.9] - 2026-01-15
+## [0.4.11] - 2026-02-06
+
+### Added
+
+- reissue:initialize task to create changelog and show setup instructions (ad4ae54)
+- working_directory input for monorepo gem releases (55dea65)
+- Gem integration tests for checksums in updated_paths (16b801e)
+
+### Changed
+
+- Replace rubygems/release-gem action with explicit release steps (55dea65)
 
 ### Fixed
 
-- Adding delete of remote branch after deling the local branch during the reissue:branch task to help with stale tracking reference. (3f6e1fb)
+- Finalize task fails when changelog is already committed (307939e)
+- Checksums not staged during finalize task (307939e)
+- Stage updated_paths fails when files do not exist (16b801e)
+- Release workflow fails with working-directory command not found (9068f04)
 
-## [0.4.8] - 2025-12-19
+## [0.4.10] - 2026-01-27

data/README.md

@@ -117,7 +117,15 @@ Reissue::Task.create :reissue do |task|
   # When true, fragments are cleared after a release (only applies when using directory fragments)
   # Note: Has no effect when using :git fragments
   task.clear_fragments = true
-  
+
+  # Optional: Tag pattern for matching version tags. Defaults to /^v(\d+\.\d+\.\d+.*)$/
+  # Must include a capture group for the version number.
+  # Only applies when using :git fragments
+  # Examples:
+  #   /^v(\d+\.\d+\.\d+.*)$/ matches "v1.2.3" (default)
+  #   /^myapp-v(\d+\.\d+\.\d+.*)$/ matches "myapp-v1.2.3"
+  task.tag_pattern = /^myapp-v(\d+\.\d+\.\d+.*)$/
+
   # Deprecated: Use `fragment` instead of `fragment_directory`
   # task.fragment_directory = "changelog_fragments"  # DEPRECATED: Use task.fragment instead
 

data/lib/reissue/fragment_handler/git_fragment_handler.rb

@@ -10,6 +10,21 @@ module Reissue
       # Regex to match changelog section trailers in commit messages
       TRAILER_REGEX = /^(#{VALID_SECTIONS.join("|")}):\s*(.+)$/i
 
+      # Default pattern for matching version tags (e.g., "v1.2.3")
+      DEFAULT_TAG_PATTERN = /^v(\d+\.\d+\.\d+.*)$/
+
+      # Initialize the handler with optional tag pattern for custom tag formats
+      #
+      # @param tag_pattern [Regexp, nil] Optional regex pattern for matching version tags.
+      #   Must include a capture group for the version number.
+      #   Examples:
+      #     - /^v(\d+\.\d+\.\d+.*)$/ matches "v1.2.3" (default)
+      #     - /^myapp-v(\d+\.\d+\.\d+.*)$/ matches "myapp-v1.2.3"
+      #     - /^qualified-v(\d+\.\d+\.\d+.*)$/ matches "qualified-v0.3.5"
+      def initialize(tag_pattern: nil)
+        @tag_pattern = tag_pattern || DEFAULT_TAG_PATTERN
+      end
+
       # Read changelog entries from git commit trailers
       #
       # @return [Hash] A hash of changelog entries organized by section
@@ -52,9 +67,11 @@ module Reissue
         tag = last_tag
         return nil unless tag
 
-        # Extract version number from tag (e.g., "v1.2.3" -> "1.2.3")
-        version_string = tag.sub(/^v/, "")
-        ::Gem::Version.new(version_string)
+        # Extract version number from tag using the pattern's capture group
+        match = tag.match(@tag_pattern)
+        return nil unless match && match[1]
+
+        ::Gem::Version.new(match[1])
       end
 
       private
@@ -103,14 +120,31 @@ module Reissue
         commits
       end
 
-      # Find the most recent semantic version tag (v*.*.*) by tag creation date across all branches
-      # This ensures we exclude commits that are already in ANY tagged release, not just the current branch
-      # Supports both numeric (v1.2.3) and alphanumeric (v2025.10.C) version tags
+      # Find the highest semantic version tag matching the configured pattern
+      # Uses the tag_pattern regex to filter tags and finds the highest version
       #
-      # @return [String, nil] The most recent version tag or nil if no tags found
+      # @return [String, nil] The highest version tag or nil if no tags found
       def find_last_tag
-        tag = `git for-each-ref --sort=-creatordate --format='%(refname:short)' 'refs/tags/v[0-9]*.[0-9]*.[a-zA-Z0-9]*' --count=1 2>/dev/null`.strip
-        tag.empty? ? nil : tag
+        output = `git tag -l 2>/dev/null`.strip
+        return nil if output.empty?
+
+        tags = output.split("\n")
+
+        matching_tags = tags.filter_map do |tag|
+          match = tag.match(@tag_pattern)
+          next unless match && match[1]
+
+          begin
+            version = ::Gem::Version.new(match[1])
+            {tag: tag, version: version}
+          rescue ArgumentError
+            nil
+          end
+        end
+
+        return nil if matching_tags.empty?
+
+        matching_tags.max_by { |t| t[:version] }&.dig(:tag)
       end
 
       def parse_trailers_from_commits(commits)

data/lib/reissue/fragment_handler.rb

@@ -22,9 +22,10 @@ module Reissue
     #
     # @param fragment_option [nil, String, Symbol] The fragment configuration
     # @param valid_sections [Array<String>, nil] List of valid section names (for directory handler)
+    # @param tag_pattern [Regexp, nil] Optional regex pattern for matching version tags (for git handler)
     # @return [FragmentHandler] The appropriate handler instance
     # @raise [ArgumentError] If the option is not supported
-    def self.for(fragment_option, valid_sections: nil)
+    def self.for(fragment_option, valid_sections: nil, tag_pattern: nil)
       case fragment_option
       when nil
         require_relative "fragment_handler/null_fragment_handler"
@@ -36,7 +37,7 @@ module Reissue
         DirectoryFragmentHandler.new(fragment_option, **options)
       when :git
         require_relative "fragment_handler/git_fragment_handler"
-        GitFragmentHandler.new
+        GitFragmentHandler.new(tag_pattern: tag_pattern)
       else
         raise ArgumentError, "Invalid fragment option: #{fragment_option.inspect}"
       end

data/lib/reissue/rake.rb

@@ -98,6 +98,15 @@ module Reissue
     # Set this to :branch to push to a new branch.
     attr_accessor :push_reissue
 
+    # Optional regex pattern for matching version tags.
+    # Must include a capture group for the version number.
+    # Examples:
+    #   - /^v(\d+\.\d+\.\d+.*)$/ matches "v1.2.3" (default)
+    #   - /^myapp-v(\d+\.\d+\.\d+.*)$/ matches "myapp-v1.2.3"
+    #   - /^qualified-v(\d+\.\d+\.\d+.*)$/ matches "qualified-v0.3.5"
+    # Default: nil (uses default pattern matching "v1.2.3")
+    attr_accessor :tag_pattern
+
     def initialize(name = :reissue, formatter: Reissue, tasker: Rake::Task)
       @name = name
       @formatter = formatter
@@ -116,6 +125,7 @@ module Reissue
       @version_limit = 2
       @version_redo_proc = nil
       @push_reissue = :branch
+      @tag_pattern = nil
     end
 
     attr_reader :formatter, :tasker
@@ -159,6 +169,20 @@ module Reissue
       end
     end
 
+    # Check if there are staged changes ready to commit.
+    def changes_to_commit?
+      _, _, status = Open3.capture3("git diff --cached --quiet")
+      !status.success?
+    end
+
+    # Stage updated_paths that exist on disk.
+    def stage_updated_paths
+      existing = updated_paths.select { |p| File.exist?(p) }
+      if existing.any?
+        run_command("git add #{existing.join(" ")}", "Failed to stage additional paths: #{existing.join(", ")}")
+      end
+    end
+
     def define
       desc description
       task name, [:segment] do |task, args|
@@ -176,13 +200,12 @@ module Reissue
         tasker["#{name}:clear_fragments"].invoke
 
         run_command("git add -u", "Failed to stage updated files")
-        if updated_paths&.any?
-          run_command("git add #{updated_paths.join(" ")}", "Failed to stage additional paths: #{updated_paths.join(", ")}")
-        end
+        stage_updated_paths
 
         bump_message = "Bump version to #{new_version}"
         if commit
           if reissue_version_with_branch?
+            tasker["#{name}:branch"].reenable
             tasker["#{name}:branch"].invoke("reissue/#{new_version}")
           end
           run_command("git commit -m '#{bump_message}'", "Failed to commit version bump")
@@ -223,8 +246,13 @@ module Reissue
             tasker["#{name}:branch"].invoke("finalize/#{version}")
           end
           run_command("git add -u", "Failed to stage finalized changelog")
-          run_command("git commit -m '#{finalize_message}'", "Failed to commit finalized changelog")
-          tasker["#{name}:push"].invoke if push_finalize?
+          stage_updated_paths
+          if changes_to_commit?
+            run_command("git commit -m '#{finalize_message}'", "Failed to commit finalized changelog")
+            tasker["#{name}:push"].invoke if push_finalize?
+          else
+            puts finalize_message
+          end
         else
           puts finalize_message
         end
@@ -262,7 +290,7 @@ module Reissue
       task "#{name}:preview" do
         if fragment
           require_relative "fragment_handler"
-          handler = Reissue::FragmentHandler.for(fragment)
+          handler = Reissue::FragmentHandler.for(fragment, tag_pattern: tag_pattern)
 
           # Show comparison tag for git trailers
           if fragment == :git && handler.respond_to?(:last_tag)
@@ -329,7 +357,7 @@ module Reissue
         require_relative "fragment_handler"
         require_relative "version_updater"
 
-        handler = Reissue::FragmentHandler.for(:git)
+        handler = Reissue::FragmentHandler.for(:git, tag_pattern: tag_pattern)
 
         # Get current version from version file
         version_content = File.read(version_file)
@@ -363,3 +391,75 @@ module Reissue
     end
   end
 end
+
+# Define the reissue:initialize task as a standalone task
+# This works without any configuration, allowing users to bootstrap their project
+namespace :reissue do
+  desc "Initialize reissue by creating a CHANGELOG.md and showing Rakefile configuration"
+  task :initialize do
+    changelog_file = "CHANGELOG.md"
+
+    if File.exist?(changelog_file)
+      puts "✓ #{changelog_file} already exists"
+    else
+      Reissue.generate_changelog(changelog_file)
+      puts "✓ Created #{changelog_file}"
+    end
+
+    puts
+    puts "Add the following to your Rakefile to enable reissue tasks:"
+    puts
+    puts <<~RAKEFILE
+      require "reissue/rake"
+
+      Reissue::Task.create :reissue do |task|
+        task.version_file = "lib/your_gem/version.rb"  # Required: path to your VERSION constant
+      end
+    RAKEFILE
+
+    puts
+    puts "Optional configuration:"
+    puts
+    puts <<~OPTIONS
+      Reissue::Task.create :reissue do |task|
+        task.version_file = "lib/your_gem/version.rb"
+
+        # Changelog options
+        task.changelog_file = "CHANGELOG.md"      # Default: "CHANGELOG.md"
+        task.version_limit = 2                    # Versions to keep in changelog
+
+        # Fragment handling for changelog entries
+        task.fragment = :git                      # Use git commit trailers (Added:, Fixed:, etc.)
+        # task.fragment = "changelog_fragments"   # Or use a directory of fragment files
+        task.clear_fragments = false              # Clear fragment files after release. Not necessary when using git trailers.
+
+        # Git workflow options
+        task.commit = true                        # Auto-commit version bumps
+        task.commit_finalize = true               # Auto-commit changelog finalization
+        task.push_reissue = :branch               # Push strategy: false, true, or :branch
+        task.push_finalize = false                # Push after finalize: false, true, or :branch
+
+        # Custom tag pattern for version detection (must include capture group)
+        # task.tag_pattern = /^myapp-v(\\d+\\.\\d+\\.\\d+.*)$/
+      end
+    OPTIONS
+
+    puts
+    puts "For Ruby gems, use reissue/gem for automatic integration with bundler tasks:"
+    puts
+    puts <<~GEM_USAGE
+      require "reissue/gem"
+
+      Reissue::Task.create :reissue do |task|
+        task.version_file = "lib/your_gem/version.rb"
+        task.fragment = :git
+      end
+    GEM_USAGE
+
+    puts
+    puts "This automatically runs reissue:bump and reissue:finalize before `rake build`"
+    puts "and runs reissue after `rake release`."
+    puts
+    puts "Run `rake -T reissue` to see all available tasks after configuration."
+  end
+end

data/lib/reissue/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Reissue
-  VERSION = "0.4.9"
+  VERSION = "0.4.11"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: reissue
 version: !ruby/object:Gem::Version
-  version: 0.4.9
+  version: 0.4.11
 platform: ruby
 authors:
 - Jim Gay