rage-rb 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 158f3d2cea7753f15be62035f7b196117284a4112159400ecf57759fb719ed08
-  data.tar.gz: 002ef2cc3b75084f0393b254f3c2b61e2e6be83d1a5cf0e64b7529aa3452e1a7
+  metadata.gz: bbfe0ad2460e5d9f51317d8be527259b500e28de3dd2817fe50017d6d44558fe
+  data.tar.gz: d55249b98d2daad91122eb8f1a0f47618df0775edeaaee1203576d034fc32a18
 SHA512:
-  metadata.gz: 3f194f003221636c0fe3120a31d5b60a38d9a8a496fc873e13fdc6c2020f8a59f4348073a06a019f7e3de6609e4b73e2bb493ffce12bb63f8f317365a720fdcc
-  data.tar.gz: 3af06d4347e71056ca9bd26e9b0edfc84e554399ed2b37aedce6afbea6b11247091929874b76540a63b3041c8b1edd3f93cc197904b68d19e4ef81a94ccc2ffd
+  metadata.gz: 3d7a3af0e96961ff51803cb02e4e5d15de02e92d076a76a6cc3f8f27c2e0ae0d6e413f97079db7590a1b476c2feace91795f1ea2c46d01aab1e16ff35581a4b0
+  data.tar.gz: 77852270e3ef3c276f0941ce346741b69f28595e03ff53d6350ca4e58423b88527baa81701365599b2fbeec3d823b6e816f37772a5c1e7d62f94936c66701db7

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+## [1.28.0] - 2026-09-15
+
+### Added
+
+- [OpenAPI] Add `openapi:validate` Rake task for OpenAPI tags validation (#163).
+- [Logger] Add `config.log_redact_keys=` for redacting structured log context (#386).
+- [Telemetry] Add  `Rage::Telemetry::Capacity` (#396).
+- [Telemetry] Add `Rage::Telemetry.every` (#381).
+- Add `Rage::Configuration.after_reload` (#398).
+
+### Fixed
+
+- Correctly enqueue deferred tasks with only positional arguments on Ruby < 3.3.4 (#385).
+- Improve restart logs in daemon (#391).
+- Ensure no duplicate daemons or error reporters can be registered (#392).
+
 ## [1.27.0] - 2026-08-06
 
 ### Added

data/CONTRIBUTING.md

@@ -6,6 +6,7 @@ This guide is designed to help contributors understand the project's internals,
 
 - [Design Principles](#design-principles)
 - [Documentation Standards](#documentation-standards)
+- [Changelog](#changelog)
 - [Dynamic Code Generation](#dynamic-code-generation)
 - [Iodine Integration](#iodine-integration)
 - [The Fiber Runtime](#the-fiber-runtime)
@@ -81,6 +82,14 @@ The `@private` tag signals to contributors:
 - It can be modified or removed without deprecation
 - It can be used freely within the framework codebase
 
+## Changelog
+
+Pull requests that introduce new features or change existing behavior must include an entry in `CHANGELOG.md`. This helps users understand what changed between versions.
+
+Not all changes require a changelog entry. For changes that don't affect users, a maintainer will add the `skip-changelog` label to your PR instead. This includes:
+- Internal refactoring, CI updates, and documentation fixes
+- Intermediary changes for larger features that aren't used yet - the changelog entry should be added when the feature is complete
+
 ## Dynamic Code Generation
 
 Rage relies heavily on dynamic code generation for both performance and flexibility. Understanding this pattern is essential for contributing to the framework.

data/exe/rage

@@ -1,4 +1,4 @@
 #!/usr/bin/env ruby
 
 require_relative "../lib/rage/cli"
-Rage::CLI.start
+Rage::CLI::App.start

data/lib/rage/cable/channel.rb

@@ -169,6 +169,12 @@ class Rage::Cable::Channel
               ActiveRecord::Base.connection_handler.clear_active_connections!(:all)
             RUBY
           end}
+
+          #{if is_subscribing
+            <<~RUBY
+              @__is_subscribing = false
+            RUBY
+          end}
         end
       RUBY
 
@@ -302,17 +308,7 @@ class Rage::Cable::Channel
 
     # @private
     def __stream_name_for(streamables)
-      stream_name = Array(streamables).map do |streamable|
-        if streamable.respond_to?(:id)
-          "#{streamable.class.name}:#{streamable.id}"
-        elsif streamable.is_a?(String) || streamable.is_a?(Symbol) || streamable.is_a?(Numeric)
-          streamable
-        else
-          raise ArgumentError, "Unable to generate stream name. Expected an object that responds to `id`, got: #{streamable.class}"
-        end
-      end
-
-      "#{name}:#{stream_name.join(":")}"
+      "#{name}:#{Rage::Internal.stream_name_for(streamables)}"
     end
 
     protected

data/lib/rage/cli/base.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Rage::CLI
+  class Base < Thor
+    private
+
+    def environment
+      require File.expand_path("config/application.rb", Dir.pwd)
+
+      if Rage.config.internal.rails_mode
+        require File.expand_path("config/environment.rb", Dir.pwd)
+      end
+    end
+
+    def set_env(options)
+      if options[:environment]
+        ENV["RAGE_ENV"] = ENV["RAILS_ENV"] = options[:environment]
+      elsif ENV["RAGE_ENV"]
+        ENV["RAILS_ENV"] = ENV["RAGE_ENV"]
+      elsif ENV["RAILS_ENV"]
+        ENV["RAGE_ENV"] = ENV["RAILS_ENV"]
+      else
+        ENV["RAGE_ENV"] = ENV["RAILS_ENV"] = "development"
+      end
+    end
+  end
+end

data/lib/rage/cli/code_generator.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Rage::CLI
+  class CodeGenerator < Base
+    include Thor::Actions
+
+    def self.source_root
+      File.expand_path("../templates", __dir__)
+    end
+
+    desc "migration NAME", "Generate a new migration"
+    def migration(name = nil)
+      return help("migration") if name.nil?
+
+      setup
+      Rake::Task["db:new_migration"].invoke(name)
+    end
+
+    desc "model NAME", "Generate a new model"
+    def model(name = nil)
+      return help("model") if name.nil?
+
+      setup
+      migration("create_#{name.pluralize}")
+      @model_name = name.classify
+      template("model-template/model.rb", "app/models/#{name.singularize.underscore}.rb")
+    end
+
+    desc "controller NAME", "Generate a new controller"
+    def controller(name = nil)
+      return help("controller") if name.nil?
+
+      setup
+      unless defined?(ActiveSupport::Inflector)
+        raise LoadError, <<~ERR
+          ActiveSupport::Inflector is required to run this command. Add the following line to your Gemfile:
+          gem "activesupport", require: "active_support/inflector"
+        ERR
+      end
+
+      # remove trailing Controller if already present
+      normalized_name = name.sub(/_?controller$/i, "")
+      @controller_name = "#{normalized_name.camelize}Controller"
+      file_name = "#{normalized_name.underscore}_controller.rb"
+
+      template("controller-template/controller.rb", "app/controllers/#{file_name}")
+    end
+
+    private
+
+    def setup
+      @setup ||= begin
+        require "rake"
+        load "Rakefile"
+      end
+    end
+  end
+end

data/lib/rage/cli/new_app_generator.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Rage::CLI
+  class NewAppGenerator < Thor::Group
+    include Thor::Actions
+    argument :path, type: :string
+    argument :database, type: :string, required: false
+
+    def self.source_root
+      File.expand_path("../templates", __dir__)
+    end
+
+    def setup
+      @use_database = !database.nil?
+    end
+
+    def create_directory
+      empty_directory(path)
+    end
+
+    def copy_files
+      inject_templates
+    end
+
+    def install_database
+      return unless @use_database
+
+      @app_name = path.tr("-", "_").downcase
+      append_to_file "#{path}/Gemfile", <<~RUBY
+
+        gem "#{get_db_gem_name}"
+        gem "activerecord"
+        gem "standalone_migrations", require: false
+      RUBY
+
+      inject_templates("db-templates")
+      inject_templates("db-templates/#{database}")
+    end
+
+    private
+
+    def inject_templates(from = nil)
+      root = "#{self.class.source_root}/#{from}"
+
+      Dir.glob("*", base: root).each do |template|
+        next if File.directory?("#{root}/#{template}")
+
+        *template_path_parts, template_name = template.split("-")
+        template("#{root}/#{template}", [path, *template_path_parts, template_name].join("/"))
+      end
+    end
+
+    def get_db_gem_name
+      case database
+      when "mysql"
+        "mysql2"
+      when "trilogy"
+        "trilogy"
+      when "postgresql"
+        "pg"
+      when "sqlite3"
+        "sqlite3"
+      end
+    end
+  end
+end

data/lib/rage/cli/openapi.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Rage::CLI
+  class OpenAPI < Base
+    desc "validate", "Validate OpenAPI tags and fail if any warnings were produced"
+    def validate
+      environment
+
+      abort "OpenAPI validation requires a booted application." unless Rage.config.internal.initialized?
+
+      warnings = Rage::OpenAPI.__collect_warnings { Rage::OpenAPI.build }
+
+      if warnings.any?
+        abort "#{set_color("𐄂", :red, :bold)} OpenAPI validation failed with #{warnings.size} warning(s)."
+      else
+        say "#{set_color("✓", :green, :bold)} OpenAPI validation passed without warnings."
+      end
+    end
+  end
+end