toys-release 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f61f9d5ff06e42dbeeadb84997e7b29f439bdd44a1aefb7f1c1501da7c87d5a9
-  data.tar.gz: 3d4e730a8fa3ae1af7faf9950a5457c046a9fdd4d16084ded260a11ad85dc708
+  metadata.gz: 6a183392907cf0499a8abb4df7f675146d1b52f602551f140cf12111fd809149
+  data.tar.gz: fbc2ca77613f5a9bc40c9d3fe89fc239d7feb0c43713cc4407f935abcf5b9a29
 SHA512:
-  metadata.gz: 96649178b625266cbebd6afbbd68614fcb2a821086ab1d365e8ce3d8df9b20d6159e52237495da67be405421e012c2f53e2bcd4838d150185ef0cba691056a63
-  data.tar.gz: 2cafbc40bb58e2cbcfbd8fa354289d998c82e3f598c4294d0cbf125ce5dba42ed1f141ce0b228bb64ad2fd86569719f23cc6abd3053801f20c404df1221e735d
+  metadata.gz: 69fb1dc0ab0870f13ab1b6dcee252a31dc19aeeabc2d318c99baed7dd3dd45c6e7c5263090e749e00827e6f8d23c1342b4d8ee982e771c85026fe690b9770323
+  data.tar.gz: 99cc97fd617ea40ec0c75ca3cd08ac89f362d29f530c907b3b9c9dab14452607cfc10a4bfcae9c1a694d19ab6a01e2869414fd6490a4eeadebc524483e8ffd16

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Release History
 
+### v0.7.0 / 2026-03-09
+
+* ADDED: Support updating dependencies among released components
+* ADDED: Configurable changelog release header format
+* ADDED: Support optionally auto-creating release PRs on push
+
 ### v0.6.0 / 2026-02-11
 
 * ADDED: Support retaining and/or linkifying issue/PR numbers in commit messages

data/docs/guide.md

@@ -851,10 +851,32 @@ rest are optional.
     This can be used to modify the default build pipeline instead of redefining
     the entire pipeline using the **steps** key.
 
+ *  **auto_create_request_branches**: *array of string* (optional) --
+    A list of branch names for which release pull requests are automatically
+    created when a push occurs and no existing release PRs are open for the
+    branch. When a push is made to one of these branches and there are no
+    open release PRs targeting it, the system will automatically run the
+    release request tool to create one, including all components with
+    releasable changes. If no components have releasable changes, the
+    auto-creation is silently skipped. This setting requires
+    **required_checks** to be disabled (set to *false*). Defaults to an
+    empty array (no auto-creation).
+
  *  **breaking_change_header**: *string* (optional) --
     A changelog entry prefix that appears when a change is marked as breaking.
     Default is `BREAKING CHANGE`.
 
+ *  **changelog_bullet**: *string* (optional) --
+    The bullet character used for changelog list items. Allowed values are
+    `*` and `-`. Default is `*`.
+
+ *  **changelog_release_header_format**: *string* (optional) --
+    A format string for changelog release headers. Use `%v` for the version
+    number and [strftime](https://docs.ruby-lang.org/en/4.0/language/strftime_formatting_rdoc.html)
+    directives (e.g. `%Y`, `%m`, `%d`) for date components. The format must
+    include `%v`. Default is `### v%v / %Y-%m-%d`, which produces headers
+    like `### v1.2.3 / 2026-02-16`.
+
  *  **commit_tags**: *array of [CommitTagConfig](#commit-tag-configuration)* (optional) --
     A set of configurations defining how to interpret
     [conventional commit](https://conventionalcommits.org) tags, including how
@@ -1144,6 +1166,13 @@ The **name** key is required. The others are optional.
     present, the default pipeline for the entire repository is used. (See the
     **steps** key under [Top level configuration](#top-level-configuration).)
 
+ *  **update_dependencies**: *[UpdateDepsConfig](#update-dependencies-configuration)* (optional) --
+    Set up automatic dependency updates, which causes this component to be
+    updated and released if any of a specified set of dependencies is also
+    present in the release. This supports automatically keeping "kitchen sink"
+    libraries up to date. If this setting is not present, automatic updating is
+    not performed for this component.
+
  *  **version_rb_path**: *string* (optional) --
     The path to a Ruby file that contains the current version of the component.
     This file *must* include Ruby code that looks like this:
@@ -1160,6 +1189,57 @@ The **name** key is required. The others are optional.
     module implied by the component name. For example, if the component (gem)
     name is `toys-release`, this defaults to `lib/toys/release/version.rb`.
 
+#### Update dependencies configuration
+
+An update-dependencies configuration describes when a component should also be
+released with updated dependency versions, due to one or more of those
+dependencies being released. It is typically used to keep "kitchen sink"
+libraries up to date.
+
+For example, consider two components "foo_a" and "foo_b", and a "kitchen sink"
+component "foo_all" that depends on both the others. Suppose whenever a patch
+or greater release of either "foo_a" or "foo_b" happens, we also want "foo_all"
+to be released with its corresponding dependency bumped to the same version. We
+might set up the configuration like so:
+
+```yaml
+components:
+  - name: foo_a
+  - name: foo_b
+  - name: foo_all
+    update_dependencies:
+      dependency_semver_threshold: patch
+      dependencies: [foo_a, foo_b]
+```
+
+The update-dependencies configuration for a kitchen sink component can include
+the following keys. The **dependencies** key is required. All others are
+optional.
+
+ *  **dependencies**: *array of string* (required) --
+    A list of names of the components this component depends on.
+
+ *  **dependency_semver_threshold**: *string* (optional) --
+    The minimum semver level of a dependency update that should trigger an
+    update of the kitchen sink component. For example, a threshold of `minor`
+    would trigger an update to the kitchen sink if a minor release of a
+    dependency occurred, but would not trigger an update to the kitchen sink if
+    a patch release occurred.
+
+    Allowed values are `major`, `minor`, `patch`, `patch2`, and `all`. The
+    `all` value indicates that every release of a dependency should trigger an
+    update to the kitchen sink. Defaults to `minor` if not specified.
+
+ *  **pessimistic_constraint_level**: *string* (optional) --
+    The highest semver level allowed to float in the pessimistic dependency
+    version constraints used to specify the dependencies. For example, a
+    version constraint of `~> 1.0` has level `minor` because the minor version
+    number is allowed to float, whereas the major version number is pinned.
+
+    Allowed values are `major`, `minor`, `patch`, `patch2`, and `exact`. The
+    `exact` value indicates that dependencies should require the exact release
+    version. Defaults to `minor` if not specified.
+
 ### Build step configuration
 
 A build step describes one step in the release process. Its format is a

data/lib/toys/release/version.rb

@@ -6,6 +6,6 @@ module Toys
     # Current version of the Toys release system.
     # @return [String]
     #
-    VERSION = "0.6.0"
+    VERSION = "0.7.0"
   end
 end

data/toys/.lib/toys/release/change_set.rb

@@ -21,8 +21,10 @@ module Toys
         @commit_tags = component_settings.commit_tags
         @breaking_change_header = component_settings.breaking_change_header
         @no_significant_updates_notice = component_settings.no_significant_updates_notice
+        @update_dependency_header = component_settings.update_dependency_header
         @semver = Semver::NONE
         @change_groups = nil
+        @updated_dependency_versions = nil
         @inputs = []
         @significant_shas = nil
         @description_normalizer = create_description_normalizer(
@@ -49,7 +51,7 @@ module Toys
       # Finish constructing a change set. After this method, new commit messages
       # cannot be added.
       #
-      def finish # rubocop:disable Metrics/AbcSize
+      def finish
         raise "ChangeSet locked" if finished?
         @semver = Semver::NONE
         change_groups = {breaking: Group.new(@breaking_change_header)}
@@ -65,24 +67,42 @@ module Toys
           change_groups[:breaking].add(input.breaks)
         end
         @change_groups = change_groups.values.find_all { |group| !group.empty? }
-        if @change_groups.empty? && @semver.significant?
-          @change_groups << Group.new(nil).add(@no_significant_updates_notice)
-        end
         @significant_shas = @inputs.map(&:sha)
+        @updated_dependency_versions = {}
         @inputs = nil
         self
       end
 
+      ##
+      # Add a set of dependency updates.
+      # May be called only on a finished changeset.
+      #
+      # @param updates [Array<Toys::Release::RequestSpec::ResolvedComponent>]
+      # @param dependency_semver_threshold [Toys::Release::Semver] The minimum
+      #     semver significance to trigger an update
+      #
+      def add_dependency_updates(updates, dependency_semver_threshold)
+        raise "ChangeSet not finished" unless finished?
+        existing_group = @change_groups.find { |group| group.header == @update_dependency_header }
+        group = existing_group || Group.new(@update_dependency_header)
+        updates.each do |resolved_update|
+          diff_semver = Toys::Release::Semver.for_diff(resolved_update.last_version, resolved_update.version)
+          next if diff_semver < dependency_semver_threshold
+          @updated_dependency_versions[resolved_update.component_name] = resolved_update.version
+          @semver = @semver.max(diff_semver)
+          group.add("Updated #{resolved_update.component_name.inspect} dependency to #{resolved_update.version}")
+        end
+        @change_groups << group unless existing_group || group.empty?
+        self
+      end
+
       ##
       # Force a non-empty changeset even if there are no significant updates.
       # May be called only on a finished changeset.
       #
       def force_release!
         raise "ChangeSet not finished" unless finished?
-        if @change_groups.empty?
-          @semver = Semver::PATCH
-          @change_groups << Group.new(nil).add(@no_significant_updates_notice)
-        end
+        @semver = Semver::PATCH unless @semver.significant?
         self
       end
 
@@ -98,7 +118,7 @@ module Toys
       #     the change set is finished.
       #
       def empty?
-        @change_groups&.empty?
+        change_groups&.empty?
       end
 
       ##
@@ -116,7 +136,21 @@ module Toys
       # @return [Array<Group>] An array of change groups, in order. Returns nil
       #     if the change set is not finished.
       #
-      attr_reader :change_groups
+      def change_groups
+        if !finished?
+          nil
+        elsif @change_groups.empty? && @semver.significant?
+          @no_significant_updates_groups ||= [Group.new(nil).add(@no_significant_updates_notice)]
+        else
+          @change_groups
+        end
+      end
+
+      ##
+      # @return [Hash{String=>Gem::Version}] Dependency version updates.
+      #     Returns nil if the change set is not yet finished.
+      #
+      attr_reader :updated_dependency_versions
 
       ##
       # Suggest a next version based on the changeset's changes.

data/toys/.lib/toys/release/changelog_file.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "time"
+
 module Toys
   module Release
     ##
@@ -16,10 +18,12 @@ module Toys
       #
       # @param path [String] File path
       # @param environment_utils [Toys::Release::EnvironmentUtils]
+      # @param settings [Toys::Release::RepoSettings] Repository settings
       #
-      def initialize(path, environment_utils)
+      def initialize(path, environment_utils, settings)
         @path = path
         @utils = environment_utils
+        @settings = settings
       end
 
       ##
@@ -46,7 +50,7 @@ module Toys
       # @return [::Gem::Version,nil] Current latest version from the changelog
       #
       def current_version
-        ChangelogFile.current_version_from_content(content)
+        ChangelogFile.current_version_from_content(content, header_format)
       end
 
       ##
@@ -60,34 +64,36 @@ module Toys
       def read_and_verify_latest_entry(version) # rubocop:disable Metrics/MethodLength
         version = version.to_s
         @utils.log("Verifying #{path} changelog content...")
-        today = ::Time.now.strftime("%Y-%m-%d")
+        expected_header = format_header(version, ::Time.now.utc)
+        version_re = ::Regexp.new("^#{ChangelogFile.header_regex(header_format, version: version)}\n$")
+        any_header_re = ::Regexp.new("^#{ChangelogFile.header_regex(header_format)}")
         entry = []
         state = :start
         ::File.readlines(@path).each do |line|
           case state
           when :start
             case line
-            when %r{^### v#{::Regexp.escape(version)} / \d\d\d\d-\d\d-\d\d\n$}
+            when version_re
               entry << line
               state = :during
-            when /^### /
+            when any_header_re
               @utils.error("The first changelog entry in #{path} isn't for version #{version}.",
                            "It should start with:",
-                           "### v#{version} / #{today}",
+                           expected_header,
                            "But it actually starts with:",
                            line)
               entry << line
               state = :during
             end
           when :during
-            break if line =~ /^### /
+            break if any_header_re.match?(line)
             entry << line
           end
         end
         if entry.empty?
           @utils.error("The changelog #{path} doesn't have any entries.",
                        "The first changelog entry should start with:",
-                       "### v#{version} / #{today}")
+                       expected_header)
         else
           @utils.log("Changelog OK")
         end
@@ -99,15 +105,14 @@ module Toys
       #
       # @param changeset [ChangeSet] The changeset.
       # @param version [String] The release version.
-      # @param date [String] The date. If not provided, uses the current UTC.
-      # @param bullet [String] The bullet character for list items. Defaults to "*".
+      # @param date [Time,String,nil] The date. If not provided, uses the current UTC.
       #
-      def append(changeset, version, date: nil, bullet: "*")
+      def append(changeset, version, date: nil)
         @utils.log("Writing version #{version} to changelog #{path}")
-        date ||= ::Time.now.utc
-        date = date.strftime("%Y-%m-%d") if date.respond_to?(:strftime)
+        bullet = @settings.changelog_bullet
+        header_line = format_header(version, date)
         new_entry = [
-          "### v#{version} / #{date}",
+          header_line,
           "",
         ]
         changeset.change_groups.each do |group|
@@ -115,7 +120,7 @@ module Toys
         end
         new_entry = new_entry.join("\n")
         old_content = content || DEFAULT_HEADER
-        new_content = old_content.sub(%r{^(### v\S+ / \d\d\d\d-\d\d-\d\d)$}, "#{new_entry}\n\n\\1")
+        new_content = old_content.sub(/^(#{ChangelogFile.header_regex(header_format)})$/, "#{new_entry}\n\n\\1")
         if new_content == old_content
           new_content = old_content.sub(/\n+\z/, "\n\n#{new_entry}\n")
         end
@@ -127,12 +132,90 @@ module Toys
       # Returns the current version from the given file content
       #
       # @param content [String] File contents
+      # @param header_format [String] The header format string containing
+      #     `%v` for version and strftime directives for date components.
       # @return [::Gem::Version] Latest version in the changelog
       #
-      def self.current_version_from_content(content)
-        match = %r{### v(\d+(?:\.[a-zA-Z0-9]+)+) / \d\d\d\d-\d\d-\d\d}.match(content)
+      def self.current_version_from_content(content, header_format)
+        regex_str = header_regex(header_format)
+        match = ::Regexp.new(regex_str).match(content.to_s)
         match ? ::Gem::Version.new(match[1]) : nil
       end
+
+      ##
+      # @private
+      #
+      # Converts a header format into a regular expression string for
+      # matching changelog headers. The `%v` placeholder is replaced with
+      # either a specific escaped version or a general version-capturing
+      # pattern. Strftime directives (including those with flags and width
+      # specifiers) are replaced with appropriate character class patterns.
+      #
+      # TODO: This does not correctly handle escaped percent signs (`%%`)
+      # in the format string. A `%%` sequence (which strftime interprets
+      # as a literal `%`) could have its second `%` misidentified as the
+      # start of a strftime directive. This is unlikely in practice but
+      # may warrant future investigation.
+      #
+      # @param header_format [String] The header format string.
+      # @param version [String,nil] If provided, the regex will match only
+      #     this specific version. If nil, the regex captures any version.
+      # @return [String] A regular expression string (not a Regexp object).
+      #
+      def self.header_regex(header_format, version: nil)
+        version_re = version ? ::Regexp.escape(version.to_s) : "(#{VERSION_PATTERN})"
+        ::Regexp.escape(header_format)
+                .gsub("%v", version_re)
+                .gsub(/%[-_0^#]?\d*([a-zA-Z])/) do
+                  STRFTIME_CONVERSIONS[::Regexp.last_match(1)] || '\S+'
+                end
+      end
+
+      # @private
+      VERSION_PATTERN = '\d+(?:\.[a-zA-Z0-9]+)+'
+      private_constant :VERSION_PATTERN
+
+      # @private
+      # Maps strftime conversion characters to regex patterns.
+      # Flags and width specifiers (e.g. %-d, %02m) are handled by
+      # header_regex via a general pattern match.
+      STRFTIME_CONVERSIONS = {
+        "Y" => '\d{4}',
+        "m" => '\d{1,2}',
+        "d" => '\d{1,2}',
+        "B" => '\w+',
+        "b" => '\w+',
+        "e" => '[\d ]\d',
+      }.freeze
+      private_constant :STRFTIME_CONVERSIONS
+
+      private
+
+      ##
+      # Returns the configured header format string from settings.
+      #
+      # @return [String] A format string containing `%v` for version and
+      #     strftime directives for date components.
+      #
+      def header_format
+        @settings.changelog_release_header_format
+      end
+
+      ##
+      # Generates a formatted header line by substituting the version and
+      # formatting the date using strftime directives from the header format.
+      #
+      # @param version [String] The release version string.
+      # @param date [Time,String,nil] The release date. If nil, defaults to
+      #     the current UTC time. Strings are parsed via `Time.parse`.
+      # @return [String] The formatted header line.
+      #
+      def format_header(version, date)
+        date ||= ::Time.now.utc
+        date = ::Time.parse(date) if date.is_a?(::String)
+        fmt = header_format.gsub("%v", "%%v")
+        date.strftime(fmt).gsub("%v", version.to_s)
+      end
     end
   end
 end

data/toys/.lib/toys/release/component.rb

@@ -2,6 +2,7 @@
 
 require "toys/release/change_set"
 require "toys/release/changelog_file"
+require "toys/release/gemspec_file"
 require "toys/release/version_rb_file"
 
 module Toys
@@ -21,8 +22,9 @@ module Toys
         @repository = repository
         @settings = repository.settings.component_settings(name)
         @utils = environment_utils
-        @changelog_file = ChangelogFile.new(changelog_path(from: :absolute), @utils)
+        @changelog_file = ChangelogFile.new(changelog_path(from: :absolute), @utils, repository.settings)
         @version_rb_file = VersionRbFile.new(version_rb_path(from: :absolute), @utils)
+        @gemspec_file = GemspecFile.new(gemspec_path(from: :absolute), @utils)
         @coordination_group = nil
       end
 
@@ -43,6 +45,12 @@ module Toys
       #
       attr_reader :version_rb_file
 
+      ##
+      # @return [Toys::Release::GemspecFile] The .gemspec file in this
+      #     component
+      #
+      attr_reader :gemspec_file
+
       ##
       # @return [Array<Component>] The coordination group containing this
       #     component. If this component is not coordinated, it will be part of
@@ -137,6 +145,19 @@ module Toys
         file_path(settings.version_rb_path, from: from)
       end
 
+      ##
+      # Returns the path to the gemspec. It can be returned as a relative
+      # path from the component directory, a relative path from the repo root
+      # directory, or an absolute path.
+      #
+      # @param from [:directory,:repo_root,:absolute] From where (defaults to
+      #     `:directory`)
+      # @return [String] The path to the gemspec
+      #
+      def gemspec_path(from: :directory)
+        file_path("#{name}.gemspec", from: from)
+      end
+
       ##
       # Validates the component and reports any errors.
       #
@@ -145,15 +166,39 @@ module Toys
           path = directory(from: :absolute)
           @utils.error("Missing directory #{path} for #{name}") unless ::File.directory?(path)
           @utils.error("Missing changelog #{changelog_file.path} for #{name}") unless changelog_file.exists?
-          if !version_rb_file.exists?
-            @utils.error("Missing version #{version_rb_file.path} for #{name}")
-          elsif version_rb_file.current_version.nil?
-            @utils.error("Unable to read VERSION constant from #{version_rb_file.path} for #{name}")
-          end
+          validate_version_rb_file
+          validate_gemspec_file
           yield if block_given?
         end
       end
 
+      ##
+      # Validates the version.rb file
+      #
+      def validate_version_rb_file
+        if !version_rb_file.exists?
+          @utils.error("Missing version #{version_rb_file.path} for #{name}")
+        elsif version_rb_file.current_version.nil?
+          @utils.error("Unable to read VERSION constant from #{version_rb_file.path} for #{name}")
+        end
+      end
+
+      ##
+      # Validates the gemspec file if this component updates from dependencies
+      #
+      def validate_gemspec_file
+        update_deps_settings = settings.update_dependencies
+        return unless update_deps_settings
+        if gemspec_file.exists?
+          cur_deps = gemspec_file.current_dependencies
+          update_deps_settings.dependencies.each do |dep_name|
+            @utils.error("Gemspec #{gemspec_file.path} is missing #{dep_name}") unless cur_deps.key?(dep_name)
+          end
+        else
+          @utils.error("Missing gemspec #{gemspec_file.path} for #{name}")
+        end
+      end
+
       ##
       # Returns the version of the latest release tag on the given branch.
       #
@@ -205,7 +250,9 @@ module Toys
         if at
           path = changelog_path(from: :repo_root)
           content = @utils.capture(["git", "show", "#{at}:#{path}"], e: true)
-          return ChangelogFile.current_version_from_content(content)
+          return ChangelogFile.current_version_from_content(
+            content, @repository.settings.changelog_release_header_format
+          )
         end
         changelog_file.current_version
       end

data/toys/.lib/toys/release/gemspec_file.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module Toys
+  module Release
+    ##
+    # Represents a gemspec file
+    #
+    class GemspecFile
+      ##
+      # Transforms an input set of versions and pessimistic constraint level to
+      # the dependency syntax for rubygems.
+      #
+      # @param versions [Hash{String=>Gem::Version}] Mapping from component
+      #     name to version
+      # @param dependency_semver_threshold [Semver] The semver significance
+      #     threshold
+      # @param pessimistic_constraint_level [Semver] The pessimistic constraint
+      #
+      # @return [Hash{String=>Array<String>}] Mapping from component name to
+      #     the rubygems version constraint syntax
+      #
+      def self.transform_version_constraints(versions,
+                                             dependency_semver_threshold,
+                                             pessimistic_constraint_level)
+        versions.transform_values do |version|
+          if pessimistic_constraint_level == Semver::NONE
+            ["= #{version}"]
+          else
+            segments = version.canonical_segments.dup
+            segments.slice!((dependency_semver_threshold.segment + 1)..) if dependency_semver_threshold.segment
+            pessimistic_segments =
+              if segments.size <= pessimistic_constraint_level.segment
+                segments + ::Array.new(pessimistic_constraint_level.segment - segments.size + 1, 0)
+              else
+                segments[..pessimistic_constraint_level.segment]
+              end
+            result = ["~> #{pessimistic_segments.join('.')}"]
+            result << ">= #{segments.join('.')}" if segments.size > pessimistic_segments.size
+            result
+          end
+        end
+      end
+
+      ##
+      # Create a gemspec file object given a file path
+      #
+      # @param path [String] File path
+      # @param environment_utils [Toys::Release::EnvironmentUtils]
+      #
+      def initialize(path, environment_utils)
+        @path = path
+        @utils = environment_utils
+      end
+
+      ##
+      # @return [String] Path to the gemspec file
+      #
+      attr_reader :path
+
+      ##
+      # @return [boolean] Whether the file exists
+      #
+      def exists?
+        path && ::File.file?(path)
+      end
+
+      ##
+      # @return [String] Current contents of the file
+      #
+      def content
+        @content ||= ::File.read(path)
+      end
+
+      ##
+      # Get the current rubygems version constraints for all dependencies
+      #
+      # @return [Hash{String=>Array<String>}] Map from component name to a
+      #     possibly empty array of version constraint strings.
+      #
+      def current_dependencies
+        result = {}
+        regex = /\.add(?:_runtime)?_dependency\(?\s*["']([^"']+)["']((?:,\s*["']([^"',]+)["'])*)\s*\)?/
+        content.scan(regex) do |comp_name, expr|
+          result[comp_name] = expr.scan(/["']([^"',]+)["']/).map(&:first)
+        end
+        result
+      end
+
+      ##
+      # Update the rubygems version constraints
+      #
+      # @param constraint_updates [Hash{String=>Array<String>}] Map from
+      #     component name to a possibly empty array of version constraint
+      #     strings.
+      # @return [self]
+      #
+      def update_dependencies(constraint_updates)
+        constraint_updates.each do |name, exprs|
+          escaped_name = Regexp.escape(name)
+          regex = /\.(add(?:_runtime)?_dependency)(\(?\s*)(["'])#{escaped_name}["'](?:,\s*["'][^"',]+["'])*(\s*\)?)/
+          content.sub!(regex) do
+            match = ::Regexp.last_match
+            method_name = match[1]
+            opening = match[2]
+            quote = match[3]
+            closing = match[4]
+            exprs_str = exprs.map { |str| ", #{str.inspect}" }.join
+            exprs_str.tr!('"', quote) unless quote == '"'
+            ".#{method_name}#{opening}#{quote}#{name}#{quote}#{exprs_str}#{closing}"
+          end
+        end
+        ::File.write(path, content) if path
+        self
+      end
+
+      # @private
+      attr_writer :content
+    end
+  end
+end