rubyshell 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d144b65a358ed5bfc9fbb6a7c4e1f1dcc6ad90516f98a8787a07ab84a81943a7
-  data.tar.gz: 06f5260717bc2e232d0d82e231eee1ddf8aa33bd5f640d1de48f52649f2862be
+  metadata.gz: f21be5da171237ec3217b6dde48055661f29a83dea187022b31fa412412d4057
+  data.tar.gz: d4a738f0169a395ed449407eb95a0e78df9d6b827472030977db728900ac055d
 SHA512:
-  metadata.gz: 82ffc3ad85d2412d885bfb59fec0835964d1ff8b1d1bb2796d3c0a98d5421c8a8eb62ad7e6d19240b3d10446e72b3cbc72f4ed0ebef461f82a292037490f812b
-  data.tar.gz: 23d6b6f996ce1867dcbc6cb5e1714eb51d4ff49c5f84d0a629cfec01384c911c5c61d6f1e0e3510ba65497911685cee285ee5dc467865c62c46d95b2be3bd15e
+  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/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
@@ -47,4 +53,15 @@ module RubyShell
       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.1"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubyshell
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  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: []