qbash 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3ac44ac6da719be360ee7785811de7c2b465efbe274c8ae9f7b0992647c05c0
-  data.tar.gz: cf4e840be85b2b9fc19df98fc2e7f45f45b6c93a525b209a4f715be104870ef5
+  metadata.gz: 629198be7c8f09f07807f2fdc3f43b771df5d1b97ef33ae3a827c1d56a9ec98c
+  data.tar.gz: f7b85be41ea296b819d13e3f4cb23f9d0bfb8137de8f05cd6f10737e535c68a7
 SHA512:
-  metadata.gz: 5eaf974307cfb04ead1c2a890c6c34cb68c1ba9a1f4a3e1f2b858f5eda0579361296fb5e95f8fd3349455f07b5acf4ea8a9fac400f6cde5ace0d1f7381b64cb9
-  data.tar.gz: 554613f18dd98fcac12d7e0d4ce56f1cc8d0aaeaea5866fad42ef41f5bb96dfaddb37d00b75fdefde6665eb0b59f1f1add15668d618379e1e14829457b87844f
+  metadata.gz: 026321cb7140203439059803f02a305980c5c44b988c9ebab82522eb8ede41d9d45dad8c6b1d312fcf7a9ae2192cabd2a67b7305e98d8836fd25d5276ceb6a48
+  data.tar.gz: fd16b90f2af7f1a8ff116e0c1d95cc66a760e4c6c74fcc2763990d9ccf8b07517b6886277e81c8e18164db4c794ac7b619f5df98a20eed888b36fc0fbd300423

data/Gemfile

@@ -32,9 +32,9 @@ gem 'random-port', '~>0.0', require: false
 gem 'rspec-rails', '7.0.1', require: false
 gem 'rubocop', '1.66.1', require: false
 gem 'rubocop-performance', '1.22.1', require: false
-gem 'rubocop-rspec', '3.0.5', require: false
+gem 'rubocop-rspec', '3.1.0', require: false
 gem 'simplecov', '0.22.0', require: false
 gem 'simplecov-cobertura', '2.1.0', require: false
 gem 'w3c_validators', '1.3.7', require: false
-gem 'webmock', '3.23.1', require: false
+gem 'webmock', '3.24.0', require: false
 gem 'yard', '0.9.37', require: false

data/Gemfile.lock

@@ -5,6 +5,7 @@ PATH
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
+      tago (> 0)
 
 GEM
   remote: https://rubygems.org/
@@ -94,7 +95,7 @@ GEM
     i18n (1.14.6)
       concurrent-ruby (~> 1.0)
     io-console (0.7.2)
-    irb (1.14.0)
+    irb (1.14.1)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     json (2.7.2)
@@ -166,7 +167,7 @@ GEM
     regexp_parser (2.9.2)
     reline (0.5.10)
       io-console (~> 0.5)
-    rexml (3.3.7)
+    rexml (3.3.8)
     rspec-core (3.13.1)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.3)
@@ -199,7 +200,7 @@ GEM
     rubocop-performance (1.22.1)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rspec (3.0.5)
+    rubocop-rspec (3.1.0)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
     securerandom (0.3.1)
@@ -225,11 +226,11 @@ GEM
       json (>= 1.8)
       nokogiri (~> 1.6)
       rexml (~> 3.2)
-    webmock (3.23.1)
+    webmock (3.24.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    webrick (1.8.1)
+    webrick (1.8.2)
     yard (0.9.37)
     zeitwerk (2.6.18)
 
@@ -253,11 +254,11 @@ DEPENDENCIES
   rspec-rails (= 7.0.1)
   rubocop (= 1.66.1)
   rubocop-performance (= 1.22.1)
-  rubocop-rspec (= 3.0.5)
+  rubocop-rspec (= 3.1.0)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
   w3c_validators (= 1.3.7)
-  webmock (= 3.23.1)
+  webmock (= 3.24.0)
   yard (= 0.9.37)
 
 BUNDLED WITH

data/README.md

@@ -27,7 +27,7 @@ Then, you can use [qbash][qbash] global function:
 
 ```ruby
 require 'qbash'
-stdout = qbash('echo "Hello, world!"')
+stdout = qbash('echo "Hello, world!"', log: $stdout)
 ```
 
 If the command fails, an exception will be raised.
@@ -38,13 +38,13 @@ It's possible to provide the standard input and environment variables:
 stdout = qbash('cat > $FILE', env: { 'FILE' => 'a.txt' }, stdin: 'Hello!')
 ```
 
-It's possible to configure the logging facility too, with the help
+It's possible to configure the logging facility too, for example, with the help
 of the [loog](https://github.com/yegor256/loog) gem (the output
 will be returned _and_ printed to the logger):
 
 ```ruby
 require 'loog'
-qbash('echo "Hello, world!"', loog: Loog::VERBOSE)
+qbash('echo "Hello, world!"', log: Loog::VERBOSE)
 ```
 
 You can also make it return both stdout and exit code, with the help
@@ -82,6 +82,14 @@ qbash("cat #{Shellwords.escape(file)}")
 Without such an escaping, in this example, a space inside the `file`
 will lead to an unpredicatable result of the execution.
 
+You can also set the maximum time for the command:
+
+```ruby
+qbash("sleep 100", timeout: 4)
+```
+
+This command will raise exception after four seconds.
+
 ## How to contribute
 
 Read

data/lib/qbash.rb

@@ -24,6 +24,7 @@ require 'backtrace'
 require 'loog'
 require 'open3'
 require 'shellwords'
+require 'tago'
 
 # Execute one bash command.
 #
@@ -37,14 +38,18 @@ module Kernel
   #
   # To escape arguments, use +Shellwords.escape()+ method.
   #
+  # Read this <a href="https://github.com/yegor256/qbash">README</a> file for more details.
+  #
   # @param [String] cmd The command to run, for example +echo "Hello, world!"+
   # @param [String] stdin The +stdin+ to provide to the command
   # @param [Hash] env Hash of environment variables
   # @param [Loog|IO] log Logging facility with +.debug()+ method (or +$stdout+)
   # @param [Array] accept List of accepted exit codes (accepts all if the list is empty)
   # @param [Boolean] both If set to TRUE, the function returns an array +(stdout, code)+
+  # @param [Integer] timeout If it's set to non-NIL, the execution will fail after this number of seconds
   # @return [String] Everything that was printed to the +stdout+ by the command
-  def qbash(cmd, stdin: '', env: {}, log: Loog::NULL, accept: [0], both: false)
+  def qbash(cmd, stdin: '', env: {}, log: Loog::NULL, accept: [0], both: false, timeout: nil)
+    cmd = cmd.join(' ') if cmd.is_a?(Array)
     if log.respond_to?(:debug)
       log.debug("+ #{cmd}")
     else
@@ -52,26 +57,32 @@ module Kernel
     end
     buf = ''
     e = 1
-    cmd = cmd.join(' ') if cmd.is_a?(Array)
-    Open3.popen2e(env, "/bin/bash -c #{Shellwords.escape(cmd)}") do |sin, sout, thr|
-      sin.write(stdin)
-      sin.close
-      until sout.eof?
-        begin
-          ln = sout.gets
-        rescue IOError => e
-          ln = Backtrace.new(e).to_s
+    start = Time.now
+    thread =
+      Thread.new do
+        Open3.popen2e(env, "/bin/bash -c #{Shellwords.escape(cmd)}") do |sin, sout, thr|
+          sin.write(stdin)
+          sin.close
+          until sout.eof?
+            begin
+              ln = sout.gets
+            rescue IOError => e
+              ln = Backtrace.new(e).to_s
+            end
+            if log.respond_to?(:debug)
+              log.debug(ln)
+            else
+              log.print("#{ln}\n")
+            end
+            buf += ln
+          end
+          e = thr.value.to_i
+          if !accept.empty? && !accept.include?(e)
+            raise "The command '#{cmd}' failed with exit code ##{e} in #{start.ago}\n#{buf}"
+          end
         end
-        if log.respond_to?(:debug)
-          log.debug(ln)
-        else
-          log.print("#{ln}\n")
-        end
-        buf += ln
       end
-      e = thr.value.to_i
-      raise "The command '#{cmd}' failed with exit code ##{e}\n#{buf}" if !accept.empty? && !accept.include?(e)
-    end
+    raise "Execution of #{cmd} timed out in #{start.ago}" if thread.join(timeout).nil?
     return [buf, e] if both
     buf
   end

data/qbash.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.2'
   s.name = 'qbash'
-  s.version = '0.0.3'
+  s.version = '0.0.5'
   s.license = 'MIT'
   s.summary = 'Quick Executor of a BASH Command'
   s.description =
@@ -42,5 +42,6 @@ Gem::Specification.new do |s|
   s.add_dependency 'backtrace', '>0'
   s.add_dependency 'elapsed', '>0'
   s.add_dependency 'loog', '>0'
+  s.add_dependency 'tago', '>0'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/test/test_qbash.rb

@@ -57,6 +57,12 @@ class TestQbash < Minitest::Test
     end
   end
 
+  def test_with_timeout
+    assert_raises do
+      qbash('sleep 100', timeout: 0.1)
+    end
+  end
+
   def test_with_special_symbols
     assert_equal("'hi'\n", qbash("echo \"'hi'\""))
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qbash
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-23 00:00:00.000000000 Z
+date: 2024-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -52,6 +52,20 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: tago
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
 description: With the help of Open3 executes bash command and conveniently returns
   its output and exit code
 email: yegor256@gmail.com