rjgit 6.4.0.1 → 6.5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ee86efc7cf49616791f74a2d0781cd3bd2bf4e570d0353c5c71b012b984230a
-  data.tar.gz: 6a87141e15f7c413f1d1d6205d9e5898e1e8e0d97183569f8bee2807ab0eb9d9
+  metadata.gz: 6ffd00cd58355827c9f0e25310905d0634d556f3266189b170ebdf5c725db6d9
+  data.tar.gz: ec13041af58650371daba46753ba499260ba3d48ead0c7159c0c3016fbd9eaa9
 SHA512:
-  metadata.gz: 6fca1bb945ad86907e0c65d1a7ce726cc6ab0f1c7a49040c52162b5b0f54c6449c67b70c13022954420912d5fba0a4104fbcbbdd563a43fa54ea241551084fb2
-  data.tar.gz: 3df8fe32b4c38c14515eaa4e0800e21aed95a1106964f49fbe6148c85699a72b4e4296be51c2d210f1e8efd4eda60d2e26205fba0a01e485f8e156330397c630
+  metadata.gz: 4dacb2b8c3414b8250c91277815813ada02b7fe6ce010dd2167b1d9d616cecd73f93b84ef51643ee1e5b625bdff58462b720fc6df511018d2637ca93a9dc3a56
+  data.tar.gz: de445b74d2ce33b6368ff794607d8c3e294ebc06231320f0e6b2ecd5d18b563f80f9f0567cbcdef2f5ce7005d2680b66b5e876006c800bb71a37f350d67d5d34

data/README.md

@@ -6,7 +6,7 @@ RJGit
 [![Ruby Build](https://github.com/repotag/rjgit/actions/workflows/test.yaml/badge.svg)](https://github.com/repotag/rjgit/actions/workflows/test.yaml)
 [![Coverage Status](https://coveralls.io/repos/repotag/rjgit/badge.png?branch=master)](https://coveralls.io/r/repotag/rjgit)
 [![Gem Version](https://badge.fury.io/rb/rjgit.png)](http://badge.fury.io/rb/rjgit)
-[![Cutting Edge Dependency Status](https://dometto-cuttingedge.herokuapp.com/github/repotag/rjgit/svg 'Cutting Edge Dependency Status')](https://dometto-cuttingedge.herokuapp.com/github/repotag/rjgit/info)
+[![Cutting Edge Dependency Status](https://cuttingedge.onrender.com/github/repotag/rjgit/svg 'Cutting Edge Dependency Status')](https://cuttingedge.onrender.com/github/repotag/rjgit/info)
 
 Summary
 -------
@@ -15,21 +15,13 @@ RJGit provides a fully featured library for accessing and manipulating git repos
 
 Installation
 ------------
-Install the rjgit gem with the command:
+
+Install the rjgit gem with:
 
 ```sh
 $ gem install rjgit
 ```
 
-#### Dependencies for using RJGit:
-- JRuby >= 1.7.0
-- mime-types >= 1.15
-
-#### Further dependencies for developing RJGIT:
-- rake >= 0.9.2.2
-- rspec >= 2.0
-- simplecov
-
 #### Version scheme
 
 RJGit's version number is the version of jgit used, plus our own patch level counter. For instance, RJGit 4.0.1.0 uses jgit 4.0.1, patch level 0.
@@ -69,18 +61,10 @@ repo.head
 commit = repo.commits('master').first # a Commit object; try commit.actor, commit.id, etc.
 ```
 
-### Getting notes
-```ruby
-repo.notes
-note = repo.head.note
-note.message # the String message of the note
-note.annotates # the SHA ID of the object this note is attached to
-repo.head.note = "Happy note writing"
-repo.head.note_remove
-```
-
+### Getting branches
 
-# Similarly for getting tags, branches, trees (directories), and blobs (files).
+```ruby
+repo.branches
 ```
 
 ### Finding a single object by SHA
@@ -89,11 +73,43 @@ repo.find('959329025f67539fb82e76b02782322fad032821')
 repo.find('959329025f67539fb82e76b02782322fad032821', :commit) # Find a specific :commit, :blob, :tree, or :tag
 ```
 
-### Logs
+### Blobs and Trees
 
 ```ruby
-repo.git.log # Returns an Array of Commits constituting the log for the default branch
-repo.git.log("follow-rename.txt", "HEAD", follow: true, list_renames: true) # Log for a specific path, tracking the pathname over renames. Returns an Array of TrackingCommits, which store the tracked filename: [#<RJGit::TrackingCommit:0x773014d3 @tracked_pathname="follow-rename.txt" ...>]
+blob = repo.blob("example/file.txt") # Retrieve a file by filepath, from the HEAD commit...
+blob = repo.blob("example/file.txt", "refs/heads/mybranch') # Retrieve the same file from a different branch
+blob = repo.find("959329025f67539fb82e76b02782322fad032822", :blob) # ...or by SHA
+blob.data # Cat the file; also blob.id, blob.mode, etc.
+tree = repo.tree("example") # Retrieve a tree by filepath...
+tree = repo.find("959329025f67539fb82e76b02782322fad032000", :tree) #...or by SHA
+tree.data # List the tree's contents (blobs and trees). Also tree.id, tree.mode, etc.
+tree.each {|entry| puts entry.inspect} # Loop over the Tree's children (Blobs and Trees)
+tree.find_blob {|entry| entry[:name] == 'foo.txt'} # Find a single blob that matches the block
+tree.find_tree {|entry| entry[:name] == 'mytree' } # Find a single tree that matches the block
+tree.find {|entry| ...} # Find a single entry that matches the block
+tree.find_all {|entry entry[:name].include?('.') } # Find all entries matching the block
+tree.trees # An array of the Tree's child Trees
+tree.blobs # An array of the Tree's child Blobs
+Porcelain::ls_tree(repo, repo.tree("example"), :print => true, :recursive => true, :ref => 'mybranch') # Outputs the Tree's contents to $stdout. Faster for recursive listing than Tree#each. Passing nil as the second argument lists the entire repository. ref defaults to HEAD.
+```
+
+### Getting tags
+```ruby
+tag = repo.tags['example_tag']
+tag.id # tag's object id
+tag.author.name # Etcetera
+some_object = Porcelain.object_for_tag(repo, tag) # Returns the tagged object; e.g. a Commit
+```
+
+### Getting notes
+
+```ruby
+repo.notes
+note = repo.head.note
+note.message # the String message of the note
+note.annotates # the SHA ID of the object this note is attached to
+repo.head.note = "Happy note writing"
+repo.head.note_remove
 ```
 
 ### Getting diffs
@@ -104,26 +120,11 @@ options = {:old_rev => sha2, :new_rev => sha1, :file_path => "some/path.txt", :p
 Porcelain.diff(repo, options)
 ```
 
-### Getting tags
-```ruby
-tag = repo.tags['example_tag']
-tag.id # tag's object id
-tag.author.name # Etcetera
-some_object = Porcelain.object_for_tag(repo, tag) # Returns the tagged object; e.g. a Commit
-```
+### Logs
 
-### Blobs and Trees
 ```ruby
-blob = repo.blob("example/file.txt") # Retrieve a file by filepath...
-blob = repo.find("959329025f67539fb82e76b02782322fad032822", :blob) # ...or by SHA
-blob.data # Cat the file; also blob.id, blob.mode, etc.
-tree = repo.tree("example") # Retrieve a tree by filepath...
-tree = repo.find("959329025f67539fb82e76b02782322fad032000", :tree) #...or by SHA
-tree.data # List the tree's contents (blobs and trees). Also tree.id, tree.mode, etc.
-tree.each {|entry| puts entry.inspect} # Loop over the Tree's children (Blobs and Trees)
-tree.trees # An array of the Tree's child Trees
-tree.blobs # An array of the Tree's child Blobs
-Porcelain::ls_tree(repo, repo.tree("example"), :print => true, :recursive => true, :ref => 'mybranch') # Outputs the Tree's contents to $stdout. Faster for recursive listing than Tree#each. Passing nil as the second argument lists the entire repository. ref defaults to HEAD.
+repo.git.log # Returns an Array of Commits constituting the log for the default branch
+repo.git.log("follow-rename.txt", "HEAD", follow: true, list_renames: true) # Log for a specific path, tracking the pathname over renames. Returns an Array of TrackingCommits, which store the tracked filename: [#<RJGit::TrackingCommit:0x773014d3 @tracked_pathname="follow-rename.txt" ...>]
 ```
 
 ### Creating blobs and trees from scratch
@@ -170,40 +171,24 @@ Contributing
 1. Create a new branch
 1. Modify the sources
 1. Add specs with full coverage for your new code
-1. Make sure the whole test suite passes by running rake
+1. Make sure the whole test suite passes by running `bundle exec rake`
 1. Push the branch up to GitHub
 1. Send us a pull request
 
-Running RSpec tests (the recommended way)
----------------
-
-1. Start the nailgun server
-```
-jruby --ng-server &
-```
-1. Run rake against the nailgun instance
-```
-jruby --ng -S rake
-```
-
 Authors
 -------
 
-RJGit is being developed by Team Repotag:
+RJGit is being developed by:
 
-- [Maarten Engelen](https://github.com/maarten)
 - [Bart Kamphorst](https://github.com/bartkamphorst)
 - [Dawa Ometto](https://github.com/dometto)
-- [Arlette van Wissen](https://github.com/arlettevanwissen)
-- [Steven Woudenberg](https://github.com/stevenwoudenberg)
 
-With special thanks to:
-- [Patrick Pepels](https://github.com/bluedread)
+
 
 
 License
 -------
-Copyright (c) 2011 - 2022, Team Repotag
+Copyright (c) 2011 - 2023, Team Repotag
 
 (Modified BSD License)
 

data/lib/tree.rb

@@ -25,14 +25,6 @@ module RJGit
       RJGit::Porcelain.ls_tree(@jrepo, @path, Constants::HEAD, options={:print => true, :io => strio})
       @contents = strio.string
     end
-    
-    def contents_array
-      @contents_ary ||= jtree_entries
-    end
-
-    def count
-      contents_array.size
-    end
           
     def recursive_contents_array(limit = nil)
       if @recursive_contents.nil? || @recursive_contents[:limit] != limit
@@ -46,6 +38,26 @@ module RJGit
     def recursive_count(limit = nil)
       recursive_contents_array(limit).size
     end
+
+    def find_blob(&block)
+      return nil unless block_given?
+      _find(:Blob) {|tree_entry| yield tree_entry }
+    end
+
+    def find_tree(&block)
+      return nil unless block_given?
+      _find(:Tree) {|tree_entry| yield tree_entry }
+    end
+
+    def find(&block)
+      return nil unless block_given?
+      _find(nil) {|tree_entry| yield tree_entry}
+    end
+
+    def find_all(&block)
+      return nil unless block_given?
+      _find(nil, true) {|tree_entry| yield tree_entry}
+    end
     
     def each(&block)
       contents_array.each(&block)
@@ -64,8 +76,12 @@ module RJGit
         self
       else
         treewalk = TreeWalk.forPath(@jrepo, file, @jtree)
-        treewalk.nil? ? nil : 
-          wrap_tree_or_blob(treewalk.get_file_mode(0), treewalk.get_path_string, treewalk.get_object_id(0))
+        if treewalk
+          mode = treewalk.get_file_mode(0)
+          wrap_tree_or_blob(obj_type(mode), mode.get_bits, treewalk.get_path_string, treewalk.get_object_id(0))
+        else
+          nil
+        end
       end
     end
     
@@ -104,22 +120,68 @@ module RJGit
 
     private
 
-    def jtree_entries(options={})
+    def contents_array
+      @contents_ary ||= jtree_entries
+    end
+
+    def _find(type = nil, multiple = false, &block)
+      return nil unless block_given?
+      treewalk = init_walk
+      results = [] if multiple
+
+      while treewalk.next
+        entry = tree_entry(treewalk)
+        next if type && type != entry[:type]
+        if yield entry
+          result = wrap_tree_or_blob(entry[:type], entry[:mode], entry[:name], entry[:id])
+          if multiple
+            results << result
+          else
+            return result
+          end
+        end
+      end
+      return results
+    end
+
+    def init_walk(recurse=false)
       treewalk = TreeWalk.new(@jrepo)
       treewalk.add_tree(@jtree)
-      treewalk.set_recursive(true) if options[:recursive]
+      treewalk.set_recursive(true) if recurse
+      treewalk
+    end
+
+    def tree_entry(treewalk)
+      mode = treewalk.get_file_mode(0)
+      {
+        type: obj_type(mode),
+        mode: mode.get_bits,
+        name: treewalk.get_path_string,
+        id: treewalk.get_object_id(0)
+      }
+    end
+
+    def jtree_entries(options = {})
+      treewalk = init_walk(options[:recursive])
       entries = []
       while treewalk.next
-        entries << wrap_tree_or_blob(treewalk.get_file_mode(0), treewalk.get_path_string, treewalk.get_object_id(0))
+        mode = treewalk.get_file_mode(0)
+        type = obj_type(mode)
+
+        entries << wrap_tree_or_blob(type, mode.get_bits, treewalk.get_path_string, treewalk.get_object_id(0))
+
         break if options[:limit] && entries.size >= options[:limit].to_i
       end
       entries
     end
 
-    def wrap_tree_or_blob(mode, path, id)
-      type = mode.get_object_type == Constants::OBJ_TREE ? RJGit::Tree : RJGit::Blob
+    def wrap_tree_or_blob(type, mode, path, id)
       walk = RevWalk.new(@jrepo)
-      type.new(@jrepo, mode.get_bits, path, walk.parse_any(id)) 
+      RJGit.const_get(type).new(@jrepo, mode, path, walk.parse_any(id)) 
+    end
+
+    def obj_type(mode)
+      mode.get_object_type == Constants::OBJ_BLOB ? :Blob : :Tree
     end
     
   end

data/lib/version.rb

@@ -1,3 +1,3 @@
 module RJGit
-  VERSION = "6.4.0.1"
+  VERSION = "6.5.0.0"
 end

metadata

@@ -1,18 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: rjgit
 version: !ruby/object:Gem::Version
-  version: 6.4.0.1
+  version: 6.5.0.0
 platform: ruby
 authors:
-- Maarten Engelen
 - Bart Kamphorst
 - Dawa Ometto
-- Arlette van Wissen
-- Steven Woudenberg
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-06 00:00:00.000000000 Z
+date: 2023-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -49,7 +46,7 @@ files:
 - lib/java/jars/bcpkix-jdk15on-168.jar
 - lib/java/jars/bcprov-jdk15on-168.jar
 - lib/java/jars/jsch-0.1.55.jar
-- lib/java/jars/org.eclipse.jgit-6.4.0.202211300538-r.jar
+- lib/java/jars/org.eclipse.jgit-6.5.0.202303070854-r.jar
 - lib/java/jars/org.eclipse.jgit.ssh.jsch-6.2.0.202206071550-r.jar
 - lib/java/jars/slf4j-api-1.7.2.jar
 - lib/java/jars/slf4j-simple-1.7.12.jar