ratalada 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d301916f1d7cbe6abcdffafc8cd2bee59c3fa4505db6d47ec3fde43de79ed19b
-  data.tar.gz: 265347175e831b2a644a2189551849c33068caf0829adce126249a094808336b
+  metadata.gz: 8d0e58c60b99a4b05777a6089c484f2104f85924694cfe0b5c0ef543a03634c7
+  data.tar.gz: d04a10b62a3f33a00489234bbb0db780517a54c7569c83dfd098cee69a3b2f5f
 SHA512:
-  metadata.gz: fe1cfb2a6b815e55ac3f5d888b4a259b954429900ba3a70f6d65902d650f13fd9929807455b0d43808cba949ce170d71a974d435c9da0b1f50aabddcfdbe0bd8
-  data.tar.gz: 41f61e2e389adb79e84a5df10ae9b1e95cbfb03099c7908dcf7cd6a5ea4e2189db9bf3ae2df658c12453ec6f8c7ab1328ad7b25a8c319798f4eed0ead55df591
+  metadata.gz: 616cb51549da081369ce6df606e8c9188900b20fc7dc5344b045eaf8ab0618edc8f1cba92fd21be24c59cae0370b2fdfe6729e56e1bf93562b118ebd2f75f4e4
+  data.tar.gz: f834abb138626a902d8c4947183bca135d0ddf6ab9c8ed92a68b6ba08cc45666edb5f9f55611b50f365e4adbb23c20d621c8fdab2a532a1721c0d0e06e0642e3

data/lib/ratalada/builder.rb

@@ -15,5 +15,5 @@ module Ratalada
     end
   end
 
-  self.frontend = Frontends::Builder
+  config.frontend = Frontends::Builder
 end

data/lib/ratalada/falcon.rb

@@ -27,20 +27,26 @@ module Ratalada
         middleware = ::Falcon::Server.rack_middleware(app, cache: cache)
 
         environment = Async::Service::Environment.new(::Falcon::Environment::Server).with(
-          name: "ratalada",
-          url: "http://#{host}:#{port}",
-          middleware: -> { middleware },
+          name:              "ratalada",
+          url:               "http://#{host}:#{port}",
+          middleware:        -> { middleware },
           container_options: { count: count, restart: true },
           # async-service >= 0.25 reads `root` in Managed::Service#preload!
           # unconditionally (the default `preload` is `[]`, which is truthy),
           # so an environment without one raises NoMethodError on boot.
-          root: Dir.pwd,
+          root:              Dir.pwd,
         )
 
         configuration = Async::Service::Configuration.new
         configuration.add(environment)
 
-        warn "ratalada: falcon listening on http://#{host}:#{port}#{" (#{count} workers)" if count > 1}"
+        if count > 1
+          workers = " (#{count} workers)"
+        else
+          workers = ""
+        end
+
+        warn "ratalada: falcon listening on http://#{host}:#{port}#{workers}"
         Async::Service::Controller.run(configuration, container_class: Async::Container.best_container_class)
       rescue Interrupt
         # clean shutdown
@@ -48,5 +54,5 @@ module Ratalada
     end
   end
 
-  self.backend = Backends::Falcon
+  config.backend = Backends::Falcon
 end

data/lib/ratalada/puma.rb

@@ -9,7 +9,9 @@ module Ratalada
       module_function
 
       def run(app, host:, port:, count: 1)
-        warn "ratalada: puma backend ignores count: (not yet implemented)" if count > 1
+        if count > 1
+          warn "ratalada: puma backend ignores count: (not yet implemented)"
+        end
         server = ::Puma::Server.new(app)
         server.add_tcp_listener(host, port)
         warn "ratalada: puma listening on http://#{host}:#{port}"
@@ -20,5 +22,5 @@ module Ratalada
     end
   end
 
-  self.backend = Backends::Puma
+  config.backend = Backends::Puma
 end

data/lib/ratalada/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ratalada
-  VERSION = "2.1.0"
+  VERSION = "3.0.0"
 end

data/lib/ratalada.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "rack"
+require "dry-configurable"
 require_relative "ratalada/version"
 
 module Ratalada
@@ -8,6 +9,8 @@ module Ratalada
   DEFAULT_PORT = Integer(ENV.fetch("PORT", "9292"))
   DEFAULT_COUNT = Integer(ENV.fetch("COUNT", "1"))
 
+  extend Dry::Configurable
+
   class Error < StandardError; end
 
   class NoBackendError < Error
@@ -25,15 +28,12 @@ module Ratalada
     # The backend runs a rack app (set by requiring ratalada/puma or
     # ratalada/falcon); the frontend turns the Server.run block into a rack
     # app (the built-in router by default, ratalada/sinatra to swap it).
-    attr_writer :backend, :frontend
-
+    # Both are settings, so `Server.run(frontend: ...)` writes them too.
     def backend
-      @backend or raise NoBackendError
+      config.backend or raise NoBackendError
     end
 
-    def frontend
-      @frontend ||= Frontends::Routes
-    end
+    def frontend = config.frontend
   end
 
   # Rack::Request plus just enough sugar to pattern match on, so everything
@@ -91,10 +91,10 @@ module Ratalada
 
         def call(env)
           request = Request.new(env)
-          handler = begin
-            @router.call(request)
+          begin
+            handler = @router.call(request)
           rescue NoMatchingPatternError
-            nil
+            handler = nil
           end
           respond(handler, request)
         end
@@ -133,8 +133,11 @@ module Ratalada
     # count runs that many worker processes accepting from a shared socket,
     # like node's cluster module. Each worker has its own state — anything
     # shared (sessions, caches) needs an external store or count: 1.
-    def run(host: DEFAULT_HOST, port: DEFAULT_PORT, count: DEFAULT_COUNT, &block)
-      Stack.new.run(host: host, port: port, count: count, &block)
+    #
+    # host:, port: and count: are written through to Ratalada.config before
+    # boot, so Server.run(port: 3000) is shorthand for configuring first.
+    def run(**options, &block)
+      Stack.new.run(**options, &block)
     end
 
     # The chain Server.use returns. Collects middleware until run ends it.
@@ -148,11 +151,29 @@ module Ratalada
         self
       end
 
-      def run(host: DEFAULT_HOST, port: DEFAULT_PORT, count: DEFAULT_COUNT, &block)
-        raise ArgumentError, "Server.run requires a block" unless block
-        raise ArgumentError, "count must be a positive Integer" unless count.is_a?(Integer) && count.positive?
+      # Every option is a Ratalada.config setting name (host, port, count);
+      # each is applied to the config verbatim — coercion and rejection of
+      # unknown names are the settings' own. Skipped entirely when no
+      # options are given so a finalized config can still boot.
+      def run(**options, &block)
+        unless block
+          raise ArgumentError, "Server.run requires a block"
+        end
+
+        if options.any?
+          Ratalada.configure do |config|
+            options.each do |key, value|
+              config[key] = value
+            end
+          end
+        end
+
+        config = Ratalada.config
+        unless config.count.is_a?(Integer) && config.count.positive?
+          raise ArgumentError, "count must be a positive Integer"
+        end
 
-        Ratalada.backend.run(to_app(block), host: host, port: port, count: count)
+        Ratalada.backend.run(to_app(block), host: config.host, port: config.port, count: config.count)
       end
 
       # First `use` in the chain is the outermost, as in Rack::Builder.
@@ -166,4 +187,14 @@ module Ratalada
 end
 
 # The whole point is a zero-ceremony top-level DSL.
-Server = Ratalada::Server unless defined?(Server)
+unless defined?(Server)
+  Server = Ratalada::Server
+end
+
+# Core settings. Contrib gems (ratalada-contrib et al.) register theirs the
+# same way — Ratalada.setting at the bottom of their own file.
+Ratalada.setting :backend
+Ratalada.setting :frontend, default: Ratalada::Frontends::Routes
+Ratalada.setting :host, default: Ratalada::DEFAULT_HOST
+Ratalada.setting :port, default: Ratalada::DEFAULT_PORT, constructor: ->(value) { Integer(value) }
+Ratalada.setting :count, default: Ratalada::DEFAULT_COUNT, constructor: ->(value) { Integer(value) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratalada
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Nathan K
@@ -24,19 +24,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: dry-configurable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement