IndexFile.add: writing of the index file can now optionally be turned off. The default is to write the physical index, which is the behaviour you would expect

Author: Byron

lib/git/index/base.py

@@ -581,10 +581,10 @@ def _preprocess_add_items(self, items):
 		return (paths, entries)
 
 	@git_working_dir
-	def add(self, items, force=True, fprogress=lambda *args: None, path_rewriter=None):
+	def add(self, items, force=True, fprogress=lambda *args: None, path_rewriter=None, 
+				write=True):
 		"""Add files from the working tree, specific blobs or BaseIndexEntries
-		to the index. The underlying index file will be written immediately, hence
-		you should provide as many items as possible to minimize the amounts of writes
+		to the index. 
 
 		:param items:
 			Multiple types of items are supported, types can be mixed within one call.
@@ -653,6 +653,10 @@ def add(self, items, force=True, fprogress=lambda *args: None, path_rewriter=Non
 			converted to Entries beforehand and passed to the path_rewriter.
 			Please note that entry.path is relative to the git repository.
 
+		:param write:
+				If True, the index will be written once it was altered. Otherwise
+				the changes only exist in memory and are not available to git commands.
+		
 		:return:
 			List(BaseIndexEntries) representing the entries just actually added.
 
@@ -748,11 +752,13 @@ def store_path(filepath):
 		# END if there are base entries
 
 		# FINALIZE
-		# add the new entries to this instance, and write it
+		# add the new entries to this instance
 		for entry in entries_added:
 			self.entries[(entry.path, 0)] = IndexEntry.from_base(entry)
-		
-		self.write()
+			
+		if write:
+			self.write()
+		# END handle write
 
 		return entries_added
 

test/git/test_index.py

@@ -171,7 +171,8 @@ def test_index_merge_tree(self, rw_repo):
 		# pretend there was a change, but we do not even bother adding a proper 
 		# sha for it ( which makes things faster of course )
 		manifest_fake_entry = BaseIndexEntry((manifest_entry[0], "\0"*20, 0, manifest_entry[3]))
-		rw_repo.index.add([manifest_fake_entry])
+		# try write flag
+		rw_repo.index.add([manifest_fake_entry], write=False)
 		# add actually resolves the null-hex-sha for us as a feature, but we can 
 		# edit the index manually
 		assert rw_repo.index.entries[manifest_key].binsha != Object.NULL_BIN_SHA