rubyshell 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e1bbca227330e09a8b8421875dc96c6049c23a1046d87a1a2c754569aaf7216
-  data.tar.gz: 6c4ee7e7b32ee568415ee62301029f407eeccb549265d3980fd961e6876860a8
+  metadata.gz: f21be5da171237ec3217b6dde48055661f29a83dea187022b31fa412412d4057
+  data.tar.gz: d4a738f0169a395ed449407eb95a0e78df9d6b827472030977db728900ac055d
 SHA512:
-  metadata.gz: 842cb4f6b522f1f91ec7e399f2378f0da3c44a362b41336a26c216dfbe706f4b7815bcabdb82e2ba60bc4a867fce90ad6dc0d407daa3b69088ee759c76276f7b
-  data.tar.gz: ab43aa943d08855ab501ed9c61f7114d427516aeb36db2d10236a05b7c45d4f54c64e58c3751a3eea97b5d8b3f67c736323d7f8c5e60c34c9fce9f24c8a8254b
+  metadata.gz: afe062bedbf8e8f1064aa662c8925364da817279fb83d9a2af74ea552cd146aa63d17fda67b7c16e608a3f0b386d5d0bc1cdcb6365398cc3e726f6255ff33de7
+  data.tar.gz: 369ac530ad58e8ed4489ca17536dcf9786491b8a641e04a24c565f8182b6d10b9e043d5714d50969bcd438a8d13e8388ba3a11b0628891d51aff5c01a80014ec

data/README.md

@@ -65,6 +65,15 @@ sh do
 end
 ```
 
+### Using without the block
+If you want to start an irb or pry session, and run commands as first-class citizens then do the following.
+
+```ruby
+extend RubyShell::Executor
+
+pwd # => /Users/albertalef/projects/rubyshell
+```
+
 ### Passing arguments
 Here we have different ways to pass arguments to a command.
 You can separate strings, use only one, use hashes, anyway will work
@@ -124,6 +133,17 @@ sh do
 end
 ```
 
+### Executing without a block
+The `sh` method can receive any method call, and execute shell commands
+
+```ruby
+sh.puts pwd # => /Users/albertalef/projects/rubyshell
+
+sh.cd 'examples'
+
+puts sh.pwd  # => /Users/albertalef/projects/rubyshell/examples
+```
+
 ## Complete example
 
 ```ruby

data/exe/rubyshell

@@ -4,4 +4,5 @@
 require "rubyshell"
 
 require "irb"
+
 IRB.start(__FILE__)

data/lib/rubyshell/chainer.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "open3"
+
 module RubyShell
   class Chainer
     attr_reader :parts
@@ -31,7 +33,13 @@ module RubyShell
     end
 
     def exec_commands
-      `#{to_shell}`.chomp
+      Open3.capture3(to_shell).then do |stdout, stderr, status|
+        unless status.success?
+          raise RubyShell::CommandError.new(command: to_shell, stdout: stdout, stderr: stderr, status: status)
+        end
+
+        stdout.chomp
+      end
     end
 
     def to_shell

data/lib/rubyshell/command.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "open3"
+
 module RubyShell
   class Command
     def initialize(command_name, *args, &block)
@@ -13,11 +15,15 @@ module RubyShell
     end
 
     def exec_command
-      result = `#{to_shell}`.chomp
-
-      raise "Command Failed" unless $?.success?
+      Open3.capture3(to_shell).then do |stdout, stderr, status|
+        unless status.success?
+          raise RubyShell::CommandError.new(command: to_shell, stdout: stdout, stderr: stderr, status: status)
+        end
 
-      result
+        stdout.chomp
+      end
+    rescue StandardError
+      raise RubyShell::CommandError.new(command: to_shell)
     end
 
     def parsed_args
@@ -43,8 +49,19 @@ module RubyShell
                 "--#{k}"
               end
 
-        [key, v.is_a?(TrueClass) ? nil : v].compact.join(" ")
+        [key, v.is_a?(TrueClass) ? nil : "'#{v}'"].compact.join(" ")
       end.compact
     end
   end
+
+  class CommandError < StandardError
+    def initialize(command:, stdout: "", stderr: "", status: "")
+      @command = command
+      @stdout = stdout
+      @stderr = stderr
+      @status = status
+
+      super
+    end
+  end
 end

data/lib/rubyshell/executor.rb

@@ -1,24 +1,22 @@
 # frozen_string_literal: true
 
 module RubyShell
-  class Executor
-    def self.cd(path, &block)
+  module Executor
+    module_function
+
+    def cd(path, &block)
       Dir.chdir(path, &block)
     end
 
-    def self.chain(&block)
-      result = RubyShell::ChainContext.class_eval(&block).exec_commands
-
-      raise "Command Failed" unless $?.success?
-
-      result
+    def chain(&block)
+      RubyShell::ChainContext.class_eval(&block).exec_commands
     end
 
-    def self.method_missing(method_name, *args)
+    def method_missing(method_name, *args)
       RubyShell::Command.new(method_name, *args).exec_command
     end
 
-    def self.respond_to_missing?(_name, _include_private)
+    def respond_to_missing?(_name, _include_private)
       false
     end
   end

data/lib/rubyshell/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyShell
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubyshell
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - albertalef
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-01-18 00:00:00.000000000 Z
 dependencies: []
 description: A rubist way to run shell commands
 email:
@@ -36,6 +37,7 @@ metadata:
   source_code_uri: https://github.com/albertalef/rubyshell
   changelog_uri: https://github.com/albertalef/rubyshell
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -50,7 +52,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: A rubist way to run shell commands
 test_files: []