summaryrefslogtreecommitdiff
path: root/perl/Git.pm
diff options
context:
space:
mode:
authorPetr Baudis <pasky@suse.cz>2006-07-03 20:48:05 (GMT)
committerJunio C Hamano <junkio@cox.net>2006-07-09 08:20:01 (GMT)
commit3c479c37f8651d09e1d08b8d6ea9757164ee1235 (patch)
treea01c9f7cc7cb7812b1691d0fb524052b5ed83a6a /perl/Git.pm
parent0270083ded143fd49841e3d3d0cac5eb06081d2a (diff)
downloadgit-3c479c37f8651d09e1d08b8d6ea9757164ee1235.zip
git-3c479c37f8651d09e1d08b8d6ea9757164ee1235.tar.gz
git-3c479c37f8651d09e1d08b8d6ea9757164ee1235.tar.bz2
Git.pm: Introduce fast get_object() method
Direct .xs routine. Note that it does not work 100% correctly when you juggle multiple repository objects, but it is not that bad either. The trouble is that we might reuse packs information for another Git project; that is not an issue since Git depends on uniqueness of SHA1 ids so if we have found the object somewhere else, it is nevertheless going to be the same object. It merely makes object existence detection through this method unreliable; it is duly noted in the documentation. At least that's how I see it, I hope I didn't overlook any other potential problem. I tested it for memory leaks and it appears to be doing ok. Signed-off-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'perl/Git.pm')
-rw-r--r--perl/Git.pm18
1 files changed, 18 insertions, 0 deletions
diff --git a/perl/Git.pm b/perl/Git.pm
index 9da15e9..f2467bd 100644
--- a/perl/Git.pm
+++ b/perl/Git.pm
@@ -572,6 +572,24 @@ sub ident_person {
}
+=item get_object ( TYPE, SHA1 )
+
+Return contents of the given object in a scalar string. If the object has
+not been found, undef is returned; however, do not rely on this! Currently,
+if you use multiple repositories at once, get_object() on one repository
+_might_ return the object even though it exists only in another repository.
+(But do not rely on this behaviour either.)
+
+The method must be called on a repository instance.
+
+Implementation of this method is very fast; no external command calls
+are involved. That's why it is broken, too. ;-)
+
+=cut
+
+# Implemented in Git.xs.
+
+
=item hash_object ( TYPE, FILENAME )
=item hash_object ( TYPE, FILEHANDLE )