tina4ruby 3.13.4 → 3.13.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f850a40f190c65782dd6f995b210335fa8b5c230c241b7d7031e34c0118f5d9e
-  data.tar.gz: 15a8e7d8cfdadd898917d1604d64cfd3f84dcc83838f5c4bf2a7f2c7ec66df3c
+  metadata.gz: 4cfc3ef750c6d75e22a7c26c3695e5e9a50c841d868b663dbbd0f0b3aaf58987
+  data.tar.gz: 2e6d763e7662cb24e13e3dbdb7147709b5d69a5e1d5fca893f68a36a0bde9f76
 SHA512:
-  metadata.gz: a457acd04c35cfd41a88def3fae8717b054a131fdd674d00eff2eda4bdc5a6084918b5f40622090613f7009eb7007b0135ff0b0cb3df0749d1def6b7ca0834cd
-  data.tar.gz: 65d449d0775ed2599739c7fceffe4f74fa1b0c488cb85a09e257070a3b6c1aa59c85e4d56a5bf0a84c6ad239b2e729099b29c8b9d5edf1719bf59738fe8852af
+  metadata.gz: f340ff33f11ec9e0c3c4cb577fb6eff61d5d674a69ca714fb7adf2e610e08f37201ec582c8e1e854ea31e52700195a7ed6308a4c102b0ff99ea1ebe362f0d6b0
+  data.tar.gz: 5f0d2ab921df913639914dfdb0799691353201b8bb12997524322181cbd22266ac537e409045212cf7c56a8cfb5db1d4a350f90adc3cf3dc53d817213c2a0b2d

data/lib/tina4/drivers/firebird_driver.rb

@@ -118,7 +118,10 @@ module Tina4
 
         open_connection
       rescue LoadError
-        raise "Firebird driver requires the 'fb' gem. Install it with: gem install fb"
+        raise LoadError,
+              "The 'fb' gem is required for Firebird connections. Install one of:\n" \
+              "    bundle add fb     # if your project uses Bundler\n" \
+              "    gem install fb    # bare driver"
       end
 
       def close

data/lib/tina4/drivers/mongodb_driver.rb

@@ -10,8 +10,9 @@ module Tina4
           require "mongo"
         rescue LoadError
           raise LoadError,
-            "The 'mongo' gem is required for MongoDB connections. " \
-            "Install: gem install mongo"
+                "The 'mongo' gem is required for MongoDB connections. Install one of:\n" \
+                "    bundle add mongo     # if your project uses Bundler\n" \
+                "    gem install mongo    # bare driver"
         end
 
         uri = build_uri(connection_string, username, password)

data/lib/tina4/drivers/mssql_driver.rb

@@ -6,7 +6,14 @@ module Tina4
       attr_reader :connection
 
       def connect(connection_string, username: nil, password: nil)
-        require "tiny_tds"
+        begin
+          require "tiny_tds"
+        rescue LoadError
+          raise LoadError,
+                "The 'tiny_tds' gem is required for MSSQL connections. Install one of:\n" \
+                "    bundle add tiny_tds     # if your project uses Bundler\n" \
+                "    gem install tiny_tds    # bare driver"
+        end
         uri = parse_connection(connection_string)
         @connection = TinyTds::Client.new(
           host: uri[:host],

data/lib/tina4/drivers/mysql_driver.rb

@@ -6,7 +6,14 @@ module Tina4
       attr_reader :connection
 
       def connect(connection_string, username: nil, password: nil)
-        require "mysql2"
+        begin
+          require "mysql2"
+        rescue LoadError
+          raise LoadError,
+                "The 'mysql2' gem is required for MySQL connections. Install one of:\n" \
+                "    bundle add mysql2     # if your project uses Bundler\n" \
+                "    gem install mysql2    # bare driver"
+        end
         uri = URI.parse(connection_string)
         @connection = Mysql2::Client.new(
           host: uri.host || "localhost",

data/lib/tina4/drivers/odbc_driver.rb

@@ -21,8 +21,9 @@ module Tina4
           require "odbc"
         rescue LoadError
           raise LoadError,
-            "The 'ruby-odbc' gem is required for ODBC connections. " \
-            "Install: gem install ruby-odbc"
+                "The 'ruby-odbc' gem is required for ODBC connections. Install one of:\n" \
+                "    bundle add ruby-odbc     # if your project uses Bundler\n" \
+                "    gem install ruby-odbc    # bare driver"
         end
 
         dsn_string = connection_string.to_s

data/lib/tina4/drivers/postgres_driver.rb

@@ -6,7 +6,14 @@ module Tina4
       attr_reader :connection
 
       def connect(connection_string, username: nil, password: nil)
-        require "pg"
+        begin
+          require "pg"
+        rescue LoadError
+          raise LoadError,
+                "The 'pg' gem is required for PostgreSQL connections. Install one of:\n" \
+                "    bundle add pg     # if your project uses Bundler\n" \
+                "    gem install pg    # bare driver"
+        end
         url = connection_string
         if username || password
           uri = URI.parse(url)

data/lib/tina4/frond.rb

@@ -21,6 +21,33 @@ module Tina4
   end
 
   class Frond
+    # -- Class-level registries ------------------------------------------------
+    # Persist globals, filters, and tests across hot-reloads and across module
+    # boundaries. When app.rb does ``Tina4::Frond.add_filter("money") { ... }``
+    # at startup before any instance exists, the registration sits here. Every
+    # subsequent ``Tina4::Frond.new`` drains these into its instance-local
+    # registries — so hot-reloads (which re-execute ``frond = Frond.new``) and
+    # late-constructed engines automatically inherit prior registrations.
+    #
+    # The same-name dual-callable (class + instance) methods below let callers
+    # write either ``Tina4::Frond.add_filter(...)`` (class-level only) or
+    # ``frond.add_filter(...)`` (updates both the class registry and the
+    # instance's live filter map). Parity with tina4-python's
+    # ``_ClassOrInstanceMethod`` descriptor.
+    @@class_filters = {}
+    @@class_globals = {}
+    @@class_tests   = {}
+
+    # Clear the class-level globals/filters/tests registries.
+    #
+    # Useful in test fixtures to prevent leaking state between tests. Does
+    # NOT affect built-in filters or globals — only user-registered ones.
+    def self.clear_registry
+      @@class_filters = {}
+      @@class_globals = {}
+      @@class_tests   = {}
+    end
+
     # -- Token types ----------------------------------------------------------
     TEXT    = :text
     VAR     = :var      # {{ ... }}
@@ -187,6 +214,16 @@ module Tina4
 
       # Built-in global functions
       register_builtin_globals
+
+      # Drain class-level registries into this instance. Filters and tests
+      # registered via ``Tina4::Frond.add_filter`` BEFORE this instance was
+      # constructed flow in here. Globals likewise. This is the key to the
+      # static-facade: ``app.rb`` registers once at startup, and every
+      # Frond instance created later (including those born from hot-reloads)
+      # automatically inherits the registration. Parity with tina4-python.
+      @filters.merge!(@@class_filters)
+      @globals.merge!(@@class_globals)
+      @tests.merge!(@@class_tests)
     end
 
     # Render a template file with data. Uses token caching for performance.
@@ -249,19 +286,61 @@ module Tina4
       @dotted_split_cache.clear
     end
 
+    # Register a custom filter on the class registry only.
+    #
+    # Callable as ``Tina4::Frond.add_filter("money") { |v| ... }`` at app
+    # startup BEFORE any instance exists. The registration is remembered at
+    # class level so every later ``Tina4::Frond.new`` inherits it. To also
+    # update a live instance's filter map, use the instance method form.
+    def self.add_filter(name, &blk)
+      @@class_filters[name.to_s] = blk
+    end
+
+    # Register a custom test on the class registry only.
+    #
+    # Same dual-callable semantics as ``add_filter`` — see that method for
+    # the static-facade pattern.
+    def self.add_test(name, &blk)
+      @@class_tests[name.to_s] = blk
+    end
+
+    # Register a global variable on the class registry only.
+    #
+    # Same dual-callable semantics as ``add_filter`` — see that method for
+    # the static-facade pattern.
+    def self.add_global(name, value)
+      @@class_globals[name.to_s] = value
+    end
+
     # Register a custom filter.
+    #
+    # Updates BOTH the class registry (so future ``Tina4::Frond.new`` picks
+    # the filter up) AND this instance's live filter map (so the change is
+    # visible to subsequent renders on the current engine).
     def add_filter(name, &blk)
+      self.class.add_filter(name, &blk)
       @filters[name.to_s] = blk
+      self
     end
 
     # Register a custom test.
+    #
+    # Updates BOTH the class registry and this instance's live tests map.
+    # See ``add_filter`` for the dual-write semantics.
     def add_test(name, &blk)
+      self.class.add_test(name, &blk)
       @tests[name.to_s] = blk
+      self
     end
 
     # Register a global variable available in all templates.
+    #
+    # Updates BOTH the class registry and this instance's live globals map.
+    # See ``add_filter`` for the dual-write semantics.
     def add_global(name, value)
+      self.class.add_global(name, value)
       @globals[name.to_s] = value
+      self
     end
 
     # Enable sandbox mode.

data/lib/tina4/mcp.rb

@@ -612,8 +612,12 @@ module Tina4
         line = err_lines.first.strip
         # Strip the absolute project_root prefix so the error reads
         # as "src/routes/foo.rb:3: syntax error, ..." instead of the
-        # full /Users/... path.
-        line.sub("#{project_root}/", "")
+        # full /Users/... path. Use gsub because Ruby 3.2's MRI parser
+        # double-prints the path — once as the file label prefix and
+        # once inside the (SyntaxError) reference — and the test asserts
+        # the absolute path appears nowhere in import_error.
+        # See: spec/mcp_spec.rb defensive file_write test (CI Ruby 3.2).
+        line.gsub("#{project_root}/", "")
       end
 
       redact_env = lambda do |key, value|

data/lib/tina4/rack_app.rb

@@ -108,22 +108,29 @@ module Tina4
       else
         # RFC 9110 conformance — before falling through to 404, check whether
         # the PATH is known to the router under any OTHER method.
-        #   - OPTIONS request → 204 with Allow header (§9.3.7)
+        #   - OPTIONS request → 204 with Allow header (§9.3.7). Bare OPTIONS
+        #     on an unknown path also returns 204 (empty Allow header) —
+        #     OPTIONS is a discovery method; rejecting unknown probes with
+        #     404 confuses link checkers and monitoring tools and breaks
+        #     CORS preflight that lacks the Origin/ACRM headers our earlier
+        #     fast-path requires. Matches PHP/Node behaviour. Fixes
+        #     spec/rack_app_spec.rb OPTIONS preflight.
         #   - Any other method (PUT on GET-only, TRACE, CONNECT, etc.)
-        #     → 405 with Allow header (§15.5.6 + §10.2.1)
+        #     → 405 with Allow header (§15.5.6 + §10.2.1) when the path
+        #     exists; → 404 when nothing about the path is known.
         allowed = Tina4::Router.methods_allowed_for_path(path)
-        if !allowed.empty?
+        if method.to_s.upcase == "OPTIONS"
+          allow_header = allowed.empty? ? "" : allowed.join(", ")
+          rack_response = [204, { "allow" => allow_header, "content-length" => "0" }, [""]]
+          matched_pattern = nil
+        elsif !allowed.empty?
           allow_header = allowed.join(", ")
-          if method.to_s.upcase == "OPTIONS"
-            rack_response = [204, { "allow" => allow_header, "content-length" => "0" }, [""]]
-          else
-            body = %({"error":"Method Not Allowed","path":"#{path}","method":"#{method}","allow":[#{allowed.map { |m| %("#{m}") }.join(",")}],"status":405})
-            rack_response = [405, {
-              "allow" => allow_header,
-              "content-type" => "application/json",
-              "content-length" => body.bytesize.to_s
-            }, [body]]
-          end
+          body = %({"error":"Method Not Allowed","path":"#{path}","method":"#{method}","allow":[#{allowed.map { |m| %("#{m}") }.join(",")}],"status":405})
+          rack_response = [405, {
+            "allow" => allow_header,
+            "content-type" => "application/json",
+            "content-length" => body.bytesize.to_s
+          }, [body]]
           matched_pattern = nil
         else
           rack_response = handle_404(path)

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.13.4"
+  VERSION = "3.13.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.13.4
+  version: 3.13.6
 platform: ruby
 authors:
 - Tina4 Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-04 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack