webrick 1.8.1 → 1.9.1

data/sig/log.rbs

@@ -0,0 +1,93 @@
+module WEBrick
+  class BasicLog
+    @log: IO?
+
+    @opened: TrueClass?
+
+    FATAL: 1
+
+    ERROR: 2
+
+    WARN: 3
+
+    INFO: 4
+
+    DEBUG: 5
+
+    # log-level, messages above this level will be logged
+    attr_accessor level: Integer
+
+    type log_file = (IO | String)?
+
+    def initialize: (?log_file log_file, ?Integer? level) -> void
+
+    #
+    # Closes the logger (also closes the log device associated to the logger)
+    def close: () -> void
+
+    def log: (Integer level, String data) -> IO?
+
+    #
+    # Synonym for log(INFO, obj.to_s)
+    def <<: (_ToS obj) -> IO?
+
+    type message = Exception | _ToStr | Object
+
+    # Shortcut for logging a FATAL message
+    def fatal: (message msg) -> IO?
+
+    # Shortcut for logging an ERROR message
+    def error: (message msg) -> IO?
+
+    # Shortcut for logging a WARN message
+    def warn: (message msg) -> IO?
+
+    # Shortcut for logging an INFO message
+    def info: (message msg) -> IO?
+
+    # Shortcut for logging a DEBUG message
+    def debug: (message msg) -> IO?
+
+    # Will the logger output FATAL messages?
+    def fatal?: () -> bool
+
+    # Will the logger output ERROR messages?
+    def error?: () -> bool
+
+    # Will the logger output WARN messages?
+    def warn?: () -> bool
+
+    # Will the logger output INFO messages?
+    def info?: () -> bool
+
+    # Will the logger output DEBUG messages?
+    def debug?: () -> bool
+
+    private
+
+    #
+    # Formats +arg+ for the logger
+    #
+    # * If +arg+ is an Exception, it will format the error message and
+    #   the back trace.
+    # * If +arg+ responds to #to_str, it will return it.
+    # * Otherwise it will return +arg+.inspect.
+    def format: (message arg) -> String
+  end
+
+  class Log < BasicLog
+    # Format of the timestamp which is applied to each logged line.  The
+    # default is <tt>"[%Y-%m-%d %H:%M:%S]"</tt>
+    attr_accessor time_format: String
+
+    #
+    # Same as BasicLog#initialize
+    #
+    # You can set the timestamp format through #time_format
+    def initialize: (?BasicLog::log_file log_file, ?Integer? level) -> void
+
+    #
+    # Same as BasicLog#log
+    def log: (Integer level, String data) -> IO?
+  end
+end

data/sig/manifest.yaml

@@ -0,0 +1,8 @@
+dependencies:
+  - name: digest
+  - name: erb
+  - name: openssl
+  - name: singleton
+  - name: socket
+  - name: tempfile
+  - name: uri

data/sig/server.rbs

@@ -0,0 +1,57 @@
+module WEBrick
+  class ServerError < StandardError
+  end
+
+  class SimpleServer
+    def self.start: [T] () { () -> T } -> T
+  end
+
+  class Daemon
+    def self.start: ()  -> void
+                  | [T] () { () -> T } -> T
+  end
+
+  class GenericServer
+    @shutdown_pipe: [IO, IO]?
+
+    attr_reader status: :Stop | :Running | :Shutdown
+
+    attr_reader config: Hash[Symbol, untyped]
+
+    attr_reader logger: BasicLog
+
+    attr_reader tokens: Thread::SizedQueue
+
+    attr_reader listeners: Array[TCPServer| OpenSSL::SSL::SSLServer]
+
+    def initialize: (?Hash[Symbol, untyped] config, ?Hash[Symbol, untyped] default) -> void
+
+    def []: (Symbol key) -> untyped
+
+    def listen: (String address, Integer port) -> void
+
+    def start: () ?{ (TCPSocket) -> void } -> void
+
+    def stop: () -> void
+
+    def shutdown: () -> void
+
+    def run: (TCPSocket sock) -> void
+
+    private
+
+    def accept_client: (TCPServer svr) -> TCPSocket?
+
+    def start_thread: (TCPSocket sock) ?{ (TCPSocket) -> void } -> Thread
+
+    def call_callback: (Symbol callback_name, *untyped args) -> untyped
+
+    def setup_shutdown_pipe: () -> [IO, IO]
+
+    def cleanup_shutdown_pipe: ([IO, IO]? shutdown_pipe) -> void
+
+    def alarm_shutdown_pipe: [T] () { (IO) -> T } -> T?
+
+    def cleanup_listener: () -> void
+  end
+end

data/sig/ssl.rbs

@@ -0,0 +1,19 @@
+module WEBrick
+  module Config
+    SSL: Hash[Symbol, untyped]
+  end
+
+  module Utils
+    def self?.create_self_signed_cert: (untyped bits, untyped cn, untyped comment) -> ::Array[untyped]
+  end
+
+  class GenericServer
+    @ssl_context: OpenSSL::SSL::SSLContext?
+
+    def ssl_context: () -> OpenSSL::SSL::SSLContext?
+
+    def setup_ssl_context: (Hash[Symbol, untyped] config) -> OpenSSL::SSL::SSLContext
+
+    def ssl_servername_callback: (untyped sslsocket, ?untyped? hostname) -> untyped
+  end
+end

data/sig/utils.rbs

@@ -0,0 +1,122 @@
+module WEBrick
+  module Utils
+    #
+    # Sets IO operations on +io+ to be non-blocking
+    def self?.set_non_blocking: (IO io) -> void
+
+    #
+    # Sets the close on exec flag for +io+
+    def self?.set_close_on_exec: (IO io) -> void
+
+    #
+    # Changes the process's uid and gid to the ones of +user+
+    def self?.su: (String user) -> void
+
+    #
+    # The server hostname
+    def self?.getservername: () -> String
+
+    #
+    # Creates TCP server sockets bound to +address+:+port+ and returns them.
+    #
+    # It will create IPV4 and IPV6 sockets on all interfaces.
+    def self?.create_listeners: (String host, Integer port) -> Array[TCPServer]
+
+    #
+    # Characters used to generate random strings
+    RAND_CHARS: String
+
+    #
+    # Generates a random string of length +len+
+    def self?.random_string: (Integer len) -> String
+
+    #
+    # Class used to manage timeout handlers across multiple threads.
+    #
+    # Timeout handlers should be managed by using the class methods which are
+    # synchronized.
+    #
+    #   id = TimeoutHandler.register(10, Timeout::Error)
+    #   begin
+    #     sleep 20
+    #     puts 'foo'
+    #   ensure
+    #     TimeoutHandler.cancel(id)
+    #   end
+    #
+    # will raise Timeout::Error
+    #
+    #   id = TimeoutHandler.register(10, Timeout::Error)
+    #   begin
+    #     sleep 5
+    #     puts 'foo'
+    #   ensure
+    #     TimeoutHandler.cancel(id)
+    #   end
+    #
+    # will print 'foo'
+    #
+    class TimeoutHandler
+      @queue: Thread::Queue
+
+      @watcher: Thread?
+
+      include Singleton
+
+      #
+      # Mutex used to synchronize access across threads
+      TimeoutMutex: Thread::Mutex
+
+      #
+      # Registers a new timeout handler
+      #
+      # +time+:: Timeout in seconds
+      # +exception+:: Exception to raise when timeout elapsed
+      def self.register: (Numeric seconds, singleton(Exception) exception) -> Integer
+
+      #
+      # Cancels the timeout handler +id+
+      def self.cancel: (Integer id) -> bool
+
+      def self.terminate: () -> Thread?
+
+      #
+      # Creates a new TimeoutHandler.  You should use ::register and ::cancel
+      # instead of creating the timeout handler directly.
+      def initialize: () -> void
+
+      private
+
+      def watch: () -> bot
+
+      def watcher: () -> Thread
+
+      public
+
+      #
+      # Interrupts the timeout handler +id+ and raises +exception+
+      def interrupt: (Thread thread, Integer id, singleton(Exception) exception) -> nil
+
+      #
+      # Registers a new timeout handler
+      #
+      # +time+:: Timeout in seconds
+      # +exception+:: Exception to raise when timeout elapsed
+      def register: (Thread thread, Numeric time, singleton(Exception) exception) -> Integer
+
+      #
+      # Cancels the timeout handler +id+
+      def cancel: (Thread thread, Integer id) -> bool
+
+      #
+      def terminate: () -> Thread?
+    end
+
+    #
+    # Executes the passed block and raises +exception+ if execution takes more
+    # than +seconds+.
+    #
+    # If +seconds+ is zero or nil, simply executes the block
+    def self?.timeout: [T] (Numeric? seconds, ?singleton(Exception) exception) { (?Numeric) -> T } -> T
+  end
+end

data/sig/version.rbs

@@ -0,0 +1,3 @@
+module WEBrick
+  VERSION: String
+end

data/webrick.gemspec

@@ -53,6 +53,41 @@ Gem::Specification.new do |s|
     "lib/webrick/ssl.rb",
     "lib/webrick/utils.rb",
     "lib/webrick/version.rb",
+    "sig/accesslog.rbs",
+    "sig/cgi.rbs",
+    "sig/compat.rbs",
+    "sig/config.rbs",
+    "sig/cookie.rbs",
+    "sig/htmlutils.rbs",
+    "sig/httpauth.rbs",
+    "sig/httpauth/authenticator.rbs",
+    "sig/httpauth/basicauth.rbs",
+    "sig/httpauth/digestauth.rbs",
+    "sig/httpauth/htdigest.rbs",
+    "sig/httpauth/htgroup.rbs",
+    "sig/httpauth/htpasswd.rbs",
+    "sig/httpauth/userdb.rbs",
+    "sig/httpproxy.rbs",
+    "sig/httprequest.rbs",
+    "sig/httpresponse.rbs",
+    "sig/https.rbs",
+    "sig/httpserver.rbs",
+    "sig/httpservlet.rbs",
+    "sig/httpservlet/abstract.rbs",
+    "sig/httpservlet/cgi_runner.rbs",
+    "sig/httpservlet/cgihandler.rbs",
+    "sig/httpservlet/erbhandler.rbs",
+    "sig/httpservlet/filehandler.rbs",
+    "sig/httpservlet/prochandler.rbs",
+    "sig/httpstatus.rbs",
+    "sig/httputils.rbs",
+    "sig/httpversion.rbs",
+    "sig/log.rbs",
+    "sig/manifest.yaml",
+    "sig/server.rbs",
+    "sig/ssl.rbs",
+    "sig/utils.rbs",
+    "sig/version.rbs",
     "webrick.gemspec",
   ]
   s.required_ruby_version = ">= 2.4.0"

metadata

@@ -1,22 +1,22 @@
 --- !ruby/object:Gem::Specification
 name: webrick
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.1
 platform: ruby
 authors:
 - TAKAHASHI Masayoshi
 - GOTOU YUUZOU
 - Eric Wong
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-27 00:00:00.000000000 Z
+date: 2024-12-02 00:00:00.000000000 Z
 dependencies: []
 description: WEBrick is an HTTP server toolkit that can be configured as an HTTPS
   server, a proxy server, and a virtual-host server.
 email:
--
--
+- 
+- 
 - normal@ruby-lang.org
 executables: []
 extensions: []
@@ -61,6 +61,41 @@ files:
 - lib/webrick/ssl.rb
 - lib/webrick/utils.rb
 - lib/webrick/version.rb
+- sig/accesslog.rbs
+- sig/cgi.rbs
+- sig/compat.rbs
+- sig/config.rbs
+- sig/cookie.rbs
+- sig/htmlutils.rbs
+- sig/httpauth.rbs
+- sig/httpauth/authenticator.rbs
+- sig/httpauth/basicauth.rbs
+- sig/httpauth/digestauth.rbs
+- sig/httpauth/htdigest.rbs
+- sig/httpauth/htgroup.rbs
+- sig/httpauth/htpasswd.rbs
+- sig/httpauth/userdb.rbs
+- sig/httpproxy.rbs
+- sig/httprequest.rbs
+- sig/httpresponse.rbs
+- sig/https.rbs
+- sig/httpserver.rbs
+- sig/httpservlet.rbs
+- sig/httpservlet/abstract.rbs
+- sig/httpservlet/cgi_runner.rbs
+- sig/httpservlet/cgihandler.rbs
+- sig/httpservlet/erbhandler.rbs
+- sig/httpservlet/filehandler.rbs
+- sig/httpservlet/prochandler.rbs
+- sig/httpstatus.rbs
+- sig/httputils.rbs
+- sig/httpversion.rbs
+- sig/log.rbs
+- sig/manifest.yaml
+- sig/server.rbs
+- sig/ssl.rbs
+- sig/utils.rbs
+- sig/version.rbs
 - webrick.gemspec
 homepage: https://github.com/ruby/webrick
 licenses:
@@ -68,7 +103,7 @@ licenses:
 - BSD-2-Clause
 metadata:
   bug_tracker_uri: https://github.com/ruby/webrick/issues
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -83,8 +118,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.0.dev
-signing_key:
+rubygems_version: 3.5.11
+signing_key: 
 specification_version: 4
 summary: HTTP server toolkit
 test_files: []