ratatui_ruby-devtools 0.1.0

data/lib/ratatui_ruby/devtools/tasks/bump/ruby_gem.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+# Coordinates version bumping across multiple manifests.
+#
+# Ruby gems have versions in multiple files: version.rb, Cargo.toml, lockfiles.
+# Bumping manually leads to mismatches. Forgetting the changelog produces
+# incomplete releases.
+#
+# This class orchestrates the bump. It updates all manifests, refreshes
+# lockfiles, and updates the changelog. One command. Consistent versions.
+#
+# Use it in rake tasks to bump major, minor, or patch versions.
+class RubyGem
+  # Creates a new RubyGem coordinator.
+  #
+  # [manifests] Array of Manifest objects. Exactly one must be primary.
+  # [lockfile] A lockfile object that responds to <tt>refresh</tt>.
+  # [changelog] A Changelog object for updating release notes.
+  def initialize(manifests:, lockfile:, changelog:)
+    raise ArgumentError, "Must have exactly one primary manifest" unless manifests.count(&:primary) == 1
+    @manifests = manifests
+    @lockfile = lockfile
+    @changelog = changelog
+  end
+
+  # Returns the current version from the primary manifest.
+  def version
+    @manifests.find(&:primary).version
+  end
+
+  # Bumps the version by the given segment.
+  #
+  # Updates all manifests, refreshes lockfiles, and updates the changelog.
+  # Prints a suggested commit message.
+  #
+  # [segment] One of <tt>:major</tt>, <tt>:minor</tt>, or <tt>:patch</tt>.
+  def bump(segment)
+    target = version.next(segment)
+    commit_message = @changelog.commit_message(target)
+
+    puts "Bumping #{segment}: #{version} -> #{target}"
+    @changelog.release(target)
+    @manifests.each { |manifest| manifest.write(target) }
+    @lockfile.refresh
+
+    puts_commit_message(commit_message)
+  end
+
+  # Sets the version to an exact value.
+  #
+  # Updates all manifests, refreshes lockfiles, and updates the changelog.
+  # Prints a suggested commit message.
+  #
+  # [version_string] A version string like <tt>"1.2.3"</tt>.
+  def set(version_string)
+    target = SemVer.parse(version_string)
+    commit_message = @changelog.commit_message(target)
+
+    puts "Setting version: #{version} -> #{target}"
+    @changelog.release(target)
+    @manifests.each { |manifest| manifest.write(target) }
+    @lockfile.refresh
+
+    puts_commit_message(commit_message)
+  end
+
+  private def puts_commit_message(message)
+    puts "=" * 80
+    puts message
+    puts "=" * 80
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/bump/sem_ver.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+# Represents a semantic version number.
+#
+# Version numbers have three segments: major, minor, patch. Incrementing one
+# resets the following segments to zero. Parsing strings by hand is tedious.
+#
+# This class parses version strings and computes the next version for any
+# segment. It follows the Semantic Versioning 2.0.0 specification.
+#
+# Use it to bump versions in rake tasks.
+#
+# === Example
+#
+#   SemVer.parse("1.2.3").next(:minor).to_s  # => "1.3.0"
+#
+# See https://semver.org/spec/v2.0.0.html
+class SemVer
+  # The valid segment names for version bumping.
+  SEGMENTS = [:major, :minor, :patch].freeze
+
+  # Parses a version string into a SemVer instance.
+  #
+  # [string] A version string like <tt>"1.2.3"</tt>.
+  def self.parse(string)
+    require "rubygems"
+    segments = Gem::Version.new(string).segments.fill(0, 3).first(3)
+    new(segments)
+  end
+
+  # Creates a new SemVer from an array of segments.
+  #
+  # [segments] An array of three integers: <tt>[major, minor, patch]</tt>.
+  def initialize(segments)
+    @segments = segments
+  end
+
+  # Returns the next version after bumping the given segment.
+  #
+  # Bumping a segment resets all following segments to zero.
+  #
+  # [segment] One of <tt>:major</tt>, <tt>:minor</tt>, or <tt>:patch</tt>.
+  def next(segment)
+    index = SEGMENTS.index(segment)
+    raise ArgumentError, "Invalid segment: #{segment}" unless index
+
+    new_segments = @segments.dup
+    new_segments[index] += 1
+    new_segments.fill(0, (index + 1)..2)
+
+    SemVer.new(new_segments)
+  end
+
+  # Returns the version as a string.
+  def to_s
+    @segments.join(".")
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/bump/unreleased_section.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require "date"
+require "rdoc"
+
+# Manages the Unreleased section of a changelog.
+#
+# Changelogs accumulate changes under an Unreleased heading. During a release,
+# this section becomes a dated version entry. Parsing and transforming it by
+# hand is tedious.
+#
+# This class extracts the Unreleased section from markdown. It transforms it
+# into a versioned section. It generates commit message bodies.
+#
+# Use it during release preparation.
+class UnreleasedSection
+  # Regex to match the Unreleased section.
+  PATTERN = /^(## \[Unreleased\].*?)(?=## \[\d)/m
+
+  # Parses the Unreleased section from changelog content.
+  #
+  # [content] The full changelog text.
+  def self.parse(content)
+    match = content.match(PATTERN)
+    new(match[1].strip) if match
+  end
+
+  # Returns a fresh Unreleased section with standard headings.
+  def self.fresh
+    new("## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Removed")
+  end
+
+  # Creates a new UnreleasedSection.
+  #
+  # [content] The raw section text.
+  def initialize(content)
+    @content = content.dup
+  end
+
+  # Converts the section to a dated version entry.
+  #
+  # [new_version] The version string or SemVer.
+  def as_version(new_version)
+    date = Date.today.iso8601
+    @content.sub(/^## \[Unreleased\]/, "## [#{new_version}] - #{date}")
+  end
+
+  # Returns the section as a string.
+  def to_s
+    @content
+  end
+
+  # Generates a commit message body from the changes.
+  #
+  # Strips markdown formatting and wraps lines to 72 characters.
+  def commit_body
+    formatter = Class.new { include RDoc::Text }.new
+    @content
+      .sub(/^## \[Unreleased\].*$/, "")
+      .gsub(/^### (Added|Changed|Fixed|Removed)\n*$/, "")
+      .gsub(/^- \*\*([^*]+)\*\*:/, '\1:')
+      .gsub(/`([^`]+)`/, '\1')
+      .strip
+      .lines
+      .map { |line| line.gsub(/^- /, "").strip }
+      .reject(&:empty?)
+      .map { |line| formatter.wrap(line, 72) }
+      .join("\n\n")
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/bump.rake

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require "rubygems"
+
+require_relative "bump/sem_ver"
+require_relative "bump/manifest"
+require_relative "bump/cargo_lockfile"
+require_relative "bump/ruby_gem"
+require_relative "bump/changelog"
+
+# Null lockfile for gems without Rust
+class NullLockfile
+  def refresh
+    # No-op
+  end
+end
+
+namespace :bump do
+  # Auto-discover gem configuration
+  def devtools_gem
+    @devtools_gem ||= begin
+      version_file = RatatuiRuby::Devtools.version_file
+      gem_name = RatatuiRuby::Devtools.gem_name
+
+      manifests = [
+        Manifest.new(
+          path: version_file,
+          pattern: /(?<=VERSION = ")[^"]+(?=")/,
+          primary: true
+        ),
+      ]
+
+      # Optionally add Cargo.toml if this gem has Rust extensions
+      cargo_toml = "ext/#{gem_name}/Cargo.toml"
+      if File.exist?(cargo_toml)
+        manifests << Manifest.new(
+          path: cargo_toml,
+          pattern: /(?<=^version = ")[^"]+(?=")/,
+          primary: false
+        )
+      end
+
+      # Optionally use Cargo lockfile if it exists
+      cargo_lock = "ext/#{gem_name}/Cargo.lock"
+      lockfile = if File.exist?(cargo_lock)
+        CargoLockfile.new(
+          path: cargo_lock,
+          dir: "ext/#{gem_name}",
+          name: gem_name
+        )
+      else
+        # No-op lockfile for pure Ruby gems
+        NullLockfile.new
+      end
+
+      RubyGem.new(
+        manifests:,
+        lockfile:,
+        changelog: Changelog.new
+      )
+    end
+  end
+
+  SemVer::SEGMENTS.each do |segment|
+    desc "Bump #{segment} version"
+    task segment do
+      devtools_gem.bump(segment)
+    end
+  end
+
+  desc "Set exact version (e.g. rake bump:exact[0.1.0])"
+  task :exact, [:version] do |_, args|
+    devtools_gem.set(args[:version])
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/cargo.rake

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+# Cargo tasks for Rust extensions.
+# Only registered if ext/ directory exists.
+
+if Dir.exist?("ext")
+  namespace :cargo do
+    desc "Run cargo fmt"
+    task :fmt do
+      ext_dirs = Dir.glob("ext/*").select { |d| File.directory?(d) && File.exist?("#{d}/Cargo.toml") }
+      ext_dirs.each do |dir|
+        sh "cd #{dir} && cargo fmt --all -- --check"
+      end
+    end
+
+    desc "Run cargo clippy"
+    task :clippy do
+      ext_dirs = Dir.glob("ext/*").select { |d| File.directory?(d) && File.exist?("#{d}/Cargo.toml") }
+      ext_dirs.each do |dir|
+        sh "cd #{dir} && cargo clippy -- -D warnings"
+      end
+    end
+
+    desc "Run cargo test"
+    task :test do
+      ext_dirs = Dir.glob("ext/*").select { |d| File.directory?(d) && File.exist?("#{d}/Cargo.toml") }
+      ext_dirs.each do |dir|
+        sh "cd #{dir} && cargo test"
+      end
+    end
+
+    namespace :fix do
+      desc "Auto-fix Clippy warnings (most aggressive)"
+      task :clippy do
+        ext_dirs = Dir.glob("ext/*").select { |d| File.directory?(d) && File.exist?("#{d}/Cargo.toml") }
+        ext_dirs.each do |dir|
+          sh "cd #{dir} && cargo clippy --fix --allow-dirty --allow-staged"
+        end
+      end
+    end
+  end
+end