io-stream 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6a65103b45022f50d46603a178bb87f7bf8a11ab24da10e855dd7c18233a261
-  data.tar.gz: d0870c42173b4e87388ea1f3c56e68323c394cac7bf4ea1d90cd879d1c02b8a4
+  metadata.gz: f0a5f918cac3b8ad0a5f88281f74f2ba71b1f37e3b0504bab234fc7139ae22c9
+  data.tar.gz: ce06b6c063777952df3f6e911807e7377983e15450259d269d05d69ac8e073fa
 SHA512:
-  metadata.gz: 97d1162cf543a3b604a1fe1873525d8c6278c1adac118fe165e0d1066a8421b06a4932e96e46276bc7abe8f618fe0bc89f45c5f13dd262d52c2e58e65cd5f878
-  data.tar.gz: 0c7db373575894a7271133aa1f610246efad907e7e168114ba677c64fbfb7a0695fd80dd286585ebdfe5af6e88f44d1f2a2c3ecf339fda540eb8ac913a2f181a
+  metadata.gz: b74b95787f49071ba75c4b17ab6683b14fa24c2a83c8cc8b896cc4f23ba684ab0657b5dd0db7d6701b65e2da276619e6539a120918f079b23dbdef53b9bd6b93
+  data.tar.gz: d254f93d0561271c7406f2a00269e53776ef6548ea1814b169fdee5dc661bed4230eefef734ceb463a0561f255e8c9c8c0f76bd20419213ac49cc18b11ccf7e0

data/lib/io/stream/buffered.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2024, by Samuel Williams.
 
-require_relative 'generic'
+require_relative "generic"
 
 module IO::Stream
 	class Buffered < Generic
@@ -50,6 +50,10 @@ module IO::Stream
 		
 		attr :io
 		
+		def to_io
+			@io.to_io
+		end
+		
 		def closed?
 			@io.closed?
 		end
@@ -70,8 +74,15 @@ module IO::Stream
 		
 		protected
 		
-		def sysclose
-			@io.close
+		if RUBY_VERSION >= "3.3.0"
+			def sysclose
+				# https://bugs.ruby-lang.org/issues/20723
+				Thread.new{@io.close}.join
+			end
+		else
+			def sysclose
+				@io.close
+			end
 		end
 		
 		def syswrite(buffer)
@@ -111,6 +122,8 @@ module IO::Stream
 					return result
 				end
 			end
+		rescue Errno::EBADF
+			raise ::IOError, "stream closed"
 		end
 	end
 end

data/lib/io/stream/generic.rb

@@ -3,20 +3,20 @@
 # Released under the MIT License.
 # Copyright, 2023-2024, by Samuel Williams.
 
-require_relative 'string_buffer'
+require_relative "string_buffer"
 
-require_relative 'shim/buffered'
-require_relative 'shim/readable'
-require_relative 'shim/timeout'
+require_relative "shim/buffered"
+require_relative "shim/readable"
+require_relative "shim/timeout"
 
-require_relative 'openssl'
+require_relative "openssl"
 
 module IO::Stream
 	# The default block size for IO buffers. Defaults to 64KB (typical pipe buffer size).
-	BLOCK_SIZE = ENV.fetch('IO_STREAM_BLOCK_SIZE', 1024*64).to_i
+	BLOCK_SIZE = ENV.fetch("IO_STREAM_BLOCK_SIZE", 1024*64).to_i
 
 	# The maximum read size when appending to IO buffers. Defaults to 8MB.
-	MAXIMUM_READ_SIZE = ENV.fetch('IO_STREAM_MAXIMUM_READ_SIZE', BLOCK_SIZE * 128).to_i
+	MAXIMUM_READ_SIZE = ENV.fetch("IO_STREAM_MAXIMUM_READ_SIZE", BLOCK_SIZE * 128).to_i
 	
 	class Generic
 		def initialize(block_size: BLOCK_SIZE, maximum_read_size: MAXIMUM_READ_SIZE)
@@ -195,7 +195,7 @@ module IO::Stream
 			rescue
 				# We really can't do anything here unless we want #close to raise exceptions.
 			ensure
-				sysclose
+				self.sysclose
 			end
 		end
 		

data/lib/io/stream/openssl.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2024, by Samuel Williams.
 
-require 'openssl'
+require "openssl"
 
 module OpenSSL
 	module SSL

data/lib/io/stream/shim/buffered.rb

@@ -15,7 +15,7 @@ unless IO.method_defined?(:buffered?, false)
 	end
 end
 
-require 'socket'
+require "socket"
 
 unless BasicSocket.method_defined?(:buffered?, false)
 	class BasicSocket
@@ -50,7 +50,7 @@ unless BasicSocket.method_defined?(:buffered?, false)
 	end
 end
 
-require 'stringio'
+require "stringio"
 
 unless StringIO.method_defined?(:buffered?, false)
 	class StringIO

data/lib/io/stream/shim/readable.rb

@@ -12,7 +12,7 @@ class IO
 	end
 end
 
-require 'socket'
+require "socket"
 
 class BasicSocket
 	unless method_defined?(:readable?, false)
@@ -32,7 +32,7 @@ class BasicSocket
 	end
 end
 
-require 'stringio'
+require "stringio"
 
 class StringIO
 	unless method_defined?(:readable?, false)
@@ -42,7 +42,7 @@ class StringIO
 	end
 end
 
-require 'openssl'
+require "openssl"
 
 class OpenSSL::SSL::SSLSocket
 	unless method_defined?(:readable?, false)

data/lib/io/stream/shim/timeout.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2024, by Samuel Williams.
+
 class IO
 	unless const_defined?(:TimeoutError)
 		# Compatibility shim.

data/lib/io/stream/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2023-2024, by Samuel Williams.
 
 module IO::Stream
-	VERSION = "0.3.0"
+	VERSION = "0.4.1"
 end

data/lib/io/stream.rb

@@ -3,10 +3,18 @@
 # Released under the MIT License.
 # Copyright, 2023-2024, by Samuel Williams.
 
-require_relative 'stream/version'
-require_relative 'stream/buffered'
+require_relative "stream/version"
+require_relative "stream/buffered"
 
 class IO
 	module Stream
 	end
+	
+	def self.Stream(io)
+		if io.is_a?(Stream::Buffered)
+			io
+		else
+			Stream::Buffered.wrap(io)
+		end
+	end
 end

data/readme.md

@@ -20,11 +20,11 @@ We welcome contributions to this project.
 
 ### Developer Certificate of Origin
 
-This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.
 
 ## See Also
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-stream
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-04-23 00:00:00.000000000 Z
+date: 2024-09-11 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -78,7 +78,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Provides a generic stream wrapper for IO instances.