uringmachine 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c4ce5de22052f74a5386dafe18ff4f021db995b6a6b120516a98e0f81783222
-  data.tar.gz: 64b51a3e8c2e1d5392c6cd8c4c995c09b506de554a537bad14a3074702fb0926
+  metadata.gz: 1c37bb6e6971036cefa78d76efbb4425f843087b4b4f5e24fe16e695920746b8
+  data.tar.gz: 144e109b5dfa199adda69387c7229c78393f3ee8b0a45f545db76934f896ef2c
 SHA512:
-  metadata.gz: 458534cc0ceec394b4dcf32829f62708ac1c68a8e7adf71f4bb48fe00195594805fe22ecc990edc38790b44e9609eeee00ca0c537bc316136e00bb3e87b69577
-  data.tar.gz: d955545beb0ba009b85ae3fa11619bf3a8869ad97474dd041e57d2c903555418e40e22eae2707a4e936563196162cec197ba55f516fb475cdb6f71da62fb9e87
+  metadata.gz: 3d19ae0d9c4056c691a8b9c93901f759e2b149ebd275d8a5d1e0dcfc33e2308eef0e583541b2ce90b69d55efc20b4ab0c7415f4e44d0c9753b07e733bc965e90
+  data.tar.gz: 697653d6d9120bcbece655bf530e1e87e9fc461e2052bd20b8666f344440ee11898b569c3d98a7477c39dd11bdf6ff03fc6b1e08f953c257a84fb0aea58a882f

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 1.0.6 2026-10-01
+
+- Add `UM#file_read` convenience method
+
 # 1.0.5 2026-10-01
 
 - Add support for regular files in UM::IO with :file mode

data/lib/uringmachine/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class UringMachine
-  VERSION = '1.0.5'
+  VERSION = '1.0.6'
 end

data/lib/uringmachine.rb

@@ -50,7 +50,7 @@ class UringMachine
   end
 
   # Runs the given block in the given fiber. This method is used to run fibers
-  # indirectly.
+  # indirectly. See FiberScheduler#fiber
   #
   # @param fiber [Fiber] fiber
   # @param block [Proc] block to run
@@ -202,9 +202,10 @@ class UringMachine
   # the type of target and how it is read from:
   #
   # - :fd - read from the given fd using the buffer pool (default mode)
+  # - :file - read from a regular file
   # - :socket - receive from the given socket fd using the buffer pool
   # - :ssl - read from the given SSL socket
-  #
+  # 
   # If a block is given, the block will be called with the IO instance as
   # argument and the method will return the block's return value.
   #
@@ -220,6 +221,17 @@ class UringMachine
     res
   end
 
+  # call-seq:
+  #   machine.file_read(fn) -> data
+  #
+  # Reads and returns the content of the given filename, with a maximum length of 1GB.
+  #
+  # @param fn [String] filename
+  # @return [String] file content
+  def file_read(fn)
+    open(fn, O_RDONLY) { io(it, :file).read(-(1 << 30)) }
+  end
+
   # Creates, binds and sets up a TCP socket for listening on the given host and
   # port.
   #

data/test/test_um.rb

@@ -2,6 +2,7 @@
 
 require_relative 'helper'
 require 'socket'
+require 'tempfile'
 
 class UringMachineTest < Minitest::Test
   def test_kernel_version
@@ -3520,6 +3521,23 @@ class IOMethodTest < UMBaseTest
   end
 end
 
+class FileHelperMethodsTest < UMBaseTest
+  def setup
+    super
+    @fn = Tempfile.new('uringmachine_test_io_from_file').path
+  end
+
+  def test_file_read
+    IO.write(@fn, 'foobar' * 321)
+    buf = machine.file_read(@fn)
+    assert_equal 'foobar' * 321, buf
+  end
+
+  def test_file_read_bad_fn
+    assert_raises(Errno::ENOENT) { machine.file_read(@fn + '-missing') }
+  end
+end
+
 class TCPHelperMethodsTest < UMBaseTest
   def setup
     super

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uringmachine
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - Sharon Rosner