qbash 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fccb41b161a6c90a23d521fa77e25afa0524e90fe208e3438c9b4d5af83d6c78
-  data.tar.gz: 85260c4600d72f50d1c3fe38030ea9a939c62e335c5ca2851b25d9d5a2c68696
+  metadata.gz: 74362bdd955fbbdf87abf2855c79d2aeecab2578f8bbc5f5b35003b4935c4e17
+  data.tar.gz: 4153458c48d71d04d6d94fda9e589149e97519a9cded80ca1f1ad059ab06c75e
 SHA512:
-  metadata.gz: c709f5c9ca3b1683d11e9bbc019e84fbf4a9c782e043fe36f88b0467f3a63123713eea48a0d8bd2f24c3ebb9fbbb2edaf4c796b0dc73615ccea8e4f5bb248953
-  data.tar.gz: 2343e378d673146501843e35998b7e3efbd0ca8f32e3ee1e67b46dc96319d0f1e0fa23caf118da2e883135360b00a168ce7b4e5809bcd8e6c02726273ee87585
+  metadata.gz: 4c728817527bd343c532664a39f3ee8eb8be3ca172cbf974e9a7d410c0eb9fa34a11c264d53fe0d6daddf33d09aca96b9355d3985121a85bb18ca69cd1be5fae
+  data.tar.gz: f5a5a9edb0de50f1c598e626173e6d4252e8db06cfe256632eb5002ef0393c92c046080d64892a8758eb40e32972753b2c58a2af6dbbaf34623284057c9ed65a

data/Gemfile

@@ -31,7 +31,7 @@ gem 'rake', '13.2.1', require: false
 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.21.1', require: false
+gem 'rubocop-performance', '1.22.1', require: false
 gem 'rubocop-rspec', '3.0.5', require: false
 gem 'simplecov', '0.22.0', require: false
 gem 'simplecov-cobertura', '2.1.0', require: false

data/Gemfile.lock

@@ -196,7 +196,7 @@ GEM
       unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.32.3)
       parser (>= 3.3.1.0)
-    rubocop-performance (1.21.1)
+    rubocop-performance (1.22.1)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.31.1, < 2.0)
     rubocop-rspec (3.0.5)
@@ -252,7 +252,7 @@ DEPENDENCIES
   random-port (~> 0.0)
   rspec-rails (= 7.0.1)
   rubocop (= 1.66.1)
-  rubocop-performance (= 1.21.1)
+  rubocop-performance (= 1.22.1)
   rubocop-rspec (= 3.0.5)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)

data/README.md

@@ -35,6 +35,23 @@ stdout = qbash('cat > $FILE', env: { 'FILE' => 'a.txt' }, stdin: 'Hello!')
 It's possible to configure the logging facility too, with the help
 of the [loog](https://github.com/yegor256/loog) gem.
 
+You can also make it return both stdout and exit code, with the help
+of the `both` option set to `true`:
+
+```ruby
+stdout, code = qbash('cat a.txt', both: true, accept: [])
+```
+
+Here, the `accept` param contains the list of exit codes that are "acceptable"
+and won't lead to runtime failures. When the list is empty, all exists are
+acceptable (there will be no failures ever).
+
+The command may be provided as an array, which automatically will be
+converted to a string by joining all items with spaces between them.
+
+It is very much recommended to escape all command-line values with the help
+of [Shellwords.escape][shellwords].
+
 ## How to contribute
 
 Read
@@ -50,3 +67,5 @@ bundle exec rake
 ```
 
 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

data/lib/qbash.rb

@@ -20,9 +20,10 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-require 'open3'
-require 'loog'
 require 'backtrace'
+require 'loog'
+require 'open3'
+require 'shellwords'
 
 # Execute one bash command.
 #

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.1'
+  s.version = '0.0.2'
   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.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-16 00:00:00.000000000 Z
+date: 2024-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace