grit 2.1.0 → 2.2.0

data/History.txt

@@ -1,3 +1,7 @@
+== HEAD
+  * Minor Enhancements
+    * Add Grit::Index#delete to allow deletions of files from the index.
+
 == 2.1.0 / 2010-08-04
   * Major Enhancements
     * Add support for parsing annotated tag objects.

data/Rakefile

@@ -98,7 +98,7 @@ task :release => :build do
   sh "git commit --allow-empty -a -m 'Release #{version}'"
   sh "git tag v#{version}"
   sh "git push origin master"
-  sh "git push v#{version}"
+  sh "git push origin v#{version}"
   sh "gem push pkg/#{name}-#{version}.gem"
 end
 

data/grit.gemspec

@@ -4,8 +4,8 @@ Gem::Specification.new do |s|
   s.rubygems_version = '1.3.5'
 
   s.name              = 'grit'
-  s.version           = '2.1.0'
-  s.date              = '2010-08-04'
+  s.version           = '2.2.0'
+  s.date              = '2010-08-19'
   s.rubyforge_project = 'grit'
 
   s.summary     = "Ruby Git bindings."

data/lib/grit.rb

@@ -51,7 +51,7 @@ require 'grit/blame'
 require 'grit/merge'
 
 module Grit
-  VERSION = '2.1.0'
+  VERSION = '2.2.0'
 
   class << self
     # Set +debug+ to true to log all git calls and responses

data/lib/grit/index.rb

@@ -1,21 +1,36 @@
 module Grit
 
   class Index
-    attr_accessor :repo, :tree, :current_tree
+    # Public: Gets/Sets the Grit::Repo to which this index belongs.
+    attr_accessor :repo
 
+    # Public: Gets/Sets the Hash tree map that holds the changes to be made
+    # in the next commit.
+    attr_accessor :tree
+
+    # Public: Gets/Sets the Grit::Tree object representing the tree upon
+    # which the next commit will be based.
+    attr_accessor :current_tree
+
+    # Initialize a new Index object.
+    #
+    # repo - The Grit::Repo to which the index belongs.
+    #
+    # Returns the newly initialized Grit::Index.
     def initialize(repo)
       self.repo = repo
       self.tree = {}
       self.current_tree = nil
     end
 
-    # Add a file to the index
-    #   +path+ is the path (including filename)
-    #   +data+ is the binary contents of the file
+    # Public: Add a file to the index.
     #
-    # Returns nothing
-    def add(file_path, data)
-      path = file_path.split('/')
+    # path - The String file path including filename (no slash prefix).
+    # data - The String binary contents of the file.
+    #
+    # Returns nothing.
+    def add(path, data)
+      path = path.split('/')
       filename = path.pop
 
       current = self.tree
@@ -29,31 +44,49 @@ module Grit
       current[filename] = data
     end
 
-    # Sets the current tree
-    #   +tree+ the branch/tag/sha... to use - a string
+    # Public: Delete the given file from the index.
+    #
+    # path - The String file path including filename (no slash prefix).
+    #
+    # Returns nothing.
+    def delete(path)
+      add(path, false)
+    end
+
+    # Public: Read the contents of the given Tree into the index to use as a
+    # starting point for the index.
+    #
+    # tree - The String branch/tag/sha of the Git tree object.
     #
-    # Returns index (self)
+    # Returns nothing.
     def read_tree(tree)
       self.current_tree = self.repo.tree(tree)
     end
 
-    # Commit the contents of the index
-    #   +message+ is the commit message [nil]
-    #   +parents+ is one or more commits to attach this commit to to form a new head [nil]
-    #   +actor+ is the details of the user making the commit [nil]
-    #   +last_tree+ is a tree to compare with - to avoid making empty commits [nil]
-    #   +head+ is the branch to write this head to [master]
+    # Public: Commit the contents of the index
     #
-    # Returns a String of the SHA1 of the commit
-    def commit(message, parents = nil, actor = nil, last_tree = nil, head = 'master')
+    # message   - The String commit message.
+    # parents   - Array of String commit SHA1s or Grit::Commit objects to
+    #             attach this commit to to form a new head (default: []).
+    # actor     - The Grit::Actor details of the user making the commit
+    #             (default: nil).
+    # last_tree - The String SHA1 of a tree to compare with in order to avoid
+    #             making empty commits (default: nil).
+    # head      - The String branch name to write this head to
+    #             (default: "master").
+    #
+    # Returns a String of the SHA1 of the new commit.
+    def commit(message, parents = [], actor = nil, last_tree = nil, head = 'master')
       tree_sha1 = write_tree(self.tree, self.current_tree)
-      return false if tree_sha1 == last_tree # don't write identical commits
+
+      # don't write identical commits
+      return false if tree_sha1 == last_tree
 
       contents = []
       contents << ['tree', tree_sha1].join(' ')
       parents.each do |p|
-        contents << ['parent', p].join(' ') if p
-      end if parents
+        contents << ['parent', p].join(' ')
+      end
 
       if actor
         name = actor.name
@@ -75,10 +108,15 @@ module Grit
       self.repo.update_ref(head, commit_sha1)
     end
 
-    # Recursively write a tree to the index
-    #   +tree+ is the tree
+    # Recursively write a tree to the index.
+    #
+    # tree -     The Hash tree map:
+    #            key - The String directory or filename.
+    #            val - The Hash submap or the String contents of the file.
+    # now_tree - The Grit::Tree representing the a previous tree upon which
+    #            this tree will be based (default: nil).
     #
-    # Returns the SHA1 String of the tree
+    # Returns the String SHA1 String of the tree.
     def write_tree(tree, now_tree = nil)
       tree_contents = {}
 
@@ -104,16 +142,20 @@ module Grit
             sha = [sha].pack("H*")
             str = "%s %s\0%s" % ['40000', k, sha]
             tree_contents[k + '/'] = str
+          when false
+            tree_contents.delete(k)
         end
       end
+
       tr = tree_contents.sort.map { |k, v| v }.join('')
       self.repo.git.put_raw_object(tr, 'tree')
     end
 
-    # Write the blob to the index
-    #   +data+ is the data to write
+    # Write a blob to the index.
+    #
+    # data - The String data to write.
     #
-    # Returns the SHA1 String of the blob
+    # Returns the String SHA1 of the new blob.
     def write_blob(data)
       self.repo.git.put_raw_object(data, 'blob')
     end

data/lib/grit/status.rb

@@ -3,6 +3,8 @@ module Grit
   class Status
     include Enumerable
 
+    attr_reader :files
+
     @base = nil
     @files = nil
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: grit
 version: !ruby/object:Gem::Version 
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors: 
 - Tom Preston-Werner
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-04 00:00:00 -06:00
+date: 2010-08-19 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency