gitti 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 651f519f3b5f3ecf8a13a5125554cac2d69790f6
-  data.tar.gz: 7ae7285e8ac625336869c7d4de1d078c11c5ee6d
+  metadata.gz: 82d9e96c41bfe2c9fa31a16a4370dd7ed22fe77d
+  data.tar.gz: f9fcafde391fbba16b951a4858dda109898e41dd
 SHA512:
-  metadata.gz: 7c002bac4f5622a3083b27fa2e29d69736821d14c7b521ecd1a00b06cd62d80cae762e853e96943baa242e77568043a356fecc8c036c8856f18c8eac42facf0c
-  data.tar.gz: 694934d8ea8263d11b90f7a14a01f8f59d3d71a695b728ebd82927e66d554cf1e59195199af7c960e930cc9cb4d9ad4c3d93abec28df9fe1aca931304e1f4698
+  metadata.gz: 1691456f72d2502668611903944cc1540b48266f733ba29ff5994f681e7911382e8bea3b45d2e6061ef7cf570b56b78d0c3c39124ccde9e28b93ba2cfdcb33ad
+  data.tar.gz: 846f28155f8e0a36ff0e8064fff12389c6cfee5b5f13b69e454842a2554dc89cf72f38fd34e395a1094708018b240811420608112fe5fabc63495bc9e0c13ee9

data/README.md

@@ -1,166 +1,166 @@
-# gitti
-
-gitti gem - (yet) another (lite) git command line helper / wrapper
-
-* home  :: [github.com/rubycoco/gitti](https://github.com/rubycoco/gitti)
-* bugs  :: [github.com/rubycoco/gitti/issues](https://github.com/rubycoco/gitti/issues)
-* gem   :: [rubygems.org/gems/gitti](https://rubygems.org/gems/gitti)
-* rdoc  :: [rubydoc.info/gems/gitti](http://rubydoc.info/gems/gitti)
-
-
-
-## Usage
-
-`Git` • `GitProject` • `GitMirror`
-
-
-### `Git` Class
-
-Use the `Git` class for "low-level / to the metal" git commands
-that run in your current working directory.
-Example:
-
-``` ruby
-
-###############
-## "setup" starter git commands
-
-Git.clone( "https://github.com/rubycoco/gitti.git" )
-Git.clone( "https://github.com/rubycoco/gitti.git", "gitti-clone" )
-# -or-    -- if you have write / commit access use ssh
-Git.clone( "git@github.com:rubycoco/gitti.git" )
-Git.clone( "git@github.com:rubycoco/gitti.git", "gitti-clone" )
-
-Git.mirror( "https://github.com/rubycoco/gitti.git" )  ## same as  git clone --mirror
-
-#################
-## standard git commands
-
-Git.version                 ## same as  git --version
-Git.status
-Git.status( short: true )   ## same as Git.changes
-Git.changes                 ## same as  git status --short
-
-#####################
-## status helpers
-
-Git.clean?
-Git.changes?
-Git.dirty?      ## alias for changes?
-
-#######
-## more (major) git commands
-
-Git.fetch
-Git.pull
-Git.fast_forward      ## same as  git pull --ff-only
-Git.ff                ## alias for fast_forward
-Git.push
-Git.add( "pathspec" )
-Git.add_all           ## same as  git --all
-Git.commit( "message" )
-
-Git.files                       ## same as  git ls-tree --full-tree --name-only -r HEAD
-
-Git.check                       ## same as  git fsck
-Git.fsck                        ## alias for check
-Git.checksum                    ## another alias for check
-
-Git.master?          ## on master branch
-Git.main?            ## on main branch
-
-Git.origin           ## same as   git remote show origin
-Git.upstream         ## same as   git remote show upstream
-Git.origin?
-Git.upstream?
-
-Git.config( "user.name" )                    ## use --get option
-Git.config( "user.name", show_origin: true ) ## add --show-origin flag
-Git.config( "user.name", show_scope: true )  ## add --show-scope flag
-
-Git.config( /user/ )                     ## use --get-regexp option
-Git.config( /user/, show_origin: true )  ## add --show-origin flag
-Git.config( /user/, show_scope: true )   ## add --show-scope flag
-```
-
-
-
-### `GitProject` Class
-
-Use the `GitProject` class for existing git repo(sitories)
-with workspace. Example:
-
-``` ruby
-GitProject.open( "rubycoco/gitti" ) do |proj|
-  proj.status
-  proj.status( short: true )
-  proj.changes
-  proj.clean?
-  proj.changes?
-  proj.dirty?
-
-  proj.fetch
-  proj.pull
-  proj.fast_forward
-  proj.ff
-
-  proj.push
-
-  proj.add( "pathspec" )
-  proj.add_all
-  proj.commit( "message" )
-
-  proj.files
-
-  proj.master?
-  proj.main?
-
-  proj.origin
-  proj.upstream
-  proj.origin?
-  proj.upstream?
-end
-```
-
-
-### `GitMirror` Class
-
-Use the `GitMirror` class for existing mirrored (bare) git repo(sitories)
-without workspace. Example:
-
-``` ruby
-GitMirror.open( "rubycoco/gitti.git" ) do |mirror|
-  mirror.update     # sames as  git remote update
-end
-```
-
-
-
-That's it for now.
-
-
-
-## Real World Usage
-
-The [`monos`](https://github.com/rubycoco/monos) gem incl. some monorepo / mono source tree tools and (startup) scripts
-that let you run git commands on multiple repos.
-
-
-
-## Installation
-
-Use
-
-    gem install gitti
-
-or add to your Gemfile
-
-    gem 'gitti'
-
-
-
-## License
-
-The `gitti` scripts are dedicated to the public domain.
-Use it as you please with no restrictions whatsoever.
-
+# gitti
+
+gitti gem - (yet) another (lite) git command line helper / wrapper
+
+* home  :: [github.com/rubycoco/gitti](https://github.com/rubycoco/gitti)
+* bugs  :: [github.com/rubycoco/gitti/issues](https://github.com/rubycoco/gitti/issues)
+* gem   :: [rubygems.org/gems/gitti](https://rubygems.org/gems/gitti)
+* rdoc  :: [rubydoc.info/gems/gitti](http://rubydoc.info/gems/gitti)
+
+
+
+## Usage
+
+`Git` • `GitProject` • `GitMirror`
+
+
+### `Git` Class
+
+Use the `Git` class for "low-level / to the metal" git commands
+that run in your current working directory.
+Example:
+
+``` ruby
+
+###############
+## "setup" starter git commands
+
+Git.clone( "https://github.com/rubycoco/gitti.git" )
+Git.clone( "https://github.com/rubycoco/gitti.git", "gitti-clone" )
+# -or-    -- if you have write / commit access use ssh
+Git.clone( "git@github.com:rubycoco/gitti.git" )
+Git.clone( "git@github.com:rubycoco/gitti.git", "gitti-clone" )
+
+Git.mirror( "https://github.com/rubycoco/gitti.git" )  ## same as  git clone --mirror
+
+#################
+## standard git commands
+
+Git.version                 ## same as  git --version
+Git.status
+Git.status( short: true )   ## same as Git.changes
+Git.changes                 ## same as  git status --short
+
+#####################
+## status helpers
+
+Git.clean?
+Git.changes?
+Git.dirty?      ## alias for changes?
+
+#######
+## more (major) git commands
+
+Git.fetch
+Git.pull
+Git.fast_forward      ## same as  git pull --ff-only
+Git.ff                ## alias for fast_forward
+Git.push
+Git.add( "pathspec" )
+Git.add_all           ## same as  git --all
+Git.commit( "message" )
+
+Git.files                       ## same as  git ls-tree --full-tree --name-only -r HEAD
+
+Git.check                       ## same as  git fsck
+Git.fsck                        ## alias for check
+Git.checksum                    ## another alias for check
+
+Git.master?          ## on master branch
+Git.main?            ## on main branch
+
+Git.origin           ## same as   git remote show origin
+Git.upstream         ## same as   git remote show upstream
+Git.origin?
+Git.upstream?
+
+Git.config( "user.name" )                    ## use --get option
+Git.config( "user.name", show_origin: true ) ## add --show-origin flag
+Git.config( "user.name", show_scope: true )  ## add --show-scope flag
+
+Git.config( /user/ )                     ## use --get-regexp option
+Git.config( /user/, show_origin: true )  ## add --show-origin flag
+Git.config( /user/, show_scope: true )   ## add --show-scope flag
+```
+
+
+
+### `GitProject` Class
+
+Use the `GitProject` class for existing git repo(sitories)
+with workspace. Example:
+
+``` ruby
+GitProject.open( "rubycoco/gitti" ) do |proj|
+  proj.status
+  proj.status( short: true )
+  proj.changes
+  proj.clean?
+  proj.changes?
+  proj.dirty?
+
+  proj.fetch
+  proj.pull
+  proj.fast_forward
+  proj.ff
+
+  proj.push
+
+  proj.add( "pathspec" )
+  proj.add_all
+  proj.commit( "message" )
+
+  proj.files
+
+  proj.master?
+  proj.main?
+
+  proj.origin
+  proj.upstream
+  proj.origin?
+  proj.upstream?
+end
+```
+
+
+### `GitMirror` Class
+
+Use the `GitMirror` class for existing mirrored (bare) git repo(sitories)
+without workspace. Example:
+
+``` ruby
+GitMirror.open( "rubycoco/gitti.git" ) do |mirror|
+  mirror.update     # sames as  git remote update
+end
+```
+
+
+
+That's it for now.
+
+
+
+## Real World Usage
+
+The [`monos`](https://github.com/rubycoco/monos) gem incl. some monorepo / mono source tree tools and (startup) scripts
+that let you run git commands on multiple repos.
+
+
+
+## Installation
+
+Use
+
+    gem install gitti
+
+or add to your Gemfile
+
+    gem 'gitti'
+
+
+
+## License
+
+The `gitti` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+

data/Rakefile

@@ -17,12 +17,13 @@ Hoe.spec 'gitti' do
   self.readme_file  = 'README.md'
   self.history_file = 'CHANGELOG.md'
 
-  self.extra_deps = []
+  self.extra_deps = [
+    ['yorobot-shell', '>= 0.0.1' ],
+  ]
 
   self.licenses = ['Public Domain']
 
   self.spec_extras = {
    required_ruby_version: '>= 2.2.2'
   }
-
 end

data/lib/gitti/base.rb

@@ -1,57 +1,60 @@
-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.
-
-
-
-# our own code
-require 'gitti/version'   # note: let version always go first
-require 'gitti/git'
-require 'gitti/project'
-require 'gitti/mirror'
-require 'gitti/reposet'
-
-
-
-module Gitti
-## todo: change to GitHubRepoRef or GitHubProject
-##   or Git::GitHub or Git::Source::GitHub or such - why? why not?
-class GitHubRepo
-  attr_reader :owner, :name
-
-  def initialize( owner, name )
-    @owner = owner    ## use/rename to login or something - why? why not??
-    @name  = name     #  e.g. "rubylibs/webservice"
-  end
-
-
-  def ssh_clone_url
-     ##  check: use https: as default? for github - http:// still supported? or redirected?
-     ## "http://github.com/#{@owner}/#{@name}"
-     "git@github.com:#{@owner}/#{@name}.git"
-  end
-
-  def http_clone_url   ## use clone_url( http: true )  -- why? why not?
-     ##  note: https is default for github - http:// gets redirected to https://
-     "http://github.com/#{@owner}/#{@name}"
-  end
-
-  def https_clone_url
-    "https://github.com/#{@owner}/#{@name}"
-  end
-
-
-end   ## class GitHubRepo
-end   ## module Gitti
-
-
-
-# say hello
-puts GittiCore.banner      ## if defined?( $RUBYCOCO_DEBUG )
+require 'yorobot/shell'   ## note: move shell execute for (re)use to its own (upstream) gem
+
+module Gitti
+  Shell      = Yorobot::Shell
+  ShellError = Yorobot::ShellError
+  GitError   = Yorobot::ShellError  ## raised if git exec returns with non-zero exit - just use ShellError - why? why not?
+  ## raised by Git::Shell.run
+  ##  todo/check: use ShellError or RunError - why? why not?
+  ##   and make Git::Shell top-level e.g. Shell - why? why not?
+
+  ##   differentiate into/use
+  ##     GitShell.run/GitCmd.run() or such and Shell.run  - why? why not?
+end
+
+
+
+# our own code
+require 'gitti/version'   # note: let version always go first
+require 'gitti/git'
+require 'gitti/project'
+require 'gitti/mirror'
+require 'gitti/reposet'
+
+
+
+module Gitti
+## todo: change to GitHubRepoRef or GitHubProject
+##   or Git::GitHub or Git::Source::GitHub or such - why? why not?
+class GitHubRepo
+  attr_reader :owner, :name
+
+  def initialize( owner, name )
+    @owner = owner    ## use/rename to login or something - why? why not??
+    @name  = name     #  e.g. "rubylibs/webservice"
+  end
+
+
+  def ssh_clone_url
+     ##  check: use https: as default? for github - http:// still supported? or redirected?
+     ## "http://github.com/#{@owner}/#{@name}"
+     "git@github.com:#{@owner}/#{@name}.git"
+  end
+
+  def http_clone_url   ## use clone_url( http: true )  -- why? why not?
+     ##  note: https is default for github - http:// gets redirected to https://
+     "http://github.com/#{@owner}/#{@name}"
+  end
+
+  def https_clone_url
+    "https://github.com/#{@owner}/#{@name}"
+  end
+
+
+end   ## class GitHubRepo
+end   ## module Gitti
+
+
+
+# say hello
+puts GittiCore.banner      ## if defined?( $RUBYCOCO_DEBUG )

data/lib/gitti/git.rb

@@ -1,18 +1,10 @@
 module Gitti
 
-## raised by Git::Shell.run -- check if top-level ShellError alread exists?
-##   use ShellError or RunError - why? why not?
-##   and make Git::Shell top-level e.g. Shell - why? why not?
-class GitError < StandardError
-end
-
-
 class Git   ## make Git a module - why? why not?
 
   ###
   ## todo/fix:  change opts=nil to *args or such - why? why not?
 
-
   ###############
   ## "setup" starter git commands
 
@@ -268,49 +260,6 @@ class Git   ## make Git a module - why? why not?
     alias_method :checksum, :check
   end
 
-
-
-###
-#  use nested class for "base" for running commands - why? why not?
-class Shell
-def self.run( cmd )
-  print "cmd exec >#{cmd}<..."
-  stdout, stderr, status = Open3.capture3( cmd )
-
-  if status.success?
-    print " OK"
-    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)
-    puts "2>"
-    puts stderr
-  end
-
-  if status.success?
-    stdout   # return stdout string
-  else
-    puts "!! ERROR: cmd exec >#{cmd}< failed with exit status #{status.exitstatus}:"
-    puts stderr
-
-    ### todo/fix:  do NOT use GitError here!!! make it more "general"
-    ###   use a Git::Shell.run() wrapper or such - why? why not?
-    ##   or use a Shell.git() or Shell.git_run() ???
-    ##   or pass in error class - why? why not?
-    raise GitError, "cmd exec >#{cmd}< failed with exit status #{status.exitstatus}<: #{stderr}"
-  end
-end
-end # class Git::Shell
-
 end # class Git
 
 end # module Gitti

data/lib/gitti/mirror.rb

@@ -1,33 +1,33 @@
-module Gitti
-
-class GitMirror
-  def self.open( path, &blk )
-    new( path ).open( &blk )
-  end
-
-  def self.update( path )    ### all-in-one convenience shortcut
-    new( path).open { |mirror| mirror.update }
-  end
-
-
-
-  def initialize( path )
-    raise ArgumentError, "dir >#{path}< not found; dir MUST already exist for GitMirror class - sorry"   unless Dir.exist?( path )
-    ## todo/check:  check for more dirs and files e.g.
-    ##  /info,/objects,/refs, /hooks, HEAD, config, description -- why? why not?
-    raise ArgumentError, "dir >#{path}/objects< not found; dir MUST already be initialized with git for GitMirror class - sorry"  unless Dir.exist?( "#{path}/objects" )
-    @path = path
-  end
-
-
-  def open( &blk )
-    Dir.chdir( @path ) do
-      blk.call( self )
-    end
-  end
-
-  def update()           Git.update; end
-
-end # class GitMirror
-end # module Gitti
-
+module Gitti
+
+class GitMirror
+  def self.open( path, &blk )
+    new( path ).open( &blk )
+  end
+
+  def self.update( path )    ### all-in-one convenience shortcut
+    new( path).open { |mirror| mirror.update }
+  end
+
+
+
+  def initialize( path )
+    raise ArgumentError, "dir >#{path}< not found; dir MUST already exist for GitMirror class - sorry"   unless Dir.exist?( path )
+    ## todo/check:  check for more dirs and files e.g.
+    ##  /info,/objects,/refs, /hooks, HEAD, config, description -- why? why not?
+    raise ArgumentError, "dir >#{path}/objects< not found; dir MUST already be initialized with git for GitMirror class - sorry"  unless Dir.exist?( "#{path}/objects" )
+    @path = path
+  end
+
+
+  def open( &blk )
+    Dir.chdir( @path ) do
+      blk.call( self )
+    end
+  end
+
+  def update()           Git.update; end
+
+end # class GitMirror
+end # module Gitti
+

data/lib/gitti/version.rb

@@ -7,8 +7,8 @@
 
 module GittiCore    ## todo/check: rename GittiBase or GittiMeta or such - why? why not?
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 4
-  PATCH = 2
+  MINOR = 5
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

metadata

@@ -1,43 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: gitti
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-21 00:00:00.000000000 Z
+date: 2020-10-19 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: yorobot-shell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.1
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: hoe
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '3.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '3.22'
 description: gitti - (yet) another (lite) git command line helper / wrapper
 email: ruby-talk@ruby-lang.org
 executables: []