uma 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0bfbeefbd2e6b80152cbc86a3f460eb687acdfd166e9b0237cf2defa772d6a47
+  data.tar.gz: ee08aa1f66d58d09bf7143b196e4b668c284295c0d2ed6bc4d773503104c9aa3
+SHA512:
+  metadata.gz: fe7f63f78727969d3745d4ee28f45c14eb53d6531ef10efa23b712587c7272e6166e8095e0eb920866faf7a43c84876ef8162e4cdfcc8ad4a57cd190215e394f
+  data.tar.gz: 9edd172653ebcabd5dfc486c6fce8f1a0f39d1e509b089648d2a2a77a6911e08c653e6cf717a1d75b92936e35d04182b4aaf9d198ce8e595dda6ba90c8247d28

data/.gitignore

@@ -0,0 +1,56 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 2026-02-23 0.1.0
+
+- First release

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://gem.coop'
+
+gemspec
+
+# gem "uringmachine", path: '../uringmachine'
+
+group :development do
+  gem 'roda',     '~>3.101'
+  gem 'minitest', '~>6.0'
+  gem 'rake'
+  gem 'yard'
+  gem 'irb'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Digital Fabric
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,18 @@
+```
+     ●
+  ●╭───╮●
+   │UMA│   A modern web server for Ruby
+  ●╰───╯●  https://uma.noteflakes.com/
+     ●
+```
+
+## What is Uma?
+
+Uma is a modern HTTP/1.1 server for Ruby/Rack apps.
+
+## Features
+
+- Built on UringMachine
+- Multi-process, multi-thread, multi-fiber concurrency model.
+
+More information coming soon(ish)...

data/Rakefile

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'rake/clean'
+
+task :default => :test
+task :test do
+  exec 'ruby test/run.rb'
+end
+
+task :release do
+  require_relative './lib/uma/version'
+  version = Uma::VERSION
+
+  puts 'Building uma...'
+  `gem build uma.gemspec`
+
+  puts "Pushing uma #{version}..."
+  `gem push uma-#{version}.gem`
+
+  puts "Cleaning up..."
+  `rm *.gem`
+end

data/TODO.md

@@ -0,0 +1,43 @@
+## Basic functionality
+
+We work from the outside to the inside. Generally, we start from the script to
+start the server, to the concurrency controls, to the actual HTTP server, to the
+Rack interface.
+
+- [v] bin script
+  - [v] `uma serve`
+
+- [v] concurrency model
+  - M threads x N fibers
+  - Clear lifecycle management - start, run, stop
+  - Each thread sets up a UringMachine instance and a fiber scheduler
+  - Graceful stop
+
+- [v] server
+
+- [v] http rack control cycle
+
+- [v] Rack hijack (full/partial)
+- [v] More Rack tests. Where can they come from?
+  - [ ] Roda apps
+
+- [v] application loading / bootstrapping
+  - [v] load .ru files
+  - [v] process warmup
+
+- [v] load apps with `uma serve`
+
+- [ ] uma serve - error if no bind address given
+
+- [ ] logging
+  - [ ] In conformance with Rack spec
+  - [ ] JSON format
+
+- [ ] benchmarks
+  - [ ] compare to falcon, puma
+  - [ ] using a Roda app with a few different endpoints representing different
+    types of requests:
+    - [ ] GET rendered template, simulate DB select query
+    - [ ] POST params, simulate DB update query, response redirects to another URL
+    - [ ] POST params, simulate DB update query, JSON response
+  - [ ] different concurrency levels: 10 50 100 500 1000 5000

data/bin/uma

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'uma/cli'
+
+env = ENV.to_h.merge(
+  io_out: STDOUT,
+  io_err: STDERR
+)
+Uma::CLI.(ARGV, env)

data/lib/uma/app.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'uma/http'
+require 'uma/error'
+
+module Uma
+  class App
+    def initialize(fn)
+      @fn = fn
+      eval_app_code
+    end
+
+    def run(proc)
+      @proc = proc
+    end
+
+    def connection_proc
+      ->(machine, fd) {
+        HTTP.http_connection(machine, { app: @proc }, fd)
+      }
+    end
+
+    def to_proc = @proc
+
+    private
+
+    def get_code
+      IO.read(@fn)
+    rescue SystemCallError
+      raise Uma::Error, "Could not load Rackup file"
+    end
+
+    def eval_app_code
+      eval(get_code, binding, @fn)
+    rescue SyntaxError, NameError => e
+      raise Uma::Error, e.message
+    end
+  end
+end

data/lib/uma/cli/error.rb

@@ -0,0 +1,13 @@
+
+# frozen_string_literal: true
+
+module Uma
+  module CLI
+    module Error
+      class Base < StandardError; end
+
+      class NoCommand < Base; end
+      class InvalidCommand < Base; end
+    end
+  end
+end

data/lib/uma/cli.rb

@@ -0,0 +1,202 @@
+# frozen_string_literal: true
+
+require 'uma/cli/error'
+require 'uma/version'
+require 'uma/server'
+require 'uma/app'
+require 'optparse'
+
+module Uma
+  module CLI
+    def self.call(argv, env)
+      setup_controller(argv, env).tap {
+        it.run if !env[:norun]
+      }
+    end
+
+    def self.setup_controller(argv, env)
+      cmd = argv[0]
+      argv = argv[1..-1]
+
+      case cmd
+      when 'help'
+        Help.new(argv, env)
+      when 'serve'
+        Serve.new(argv, env)
+      when 'version'
+        Version.new(argv, env)
+      when '', nil
+        raise Error::NoCommand, ''
+      else
+        raise Error::InvalidCommand, "unrecognized command '#{cmd}'"
+      end
+    rescue => e
+      if env[:error_handler]
+        env[:error_handler].(e)
+      else
+        ErrorResponse.new(e, argv, env)
+      end
+    end
+
+    class Base
+      attr_reader :argv, :env
+
+      def initialize(argv, env)
+        @argv = argv
+        @env = env
+      end
+
+      def print_message(io, template, **)
+        io << "#{format(template, **)}\n"
+      end
+    end
+
+    CLI_HELP = <<~EOF
+
+           ●
+        ●╭───╮●
+         │UMA│   A modern web server for Ruby
+        ●╰───╯●  https://uma.noteflakes.com/
+           ●
+
+      Uma version #{Uma::VERSION}
+
+      Usage: uma <COMMAND>
+
+      Commands:
+        serve          Run a Rack application
+        help           Print this message or the help of the given subcommand(s)
+    EOF
+
+    class Help < Base
+      def run
+        print_message(env[:io_out], CLI_HELP)
+      end
+    end
+
+    ERROR_RESPONSE_TEMPLATE = <<~EOF
+      Error: %<error_msg>s
+
+      Usage: uma <COMMAND>
+
+      Commands:
+        serve          Run a Rack application
+        help           Print this message or the help of the given subcommand(s)
+    EOF
+
+    class ErrorResponse < Base
+      def initialize(error, argv, env)
+        @error = error
+        @argv = argv
+        @env = env
+      end
+
+      def run
+        error_msg = @error.message
+        if error_msg.empty?
+          print_message(env[:io_err], CLI_HELP)
+        else
+          print_message(
+            env[:io_err], ERROR_RESPONSE_TEMPLATE,
+            error_msg:
+          )
+        end
+      end
+    end
+
+    class Version < Base
+      def run
+        print_message(env[:io_out], "Uma version #{Uma::VERSION}")
+      end
+    end
+
+    SERVE_BANNER = <<~EOF
+
+           ●
+        ●╭───╮●
+         │UMA│   A modern web server for Ruby
+        ●╰───╯●  https://uma.noteflakes.com/
+           ●
+
+      Uma version #{Uma::VERSION}
+    EOF
+
+    class Serve < Base
+      attr_reader :server
+
+      def initialize(argv, env)
+        super
+        server_class = env[:server_class] || Uma::Server
+        @server = server_class.new(@env)
+      end
+
+      def run
+        parse_argv
+
+        print_message(@env[:io_err], SERVE_BANNER)
+        @server.start
+      rescue => e
+        if env[:error_handler]
+          env[:error_handler].(e)
+        else
+          ErrorResponse.new(e, @argv, @env).run
+        end
+      ensure
+        @server.stop
+      end
+
+      private
+
+      HELP_BANNER = <<~EOF
+
+             ●
+          ●╭───╮●
+           │UMA│   A modern web server for Ruby
+          ●╰───╯●  https://uma.noteflakes.com/
+             ●
+
+        Usage: uma serve [OPTIONS] [location]
+
+      EOF
+
+      def parse_argv
+        parser = OptionParser.new do |o|
+          o.banner = HELP_BANNER
+
+          o.on('-b', '--bind BIND', String,
+            'Bind address (default: http://0.0.0.0:1234). You can specify this flag multiple times to bind to multiple addresses.') do
+            @env[:bind] ||= []
+            @env[:bind] << it
+          end
+
+          o.on('-s', '--silent', 'Silent mode') do
+            @env[:silent] = true
+          end
+
+          o.on('-h', '--help', 'Show this help message') do
+            puts o
+            exit
+          end
+
+          o.on('--no-server-headers', 'Don\'t include Server and Date headers') do
+            @env[:server_extensions] = false
+          end
+        end
+
+        parser.parse!(argv)
+        load_rackup_file(argv) if !@env[:connection_proc]
+      end
+
+      def load_rackup_file(argv)
+        location = File.expand_path(argv.first || '.')
+        if File.directory?(location)
+          fn = File.join(location, 'config.ru')
+        else
+          fn = location
+        end
+        app = App.new(fn)
+        @env[:connection_proc] = app.connection_proc
+      end
+    end
+  end
+end

data/lib/uma/error.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Uma
+  class Error < StandardError; end
+
+  class TimeoutError < Error; end
+end