Added 'path' keyword argument to Repo.archive().

This allows sub-trees to be archived as well, and makes `.archive()`
feature complete.

Fixes #67

Author: Byron

doc/source/changes.rst

@@ -5,6 +5,7 @@ Changelog
 0.3.6 - Features
 ================
 * Added `Repo.merge_base()` implementation. See the `respective issue on github <https://github.com/gitpython-developers/GitPython/issues/169>`_
+* `[include]` sections in git configuration files are now respected
 * A list of all issues can be found here: https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v0.3.6+-+Features%22+
 
 0.3.5 - Bugfixes

git/repo/base.py

@@ -846,7 +846,10 @@ def archive(self, ostream, treeish=None, prefix=None, **kwargs):
         :parm kwargs:
             Additional arguments passed to git-archive
             NOTE: Use the 'format' argument to define the kind of format. Use
-            specialized ostreams to write any format supported by python
+            specialized ostreams to write any format supported by python.
+
+            You may specify the special 'path' keyword, which may either be a repository-relative
+            path to a directory or file to place into the archive, or a list or tuple of multipe paths.
 
         :raise GitCommandError: in case something went wrong
         :return: self"""
@@ -855,8 +858,12 @@ def archive(self, ostream, treeish=None, prefix=None, **kwargs):
         if prefix and 'prefix' not in kwargs:
             kwargs['prefix'] = prefix
         kwargs['output_stream'] = ostream
+        path = kwargs.pop('path', list())
+        if not isinstance(path, (tuple, list)):
+            path = [path]
+        # end assure paths is list
 
-        self.git.archive(treeish, **kwargs)
+        self.git.archive(treeish, *path, **kwargs)
         return self
 
     rev_parse = rev_parse

git/test/test_repo.py

@@ -266,7 +266,7 @@ def test_tag(self):
     def test_archive(self):
         tmpfile = tempfile.mktemp(suffix='archive-test')
         stream = open(tmpfile, 'wb')
-        self.rorepo.archive(stream, '0.1.5')
+        self.rorepo.archive(stream, '0.1.6', path='doc')
         assert stream.tell()
         stream.close()
         os.remove(tmpfile)