tina4ruby 3.10.38 → 3.10.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a0442856facd7be61939efc9066b395c7578a2b7bd8df31282e02fdec58b95c
-  data.tar.gz: 33170414bbc5ed736aab77ce1790b62e90a74a62d51fa3f194b154b69acd34c4
+  metadata.gz: 6d61b5cbf67e0703b569e23d10d160e817c0a2ab39e40afc79970d42b4934ef8
+  data.tar.gz: 1c07bde0df2774c7c8105f9ecd90aeb0863e83ad935e89500eda76cf9d638602
 SHA512:
-  metadata.gz: 237cd6644e93ee8ed01754a550a65cd5b43d9da8771631e7cff0745bb3e26e2e2892ddbea96e619bf264b527ce207276436c9f8a5c444f0ed1c28486a27ebe31
-  data.tar.gz: 71fb5d29f52b2aa9971424fbfddcc236881764a7bf6af0bcf491aa0a587d86d1ffcbd6ecfca5296bdbf3d2ee5d504d40eff2ea3eb4753c31dbb0db5c89326690
+  metadata.gz: 7134b5ad784722e27d00bee27dd02a5af60f7e096a38ea7a0a740b1a332d3c12b00cd01b3ee586aa23c2162d7a803505b79447868d7101b5c106ebb1a4e985ef
+  data.tar.gz: ef891151367dfdbed749fb164cff04a8c3884731763647a660ce7f40b61e33fe6cf23c711c79dfc433ecea5af2c80285cdaebe1ac0f4268b850528467dc1c19b

data/lib/tina4/container.rb

@@ -3,9 +3,10 @@
 module Tina4
   # Lightweight dependency injection container.
   #
-  #   Tina4.register(:mailer, MailService.new)          # concrete instance
-  #   Tina4.register(:db) { Database.new(ENV["DB_URL"]) } # lazy factory
-  #   Tina4.resolve(:mailer)                            # => MailService instance
+  #   Tina4::Container.register(:mailer) { MailService.new } # transient — new instance each resolve
+  #   Tina4::Container.singleton(:db) { Database.new(ENV["DB_URL"]) } # singleton — memoised
+  #   Tina4::Container.register(:cache, RedisCacheInstance)  # concrete instance (always same)
+  #   Tina4::Container.resolve(:db)                          # => Database instance
   #
   module Container
     class << self
@@ -14,28 +15,47 @@ module Tina4
       end
 
       # Register a service by name.
-      # Pass an instance directly, or a block for lazy instantiation.
+      # Pass a concrete instance directly, or a block for transient instantiation.
+      # Blocks are called on every resolve() — use singleton() for memoised factories.
       def register(name, instance = nil, &factory)
         raise ArgumentError, "provide an instance or a block, not both" if instance && factory
         raise ArgumentError, "provide an instance or a block" unless instance || factory
 
         registry[name.to_sym] = if factory
-          { factory: factory, instance: nil }
+          { factory: factory, singleton: false, instance: nil }
         else
-          { factory: nil, instance: instance }
+          { factory: nil, singleton: false, instance: instance }
         end
       end
 
+      # Register a singleton factory by name.
+      # The block is called once on first resolve() and the result is memoised.
+      def singleton(name, &factory)
+        raise ArgumentError, "singleton requires a block" unless factory
+
+        registry[name.to_sym] = { factory: factory, singleton: true, instance: nil }
+      end
+
       # Resolve a service by name.
-      # Lazy factories are called once and memoized.
+      # Singletons and concrete instances return the same object each time.
+      # Transient factories (register with block) return a new object each time.
       def resolve(name)
         entry = registry[name.to_sym]
         raise KeyError, "service not registered: #{name}" unless entry
 
-        if entry[:instance]
-          entry[:instance]
-        elsif entry[:factory]
-          entry[:instance] = entry[:factory].call
+        # Concrete instance (register with value)
+        return entry[:instance] if entry[:instance] && entry[:factory].nil?
+
+        if entry[:factory]
+          if entry[:singleton]
+            # Singleton — call once, memoize
+            entry[:instance] ||= entry[:factory].call
+            entry[:instance]
+          else
+            # Transient — call every time
+            entry[:factory].call
+          end
+        else
           entry[:instance]
         end
       end

data/lib/tina4/router.rb

@@ -194,6 +194,14 @@ module Tina4
         @routes ||= []
       end
 
+      def get_routes
+        routes
+      end
+
+      def list_routes
+        routes
+      end
+
       # Registered WebSocket routes
       def ws_routes
         @ws_routes ||= []
@@ -283,6 +291,11 @@ module Tina4
         nil
       end
 
+      # Alias for find_route().
+      def match(path, method)
+        find_route(path, method)
+      end
+
       # Register a class-based middleware globally.
       # The class should define static before_* and/or after_* methods.
       # Example:

data/lib/tina4/version.rb

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

data/lib/tina4.rb

@@ -382,6 +382,10 @@ module Tina4
       Tina4::Container.register(name, instance, &block)
     end
 
+    def singleton(name, &block)
+      Tina4::Container.singleton(name, &block)
+    end
+
     def resolve(name)
       Tina4::Container.resolve(name)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.10.38
+  version: 3.10.39
 platform: ruby
 authors:
 - Tina4 Team