ratalada 2.2.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1803a4b3f845951ed01752e1423b0c37c943b07ca1364f4b9d43e3c0a3add365
-  data.tar.gz: 104cf13b9244ecc47c975e3ea2a021db2869797bc7754fd2e745e016311780cc
+  metadata.gz: '079378d0ea4867145471fa730a8d2eb6ec20513d50e7bfcb52b643cd99bbf6e2'
+  data.tar.gz: 228276a9a88b32c152a4e84eb12f267f62b8cde567d7d9dab9fae4734e207ab9
 SHA512:
-  metadata.gz: 5705db0d6d6e6a5145f5af7882fdb3c1cbd1abca7f4ac27bcfce1ecf576ef58ce35129bab5f4e4bd27a436796c53bfb49c3b87aee7ed0126f5ac5990db74727c
-  data.tar.gz: e42d339d4e674109a13276972d6513dddf8c2ce90c6c5e6d75f50ead33c4a9dc4932e5f9ab64e33c63882970138f0dc0d5df010726ac763427e23259e6d2a617
+  metadata.gz: 5fa8af50cdf2da52fcc5e35d4a8f9acdd97307a6b1c5a7afd09d2971889331ec7af9f16a9472991db768fc71bb195174bf7c77e45fec50dded0b7696eef37c03
+  data.tar.gz: 939a4d0b6d7f9b1434561607ba7d02e44ab93a471abb8d7565e223a2b103434177648d648901fa65a75b001ced4a926aef14f95478cffeb1c1c1c885dbcfbb84

data/README.md

@@ -253,6 +253,11 @@ gem kit changelog --write --gem ratalada-roda
 gem kit release --gem ratalada-roda      # gate, build, push, tag
 ```
 
+## Why
+
+Spurred on by things like [this post](https://blainsmith.com/articles/just-fucking-use-go/), and just how easy it is to create servers with [hono](https://hono.dev/) or agents with [volt](https://github.com/voltagent/voltagent), which makes me irrationally angry that ruby hasn't more libraries like this considering it's WELL beyond javascript in it's flexibility as a language.
+[This post is great](https://www.toptal.com/developers/ruby/api-with-sinatra-and-sequel-ruby-tutorial), but it shuold be even simpler.
+
 ## License
 
 [MIT](LICENSE)

data/lib/ratalada/async.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "async/http/server"
+require "async/http/endpoint"
+require "protocol/rack/adapter"
+require_relative "../ratalada"
+
+module Ratalada
+  module Backends
+    # Falcon without falcon: one Async::HTTP::Server in this process, no
+    # container, no supervision, no restarts. Use ratalada/falcon when you
+    # want those; this is the fiber-based server on its own.
+    module Async
+      module_function
+
+      def run(app, host:, port:, count: 1)
+        if count > 1
+          warn "ratalada: async backend ignores count: (single process — use ratalada/falcon)"
+        end
+
+        endpoint = ::Async::HTTP::Endpoint.parse("http://#{host}:#{port}")
+        server = ::Async::HTTP::Server.new(::Protocol::Rack::Adapter.new(app), endpoint)
+
+        warn "ratalada: async listening on http://#{host}:#{port}"
+        # #run wraps itself in Async{}, which outside a reactor starts one and
+        # blocks until the accept loop ends.
+        server.run
+      rescue Interrupt
+        # clean shutdown
+      end
+    end
+  end
+
+  config.backend = Backends::Async
+end

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

@@ -54,5 +54,5 @@ module Ratalada
     end
   end
 
-  self.backend = Backends::Falcon
+  config.backend = Backends::Falcon
 end

data/lib/ratalada/puma.rb

@@ -22,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.2.0"
+  VERSION = "3.1.0"
 end

data/lib/ratalada/webrick.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rackup/handler/webrick"
+require_relative "../ratalada"
+
+module Ratalada
+  module Backends
+    # Stdlib WEBrick via rackup's handler, which already does the rack env
+    # translation. Single process, one thread per connection — fine for
+    # development and tests, not what you ship.
+    module Webrick
+      module_function
+
+      def run(app, host:, port:, count: 1)
+        if count > 1
+          warn "ratalada: webrick backend ignores count: (single process)"
+        end
+
+        warn "ratalada: webrick listening on http://#{host}:#{port}"
+        ::Rackup::Handler::WEBrick.run(app, Host: host, Port: port)
+      rescue Interrupt
+        ::Rackup::Handler::WEBrick.shutdown
+      end
+    end
+  end
+
+  config.backend = Backends::Webrick
+end

data/lib/ratalada.rb

@@ -18,8 +18,10 @@ module Ratalada
       super(msg || <<~MSG)
         No server backend selected. Require one before calling Server.run:
 
-          require "ratalada/puma"    # or
-          require "ratalada/falcon"
+          require "ratalada/puma"     # or
+          require "ratalada/falcon"   # or
+          require "ratalada/async"    # or
+          require "ratalada/webrick"
       MSG
     end
   end
@@ -28,15 +30,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
@@ -196,6 +195,8 @@ 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.2.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Nathan K
@@ -107,6 +107,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: lefthook
   requirement: !ruby/object:Gem::Requirement
@@ -135,10 +149,12 @@ files:
 - README.md
 - exe/ratalada
 - lib/ratalada.rb
+- lib/ratalada/async.rb
 - lib/ratalada/builder.rb
 - lib/ratalada/falcon.rb
 - lib/ratalada/puma.rb
 - lib/ratalada/version.rb
+- lib/ratalada/webrick.rb
 homepage: https://github.com/n-at-han-k/ratalada
 licenses:
 - MIT