ezcapture 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c5f60156eb6c86308373d01e8eedae2b96e3a4418af394a8d75089b661f42f6e
+  data.tar.gz: b0be9f513422b2d8e734d84c38856bb1400ef5b287652a0ba384889bd4b2980c
+SHA512:
+  metadata.gz: 5cc37e48577657e15ff6fe2103dd1fb67adccf8fbe153e77dd0a3c3257faaa8ae6c77ca20668824af72f816a24da3791c4f71b5d31eb1a249973ea92d66a8bbe
+  data.tar.gz: 6508b7ec1070dbe99025b675faae4e2d73139adf1278c5c427bb60a9e8f2e905ee85b5380dff658133e787d1239848d582c7f84064e8616e2399162291e49086

data/README.md

@@ -0,0 +1,15 @@
+# EzCapture
+
+EzCapture provides a simple way to run a system process and capture the results.
+EzCapture is a thin layer over Open3.capture.
+
+## Author
+
+Mike O'Sullivan
+mike@idocs.com
+
+## History
+
+| version | date          | notes                         |
+|---------|---------------|-------------------------------|
+| 1.0     | June 24, 2023 | Initial upload.               |

data/lib/ezcapture.rb

@@ -0,0 +1,74 @@
+require 'open3'
+
+class EzCapture
+  # version
+  VERSION = '1.0'
+  
+  # The command sent to Open3.capture
+  # @!attribute [r] cmd
+  # @return [Array] individual strings in the command
+  attr_reader :cmd
+  
+  # Array returned by Open3.capture
+  # @return [Array]
+  attr_reader :results
+  
+  # Error object if command failed
+  # @return [Errno::ENOENT]
+  attr_reader :error
+  
+  # @param p_cmd [Array] one or more strings to send as a command
+  def initialize(*p_cmd)
+      super()
+      @results = nil
+      @error = nil
+      
+      # flatten command
+      @cmd = p_cmd.flatten.clone
+      
+      # attempt to run command
+      begin
+          @results = Open3.capture3(*cmd)
+      
+      # catch errors
+      rescue => e
+          @error = e
+      end
+  end
+  
+  # @return [String] STDOUT from the command
+  def stdout
+      if @results
+          return @results[0]
+      else
+          return nil
+      end
+  end
+  
+  # @return [String] STDERR from the command
+  def stderr
+      if @results
+          return @results[1]
+      else
+          return nil
+      end
+  end
+  
+  # @return [Process::Status] status of running the command
+  def status
+      if @results
+          return @results[2]
+      else
+          return nil
+      end
+  end
+  
+  # @return [Boolean] success or failure of the command
+  def success?
+      if status
+          return @results[2].success?
+      else
+          return false
+      end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: ezcapture
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Mike O'Sullivan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-06-24 00:00:00.000000000 Z
+dependencies: []
+description: Thin layer over Open3.capture
+email: mike@idocs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/ezcapture.rb
+homepage: https://github.com/mikosullivan/ezcapture
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.5
+signing_key: 
+specification_version: 4
+summary: EzCapture
+test_files: []