ratatui_ruby-devtools 0.1.0

data/lib/ratatui_ruby/devtools/version.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Devtools
+    # Current version of the ratatui_ruby-devtools gem.
+    VERSION = "0.1.0"
+  end
+end

data/lib/ratatui_ruby/devtools.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require_relative "devtools/version"
+
+# Root namespace for RatatuiRuby ecosystem gems.
+#
+# This gem provides development tooling shared across the ecosystem. Consumer
+# gems require this and call <tt>Devtools.install!</tt> to load Rake tasks.
+module RatatuiRuby
+  # Development tooling for the RatatuiRuby ecosystem.
+  #
+  # This gem provides shared Rake tasks, linter configurations, and build
+  # tooling used across all RatatuiRuby ecosystem gems.
+  #
+  # == Usage
+  #
+  # In your Rakefile:
+  #
+  #   require "ratatui_ruby/devtools"
+  #   RatatuiRuby::Devtools.install!
+  #
+  #   # Optional: import project-specific tasks
+  #   Dir.glob("tasks/*.rake").each { |r| import r }
+  #
+  #   task default: %w[lint:fix test lint]
+  #
+  module Devtools
+    # Base error class for devtools failures.
+    #
+    # Rake tasks may encounter errors during configuration discovery or task
+    # execution. This class provides a common base for all devtools exceptions.
+    class Error < StandardError; end
+
+    class << self
+      # Configuration accessors - auto-discovered if not set
+      attr_writer :gem_name, :gemspec_file, :version_file
+
+      # Loads all devtools Rake tasks into the current application.
+      #
+      # Consumer gems need shared tasks for linting, testing, and licensing.
+      # Manually copying rake files is tedious and leads to drift. Call this
+      # once in your Rakefile to import all devtools tasks.
+      #
+      # === Example
+      #
+      #   require "ratatui_ruby/devtools"
+      #   RatatuiRuby::Devtools.install!
+      #
+      def install!
+        tasks_dir = File.expand_path("devtools/tasks", __dir__)
+        Dir.glob("#{tasks_dir}/*.rake").each do |task_file|
+          Rake.application.add_import(task_file)
+        end
+        Rake.application.load_imports
+      end
+
+      # Returns the gem name, auto-discovered from gemspec if not set.
+      #
+      # Tasks need to know which gem they're operating on. Auto-discovery from
+      # gemspec files means zero configuration for standard layouts. Override
+      # via <tt>gem_name=</tt> if needed.
+      def gem_name
+        @gem_name ||= discover_gem_name
+      end
+
+      # Returns the path to the gemspec file.
+      #
+      # Tasks parse the gemspec for metadata. Auto-discovery finds the single
+      # <tt>.gemspec</tt> file in the project root. Override via
+      # <tt>gemspec_file=</tt> for non-standard layouts.
+      def gemspec_file
+        @gemspec_file ||= discover_gemspec
+      end
+
+      # Returns the path to the version.rb file.
+      #
+      # Version bumping needs the version file location. Auto-discovery finds
+      # it in the standard <tt>lib/*/</tt> path. Override via
+      # <tt>version_file=</tt> for non-standard layouts.
+      def version_file
+        @version_file ||= discover_version_file
+      end
+
+      # Returns the path to the templates directory.
+      #
+      # Scaffolding commands copy files from templates. This method provides
+      # the absolute path regardless of caller location.
+      def templates_path
+        File.expand_path("devtools/templates", __dir__)
+      end
+
+      # Returns the path to the tasks directory.
+      #
+      # Debug and introspection tools may need to list available tasks. This
+      # method provides the absolute path regardless of caller location.
+      def tasks_path
+        File.expand_path("devtools/tasks", __dir__)
+      end
+
+      private def discover_gemspec
+        gemspecs = Dir.glob("*.gemspec")
+        raise Error, "No *.gemspec found in #{Dir.pwd}" if gemspecs.empty?
+        raise Error, "Multiple gemspecs found: #{gemspecs.join(', ')}" if gemspecs.size > 1
+
+        gemspecs.first
+      end
+
+      private def discover_gem_name
+        File.basename(gemspec_file, ".gemspec")
+      end
+
+      private def discover_version_file
+        # Convention: lib/gem_name/version.rb (with underscores for namespacing)
+        # e.g., ratatui_ruby-tea -> lib/ratatui_ruby/tea/version.rb
+        parts = gem_name.split("-")
+        if parts.size > 1
+          # ratatui_ruby-tea -> ratatui_ruby/tea
+          path = "lib/#{parts.first}/#{parts[1..].join('/')}/version.rb"
+        else
+          # ratatui_ruby -> ratatui_ruby
+          path = "lib/#{gem_name}/version.rb"
+        end
+
+        return path if File.exist?(path)
+
+        # Fallback: search for any version.rb in lib/
+        found = Dir.glob("lib/**/version.rb").first
+        found || path
+      end
+    end
+  end
+end

data/mise.toml

@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+[tools]
+ruby = "4.0.0"
+python = "3.12"
+pre-commit = "latest"

data/sig/ratatui_ruby/devtools.rbs

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module Devtools
+    VERSION: String
+
+    class Error < StandardError
+    end
+
+    def self.install!: () -> void
+    def self.templates_path: () -> String
+    def self.tasks_path: () -> String
+  end
+end