thread_io 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1ddae2ee6000eeb036b0ed8bccf23ca56dd80823ba7d4e86b8075b0751a1daa3
+  data.tar.gz: 012364aed013a8381c6755b0e3e1b60e1ba640dae28cdb05ac3f09b54631bb59
+SHA512:
+  metadata.gz: a71ac3aab6e4f7f8a66d11cb62da0c4fe5ab45a0bbd37e6f041e87f6d70468dfa6a38e80028e60bf0237d5cd05e4edd69c1b2f927cfa4aafe4f789ed40c21961
+  data.tar.gz: 2da2efb69a9e4780c62116585e911cdb6d242b5a68dda37c45679e6c858a66209e1317a10629817306f013dddffc170b3e7ccc02ca552b431178b186c45d2b4c

data/lib/thread_io.rb

@@ -0,0 +1,42 @@
+# this class loads the contents of a file using a Thread so that it's running
+# outside your main Thread.
+#
+# Usage:
+#   tio = ThreadIO.new.read('/tmp/a_large_file.txt')  # read a file
+#   ... do other stuff ...
+#
+#   # optional loop until the file is read
+#   loop do
+#     breadk if tio.ready?
+#     sleep 1
+#   end
+#
+#   tio.string    # contains the contents of the file as one large String
+class ThreadIO
+  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)
+    @ready = false
+    Thread.new do
+      @string = nil
+      @string = IO.read(path)
+      @ready = true
+
+      nil
+    end
+
+    nil
+  end
+
+  def ready?
+    @ready
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: thread_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 Thread
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/thread_io.rb
+homepage: https://github.com/jefflunt/thread_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 Thread? then
+  this library is for you.
+test_files: []