ractor_io 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bf54ab67f82f962cbe2775f129d2b3dda7ede4d7b62fb9d0f8073027257b9514
+  data.tar.gz: 1578c016bb11b9ed1c231c15428715a89f3c3869d7eacc65ea6e561121112ec3
+SHA512:
+  metadata.gz: f70fe4a5bf3c4afcf7331e5f5871c8ee0dc3fc3e298ec57c5f2c78235bb6c0f2736214edb3edb4fc2bfdff03ee5406cc2169572afcee2255bbf17e046ac5c954
+  data.tar.gz: cbfd790166f4daf442aa8df1fc5403758c305201d56489ea31d8193b3846ac844c451ce9732d2d3a5dd2fc3e20ba9614e572ac0a49b568780f230c97a1fa1d0d

data/lib/ractor_io.rb

@@ -0,0 +1,46 @@
+# this class loads the contents of a file using a Ractor so that it's running
+# outside your main Ractor.
+#
+# Usage:
+#   rio = RactorIO.new.read('/tmp/a_large_file.txt')  # read a file
+#   ... do other stuff ...
+#
+#   # optional loop until the file is read
+#   loop do
+#     breadk if rio.ready?
+#     sleep 1
+#   end
+#
+#   rio.string    # contains the contents of the file as one large String
+class RactorIO
+  attr_reader :string
+
+  def initialize
+    @ready = false
+    @string = nil
+  end
+
+  # this method returns immediately and loads the file in the background
+  #
+  # path: the path to the file you want to read.
+  def read(path)
+    Thread.new do
+      @ready = false
+      @string = nil
+      r = Ractor.new do
+        Ractor.yield(IO.read(Ractor.receive), move: true)
+      end
+      r.send(path)
+      @string = r.take
+      @ready = true
+
+      nil
+    end
+
+    nil
+  end
+
+  def ready?
+    @ready
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: ractor_io
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-01-01 00:00:00.000000000 Z
+dependencies: []
+description: a small class that loads files in the background via a Ractor
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ractor_io.rb
+homepage: https://github.com/jefflunt/ractor_io
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: want a simple way to load large files in the backgroudn via a Ractor? then
+  this library is for you.
+test_files: []