matrix:

-PYTHON:"C:\\Python26"

PYTHON_VERSION:"2.6"

GIT_PATH:"%GIT_DAEMON_PATH%"

-PYTHON:"C:\\Python27"

PYTHON_VERSION:"2.7"

GIT_PATH:"%GIT_DAEMON_PATH%"

language:python

python:

-"2.6"

-"2.7"

-"3.3"

-"3.4"

-"3.5"

-"3.6"

matrix:

allow_failures:

-python:"2.6"

-python:"3.6-dev"

-python:"3.7-dev"

-python:"nightly"

-git fetch --tags

-pip install -r test-requirements.txt

-pip install codecov sphinx

-if [ "$TRAVIS_PYTHON_VERSION" == '2.6' ]; then pip install unittest2; fi

-./init-tests-after-clone.sh

*[fork this project](https://github.com/gitpython-developers/GitPython/fork) ongithub

*[fork this project](https://github.com/gitpython-developers/GitPython/fork) onGitHub

* For setting up the environment to run the self tests, look at`.travis.yml`.

* Add yourself to AUTHORS.md and write your patch.**Write a test that fails unless your patch is present.**

* Initiate a pull request

the`GIT_PYTHON_GIT_EXECUTABLE=<path/to/git>` environment variable.

* Git (1.7.x or newer)

* Python 2.7 to 3.6, while python 2.6 is supported on a*best-effort basis*.

* Python 2.7 to 3.6.

The list of dependencies are listed in`./requirements.txt` and`./test-requirements.txt`.

The installer takes care of installing them for you.

but not all test-cases pass - you may help improve them by exploring

[Issue#525](https://github.com/gitpython-developers/GitPython/issues/525).

Python 2.6 is supported on best-effort basis; which means that it is likely to deteriorate over time.

*Important*: Right after cloning this repository, please be sure to have executed

with large repositories.

* CRITICAL: fixed incorrect `Commit` object serialization when authored or commit date had timezones which were not

divisiblej by 3600 seconds. This would happen if the timezone was something like `+0530` for instance.

* A list of all additional fixes can be found `ongithub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v1.0.2+-+Fixes%22+is%3Aclosed>`_

* A list of all additional fixes can be found `onGitHub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v1.0.2+-+Fixes%22+is%3Aclosed>`_

* CRITICAL: `Tree.cache` was removed without replacement. It is technically impossible to change individual trees and expect their serialization results to be consistent with what *git* expects. Instead, use the `IndexFile` facilities to adjust the content of the staging area, and write it out to the respective tree objects using `IndexFile.write_tree()` instead.

1.0.1 - Fixes

* A list of all issues can be found `ongithub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v1.0.1+-+Fixes%22+is%3Aclosed>`_

* A list of all issues can be found `onGitHub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v1.0.1+-+Fixes%22+is%3Aclosed>`_

1.0.0 - Notes

- Those who support **GUI on windows** will now have to set `git.Git.USE_SHELL = True` to get the previous behaviour.

* A list of all issues can be found `ongithub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v0.3.7+-+Fixes%22+is%3Aclosed>`_

* A list of all issues can be found `onGitHub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v0.3.7+-+Fixes%22+is%3Aclosed>`_

0.3.6 - Features

* Repo.working_tree_dir now returns None if it is bare. Previously it raised AssertionError.

* IndexFile.add() previously raised AssertionError when paths where used with bare repository, now it raises InvalidGitRepositoryError

* Added `Repo.merge_base()` implementation. See the `respective issue ongithub<https://github.com/gitpython-developers/GitPython/issues/169>`_

* Added `Repo.merge_base()` implementation. See the `respective issue onGitHub<https://github.com/gitpython-developers/GitPython/issues/169>`_

* `[include]` sections in git configuration files are now respected

* Added `GitConfigParser.rename_section()`

* Added `Submodule.rename()`

* A list of all issues can be found `ongithub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v0.3.6+-+Features%22+>`_

* A list of all issues can be found `onGitHub<https://github.com/gitpython-developers/GitPython/issues?q=milestone%3A%22v0.3.6+-+Features%22+>`_

0.3.5 - Bugfixes

* `Python`_ 2.7 or newer

Since GitPython 2.0.0. Please note that python 2.6 is still reasonably well supported, but might

deteriorate over time. Support is provided on a best-effort basis only.

* `Git`_ 1.7.0 or newer

It should also work with older versions, but it may be that some operations

involving remotes will not work as expected.

Another way assure proper cleanup of resources is to factor out GitPython into a

separate process which can be dropped periodically.

Best-effort for Python 2.6 and Windows support

This means that support for these platforms is likely to worsen over time

as they are kept alive solely by their users, or not.

Getting Started

Issue Tracker

The issue tracker is hosted bygithub:

The issue tracker is hosted byGitHub:

https://github.com/gitpython-developers/GitPython/issues

Roadmap

The full list of milestones including associated tasks can be found ongithub:

The full list of milestones including associated tasks can be found onGitHub:

https://github.com/gitpython-developers/GitPython/issues

Select the respective milestone to filter the list of issues accordingly.

fromgit.compatimport (

is_win,

)

fromgit.excimportCommandError

fromgit.odictimportOrderedDict

fromgit.utilimportis_cygwin_git,cygpath,expand_path

from .excimport (

)

execute_kwargs=set(('istream','with_extended_output',

'with_exceptions','as_process','stdout_as_string',

'output_stream','with_stdout','kill_after_timeout',

'universal_newlines','shell','env'))

execute_kwargs={'istream','with_extended_output','with_exceptions',

'as_process','stdout_as_string','output_stream',

'with_stdout','kill_after_timeout','universal_newlines',

'shell','env'}

log=logging.getLogger(__name__)

log.addHandler(logging.NullHandler())

defslots_to_dict(self,exclude=()):

returndict((s,getattr(self,s))forsinself.__slots__ifsnotinexclude)

return{s:getattr(self,s)forsinself.__slots__ifsnotinexclude}

defdict_to_slots_and__excluded_are_none(self,d,excluded=()):

PROC_CREATIONFLAGS= (CREATE_NO_WINDOW|subprocess.CREATE_NEW_PROCESS_GROUP

ifis_winandsys.version_info>= (2,7)

else0)

ifis_winelse0)

classGit(LazyMixin):

defreadlines(self,size=-1):

ifself._nbr==self._size:

whileTrue:

line=self.readline()

deftransform_kwargs(self,split_single_char_options=True,**kwargs):

kwargs=OrderedDict(sorted(kwargs.items(),key=lambdax:x[0]))

fork,vinkwargs.items():

ifisinstance(v, (list,tuple)):

return [arg_list.encode(defenc)]

return [str(arg_list)]

forarginarg_list:

ifisinstance(arg_list, (list,tuple)):

outlist.extend(cls.__unpack_args(arg))

exec_kwargs=dict((k,v)fork,vinkwargs.items()ifkinexecute_kwargs)

opts_kwargs=dict((k,v)fork,vinkwargs.items()ifknotinexecute_kwargs)

exec_kwargs={k:vfork,vinkwargs.items()ifkinexecute_kwargs}

opts_kwargs={k:vfork,vinkwargs.items()ifknotinexecute_kwargs}

insert_after_this_arg=opts_kwargs.pop('insert_kwargs_after',None)

fromgit.compatimport (

string_types,

with_metaclass,

)

fromgit.odictimportOrderedDict

fromgit.utilimportLockFile

importos.pathasosp

__slots__=tuple()

__slots__= ()

classIndex(object):

args.append("--abbrev=40")# we need full shas

args.append("--full-index")# get full index paths, not only filenames

exceptOSError:

self.entries=dict()

self.entries={}

finally:

ifnotok:

iflen(treeish)==0orlen(treeish)>3:

raiseValueError("Please specify between 1 and 3 treeish, got %i"%len(treeish))

iflen(treeish)>1:

is_unmerged_blob=lambdat:t[0]!=0

forstage,blobinself.iter_blobs(is_unmerged_blob):

path_map.setdefault(blob.path,list()).append((stage,blob))

path_map.setdefault(blob.path,[]).append((stage,blob))

forlinmviter(path_map):

l.sort()

def_preprocess_add_items(self,items):

foriteminitems:

ifisinstance(item,string_types):

def_entries_for_paths(self,paths,path_rewriter,fprogress,entries):

ifpath_rewriter:

forpathinpaths:

ifosp.isabs(path):

paths,entries=self._preprocess_add_items(items)

def_items_to_rela_paths(self,items):

foriteminitems:

ifisinstance(item, (BaseIndexEntry, (Blob,Submodule))):

paths.append(self._to_relative_path(item.path))

ifnotworking_tree:

args.append("--cached")

args.append("--")

ifskip_errors:

args.append('-k')

mvlines=self.repo.git.mv(args,paths,**kwargs).splitlines()

stderr=stderr.decode(defenc)

endings= (' already exists',' is not in the cache',' does not exist at stage',' is unmerged')

forlineinstderr.splitlines():

ifnotline.startswith("git checkout-index: ")andnotline.startswith("git-checkout-index: "):

proc=self.repo.git.checkout_index(args,**kwargs)

make_exc=lambda:GitCommandError(("git-checkout-index",)+tuple(args),128,proc.stderr.read())

forpathinpaths:

co_path=to_native_path_linux(self._to_relative_path(path))