qbash 0.3.2 → 0.4.1

data/Gemfile.lock

@@ -10,50 +10,16 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (8.0.1)
-      actionview (= 8.0.1)
-      activesupport (= 8.0.1)
-      nokogiri (>= 1.8.5)
-      rack (>= 2.2.4)
-      rack-session (>= 1.0.1)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.2)
-      rails-html-sanitizer (~> 1.6)
-      useragent (~> 0.16)
-    actionview (8.0.1)
-      activesupport (= 8.0.1)
-      builder (~> 3.1)
-      erubi (~> 1.11)
-      rails-dom-testing (~> 2.2)
-      rails-html-sanitizer (~> 1.6)
-    activesupport (8.0.1)
-      base64
-      benchmark (>= 0.3)
-      bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.3.1)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      logger (>= 1.4.2)
-      minitest (>= 5.1)
-      securerandom (>= 0.3)
-      tzinfo (~> 2.0, >= 2.0.5)
-      uri (>= 0.13.1)
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ansi (1.5.0)
-    ast (2.4.2)
+    ast (2.4.3)
     backtrace (0.4.0)
-    base64 (0.2.0)
-    benchmark (0.4.0)
     bigdecimal (3.1.9)
     builder (3.3.0)
-    concurrent-ruby (1.3.5)
-    connection_pool (2.5.0)
     crack (1.0.0)
       bigdecimal
       rexml
-    crass (1.0.6)
     cucumber (9.2.1)
       builder (~> 3.2)
       cucumber-ci-environment (> 9, < 11)
@@ -79,39 +45,28 @@ GEM
       cucumber-messages (> 19, < 28)
     cucumber-messages (22.0.0)
     cucumber-tag-expressions (6.1.2)
-    date (3.4.1)
-    diff-lcs (1.5.1)
+    diff-lcs (1.6.1)
     docile (1.4.1)
-    drb (2.2.1)
     elapsed (0.0.1)
       loog (> 0)
       tago (> 0)
-    erubi (1.13.1)
-    ffi (1.17.1-aarch64-linux-gnu)
-    ffi (1.17.1-arm-linux-gnu)
-    ffi (1.17.1-arm64-darwin)
-    ffi (1.17.1-x64-mingw-ucrt)
-    ffi (1.17.1-x86-linux-gnu)
-    ffi (1.17.1-x86_64-darwin)
-    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.2-aarch64-linux-gnu)
+    ffi (1.17.2-arm-linux-gnu)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x64-mingw-ucrt)
+    ffi (1.17.2-x86-linux-gnu)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
     hashdiff (1.1.2)
-    i18n (1.14.7)
-      concurrent-ruby (~> 1.0)
-    io-console (0.8.0)
-    irb (1.15.1)
-      pp (>= 0.6.0)
-      rdoc (>= 4.0.0)
-      reline (>= 0.4.2)
-    json (2.9.1)
+    json (2.11.3)
     language_server-protocol (3.17.0.4)
-    logger (1.6.5)
-    loofah (2.24.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.12.0)
-    loog (0.6.0)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    loog (0.6.1)
+      logger (~> 1.0)
     mini_mime (1.1.5)
     mini_portile2 (2.8.8)
-    minitest (5.25.4)
+    minitest (5.25.5)
     minitest-reporters (1.7.1)
       ansi
       builder
@@ -119,107 +74,60 @@ GEM
       ruby-progressbar
     multi_test (1.1.0)
     net-ping (2.0.8)
-    nokogiri (1.18.2)
+    nokogiri (1.18.8)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.18.2-aarch64-linux-gnu)
+    nokogiri (1.18.8-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.2-arm-linux-gnu)
+    nokogiri (1.18.8-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.2-arm64-darwin)
+    nokogiri (1.18.8-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.2-x64-mingw-ucrt)
+    nokogiri (1.18.8-x64-mingw-ucrt)
       racc (~> 1.4)
-    nokogiri (1.18.2-x86_64-darwin)
+    nokogiri (1.18.8-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.2-x86_64-linux-gnu)
+    nokogiri (1.18.8-x86_64-linux-gnu)
       racc (~> 1.4)
-    parallel (1.26.3)
-    parser (3.3.7.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
-    pp (0.6.2)
-      prettyprint
-    prettyprint (0.2.0)
-    psych (5.2.3)
-      date
-      stringio
-    public_suffix (6.0.1)
+    prism (1.4.0)
+    public_suffix (6.0.2)
     racc (1.8.1)
-    rack (3.1.9)
-    rack-session (2.1.0)
-      base64 (>= 0.1.0)
-      rack (>= 3.0.0)
-    rack-test (2.2.0)
-      rack (>= 1.3)
-    rackup (2.2.1)
-      rack (>= 3)
-    rails-dom-testing (2.2.0)
-      activesupport (>= 5.0.0)
-      minitest
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.6.2)
-      loofah (~> 2.21)
-      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
-    railties (8.0.1)
-      actionpack (= 8.0.1)
-      activesupport (= 8.0.1)
-      irb (~> 1.13)
-      rackup (>= 1.0.0)
-      rake (>= 12.2)
-      thor (~> 1.0, >= 1.2.2)
-      zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.2.1)
     random-port (0.7.5)
       tago (> 0)
-    rdoc (6.11.0)
-      psych (>= 4.0.0)
     regexp_parser (2.10.0)
-    reline (0.6.0)
-      io-console (~> 0.5)
-    rexml (3.4.0)
-    rspec-core (3.13.2)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.3)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-rails (7.1.0)
-      actionpack (>= 7.0)
-      activesupport (>= 7.0)
-      railties (>= 7.0)
-      rspec-core (~> 3.13)
-      rspec-expectations (~> 3.13)
-      rspec-mocks (~> 3.13)
-      rspec-support (~> 3.13)
-    rspec-support (3.13.2)
-    rubocop (1.71.2)
+    rexml (3.4.1)
+    rubocop (1.75.5)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.38.0)
-      parser (>= 3.3.1.0)
-    rubocop-minitest (0.36.0)
-      rubocop (>= 1.61, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-performance (1.23.1)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (3.4.0)
-      rubocop (~> 1.61)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-minitest (0.38.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
     ruby-progressbar (1.13.0)
-    securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
@@ -229,28 +137,21 @@ GEM
       simplecov (~> 0.19)
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
-    stringio (3.1.2)
     sys-uname (1.3.1)
       ffi (~> 1.1)
-    tago (0.0.2)
-    thor (1.3.2)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
+    tago (0.1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    uri (1.0.2)
-    useragent (0.16.11)
     w3c_validators (1.3.7)
       json (>= 1.8)
       nokogiri (~> 1.6)
       rexml (~> 3.2)
-    webmock (3.24.0)
+    webmock (3.25.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
     yard (0.9.37)
-    zeitwerk (2.7.1)
 
 PLATFORMS
   aarch64-linux
@@ -263,24 +164,22 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  cucumber (= 9.2.1)
-  minitest (= 5.25.4)
-  minitest-reporters (= 1.7.1)
-  net-ping (= 2.0.8)
+  cucumber (~> 9.2)
+  minitest (~> 5.25)
+  minitest-reporters (~> 1.7)
+  net-ping (~> 2.0)
   qbash!
-  rake (= 13.2.1)
+  rake (~> 13.2)
   random-port (~> 0.0)
-  rspec-rails (= 7.1.0)
-  rubocop (= 1.71.2)
-  rubocop-minitest (= 0.36.0)
-  rubocop-performance (= 1.23.1)
-  rubocop-rake (= 0.6.0)
-  rubocop-rspec (= 3.4.0)
-  simplecov (= 0.22.0)
-  simplecov-cobertura (= 2.1.0)
-  w3c_validators (= 1.3.7)
-  webmock (= 3.24.0)
-  yard (= 0.9.37)
+  rubocop (~> 1.73)
+  rubocop-minitest (> 0)
+  rubocop-performance (> 0)
+  rubocop-rake (> 0)
+  simplecov (~> 0.22)
+  simplecov-cobertura (~> 2.1)
+  w3c_validators (~> 1.3)
+  webmock (~> 3.25)
+  yard (~> 0.9)
 
 BUNDLED WITH
    2.5.16

data/LICENSES/MIT.txt

@@ -0,0 +1,21 @@
+(The MIT License)
+
+Copyright (c) 2024-2025 Yegor Bugayenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the 'Software'), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,18 +1,18 @@
 # Quick and Simple Executor of Bash Commands
 
-[![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/qbash)](http://www.rultor.com/p/yegor256/qbash)
+[![DevOps By Rultor.com](https://www.rultor.com/b/yegor256/qbash)](https://www.rultor.com/p/yegor256/qbash)
 [![We recommend RubyMine](https://www.elegantobjects.org/rubymine.svg)](https://www.jetbrains.com/ruby/)
 
 [![rake](https://github.com/yegor256/qbash/actions/workflows/rake.yml/badge.svg)](https://github.com/yegor256/qbash/actions/workflows/rake.yml)
-[![PDD status](http://www.0pdd.com/svg?name=yegor256/qbash)](http://www.0pdd.com/p?name=yegor256/qbash)
-[![Gem Version](https://badge.fury.io/rb/qbash.svg)](http://badge.fury.io/rb/qbash)
+[![PDD status](https://www.0pdd.com/svg?name=yegor256/qbash)](https://www.0pdd.com/p?name=yegor256/qbash)
+[![Gem Version](https://badge.fury.io/rb/qbash.svg)](https://badge.fury.io/rb/qbash)
 [![Test Coverage](https://img.shields.io/codecov/c/github/yegor256/qbash.svg)](https://codecov.io/github/yegor256/qbash?branch=master)
-[![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/yegor256/qbash/master/frames)
+[![Yard Docs](https://img.shields.io/badge/yard-docs-blue.svg)](https://rubydoc.info/github/yegor256/qbash/master/frames)
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/qbash)](https://hitsofcode.com/view/github/yegor256/qbash)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/qbash/blob/master/LICENSE.txt)
 
 How do you execute a new shell command from Ruby?
-There are [many ways](https://stackoverflow.com/questions/2232).
+There are [many ways][so-question].
 None of them offers a one-liner that would execute a command, print
 its output to the console or a logger, and then raise an exception if
 the exit code is not zero. This small gem offers exactly this one-liner.
@@ -67,13 +67,23 @@ converted to a string by joining all items with spaces between them.
 ```ruby
 qbash(
   [
-    'echo "Hello, world!"'
+    'echo "Hello, world!"',
     '&& echo "How are you?"',
     '&& cat /etc/passwd'
   ]
 )
 ```
 
+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:
 
@@ -83,10 +93,10 @@ 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.
+will lead to an unpredictable 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'
@@ -102,7 +112,7 @@ of waiting for the `sleep` to finish.
 
 Read
 [these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
-Make sure you build is green before you contribute
+Make sure your build is green before you contribute
 your pull request. You will need to have
 [Ruby](https://www.ruby-lang.org/en/) 3.0+ and
 [Bundler](https://bundler.io/) installed. Then:
@@ -116,3 +126,6 @@ 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
+[so-question]: https://stackoverflow.com/questions/2232/

data/REUSE.toml

@@ -0,0 +1,34 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+version = 1
+[[annotations]]
+path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".pdd",
+    "**.json",
+    "**.md",
+    "**.txt",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.pdd",
+    "**/*.csv",
+    "**/*.jpg",
+    "**/*.json",
+    "**/*.md",
+    "**/*.pdf",
+    "**/*.png",
+    "**/*.svg",
+    "**/*.txt",
+    "**/*.vm",
+    "**/CNAME",
+    "**/Gemfile.lock",
+    "Gemfile.lock",
+    "README.md",
+    "renovate.json",
+]
+precedence = "override"
+SPDX-FileCopyrightText = "Copyright (c) 2025 Yegor Bugayenko"
+SPDX-License-Identifier = "MIT"

data/Rakefile

@@ -1,28 +1,10 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2024-2025 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'rubygems'
 require 'rake'
-require 'rdoc'
 require 'rake/clean'
 
 def name
@@ -57,5 +39,4 @@ require 'rubocop/rake_task'
 desc 'Run RuboCop on all directories'
 RuboCop::RakeTask.new(:rubocop) do |task|
   task.fail_on_error = true
-  task.requires << 'rubocop-rspec'
 end

data/lib/qbash.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2024-2025 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'backtrace'
 require 'logger'
@@ -33,25 +16,64 @@ require 'tago'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 module Kernel
-  # Execute a single bash command.
+  # Execute a single bash command safely with proper error handling.
+  #
+  # QBash provides a safe way to execute shell commands with proper error handling,
+  # logging, and stdin/stdout management. It's designed to be simple for basic use
+  # cases while offering powerful options for advanced scenarios.
+  #
+  # == Basic Usage
+  #
+  #   # Execute a command and get its output
+  #   year = qbash('date +%Y')
+  #   puts "Current year: #{year}"
+  #
+  #   # Execute a command that might fail
+  #   files = qbash('find /tmp -name "*.log"')
+  #
+  # == Working with Exit Codes
   #
-  # For example:
+  #   # Get both output and exit code
+  #   output, code = qbash('grep "error" /var/log/system.log', both: true)
+  #   puts "Command succeeded" if code.zero?
   #
-  #  year = qbash('date +%Y')
+  #   # Accept multiple exit codes as valid
+  #   result = qbash('grep "pattern" file.txt', accept: [0, 1])
   #
-  # If exit code is not zero, an exception will be raised.
+  # == Providing Input via STDIN
   #
-  # To escape arguments, use +Shellwords.escape()+ method.
+  #   # Pass data to command's stdin
+  #   result = qbash('wc -l', stdin: "line 1\nline 2\nline 3")
   #
-  # Stderr automatically merges with stdout.
+  # == Environment Variables
   #
-  # If you need full control over the process started, provide
-  # a block, which will receive process ID (integer) once the process
-  # is started.
+  #   # Set environment variables for the command
+  #   output = qbash('echo $NAME', env: { 'NAME' => 'Ruby' })
+  #
+  # == Logging
+  #
+  #   # Enable detailed logging to stdout
+  #   qbash('ls -la', log: $stdout)
+  #
+  #   # Use custom logger with specific level
+  #   logger = Logger.new($stdout)
+  #   qbash('make all', log: logger, level: Logger::INFO)
+  #
+  # == Process Control
+  #
+  #   # Get control over long-running process
+  #   qbash('sleep 30') do |pid|
+  #     puts "Process #{pid} is running..."
+  #     # Do something while process is running
+  #     # Process will be terminated when block exits
+  #   end
+  #
+  # For command with multiple arguments, you can use +Shellwords.escape()+ to
+  # properly escape each argument. Stderr automatically merges with stdout.
   #
   # 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, Array] cmd The command to run (String or Array of arguments)
   # @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+, or nil if should go to +/dev/null+)
@@ -85,29 +107,41 @@ module Kernel
     buf = ''
     e = 1
     start = Time.now
-    Open3.popen2e(env, "/bin/bash -c #{Shellwords.escape(cmd)}") do |sin, sout, thr|
+    Open3.popen2e(env, "/bin/bash -c #{Shellwords.escape(cmd)}") do |sin, sout, ctrl|
       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
-            end
-            ln = "##{thr.pid}: #{ln}"
-            if log.nil?
-              # no logging
-            elsif log.respond_to?(mtd)
-              log.__send__(mtd, ln)
-            else
-              log.print(ln)
+        closed = false
+        watch =
+          Thread.new do
+            until closed
+              begin
+                ln = sout.gets
+              rescue IOError => e
+                ln = Backtrace.new(e).to_s
+              end
+              next if ln.nil?
+              next if ln.empty?
+              ln = "##{ctrl.pid}: #{ln}"
+              if log.nil?
+                # no logging
+              elsif log.respond_to?(mtd)
+                log.__send__(mtd, ln)
+              else
+                log.print(ln)
+              end
+              buf += ln
             end
-            buf += ln
           end
+        pid = ctrl.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
@@ -124,7 +158,7 @@ module Kernel
           end
           buf += ln
         end
-        e = thr.value.to_i
+        e = ctrl.value.to_i
         if !accept.nil? && !accept.include?(e)
           raise "The command '#{cmd}' failed with exit code ##{e} in #{start.ago}\n#{buf}"
         end