io-stream 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 506d80a7bb9aee846def3d18d0bf53f2085b751de5d511a8a6a31f8a5de0efd2
-  data.tar.gz: 9c828735d78bdeb4dba18b81ed350f5776ba3436cca7f18b17c465d6efd4ce7e
+  metadata.gz: c9a2897049a042fc1a0ba9a45d3f5700375938c6983d2ad2752f68c98b187b0c
+  data.tar.gz: 7991aaf45961ca5ec63254a1f83dffa5af87a1b4950aa0d0484ea4d23b55f7f0
 SHA512:
-  metadata.gz: 19d26e89eca00835b6331548e72fc74bf17add777028af9bb6d6a7749ee760eab41a5bae780876de278c6f82eeec02366ce83bb160c798cb441a28dbef56f263
-  data.tar.gz: 798d2863752eca4a03d9ae7b21000530442b7a4af218f2e89d1590baa2e821650fcb66689e6ae88ba91b5ec742136ef46c328a7a48afb2d7048990084a12af05
+  metadata.gz: ee85bb6dd18c0281d3dbe0d3af1a8cb5379834e40666e0a77c813a372f05dea8dda255a29c0196517ca978860f0032ee15bfec89cfb8770c1a24416acfc1d189
+  data.tar.gz: 399269a7444a2763b7ef82f2dacc2954aa06e82e3859a88411f7291f6afc98949d93a5b2936fdc8a0d493df3c38ee216b40e9055017f8c9f6c5dd95fcfc6116c

data/lib/io/stream/readable.rb

@@ -30,7 +30,7 @@ module IO::Stream
 		# @parameter maximum_read_size [Integer] The maximum size for read operations.
 		# @parameter block_size [Integer] Legacy parameter, use minimum_read_size instead.
 		def initialize(minimum_read_size: MINIMUM_READ_SIZE, maximum_read_size: MAXIMUM_READ_SIZE, block_size: nil, **, &block)
-			@done = false
+			@finished = false
 			@read_buffer = StringBuffer.new
 			# Used as destination buffer for underlying reads.
 			@input_buffer = StringBuffer.new
@@ -72,7 +72,7 @@ module IO::Stream
 			end
 			
 			if size
-				until @done or @read_buffer.bytesize >= size
+				until @finished or @read_buffer.bytesize >= size
 					# Compute the amount of data we need to read from the underlying stream:
 					read_size = size - @read_buffer.bytesize
 					
@@ -80,7 +80,7 @@ module IO::Stream
 					fill_read_buffer(read_size > @minimum_read_size ? read_size : @minimum_read_size)
 				end
 			else
-				until @done
+				until @finished
 					fill_read_buffer
 				end
 				
@@ -114,7 +114,7 @@ module IO::Stream
 				end
 			end
 		
-			if !@done and @read_buffer.empty?
+			if !@finished and @read_buffer.empty?
 				fill_read_buffer
 			end
 			
@@ -134,7 +134,7 @@ module IO::Stream
 				return buffer
 			end
 			
-			raise exception, "Encountered done while reading data!"
+			raise exception, "Stream finished before reading enough data!"
 		end
 		
 		# This is a compatibility shim for existing code that uses `readpartial`.
@@ -142,7 +142,7 @@ module IO::Stream
 		# @parameter buffer [String | Nil] An optional buffer to fill with data instead of allocating a new string.
 		# @returns [String] The data read from the stream.
 		def readpartial(size = nil, buffer = nil)
-			read_partial(size, buffer) or raise EOFError, "Encountered done while reading data!"
+			read_partial(size, buffer) or raise EOFError, "Stream finished before reading enough data!"
 		end
 		
 		# Find the index of a pattern in the read buffer, reading more data if needed.
@@ -222,7 +222,7 @@ module IO::Stream
 		# @returns [String] The data in the buffer without consuming it.
 		def peek(size = nil)
 			if size
-				until @done or @read_buffer.bytesize >= size
+				until @finished or @read_buffer.bytesize >= size
 					# Compute the amount of data we need to read from the underlying stream:
 					read_size = size - @read_buffer.bytesize
 					
@@ -231,7 +231,7 @@ module IO::Stream
 				end
 				return @read_buffer[..([size, @read_buffer.size].min - 1)]
 			end
-			until (block_given? && yield(@read_buffer)) or @done
+			until (block_given? && yield(@read_buffer)) or @finished
 				fill_read_buffer
 			end
 			return @read_buffer
@@ -287,33 +287,33 @@ module IO::Stream
 		# See {readable?} for a non-blocking alternative.
 		#
 		# @returns [Boolean] If the stream is at file which means there is no more data to be read.
-		def done?
+		def finished?
 			if !@read_buffer.empty?
 				return false
-			elsif @done
+			elsif @finished
 				return true
 			else
 				return !self.fill_read_buffer
 			end
 		end
 		
-		alias eof? done?
+		alias eof? finished?
 		
-		# Mark the stream as done and raise `EOFError`.
-		def done!
+		# Mark the stream as finished and raise `EOFError`.
+		def finish!
 			@read_buffer.clear
-			@done = true
+			@finished = true
 			
 			raise EOFError
 		end
 		
-		alias eof! done!
+		alias eof! finish!
 		
 		# Whether there is a chance that a read operation will succeed or not.
 		# @returns [Boolean] If the stream is readable, i.e. a `read` operation has a chance of success.
 		def readable?
 			# If we are at the end of the file, we can't read any more data:
-			if @done
+			if @finished
 				return false
 			end
 			
@@ -358,7 +358,7 @@ module IO::Stream
 			end
 			
 			# else for both cases above:
-			@done = true
+			@finished = true
 			return false
 		end
 		
@@ -367,8 +367,8 @@ module IO::Stream
 		# @parameter buffer [String | Nil] An optional buffer to fill with data instead of allocating a new string.
 		# @returns [String | Nil] The consumed data, or nil if no data available.
 		def consume_read_buffer(size = nil, buffer = nil)
-			# If we are at done, and the read buffer is empty, we can't consume anything.
-			if @done && @read_buffer.empty?
+			# If we are at finished, and the read buffer is empty, we can't consume anything.
+			if @finished && @read_buffer.empty?
 				# Clear the buffer even when returning nil
 				if buffer
 					buffer.clear

data/lib/io/stream/version.rb

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

data/readme.md

@@ -12,6 +12,10 @@ Please see the [project documentation](https://socketry.github.io/io-stream) for
 
 Please see the [project releases](https://socketry.github.io/io-streamreleases/index) for all releases.
 
+### v0.10.0
+
+  - Rename `done?` to `finished?` for clarity and consistency.
+
 ### v0.9.1
 
   - Fix EOF behavior to match Ruby IO semantics: `read()` returns empty string `""` at EOF while `read(size)` returns `nil` at EOF.
@@ -55,13 +59,6 @@ Please see the [project releases](https://socketry.github.io/io-streamreleases/i
   - Add external test suite for better integration testing.
   - Update dependencies and improve code style with RuboCop.
 
-### v0.4.1
-
-  - Add compatibility fix for `SSLSocket` raising `EBADF` errors.
-  - Fix `IO#close` hang issue in certain scenarios.
-  - Add `#to_io` method to `IO::Stream::Buffered` for better compatibility.
-  - Modernize gem structure and dependencies.
-
 ## See Also
 
   - [async-io](https://github.com/socketry/async-io) — Where this implementation originally came from.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.10.0
+
+  - Rename `done?` to `finished?` for clarity and consistency.
+
 ## v0.9.1
 
   - Fix EOF behavior to match Ruby IO semantics: `read()` returns empty string `""` at EOF while `read(size)` returns `nil` at EOF.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-stream
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Samuel Williams