feat(bindings/ruby): implement an IO like class

bindings/ruby/lib/opendal.rb

@@ -19,3 +19,4 @@
 
 require_relative "opendal_ruby/version"
 require_relative "opendal_ruby/opendal_ruby"
+require_relative "opendal_ruby/io"

bindings/ruby/lib/opendal_ruby/io.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module OpenDAL
+  class IO
+    # Reads all lines from the stream into an array.
+    # Raises `EOFError` when the end of the file is reached.
+    def readlines
+      results = []
+
+      loop do
+        results << readline
+      rescue EOFError
+        break
+      end
+
+      results
+    end
+
+    # Rewinds the stream to the beginning.
+    def rewind
+      seek(0, ::IO::SEEK_SET)
+    end
+
+    # Sets the file position to `new_position`.
+    def pos=(new_position)
+      seek(new_position, ::IO::SEEK_SET)
+    end
+
+    alias_method :pos, :tell
+
+    # Checks if the stream is at the end of the file.
+    def eof
+      position = tell
+      seek(0, ::IO::SEEK_END)
+      tell == position
+    end
+
+    alias_method :eof?, :eof
+
+    # Returns the total length of the stream.
+    def length
+      current_position = tell
+      seek(0, ::IO::SEEK_END)
+      tell.tap { self.pos = current_position }
+    end
+
+    alias_method :size, :length
+  end
+end

bindings/ruby/lib/opendal_ruby/version.rb

@@ -18,5 +18,5 @@
 # frozen_string_literal: true
 
 module OpenDAL
-  VERSION = "0.1.9"
+  VERSION = "0.1.10"
 end

bindings/ruby/src/lib.rs

@@ -26,6 +26,7 @@ pub use ::opendal as ocore;
 
 mod capability;
 mod metadata;
+mod opendal_io;
 mod operator;
 
 pub fn format_magnus_error(err: ocore::Error) -> Error {
@@ -39,6 +40,7 @@ fn init(ruby: &Ruby) -> Result<(), Error> {
     let _ = operator::include(&gem_module);
     let _ = metadata::include(&gem_module);
     let _ = capability::include(&gem_module);
+    let _ = opendal_io::include(&gem_module);
 
     Ok(())
 }