computer 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 23ede6f396272db6056b8c8797f1f5efa0b9829a
-  data.tar.gz: 2a251db14f1dba7f5d930b07f9b8f1bed4b3e134
+  metadata.gz: 5607ed6cb5688ad020b7c5f3908e12f88a828084
+  data.tar.gz: 2746b122b2e927f729b26d28af7b27bc7729a13b
 SHA512:
-  metadata.gz: 634fd8cfc53d7e64f9a65d4290fdbcd9838442764906ee7206f500d92a7a3e8c823d2ade0cfaa8ec2065cec8f48bf43492377b75f11f99565825acbf2fd8169a
-  data.tar.gz: 6aac2b5f87a69362d4e2b43331686f931ada4c012eacc63f7766946b23e05e1368b8ab4a195a17ba9179ea5e1a43f8f387d33c8adf25b7866f1346767eac3bd9
+  metadata.gz: 53be4c3d03aaf38bda90fbb482c4862be247e037503a3ef35e72ed8b767d43de52cd605831fb161a8374d22eaa41c66057814a99142aa7f0ab2ed470d46191b1
+  data.tar.gz: 8ea309ab1de096aafb509f6722031dd87172f572ba491cf64f7424cb99e08dc6abf33f27e8366fced3a18271a6e71347631dda408a7f06c00e351a3521c0ea97

data/CHANGELOG.md

@@ -1,4 +1,4 @@
-### 0.0.1 / 2020-10-20
+### 0.0.1 / 2020-10-19
 
 * Everything is new. First release.
 

data/Manifest.txt

@@ -3,3 +3,7 @@ Manifest.txt
 README.md
 Rakefile
 lib/computer.rb
+lib/computer/shell.rb
+lib/computer/version.rb
+test/helper.rb
+test/test_shell.rb

data/README.md

@@ -1,11 +1,11 @@
 # computer
 
-computer gem - command line helpers / wrappers
+computer gem  -  shell command line helper / wrapper 'n' more for your computer
 
 * home  :: [github.com/rubycoco/git](https://github.com/rubycoco/git)
 * bugs  :: [github.com/rubycoco/git/issues](https://github.com/rubycoco/git/issues)
-* gem   :: [rubygems.org/gems/yorobot](https://rubygems.org/gems/yorobot)
-* rdoc  :: [rubydoc.info/gems/yorobot](http://rubydoc.info/gems/yorobot)
+* gem   :: [rubygems.org/gems/computer](https://rubygems.org/gems/computer)
+* rdoc  :: [rubydoc.info/gems/computer](http://rubydoc.info/gems/computer)
 
 
 

data/Rakefile

@@ -1,11 +1,11 @@
 require 'hoe'
-require './lib/computer.rb'
+require './lib/computer/version.rb'
 
 Hoe.spec 'computer' do
 
   self.version = Computer::VERSION
 
-  self.summary = "computer gem - command line helpers / wrappers"
+  self.summary = "computer gem  -  shell command line helper / wrapper 'n' more for your computer"
   self.description = summary
 
   self.urls    = { home: 'https://github.com/rubycoco/git' }

data/lib/computer.rb

@@ -1,4 +1,30 @@
-module Computer
-  VERSION = '0.0.1'
-end
+require 'pp'
+require 'time'
+require 'date'    ## e.g. Date.today etc.
+require 'yaml'
+require 'json'
+require 'uri'
+require 'net/http'
+require "net/https"
+require 'open3'
+require 'fileutils'    ## e.g. FileUtils.mkdir_p etc.
 
+##########################
+# more defaults ("prolog/prelude") always pre-loaded
+require 'optparse'
+
+
+#####################
+# our own code
+require 'computer/version'   # note: let version always go first
+require 'computer/shell'
+
+
+
+######################
+# add convenience shortcuts - why? why not?
+Compu = Computer
+
+
+# say hello
+puts Computer.banner

data/lib/computer/shell.rb

@@ -0,0 +1,57 @@
+module Computer
+
+
+## raised / thrown by Shell.run if exit status non-zero
+##   todo/check: (re)use an already existing error - why? why not?
+class ShellError < StandardError
+end
+
+
+###
+#  use nested class for "base" for running commands - why? why not?
+class Shell
+
+  ## use call for the "to-the-metal" command execution
+  def self.call( cmd )
+    stdout, stderr, status = Open3.capture3( cmd )
+    [stdout, stderr, status]
+  end
+
+
+  ## use run for "porcelain / high-level" command execution
+  def self.run( cmd )
+    ## add pwd (print working directory to output?) - why? why not?
+    print "---> (shell run) >#{cmd}<..."
+    stdout, stderr, status = Open3.capture3( cmd )
+
+    ## todo: add colors (red, green) - why? why not?
+    if status.success?
+      print " OK"   ## todo/check: use OK (0) - why? why not?
+      print "\n"
+    else
+      print " FAIL (#{status.exitstatus})"
+      print "\n"
+    end
+
+    unless stdout.empty?
+      puts stdout
+    end
+
+    unless stderr.empty?
+      ## todo/check: or use >2: or &2: or such
+      ##  stderr output not always an error (that is, exit status might be 0)
+      STDERR.puts "2>"
+      STDERR.puts stderr
+    end
+
+    if status.success?
+      stdout   # return stdout string
+    else
+      STDERR.puts "!! ERROR: Shell.run >#{cmd}< failed with exit status #{status.exitstatus}:"
+      STDERR.puts stderr
+
+      raise ShellError, "Shell.run >#{cmd}< failed with exit status #{status.exitstatus}<: #{stderr}"
+    end
+  end
+  end # class Shell
+end  # module Computer

data/lib/computer/version.rb

@@ -0,0 +1,21 @@
+module Computer
+
+  MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+  MINOR = 1
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "computer/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module Computer
+

data/test/helper.rb

@@ -0,0 +1,9 @@
+## minitest setup
+require 'minitest/autorun'
+
+
+## our own code
+require 'computer'
+
+
+

data/test/test_shell.rb

@@ -0,0 +1,33 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_shell.rb
+
+require 'helper'
+
+class TestShell < MiniTest::Test
+
+  Shell = Computer::Shell
+
+  def test_run
+    Shell.run( 'git config user.name' )
+    Shell.run( 'git config --show-origin user.name' )
+    # Shell.run( 'git config xxxx' )
+    # Shell.run( 'xxxx' )
+  end
+
+  def test_call
+    stdout1, stderr1, status1 = Shell.call( 'git config user.name' )
+    stdout2, stderr2, status2 = Shell.call( 'git config --show-origin user.name' )
+    # stdout3, stderr3, status3 = Shell.call( 'xxxx' )
+
+    pp stdout1
+    pp stderr1
+    pp status1
+    puts "---"
+    pp stdout2
+    pp stderr2
+    pp status2
+  end
+
+end # class TestShell
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: computer
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
@@ -44,7 +44,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.22'
-description: computer gem - command line helpers / wrappers
+description: computer gem  -  shell command line helper / wrapper 'n' more for your
+  computer
 email: ruby-talk@ruby-lang.org
 executables: []
 extensions: []
@@ -58,6 +59,10 @@ files:
 - README.md
 - Rakefile
 - lib/computer.rb
+- lib/computer/shell.rb
+- lib/computer/version.rb
+- test/helper.rb
+- test/test_shell.rb
 homepage: https://github.com/rubycoco/git
 licenses:
 - Public Domain
@@ -83,5 +88,5 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: computer gem - command line helpers / wrappers
+summary: computer gem  -  shell command line helper / wrapper 'n' more for your computer
 test_files: []