async-htty 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57888805cdcf6fd48de1750317bdaff0252e1b912109ac138ab16e781152efba
-  data.tar.gz: b1f8814861de4ef764495a9a7ef5d43aa954ab01248c3e905b32bceec081f068
+  metadata.gz: c05feb5444f1fb836e415c02bc4298c1999358b35c5f9775dc7da7f6d52f3c7c
+  data.tar.gz: 93215fb6565f7033e45b70e4c3f7831998e0b10e926afac2e098c8fb38cdbfd5
 SHA512:
-  metadata.gz: 0c564e40838c62f1918c1c95317638088e96b54aacf7aa3d0282fcb8046795a320a428e332fab27805fdccefbbd6f096090f7351bdf5143c1fd0a5618ebed753
-  data.tar.gz: 1129bb1a6e58dc3dd0b4aff3572377871cc0ba98ae553330cc5211032d08c5b5d777f8392e45885ae95d4ebafe1fb1a9b13c4c74027f048eb72a21a15fa681c2
+  metadata.gz: e662f9bad50e239ef015d27b45299f959ef16376fe03d2eac4790ed1cf4ccd96e970792123c1346e1cb69d99436a47783e886e4ccafbbdbebf52d8d568d991d0
+  data.tar.gz: 167fa6017a168cb7a6cfcd13fb1feaa4e02d41afdfa8dfb6e612d58fc3cee145ee38424d8efad8f3db236f6c8f3a0899f3271e7baaec9f6e2f00b753af796e0a

data/examples/raw_mode_probe.rb

@@ -49,15 +49,15 @@ TEXT
 STDIN.raw(min: 0, time: 1) do |input|
 	loop do
 		chunk = input.read_nonblock(32, exception: false)
-
+		
 		case chunk
 		when :wait_readable, nil
 			# Keep the process alive while waiting for external signals.
 			next
 		else
 			bytes = chunk.bytes
-			puts "read #{bytes.length} byte(s): #{bytes.map {|byte| format("0x%02X", byte)}.join(" ")}"
-
+			puts "read #{bytes.length} byte(s): #{bytes.map{|byte| format("0x%02X", byte)}.join(" ")}"
+			
 			break if chunk.include?("q")
 			break if bytes.include?(3)
 		end

data/lib/async/htty/environment/server.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require_relative "../service/server"
+
+module Async
+	module HTTY
+		module Environment
+			# An async-service environment module for HTTY transport.
+			# Include this (or let Lively::Environment::Application include it)
+			# to replace Falcon with an HTTY server in the service lifecycle.
+			module Server
+				# Do not restart after the HTTY session ends.
+				# Unlike a TCP server, there is nothing to reconnect to once
+				# stdin/stdout closes.
+				# @returns [Hash]
+				def container_options
+					{count: 1, restart: false}
+				end
+				
+				# Use the HTTY service server instead of Falcon's.
+				# @returns [Class]
+				def service_class
+					Async::HTTY::Service::Server
+				end
+			end
+		end
+	end
+end

data/lib/async/htty/server.rb

@@ -28,7 +28,7 @@ module Async
 			def self.open(app = nil, input: $stdin, output: $stdout, error: $stderr, env: ENV, **options, &block)
 				app ||= block
 				server = self.new(app, **options)
-
+				
 				case env["HTTY"]
 				when "0"
 					raise DisabledError, "HTTY is disabled!"
@@ -36,7 +36,7 @@ module Async
 					$stderr.puts "HTTY is not supported by this environment, visit https://htty.dev for more information."
 					raise UnsupportedError, "HTTY is not supported by this environment"
 				end
-
+				
 				unless input.respond_to?(:tty?) && input.tty?
 					raise UnsupportedError, "HTTY requires a TTY input stream"
 				end

data/lib/async/htty/service/server.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "async/service/generic"
+require_relative "../server"
+
+module Async
+	module HTTY
+		module Service
+			# An async-service managed service that runs an HTTY server.
+			# Mirrors Falcon::Service::Server but binds to stdin/stdout instead
+			# of a TCP endpoint. The container thread lifetime equals the HTTY session.
+			#
+			# We use Generic rather than Managed::Service because Managed::Service
+			# calls instance.ready! *after* run() returns. For HTTY, run() blocks for
+			# the entire session, so ready! would never be signalled while the session
+			# is live — causing the container controller to hang in wait_until_ready.
+			class Server < Async::Service::Generic
+				# Set up the container to run the HTTY server.
+				# Signals instance.ready! before the blocking accept loop so the
+				# controller does not stall waiting for startup confirmation.
+				#
+				# @parameter container [Async::Container::Generic]
+				def setup(container)
+					super
+					
+					container.run(**@evaluator.container_options) do |instance|
+						Sync do
+							server = Async::HTTY::Server.new(@evaluator.middleware)
+							
+							original_input = $stdin.dup
+							original_output = $stdout.dup
+							original_error = $stderr.dup
+							
+							stream = ::Protocol::HTTY::Stream.new(original_input, original_output)
+							
+							$stdin.reopen(File::NULL)
+							$stdout.reopen(File::NULL)
+							if path = ENV.fetch("HTTY_ERROR_LOG", nil)
+								$stderr.reopen(File.open(path, "a"))
+							else
+								$stderr.reopen(File::NULL)
+							end
+							
+							instance.ready!
+							
+							Async::HTTY::Server.with_raw_terminal(original_input) do
+								server.accept(stream)
+							end
+						ensure
+							$stdin.reopen(original_input) rescue nil
+							$stdout.reopen(original_output) rescue nil
+							$stderr.reopen(original_error) rescue nil
+						end
+					end
+				end
+			end
+		end
+	end
+end

data/lib/async/htty/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module HTTY
-		VERSION = "0.4.0"
+		VERSION = "0.5.0"
 	end
 end

data/readme.md

@@ -14,6 +14,10 @@ Please see the [project documentation](https://socketry.github.io/async-htty/) f
 
 Please see the [project releases](https://socketry.github.io/async-htty/releases/index) for all releases.
 
+### v0.5.0
+
+  - Add `Async::HTTY::Service::Server` and `Async::HTTY::Environment::Server`.
+
 ### v0.4.0
 
   - Suppress errors from `send_goaway` during connection cleanup to prevent shutdown exceptions from propagating.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.5.0
+
+  - Add `Async::HTTY::Service::Server` and `Async::HTTY::Environment::Server`.
+
 ## v0.4.0
 
   - Suppress errors from `send_goaway` during connection cleanup to prevent shutdown exceptions from propagating.

data/test/async/htty/server.rb

@@ -209,15 +209,15 @@ describe Async::HTTY::Server do
 		
 		expect(Async::HTTY::DisabledError).to be < Async::HTTY::UnsupportedError
 	end
-
+	
 	it "raises a typed error when stdin is not a tty" do
 		input = Async::HTTY::FakeFile.new
 		output = Async::HTTY::FakeFile.new
-
+		
 		expect do
 			subject.open(Protocol::HTTP::Middleware::Okay, input: input, output: output, error: error, env: env)
 		end.to raise_exception(Async::HTTY::UnsupportedError, message: be =~ /TTY input/)
-
+		
 		expect(input.reopen_events).to be == []
 		expect(output.reopen_events).to be == []
 	end
@@ -238,12 +238,12 @@ describe Async::HTTY::Server do
 		
 		expect(error_output.string).to be(:include?, "https://htty.dev")
 	end
-
+	
 	it "opens a server within its own async context when no task is provided" do
 		input = Async::HTTY::FakeFile.new(tty: true)
 		output = Async::HTTY::FakeFile.new
 		accepted = false
-
+		
 		server = Object.new
 		server.define_singleton_method(:each) do
 		end
@@ -254,15 +254,15 @@ describe Async::HTTY::Server do
 		end
 		server.define_singleton_method(:close) do
 		end
-
+		
 		protocol = Object.new
 		protocol.define_singleton_method(:server) do |stream|
 			accepted = true
 			server
 		end
-
+		
 		subject.open(Protocol::HTTP::Middleware::Okay, input: input, output: output, error: error, env: env, protocol: protocol)
-
+		
 		expect(accepted).to be == true
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-htty
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -102,11 +102,13 @@ files:
 - examples/hello_world.rb
 - examples/raw_mode_probe.rb
 - lib/async/htty.rb
+- lib/async/htty/environment/server.rb
 - lib/async/htty/error.rb
 - lib/async/htty/protocol.rb
 - lib/async/htty/protocol/htty.rb
 - lib/async/htty/protocol/htty/server.rb
 - lib/async/htty/server.rb
+- lib/async/htty/service/server.rb
 - lib/async/htty/version.rb
 - license.md
 - readme.md