wsv 0.10.0 → 0.11.0

data/test/server_test.rb

@@ -5,6 +5,8 @@ require "socket"
 require_relative "test_helper"
 
 class ServerTest < Minitest::Test
+  include TlsTestHelpers
+
   def setup
     @dir = Dir.mktmpdir
     @server = nil
@@ -164,55 +166,74 @@ class ServerTest < Minitest::Test
     socket&.close
   end
 
-  def test_slow_client_does_not_block_other_clients
-    File.write(File.join(@dir, "x.txt"), "ok")
-    start_server(read_timeout: 5)
-
-    slow_socket = TCPSocket.open("127.0.0.1", @server.port)
+  def test_408_carries_cors_header_when_cors_enabled
+    start_server(read_timeout: 0.1, cors: true)
 
-    started = Time.now
-    response = get("/x.txt")
-    elapsed = Time.now - started
+    socket = TCPSocket.open("127.0.0.1", @server.port)
+    response = socket.read
 
-    assert_equal "200", response.code
-    assert_equal "ok", response.body
-    assert_operator elapsed, :<, 1.0, "request should not be serialized behind slow client"
+    assert_includes response, "HTTP/1.1 408"
+    assert_includes response, "Access-Control-Allow-Origin: *"
   ensure
-    slow_socket&.close
+    socket&.close
   end
 
-  def test_warns_when_binding_to_non_loopback
-    err = StringIO.new
-    server = Wsv::Server.new(host: "0.0.0.0", port: 0, root: @dir, out: StringIO.new, err: err)
-    server.send(:log_startup)
+  def test_414_carries_cors_header_when_cors_enabled
+    start_server(cors: true)
+
+    long_path = "/" + ("a" * 9000)
+    socket = TCPSocket.open("127.0.0.1", @server.port)
+    socket.write("GET #{long_path} HTTP/1.1\r\nHost: localhost\r\n\r\n")
+    response = socket.read
 
-    assert_includes err.string, "WARNING"
-    assert_includes err.string, "0.0.0.0"
+    assert_includes response, "HTTP/1.1 414"
+    assert_includes response, "Access-Control-Allow-Origin: *"
+  ensure
+    socket&.close
   end
 
-  def test_no_warning_for_loopback_bind
-    err = StringIO.new
-    server = Wsv::Server.new(host: "127.0.0.1", port: 0, root: @dir, out: StringIO.new, err: err)
-    server.send(:log_startup)
+  def test_200_carries_cors_header_when_cors_enabled
+    File.write(File.join(@dir, "x.txt"), "hi")
+    start_server(cors: true)
+
+    response = get("/x.txt")
 
-    refute_includes err.string, "WARNING"
+    assert_equal "200", response.code
+    assert_equal "*", response["access-control-allow-origin"]
+    assert_equal "Origin", response["vary"]
   end
 
-  def test_banner_brackets_ipv6_address_in_url
-    out = StringIO.new
-    server = Wsv::Server.new(host: "::1", port: 8000, root: @dir, out: out, err: StringIO.new)
-    server.send(:log_startup)
+  def test_options_preflight_carries_cors_headers_when_cors_enabled
+    start_server(cors: true)
+
+    socket = TCPSocket.open("127.0.0.1", @server.port)
+    socket.write("OPTIONS /x.txt HTTP/1.1\r\nHost: localhost\r\n" \
+                 "Access-Control-Request-Method: GET\r\n\r\n")
+    response = socket.read
 
-    assert_includes out.string, "http://[::1]:8000/"
-    refute_includes out.string, "http://::1:8000/"
+    assert_includes response, "HTTP/1.1 204"
+    assert_includes response, "Access-Control-Allow-Origin: *"
+    assert_includes response, "Access-Control-Allow-Methods: GET, HEAD, OPTIONS"
+    assert_includes response, "Vary: Origin"
+  ensure
+    socket&.close
   end
 
-  def test_banner_percent_encodes_ipv6_zone_identifier
-    out = StringIO.new
-    server = Wsv::Server.new(host: "fe80::1%eth0", port: 8000, root: @dir, out: out, err: StringIO.new)
-    server.send(:log_startup)
+  def test_slow_client_does_not_block_other_clients
+    File.write(File.join(@dir, "x.txt"), "ok")
+    start_server(read_timeout: 5)
+
+    slow_socket = TCPSocket.open("127.0.0.1", @server.port)
+
+    started = Time.now
+    response = get("/x.txt")
+    elapsed = Time.now - started
 
-    assert_includes out.string, "http://[fe80::1%25eth0]:8000/"
+    assert_equal "200", response.code
+    assert_equal "ok", response.body
+    assert_operator elapsed, :<, 1.0, "request should not be serialized behind slow client"
+  ensure
+    slow_socket&.close
   end
 
   def test_accept_loop_survives_transient_accept_error
@@ -272,7 +293,7 @@ class ServerTest < Minitest::Test
 
   def test_serves_over_tls
     File.write(File.join(@dir, "x.txt"), "secret")
-    start_server(tls: build_ephemeral_tls)
+    start_server(tls: ephemeral_tls)
 
     response = Net::HTTP.start("127.0.0.1", @server.port, use_ssl: true,
                                                           verify_mode: OpenSSL::SSL::VERIFY_NONE) do |http|
@@ -283,24 +304,6 @@ class ServerTest < Minitest::Test
     assert_equal "secret", response.body
   end
 
-  def test_logs_https_scheme_when_tls_enabled
-    out = StringIO.new
-    @server = Wsv::Server.new(host: "127.0.0.1", port: 0, root: @dir,
-                              out: out, err: StringIO.new, tls: build_ephemeral_tls)
-    @server.send(:log_startup)
-
-    assert_includes out.string, "https://"
-  end
-
-  def test_warns_about_self_signed_cert
-    err = StringIO.new
-    @server = Wsv::Server.new(host: "127.0.0.1", port: 0, root: @dir,
-                              out: StringIO.new, err: err, tls: build_ephemeral_tls)
-    @server.send(:log_startup)
-
-    assert_includes err.string, "self-signed"
-  end
-
   def test_unsupported_method
     start_server
 
@@ -312,7 +315,7 @@ class ServerTest < Minitest::Test
 
   private
 
-  def start_server(read_timeout: Wsv::Server::DEFAULT_READ_TIMEOUT, tls: nil)
+  def start_server(read_timeout: Wsv::Server::DEFAULT_READ_TIMEOUT, tls: nil, cors: false)
     @server = Wsv::Server.new(
       host: "127.0.0.1",
       port: free_port,
@@ -320,39 +323,32 @@ class ServerTest < Minitest::Test
       out: StringIO.new,
       err: StringIO.new,
       read_timeout: read_timeout,
-      tls: tls
+      tls: tls,
+      cors: cors
     )
     @thread = Thread.new { @server.start }
     wait_until_ready
   end
 
+  # Wrap accept_loop so the very first call to @server.accept raises a
+  # transient error. Avoids redefining Server#start, which would silently
+  # drift if start grew new steps (open_in_browser, etc.).
   def inject_one_accept_error(server, error_class)
+    original_accept_loop = server.method(:accept_loop)
     fired = false
-    server.define_singleton_method(:start) do
-      @server = TCPServer.new(host, port)
-      original = @server.method(:accept)
+    server.define_singleton_method(:accept_loop) do
+      original_accept = @server.method(:accept)
       @server.define_singleton_method(:accept) do
         unless fired
           fired = true
           raise error_class, "injected"
         end
-        original.call
+        original_accept.call
       end
-      @running = true
-      log_startup
-      trap_signals
-      accept_loop
-    ensure
-      close
+      original_accept_loop.call
     end
   end
 
-  def build_ephemeral_tls
-    key = OpenSSL::PKey::RSA.new(2048)
-    cert = Wsv::TlsContext::SelfSignedCert.build(key)
-    Wsv::TlsContext.new(cert: cert, key: key, ephemeral: true)
-  end
-
   def free_port
     server = TCPServer.new("127.0.0.1", 0)
     server.addr[1]

data/test/test_helper.rb

@@ -7,3 +7,11 @@ require "fileutils"
 require "stringio"
 require "tmpdir"
 require "wsv"
+
+module TlsTestHelpers
+  def ephemeral_tls
+    key = OpenSSL::PKey::RSA.new(2048)
+    cert = Wsv::TlsContext::SelfSignedCert.build(key)
+    Wsv::TlsContext.new(cert: cert, key: key, ephemeral: true)
+  end
+end

data/wsv.gemspec

@@ -8,15 +8,16 @@ Gem::Specification.new do |spec|
   spec.authors = ["takahashim"]
   spec.email = ["takahashimm@gmail.com"]
 
-  spec.summary = "A tiny static web server for local previews."
-  spec.description = "wsv serves a local directory over HTTP from a zero-config CLI."
-  spec.homepage = "https://rubygems.org/gems/wsv"
+  spec.summary = "A zero-dependency static preview server for Ruby projects."
+  spec.description = "wsv is a Ruby CLI that previews a directory over HTTP/HTTPS. " \
+                     "Stdlib-only, no runtime dependencies. Defensive by design: " \
+                     "blocks dotfiles, binds to loopback, ships with TLS and CORS."
+  spec.homepage = "https://github.com/takahashim/wsv"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.2"
 
   spec.metadata = {
     "homepage_uri" => spec.homepage,
-    "source_code_uri" => "https://github.com/takahashim/wsv",
     "changelog_uri" => "https://github.com/takahashim/wsv/blob/main/CHANGELOG.md",
     "rubygems_mfa_required" => "true"
   }
@@ -25,12 +26,12 @@ Gem::Specification.new do |spec|
     "CHANGELOG.md",
     "LICENSE.txt",
     "README.md",
-    "bin/wsv",
+    "exe/wsv",
     "lib/**/*.rb",
     "test/**/*.rb",
     "wsv.gemspec"
   ]
-  spec.bindir = "bin"
+  spec.bindir = "exe"
   spec.executables = ["wsv"]
   spec.require_paths = ["lib"]
 end

metadata

@@ -1,15 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: wsv
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - takahashim
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
-description: wsv serves a local directory over HTTP from a zero-config CLI.
+description: 'wsv is a Ruby CLI that previews a directory over HTTP/HTTPS. Stdlib-only,
+  no runtime dependencies. Defensive by design: blocks dotfiles, binds to loopback,
+  ships with TLS and CORS.'
 email:
 - takahashimm@gmail.com
 executables:
@@ -20,13 +22,14 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- bin/wsv
+- exe/wsv
 - lib/wsv.rb
 - lib/wsv/app.rb
 - lib/wsv/cli.rb
 - lib/wsv/cors.rb
 - lib/wsv/mime_types.rb
 - lib/wsv/path_resolver.rb
+- lib/wsv/range_request.rb
 - lib/wsv/request.rb
 - lib/wsv/request/parser.rb
 - lib/wsv/request/too_large.rb
@@ -38,28 +41,33 @@ files:
 - lib/wsv/server.rb
 - lib/wsv/server/banner.rb
 - lib/wsv/server/browser_launcher.rb
+- lib/wsv/server/connection.rb
+- lib/wsv/server/connection_throttle.rb
 - lib/wsv/server/deadline_reader.rb
+- lib/wsv/server/url_host.rb
 - lib/wsv/status.rb
 - lib/wsv/tls_context.rb
 - lib/wsv/tls_context/resolver.rb
 - lib/wsv/tls_context/self_signed_cert.rb
 - lib/wsv/version.rb
 - test/app_test.rb
+- test/banner_test.rb
 - test/browser_launcher_test.rb
 - test/cli_test.rb
+- test/cors_test.rb
 - test/path_resolver_test.rb
+- test/range_request_test.rb
 - test/request_test.rb
 - test/response_test.rb
 - test/server_test.rb
 - test/test_helper.rb
 - test/tls_context_test.rb
 - wsv.gemspec
-homepage: https://rubygems.org/gems/wsv
+homepage: https://github.com/takahashim/wsv
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://rubygems.org/gems/wsv
-  source_code_uri: https://github.com/takahashim/wsv
+  homepage_uri: https://github.com/takahashim/wsv
   changelog_uri: https://github.com/takahashim/wsv/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
@@ -78,5 +86,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.2
 specification_version: 4
-summary: A tiny static web server for local previews.
+summary: A zero-dependency static preview server for Ruby projects.
 test_files: []