rage-rb 1.26.1 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1dab3bd5fbff6c838ff8bb686e7f81251f10a3734330f4788990791822484371
-  data.tar.gz: c7d03259c16c307078ed3f01f70cf5505b7ce70a49726f52a109377ec9f3ee44
+  metadata.gz: bbfe0ad2460e5d9f51317d8be527259b500e28de3dd2817fe50017d6d44558fe
+  data.tar.gz: d55249b98d2daad91122eb8f1a0f47618df0775edeaaee1203576d034fc32a18
 SHA512:
-  metadata.gz: 1d2d40b1bc876cfaf50fed91c34764798261f85c90e0ca8ffdd12f5039e4a4aa20b16e372be366ddbb9af07eb4de5a5a9b39c5bc603e604593255df347ef089f
-  data.tar.gz: 952f48b476cc8dcd1c6b604b771e565f1298d14e5c2857f24881f2a22abb7b32bd67b7c3d75497516ca3b72ce6e61165086ac4979471bbcf0c1d7140fd6eb1ef
+  metadata.gz: 3d7a3af0e96961ff51803cb02e4e5d15de02e92d076a76a6cc3f8f27c2e0ae0d6e413f97079db7590a1b476c2feace91795f1ea2c46d01aab1e16ff35581a4b0
+  data.tar.gz: 77852270e3ef3c276f0941ce346741b69f28595e03ff53d6350ca4e58423b88527baa81701365599b2fbeec3d823b6e816f37772a5c1e7d62f94936c66701db7

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 ## [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
+
+- [OpenAPI] Add support for the `root:` option in Blueprinter response annotations (#343).
+- Add `FiberScheduler#timeout_after` (#374).
+
+### Fixed
+
+- [OpenAPI] Avoid caching a request-specific spec URL in the HTML docs page.
+- [Router] Compose and restore `SCRIPT_NAME` correctly for mounted Rack apps.
+- [OpenAPI] Fix schema registry key collisions for Blueprinter classes referenced under different views.
+- Fixed RbNaCl dependency check to produce correct error message (#361).
+
 ## [1.26.1] - 2026-07-17
 
 ### Fixed
@@ -22,7 +52,6 @@
 
 ### Fixed
 
-- [CI] Check all changed PR file pages when requiring changelog updates.
 - [API] Ignore `If-Modified-Since` when `If-None-Match` is present.
 - [API] Use weak comparison for `If-None-Match` validation.
 - [Deferred] Ignore missing temp files during async disk storage cleanup.

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.
@@ -223,7 +232,7 @@ end
 1. Wraps every request in a Fiber
 2. Implements the defer protocol for pausing/resuming async requests
 
-When a request encounters blocking I/O (database query, HTTP request, etc.), the fiber yields. `FiberWrapper` detects this (`fiber.alive?`) and returns a special `:__http_defer__` signal to Iodine, which pauses the connection.
+When a request encounters blocking I/O (database query, HTTP request, etc.), the fiber yields. `FiberWrapper` detects this (`fiber.alive?`) and returns the special `[:__http_defer__, fiber]` tuple to Iodine, which pauses the connection.
 
 When the I/O completes, the fiber resumes and publishes a message to notify Iodine that the response is ready. This is the mechanism that enables transparent, non-blocking concurrency.
 

data/README.md

@@ -145,7 +145,7 @@ Rage prioritizes stable public APIs, long deprecation cycles, and minimal extern
 
 ## Learn More
 
-- Documentation: [https://rage-rb.dev](https://rage-rb.dev/docs/intro)
+- Documentation: [https://rage-rb.dev/docs/intro](https://rage-rb.dev/docs/intro)
 - API Reference: [https://rage-rb.dev/api](https://rage-rb.dev/api)
 - Architecture: [ARCHITECTURE.md](https://github.com/rage-rb/rage/blob/main/ARCHITECTURE.md)
 - Contributing: [CONTRIBUTING.md](https://github.com/rage-rb/rage/blob/main/CONTRIBUTING.md)

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