spikard 0.2.0 → 0.2.1

data/lib/spikard/provide.rb

@@ -1,228 +1,228 @@
-# frozen_string_literal: true
-
-module Spikard
-  # Wrapper class for dependency providers
-  #
-  # This class wraps factory functions and configuration for dependency injection.
-  # It provides a consistent API across Python, Node.js, and Ruby bindings.
-  #
-  # @example Factory with caching
-  #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
-  #
-  # @example Factory with dependencies
-  #   app.provide("auth", Spikard::Provide.new(
-  #     method("create_auth_service"),
-  #     depends_on: ["db", "cache"],
-  #     singleton: true
-  #   ))
-  class Provide
-    attr_reader :factory, :depends_on, :singleton, :cacheable
-
-    # Create a new dependency provider
-    #
-    # @param factory [Proc, Method] The factory function that creates the dependency value
-    # @param depends_on [Array<String, Symbol>] List of dependency keys this factory depends on
-    # @param singleton [Boolean] Whether to cache the value globally (default: false)
-    # @param cacheable [Boolean] Whether to cache the value per-request (default: true)
-    def initialize(factory, depends_on: [], singleton: false, cacheable: true)
-      @factory = factory
-      @depends_on = Array(depends_on).map(&:to_s)
-      @singleton = singleton
-      @cacheable = cacheable
-    end
-
-    # Check if the factory is async (based on method arity or other heuristics)
-    #
-    # @return [Boolean] True if the factory appears to be async
-    def async?
-      # Ruby doesn't have explicit async/await like Python/JS
-      # We could check if it returns a Thread or uses Fiber
-      false
-    end
-
-    # Check if the factory is an async generator
-    #
-    # @return [Boolean] True if the factory is an async generator
-    def async_generator?
-      false
-    end
-  end
-
-  # Dependency Injection support for Spikard applications
-  #
-  # Provides methods for registering and managing dependencies that can be
-  # automatically injected into route handlers.
-  #
-  # @example Registering a value dependency
-  #   app.provide("database_url", "postgresql://localhost/mydb")
-  #
-  # @example Registering a factory dependency
-  #   app.provide("db_pool", depends_on: ["database_url"]) do |database_url:|
-  #     ConnectionPool.new(database_url)
-  #   end
-  #
-  # @example Singleton dependency (shared across all requests)
-  #   app.provide("config", singleton: true) do
-  #     Config.load_from_file("config.yml")
-  #   end
-  #
-  # @example Using Provide wrapper
-  #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
-  module ProvideSupport
-    # Register a dependency in the DI container
-    #
-    # This method supports three patterns:
-    # 1. **Value dependency**: Pass a value directly (e.g., string, number, object)
-    # 2. **Factory dependency**: Pass a block that computes the value
-    # 3. **Provide wrapper**: Pass a Spikard::Provide instance
-    #
-    # @param key [String, Symbol] Unique identifier for the dependency
-    # @param value [Object, Provide, nil] Static value, Provide instance, or nil
-    # @param depends_on [Array<String, Symbol>] List of dependency keys this factory depends on
-    # @param singleton [Boolean] Whether to cache the value globally (default: false)
-    # @param cacheable [Boolean] Whether to cache the value per-request (default: true)
-    # @yield Optional factory block that receives dependencies as keyword arguments
-    # @yieldparam **deps [Hash] Resolved dependencies as keyword arguments
-    # @yieldreturn [Object] The computed dependency value
-    # @return [self] Returns self for method chaining
-    #
-    # @example Value dependency
-    #   app.provide("app_name", "MyApp")
-    #   app.provide("port", 8080)
-    #
-    # @example Factory with dependencies
-    #   app.provide("database", depends_on: ["config"]) do |config:|
-    #     Database.connect(config["db_url"])
-    #   end
-    #
-    # @example Singleton factory
-    #   app.provide("thread_pool", singleton: true) do
-    #     ThreadPool.new(size: 10)
-    #   end
-    #
-    # @example Non-cacheable factory (resolves every time)
-    #   app.provide("request_id", cacheable: false) do
-    #     SecureRandom.uuid
-    #   end
-    #
-    # @example Using Provide wrapper
-    #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
-    # rubocop:disable Metrics/MethodLength
-    def provide(key, value = nil, depends_on: [], singleton: false, cacheable: true, &block)
-      key_str = key.to_s
-      @dependencies ||= {}
-
-      # Handle Provide wrapper instances
-      if value.is_a?(Provide)
-        provider = value
-        @dependencies[key_str] = {
-          type: :factory,
-          factory: provider.factory,
-          depends_on: provider.depends_on,
-          singleton: provider.singleton,
-          cacheable: provider.cacheable
-        }
-      elsif block
-        # Factory dependency (block form)
-        @dependencies[key_str] = {
-          type: :factory,
-          factory: block,
-          depends_on: Array(depends_on).map(&:to_s),
-          singleton: singleton,
-          cacheable: cacheable
-        }
-      else
-        # Value dependency
-        raise ArgumentError, 'Either provide a value or a block, not both' if value.nil?
-
-        @dependencies[key_str] = {
-          type: :value,
-          value: value,
-          singleton: true, # Values are always singleton
-          cacheable: true
-        }
-      end
-
-      self
-    end
-    # rubocop:enable Metrics/MethodLength
-
-    # Get all registered dependencies
-    #
-    # @return [Hash] Dictionary mapping dependency keys to their definitions
-    # @api private
-    def dependencies
-      @dependencies ||= {}
-      @dependencies.dup
-    end
-  end
-
-  # Dependency injection handler wrapper
-  #
-  # Wraps a route handler to inject dependencies based on parameter names.
-  # Dependencies are resolved from the DI container and passed as keyword arguments.
-  #
-  # @api private
-  module DIHandlerWrapper
-    # Wrap a handler to inject dependencies
-    #
-    # @param handler [Proc] The original route handler
-    # @param dependencies [Hash] Available dependencies from the app
-    # @return [Proc] Wrapped handler with DI support
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-    def self.wrap_handler(handler, dependencies)
-      # Extract parameter names from the handler
-      params = handler.parameters.map { |_type, name| name.to_s }
-
-      # Find which parameters match registered dependencies
-      injectable_params = params & dependencies.keys
-
-      if injectable_params.empty?
-        # No DI needed, return original handler
-        return handler
-      end
-
-      # Create wrapped handler that injects dependencies
-      lambda do |request|
-        # Build kwargs with injected dependencies
-        kwargs = {}
-
-        injectable_params.each do |param_name|
-          dep_def = dependencies[param_name]
-          kwargs[param_name.to_sym] = resolve_dependency(dep_def, request)
-        end
-
-        # Call original handler with injected dependencies
-        if handler.arity.zero?
-          # Handler takes no arguments (dependencies injected via closure or instance vars)
-          handler.call
-        elsif injectable_params.length == params.length
-          # All parameters are dependencies
-          handler.call(**kwargs)
-        else
-          # Mix of request data and dependencies
-          handler.call(request, **kwargs)
-        end
-      end
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
-
-    # Resolve a dependency definition
-    #
-    # @param dep_def [Hash] Dependency definition
-    # @param request [Hash] Request context (unused for now, future: per-request deps)
-    # @return [Object] Resolved dependency value
-    # @api private
-    def self.resolve_dependency(dep_def, _request)
-      case dep_def[:type]
-      when :value
-        dep_def[:value]
-      when :factory
-        factory = dep_def[:factory]
-        dep_def[:depends_on]
-        # TODO: Implement nested dependency resolution when dependencies are provided
-        factory.call
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Spikard
+  # Wrapper class for dependency providers
+  #
+  # This class wraps factory functions and configuration for dependency injection.
+  # It provides a consistent API across Python, Node.js, and Ruby bindings.
+  #
+  # @example Factory with caching
+  #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
+  #
+  # @example Factory with dependencies
+  #   app.provide("auth", Spikard::Provide.new(
+  #     method("create_auth_service"),
+  #     depends_on: ["db", "cache"],
+  #     singleton: true
+  #   ))
+  class Provide
+    attr_reader :factory, :depends_on, :singleton, :cacheable
+
+    # Create a new dependency provider
+    #
+    # @param factory [Proc, Method] The factory function that creates the dependency value
+    # @param depends_on [Array<String, Symbol>] List of dependency keys this factory depends on
+    # @param singleton [Boolean] Whether to cache the value globally (default: false)
+    # @param cacheable [Boolean] Whether to cache the value per-request (default: true)
+    def initialize(factory, depends_on: [], singleton: false, cacheable: true)
+      @factory = factory
+      @depends_on = Array(depends_on).map(&:to_s)
+      @singleton = singleton
+      @cacheable = cacheable
+    end
+
+    # Check if the factory is async (based on method arity or other heuristics)
+    #
+    # @return [Boolean] True if the factory appears to be async
+    def async?
+      # Ruby doesn't have explicit async/await like Python/JS
+      # We could check if it returns a Thread or uses Fiber
+      false
+    end
+
+    # Check if the factory is an async generator
+    #
+    # @return [Boolean] True if the factory is an async generator
+    def async_generator?
+      false
+    end
+  end
+
+  # Dependency Injection support for Spikard applications
+  #
+  # Provides methods for registering and managing dependencies that can be
+  # automatically injected into route handlers.
+  #
+  # @example Registering a value dependency
+  #   app.provide("database_url", "postgresql://localhost/mydb")
+  #
+  # @example Registering a factory dependency
+  #   app.provide("db_pool", depends_on: ["database_url"]) do |database_url:|
+  #     ConnectionPool.new(database_url)
+  #   end
+  #
+  # @example Singleton dependency (shared across all requests)
+  #   app.provide("config", singleton: true) do
+  #     Config.load_from_file("config.yml")
+  #   end
+  #
+  # @example Using Provide wrapper
+  #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
+  module ProvideSupport
+    # Register a dependency in the DI container
+    #
+    # This method supports three patterns:
+    # 1. **Value dependency**: Pass a value directly (e.g., string, number, object)
+    # 2. **Factory dependency**: Pass a block that computes the value
+    # 3. **Provide wrapper**: Pass a Spikard::Provide instance
+    #
+    # @param key [String, Symbol] Unique identifier for the dependency
+    # @param value [Object, Provide, nil] Static value, Provide instance, or nil
+    # @param depends_on [Array<String, Symbol>] List of dependency keys this factory depends on
+    # @param singleton [Boolean] Whether to cache the value globally (default: false)
+    # @param cacheable [Boolean] Whether to cache the value per-request (default: true)
+    # @yield Optional factory block that receives dependencies as keyword arguments
+    # @yieldparam **deps [Hash] Resolved dependencies as keyword arguments
+    # @yieldreturn [Object] The computed dependency value
+    # @return [self] Returns self for method chaining
+    #
+    # @example Value dependency
+    #   app.provide("app_name", "MyApp")
+    #   app.provide("port", 8080)
+    #
+    # @example Factory with dependencies
+    #   app.provide("database", depends_on: ["config"]) do |config:|
+    #     Database.connect(config["db_url"])
+    #   end
+    #
+    # @example Singleton factory
+    #   app.provide("thread_pool", singleton: true) do
+    #     ThreadPool.new(size: 10)
+    #   end
+    #
+    # @example Non-cacheable factory (resolves every time)
+    #   app.provide("request_id", cacheable: false) do
+    #     SecureRandom.uuid
+    #   end
+    #
+    # @example Using Provide wrapper
+    #   app.provide("db", Spikard::Provide.new(method("create_db"), cacheable: true))
+    # rubocop:disable Metrics/MethodLength
+    def provide(key, value = nil, depends_on: [], singleton: false, cacheable: true, &block)
+      key_str = key.to_s
+      @dependencies ||= {}
+
+      # Handle Provide wrapper instances
+      if value.is_a?(Provide)
+        provider = value
+        @dependencies[key_str] = {
+          type: :factory,
+          factory: provider.factory,
+          depends_on: provider.depends_on,
+          singleton: provider.singleton,
+          cacheable: provider.cacheable
+        }
+      elsif block
+        # Factory dependency (block form)
+        @dependencies[key_str] = {
+          type: :factory,
+          factory: block,
+          depends_on: Array(depends_on).map(&:to_s),
+          singleton: singleton,
+          cacheable: cacheable
+        }
+      else
+        # Value dependency
+        raise ArgumentError, 'Either provide a value or a block, not both' if value.nil?
+
+        @dependencies[key_str] = {
+          type: :value,
+          value: value,
+          singleton: true, # Values are always singleton
+          cacheable: true
+        }
+      end
+
+      self
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    # Get all registered dependencies
+    #
+    # @return [Hash] Dictionary mapping dependency keys to their definitions
+    # @api private
+    def dependencies
+      @dependencies ||= {}
+      @dependencies.dup
+    end
+  end
+
+  # Dependency injection handler wrapper
+  #
+  # Wraps a route handler to inject dependencies based on parameter names.
+  # Dependencies are resolved from the DI container and passed as keyword arguments.
+  #
+  # @api private
+  module DIHandlerWrapper
+    # Wrap a handler to inject dependencies
+    #
+    # @param handler [Proc] The original route handler
+    # @param dependencies [Hash] Available dependencies from the app
+    # @return [Proc] Wrapped handler with DI support
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+    def self.wrap_handler(handler, dependencies)
+      # Extract parameter names from the handler
+      params = handler.parameters.map { |_type, name| name.to_s }
+
+      # Find which parameters match registered dependencies
+      injectable_params = params & dependencies.keys
+
+      if injectable_params.empty?
+        # No DI needed, return original handler
+        return handler
+      end
+
+      # Create wrapped handler that injects dependencies
+      lambda do |request|
+        # Build kwargs with injected dependencies
+        kwargs = {}
+
+        injectable_params.each do |param_name|
+          dep_def = dependencies[param_name]
+          kwargs[param_name.to_sym] = resolve_dependency(dep_def, request)
+        end
+
+        # Call original handler with injected dependencies
+        if handler.arity.zero?
+          # Handler takes no arguments (dependencies injected via closure or instance vars)
+          handler.call
+        elsif injectable_params.length == params.length
+          # All parameters are dependencies
+          handler.call(**kwargs)
+        else
+          # Mix of request data and dependencies
+          handler.call(request, **kwargs)
+        end
+      end
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+
+    # Resolve a dependency definition
+    #
+    # @param dep_def [Hash] Dependency definition
+    # @param request [Hash] Request context (unused for now, future: per-request deps)
+    # @return [Object] Resolved dependency value
+    # @api private
+    def self.resolve_dependency(dep_def, _request)
+      case dep_def[:type]
+      when :value
+        dep_def[:value]
+      when :factory
+        factory = dep_def[:factory]
+        dep_def[:depends_on]
+        # TODO: Implement nested dependency resolution when dependencies are provided
+        factory.call
+      end
+    end
+  end
+end

data/lib/spikard/response.rb

@@ -1,109 +1,109 @@
-# frozen_string_literal: true
-
-module Spikard
-  # Response object returned from route handlers.
-  # Mirrors the Python/Node response helpers so the native layer
-  # can extract status, headers, and JSON-serialisable content.
-  class Response
-    attr_accessor :content
-    attr_reader :status_code, :headers
-
-    def initialize(content: nil, body: nil, status_code: 200, headers: nil, content_type: nil)
-      @content = content.nil? ? body : content
-      self.status_code = status_code
-      self.headers = headers
-      set_header('content-type', content_type) if content_type
-    end
-
-    def status
-      @status_code
-    end
-
-    def status_code=(value)
-      @status_code = Integer(value)
-    rescue ArgumentError, TypeError
-      raise ArgumentError, 'status_code must be an integer'
-    end
-
-    def headers=(value)
-      @headers = normalize_headers(value)
-    end
-
-    def set_header(name, value)
-      @headers[name.to_s] = value.to_s
-    end
-
-    def set_cookie(name, value, **options)
-      raise ArgumentError, 'cookie name required' if name.nil? || name.empty?
-
-      header_value = ["#{name}=#{value}", *cookie_parts(options)].join('; ')
-      set_header('set-cookie', header_value)
-    end
-
-    private
-
-    def cookie_parts(options)
-      [
-        options[:max_age] && "Max-Age=#{Integer(options[:max_age])}",
-        options[:domain] && "Domain=#{options[:domain]}",
-        "Path=#{options.fetch(:path, '/') || '/'}",
-        options[:secure] ? 'Secure' : nil,
-        options[:httponly] ? 'HttpOnly' : nil,
-        options[:samesite] && "SameSite=#{options[:samesite]}"
-      ].compact
-    end
-
-    def normalize_headers(value)
-      case value
-      when nil
-        {}
-      when Hash
-        value.each_with_object({}) do |(key, val), acc|
-          acc[key.to_s] = val.to_s
-        end
-      else
-        raise ArgumentError, 'headers must be a Hash'
-      end
-    end
-  end
-
-  module Testing
-    # Lightweight wrapper around native response hashes.
-    class Response
-      attr_reader :status_code, :headers, :body
-
-      def initialize(payload)
-        @status_code = payload[:status_code]
-        @headers = payload[:headers] || {}
-        @body = payload[:body]
-        @body_text = payload[:body_text]
-      end
-
-      def status
-        @status_code
-      end
-
-      def body_bytes
-        @body || ''.b
-      end
-
-      def body_text
-        @body_text || @body&.dup&.force_encoding(Encoding::UTF_8)
-      end
-
-      def text
-        body_text
-      end
-
-      def json
-        return nil if @body.nil? || @body.empty?
-
-        JSON.parse(@body)
-      end
-
-      def bytes
-        body_bytes.bytes
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Spikard
+  # Response object returned from route handlers.
+  # Mirrors the Python/Node response helpers so the native layer
+  # can extract status, headers, and JSON-serialisable content.
+  class Response
+    attr_accessor :content
+    attr_reader :status_code, :headers
+
+    def initialize(content: nil, body: nil, status_code: 200, headers: nil, content_type: nil)
+      @content = content.nil? ? body : content
+      self.status_code = status_code
+      self.headers = headers
+      set_header('content-type', content_type) if content_type
+    end
+
+    def status
+      @status_code
+    end
+
+    def status_code=(value)
+      @status_code = Integer(value)
+    rescue ArgumentError, TypeError
+      raise ArgumentError, 'status_code must be an integer'
+    end
+
+    def headers=(value)
+      @headers = normalize_headers(value)
+    end
+
+    def set_header(name, value)
+      @headers[name.to_s] = value.to_s
+    end
+
+    def set_cookie(name, value, **options)
+      raise ArgumentError, 'cookie name required' if name.nil? || name.empty?
+
+      header_value = ["#{name}=#{value}", *cookie_parts(options)].join('; ')
+      set_header('set-cookie', header_value)
+    end
+
+    private
+
+    def cookie_parts(options)
+      [
+        options[:max_age] && "Max-Age=#{Integer(options[:max_age])}",
+        options[:domain] && "Domain=#{options[:domain]}",
+        "Path=#{options.fetch(:path, '/') || '/'}",
+        options[:secure] ? 'Secure' : nil,
+        options[:httponly] ? 'HttpOnly' : nil,
+        options[:samesite] && "SameSite=#{options[:samesite]}"
+      ].compact
+    end
+
+    def normalize_headers(value)
+      case value
+      when nil
+        {}
+      when Hash
+        value.each_with_object({}) do |(key, val), acc|
+          acc[key.to_s] = val.to_s
+        end
+      else
+        raise ArgumentError, 'headers must be a Hash'
+      end
+    end
+  end
+
+  module Testing
+    # Lightweight wrapper around native response hashes.
+    class Response
+      attr_reader :status_code, :headers, :body
+
+      def initialize(payload)
+        @status_code = payload[:status_code]
+        @headers = payload[:headers] || {}
+        @body = payload[:body]
+        @body_text = payload[:body_text]
+      end
+
+      def status
+        @status_code
+      end
+
+      def body_bytes
+        @body || ''.b
+      end
+
+      def body_text
+        @body_text || @body&.dup&.force_encoding(Encoding::UTF_8)
+      end
+
+      def text
+        body_text
+      end
+
+      def json
+        return nil if @body.nil? || @body.empty?
+
+        JSON.parse(@body)
+      end
+
+      def bytes
+        body_bytes.bytes
+      end
+    end
+  end
+end