qbash 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99ee7da1c86261e9e775fcf93c0d13de3393d9a861b3e30598b23509e97e80f6
-  data.tar.gz: 7e6cfe10c543dccf59e2b1aa7d36890a539d2cb72c00d041c949611d2a2344dd
+  metadata.gz: 0b0f67b4e45883bc237c70115187e6ab211f6fdd29da3f9f891720153ad26569
+  data.tar.gz: a12f5e499c7f756d71c59b52467454346c455e72d291d2bae7891f05c7e8610b
 SHA512:
-  metadata.gz: b8a978fd448871257f511cd0dfd14459e1da2837a948033069a4bd11b029f5fb9501eff131adea19000005057f5474ecc8264cfa8ce2e6cb3aa5eaddcda6b2ea
-  data.tar.gz: 7ea6c3330923bccbadbdeae609730573e20022fdc3a888bcd8095c40c11ae583819080c6c11778a513eb4c6c51f73474434d5a7ce66836cb85826d257510cc1b
+  metadata.gz: eb17f8adf645e156986fcf7d08b27ee3b049fa29910b1f7b9154c51339530481167419d2a68af21b9dafae51613f81971b3e6e30f5eb175416ddafb82c87ea6b
+  data.tar.gz: 55c6932d3ff9a02474c33d69b3fa05f0b3ae83bf36a911468c155ef3944b603a9dceb29b13ba04eea3e9f3bd8748e90101952b0586d0e82001229a398d80c555

data/.rubocop.yml

@@ -31,7 +31,6 @@ require:
   - rubocop-minitest
   - rubocop-performance
   - rubocop-rake
-
 Minitest/EmptyLineBeforeAssertionMethods:
   Enabled: false
 Metrics/ParameterLists:

data/Gemfile

@@ -29,7 +29,7 @@ gem 'minitest-reporters', '1.7.1', require: false
 gem 'net-ping', '2.0.8', require: false
 gem 'rake', '13.2.1', require: false
 gem 'random-port', '~>0.0', require: false
-gem 'rspec-rails', '7.1.0', require: false
+gem 'rspec-rails', '7.1.1', require: false
 gem 'rubocop', '1.71.2', require: false
 gem 'rubocop-minitest', '0.36.0', require: false
 gem 'rubocop-performance', '1.23.1', require: false
@@ -38,5 +38,5 @@ gem 'rubocop-rspec', '3.4.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.24.0', require: false
+gem 'webmock', '3.25.0', require: false
 gem 'yard', '0.9.37', require: false

data/Gemfile.lock

@@ -179,7 +179,7 @@ GEM
     reline (0.6.0)
       io-console (~> 0.5)
     rexml (3.4.0)
-    rspec-core (3.13.2)
+    rspec-core (3.13.3)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
@@ -187,7 +187,7 @@ GEM
     rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-rails (7.1.0)
+    rspec-rails (7.1.1)
       actionpack (>= 7.0)
       activesupport (>= 7.0)
       railties (>= 7.0)
@@ -245,7 +245,7 @@ GEM
       json (>= 1.8)
       nokogiri (~> 1.6)
       rexml (~> 3.2)
-    webmock (3.24.0)
+    webmock (3.25.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -270,7 +270,7 @@ DEPENDENCIES
   qbash!
   rake (= 13.2.1)
   random-port (~> 0.0)
-  rspec-rails (= 7.1.0)
+  rspec-rails (= 7.1.1)
   rubocop (= 1.71.2)
   rubocop-minitest (= 0.36.0)
   rubocop-performance (= 1.23.1)
@@ -279,7 +279,7 @@ DEPENDENCIES
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
   w3c_validators (= 1.3.7)
-  webmock (= 3.24.0)
+  webmock (= 3.25.0)
   yard (= 0.9.37)
 
 BUNDLED WITH

data/README.md

@@ -74,6 +74,16 @@ qbash(
 )
 ```
 
+If a block is given to `qbash`, it will run the command in background mode,
+waiting for the block to finish. Once it's finished, the command will be
+terminated via the `TERM` [signal]:
+
+```ruby
+qbash('sleep 9999') do |pid|
+  # do something
+end
+```
+
 It is very much recommended to escape all command-line values with the help
 of the [Shellwords.escape()][shellwords] utility method, for example:
 
@@ -86,7 +96,7 @@ Without such an escaping, in this example, a space inside the `file`
 will lead to an unpredicatable result of the execution.
 
 If you want to stop sooner than the command finishes, use
-[`timeout`](https://github.com/ruby/timeout) gem:
+[timeout] gem:
 
 ```ruby
 require 'timeout'
@@ -116,3 +126,5 @@ If it's clean and you don't see any error messages, submit your pull request.
 
 [shellwords]: https://ruby-doc.org/stdlib-3.0.1/libdoc/shellwords/rdoc/Shellwords.html
 [qbash]: https://rubydoc.info/github/yegor256/qbash/master/Kernel#qbash-instance_method
+[signal]: https://en.wikipedia.org/wiki/Signal_(IPC)
+[timeout]: https://github.com/ruby/timeout

data/lib/qbash.rb

@@ -89,25 +89,35 @@ module Kernel
       sin.write(stdin)
       sin.close
       if block_given?
-        Thread.new do
-          until sout.closed?
-            begin
-              ln = sout.gets
-            rescue IOError => e
-              ln = Backtrace.new(e).to_s
+        closed = false
+        watch =
+          Thread.new do
+            until closed
+              begin
+                ln = sout.gets
+              rescue IOError => e
+                ln = Backtrace.new(e).to_s
+              end
+              ln = "##{thr.pid}: #{ln}"
+              if log.nil?
+                # no logging
+              elsif log.respond_to?(mtd)
+                log.__send__(mtd, ln)
+              else
+                log.print(ln)
+              end
+              buf += ln
             end
-            ln = "##{thr.pid}: #{ln}"
-            if log.nil?
-              # no logging
-            elsif log.respond_to?(mtd)
-              log.__send__(mtd, ln)
-            else
-              log.print(ln)
-            end
-            buf += ln
           end
+        pid = thr.pid
+        yield pid
+        begin
+          Process.kill('TERM', pid)
+        rescue Errno::ESRCH
+          # simply ignore it
         end
-        yield thr.pid
+        closed = true
+        watch.join
       else
         until sout.eof?
           begin

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.3.2'
+  s.version = '0.4.0'
   s.license = 'MIT'
   s.summary = 'Quick Executor of a BASH Command'
   s.description =

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qbash
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-04 00:00:00.000000000 Z
+date: 2025-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace