Merge pull request gitpython-developers#154 from brunson/0.3

add git command options

Author: brunson

git/cmd.py

@@ -42,7 +42,8 @@ class Git(LazyMixin):
         of the command to stdout.
         Set its value to 'full' to see details about the returned values.
     """
-    __slots__ = ("_working_dir", "cat_file_all", "cat_file_header", "_version_info")
+    __slots__ = ("_working_dir", "cat_file_all", "cat_file_header", "_version_info",
+                 "_git_options")
 
     # CONFIGURATION
     # The size in bytes read from stdout when copying git's output to another stream
@@ -217,7 +218,8 @@ def __init__(self, working_dir=None):
            .git directory in case of bare repositories."""
         super(Git, self).__init__()
         self._working_dir = working_dir
-        
+        self._git_options = ()
+
         # cached command slots
         self.cat_file_header = None
         self.cat_file_all = None
@@ -386,15 +388,18 @@ def execute(self, command,
         else:
             return stdout_value
 
-    def transform_kwargs(self, **kwargs):
+    def transform_kwargs(self, split_single_char_options=False, **kwargs):
         """Transforms Python style kwargs into git command line options."""
         args = list()
         for k, v in kwargs.items():
             if len(k) == 1:
                 if v is True:
                     args.append("-%s" % k)
                 elif type(v) is not bool:
-                    args.append("-%s%s" % (k, v))
+                    if split_single_char_options:
+                        args.extend(["-%s" % k, "%s" % v])
+                    else:
+                        args.append("-%s%s" % (k, v))
             else:
                 if v is True:
                     args.append("--%s" % dashify(k))
@@ -417,6 +422,22 @@ def __unpack_args(cls, arg_list):
         # END for each arg
         return outlist
 
+    def __call__(self, **kwargs):
+        """Specify command line options to the git executable
+        for a subcommand call
+
+        :param kwargs:
+            is a dict of keyword arguments.
+            these arguments are passed as in _call_process
+            but will be passed to the git command rather than
+            the subcommand.
+
+        ``Examples``::
+            git(work_tree='/tmp').difftool()"""
+        self._git_options = self.transform_kwargs(
+            split_single_char_options=True, **kwargs)
+        return self
+
     def _call_process(self, method, *args, **kwargs):
         """Run the given git command with the specified arguments and return
         the result as a String
@@ -455,7 +476,14 @@ def _call_process(self, method, *args, **kwargs):
         args = opt_args + ext_args
 
         def make_call():
-            call = [self.GIT_PYTHON_GIT_EXECUTABLE, dashify(method)]
+            call = [self.GIT_PYTHON_GIT_EXECUTABLE]
+
+            # add the git options, the reset to empty
+            # to avoid side_effects
+            call.extend(self._git_options)
+            self._git_options = ()
+
+            call.extend([dashify(method)])
             call.extend(args)
             return call
         #END utility to recreate call after changes

git/test/test_git.py

@@ -107,3 +107,17 @@ def test_cmd_override(self):
         finally:
             type(self.git).GIT_PYTHON_GIT_EXECUTABLE = prev_cmd
         #END undo adjustment
+
+    def test_options_are_passed_to_git(self):
+        # This work because any command after git --version is ignored
+        git_version = self.git(version=True).NoOp()
+        git_command_version = self.git.version()
+        self.assertEquals(git_version, git_command_version)
+
+    def test_single_char_git_options_are_passed_to_git(self):
+        input_value='TestValue'
+        output_value = self.git(c='user.name={}'.format(input_value)).config('--get', 'user.name')
+        self.assertEquals(input_value, output_value)
+
+    def test_change_to_transform_kwargs_does_not_break_command_options(self):
+        self.git.log(n=1)