io-stream 0.11.0 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c071e8e033bc6afd35a809466299187cfbee327acf26787968a7af2baeb89ce
-  data.tar.gz: 748cee4f872237453f35ef91aea936f29a632a27d35cf09235dcdd72b12e5826
+  metadata.gz: aa0f71cc4addc72776d1dbc02c14d0edb79fc0ae250aebb7f0d4924f6b251701
+  data.tar.gz: b5f6ec1328debef8a9b9f9d8593f8a929504e5f0cc170cb780fec41a75ac38f2
 SHA512:
-  metadata.gz: 758b8a379a4b745e51a58810011a33fd5473527863da8c655d2f84a8fa135925b258edf25dd2431ab9b4f2b9e983a725cf6855ead510ac832705eb55c08a5d41
-  data.tar.gz: d7acbd5c30572b838503b1e25faea6b6ce046e76581d712bcd2fa6792a3f156992a69610a19d76be6e3746b4782cba479b9e318762dbb5864d5f4ff732fd273e
+  metadata.gz: bd297845e8fdcabd8879baa92e46908129d585a378bf982a1e6f051d67748d216aa7435cbd391bebf2ae364838893c372666a1c10d5de36fcef4e91884377cd1
+  data.tar.gz: 857c75d7a920b8f4b6dbcda4746ae41e059eb936cda6f1ea347191843996e00af4a87d4f6e04b0be219c1b4199f59d9ccb3b1114a15619f131186aba68b833e5

data/lib/io/stream/generic.rb

@@ -18,6 +18,14 @@ module IO::Stream
 		include Readable
 		include Writable
 		
+		# Check if a method is async-safe.
+		#
+		# @parameter method [Symbol] The method name to check.
+		# @returns [Symbol | Boolean] The concurrency guard for the given method.
+		def self.async_safe?(method)
+			Readable.async_safe?(method) || Writable.async_safe?(method)
+		end
+		
 		# Initialize a new generic stream.
 		# @parameter options [Hash] Options passed to included modules.
 		def initialize(**options)

data/lib/io/stream/readable.rb

@@ -25,6 +25,31 @@ module IO::Stream
 	#
 	# You must implement the `sysread` method to read data from the underlying IO.
 	module Readable
+		ASYNC_SAFE = {
+			read: :readable,
+			read_partial: :readable,
+			read_exactly: :readable,
+			read_until: :readable,
+			peek: :readable,
+			gets: :readable,
+			getc: :readable,
+			getbyte: :readable,
+			readline: :readable,
+			readlines: :readable,
+			readable?: :readable,
+			fill_read_buffer: :readable,
+			eof?: :readable,
+			finished?: :readable,
+		}.freeze
+		
+		# Check if a method is async-safe.
+		#
+		# @parameter method [Symbol] The method name to check.
+		# @returns [Symbol | Boolean] The concurrency guard for the given method.
+		def self.async_safe?(method)
+			ASYNC_SAFE.fetch(method, false)
+		end
+		
 		# Initialize readable stream functionality.
 		# @parameter minimum_read_size [Integer] The minimum size for read operations.
 		# @parameter maximum_read_size [Integer] The maximum size for read operations.

data/lib/io/stream/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2023-2025, by Samuel Williams.
 
 module IO::Stream
-	VERSION = "0.11.0"
+	VERSION = "0.11.1"
 end

data/lib/io/stream/writable.rb

@@ -13,6 +13,20 @@ module IO::Stream
 	#
 	# You must implement the `syswrite` method to write data to the underlying IO.
 	module Writable
+		ASYNC_SAFE = {
+			write: true,
+			puts: true,
+			flush: true,
+		}.freeze
+		
+		# Check if a method is async-safe.
+		#
+		# @parameter method [Symbol] The method name to check.
+		# @returns [Symbol | Boolean] The concurrency guard for the given method.
+		def self.async_safe?(method)
+			ASYNC_SAFE.fetch(method, false)
+		end
+		
 		# Initialize writable stream functionality.
 		# @parameter minimum_write_size [Integer] The minimum buffer size before flushing.
 		def initialize(minimum_write_size: MINIMUM_WRITE_SIZE, **, &block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-stream
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.11.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -76,7 +76,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Provides a generic stream wrapper for IO instances.
 test_files: []