Oct 30, 2023 · Oct 10, 2023 · Oct 10, 2023 · Oct 10, 2023 · Oct 15, 2023 · Oct 16, 2023
diff --git a/doc/source/conf.py b/doc/source/conf.py
 # -*- coding: utf-8 -*-
 #
 # GitPython documentation build configuration file, created by
 # GitPython documentation build configuration file, originally created by
 # sphinx-quickstart on Sat Jan 24 11:51:01 2009.
 #
 # This file is execfile()d with the current directory set to its containing dir.
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, document class [howto/manual]).
 latex_documents = [
    ("index", "GitPython.tex",r"GitPython Documentation",r"Michael Trier", "manual"),
    ("index", "GitPython.tex", "GitPython Documentation", "Michael Trier", "manual"),
 ]

 # The name of an image file (relative to this directory) to place at the top of
diff --git a/doc/source/tutorial.rst b/doc/source/tutorial.rst
 you have to inform the submodule about its actual commit to retrieve the data from
 by using the ``set_parent_commit(...)`` method.

 The special :class:`RootModule <git.objects.submodule.root.RootModule>` type allows you to treat your master repository as root of a hierarchy of submodules, which allows very convenient submodule handling. Its ``update(...)`` method is reimplemented to provide an advanced way of updating submodules as they change their values over time. The update method will track changes and make sure your working tree and submodule checkouts stay consistent, which is very useful in case submodules get deleted or added to name just two of the handled cases.
 The special :class:`RootModule <git.objects.submodule.root.RootModule>` type allows you to treat yoursuperproject (master repository) as root of a hierarchy of submodules, which allows very convenient submodule handling. Its ``update(...)`` method is reimplemented to provide an advanced way of updating submodules as they change their values over time. The update method will track changes and make sure your working tree and submodule checkouts stay consistent, which is very useful in case submodules get deleted or added to name just two of the handled cases.

 Additionally, GitPython adds functionality to track a specific branch, instead of just a commit. Supported by customized update methods, you are able to automatically update submodules to the latest revision available in the remote repository, as well as to keep track of changes and movements of these submodules. To use it, set the name of the branch you want to track to the ``submodule.$name.branch`` option of the *.gitmodules*  file, and use GitPython update methods on the resulting repository with the ``to_latest_revision`` parameter turned on. In the latter case, the sha of your submodule will be ignored, instead a local tracking branch will be updated to the respective remote branch automatically, provided there are no local changes. The resulting behaviour is much like the one of svn::externals, which can be useful in times.

 There is more functionality in there, like the ability to archive repositories, get stats and logs, blame, and probably a few other things that were not mentioned here.

 Check the unit tests for an in-depth introduction on how each function is supposed to be used.

diff --git a/git/__init__.py b/git/__init__.py
 #
 # This module is part of GitPython and is released under
 # the BSD License: https://opensource.org/license/bsd-3-clause/

 # flake8: noqa
 # @PydevCodeAnalysisIgnore

 from git.exc import *  # @NoMove @IgnorePep8
 from typing import List, Optional, Sequence, Tuple, Union, TYPE_CHECKING
 from git.types import PathLike
diff --git a/git/cmd.py b/git/cmd.py
diff --git a/git/compat.py b/git/compat.py
 # -*- coding: utf-8 -*-
 # config.py
 # compat.py
 # Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
 #
 # This module is part of GitPython and is released under
 # the BSD License: https://opensource.org/license/bsd-3-clause/
 """utilities to help provide compatibility with python 3"""

 """Utilities to help provide compatibility with Python 3."""

 # flake8: noqa

 import locale


 def safe_decode(s: Union[AnyStr, None]) -> Optional[str]:
    """Safelydecodes a binary string tounicode"""
    """Safelydecode a binary string toUnicode."""
    if isinstance(s, str):
        return s
    elif isinstance(s, bytes):


 def safe_encode(s: Optional[AnyStr]) -> Optional[bytes]:
    """Safelyencodes a binary string tounicode"""
    """Safelyencode a binary string toUnicode."""
    if isinstance(s, str):
        return s.encode(defenc)
    elif isinstance(s, bytes):


 def win_encode(s: Optional[AnyStr]) -> Optional[bytes]:
    """Encodeunicodes for process arguments on Windows."""
    """EncodeUnicode strings for process arguments on Windows."""
    if isinstance(s, str):
        return s.encode(locale.getpreferredencoding(False))
    elif isinstance(s, bytes):
Original file line number	Diff line number	Diff line change
		@@ -1,6 +1,4 @@
		# -- coding: utf-8 --
		#
		# GitPython documentation build configuration file, created by
		# GitPython documentation build configuration file, originally created by
		# sphinx-quickstart on Sat Jan 24 11:51:01 2009.
		#
		# This file is execfile()d with the current directory set to its containing dir.
Expand DownExpand Up		@@ -170,7 +168,7 @@
		# Grouping the document tree into LaTeX files. List of tuples
		# (source start file, target name, title, author, document class [howto/manual]).
		latex_documents = [
		("index", "GitPython.tex",r"GitPython Documentation",r"Michael Trier", "manual"),
		("index", "GitPython.tex", "GitPython Documentation", "Michael Trier", "manual"),
		]

		# The name of an image file (relative to this directory) to place at the top of
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -413,7 +413,7 @@ If you obtained your submodule object by traversing a tree object which is not r
		you have to inform the submodule about its actual commit to retrieve the data from
		by using the ``set_parent_commit(...)`` method.

		The special :class:`RootModule <git.objects.submodule.root.RootModule>` type allows you to treat your master repository as root of a hierarchy of submodules, which allows very convenient submodule handling. Its ``update(...)`` method is reimplemented to provide an advanced way of updating submodules as they change their values over time. The update method will track changes and make sure your working tree and submodule checkouts stay consistent, which is very useful in case submodules get deleted or added to name just two of the handled cases.
		The special :class:`RootModule <git.objects.submodule.root.RootModule>` type allows you to treat yoursuperproject (master repository) as root of a hierarchy of submodules, which allows very convenient submodule handling. Its ``update(...)`` method is reimplemented to provide an advanced way of updating submodules as they change their values over time. The update method will track changes and make sure your working tree and submodule checkouts stay consistent, which is very useful in case submodules get deleted or added to name just two of the handled cases.

		Additionally, GitPython adds functionality to track a specific branch, instead of just a commit. Supported by customized update methods, you are able to automatically update submodules to the latest revision available in the remote repository, as well as to keep track of changes and movements of these submodules. To use it, set the name of the branch you want to track to the ``submodule.$name.branch`` option of the .gitmodules file, and use GitPython update methods on the resulting repository with the ``to_latest_revision`` parameter turned on. In the latter case, the sha of your submodule will be ignored, instead a local tracking branch will be updated to the respective remote branch automatically, provided there are no local changes. The resulting behaviour is much like the one of svn::externals, which can be useful in times.

Expand DownExpand Up		@@ -545,4 +545,3 @@ And even more ...
		There is more functionality in there, like the ability to archive repositories, get stats and logs, blame, and probably a few other things that were not mentioned here.

		Check the unit tests for an in-depth introduction on how each function is supposed to be used.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -3,8 +3,10 @@
		#
		# This module is part of GitPython and is released under
		# the BSD License: https://opensource.org/license/bsd-3-clause/

		# flake8: noqa
		# @PydevCodeAnalysisIgnore

		from git.exc import * # @NoMove @IgnorePep8
		from typing import List, Optional, Sequence, Tuple, Union, TYPE_CHECKING
		from git.types import PathLike
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,10 +1,11 @@
		# -- coding: utf-8 --
		# config.py
		# compat.py
		# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
		#
		# This module is part of GitPython and is released under
		# the BSD License: https://opensource.org/license/bsd-3-clause/
		"""utilities to help provide compatibility with python 3"""

		"""Utilities to help provide compatibility with Python 3."""

		# flake8: noqa

		import locale
Expand DownExpand Up		@@ -50,7 +51,7 @@ def safe_decode(s: AnyStr) -> str:


		def safe_decode(s: Union[AnyStr, None]) -> Optional[str]:
		"""Safelydecodes a binary string tounicode"""
		"""Safelydecode a binary string toUnicode."""
		if isinstance(s, str):
		return s
		elif isinstance(s, bytes):
Expand All		@@ -72,7 +73,7 @@ def safe_encode(s: AnyStr) -> bytes:


		def safe_encode(s: Optional[AnyStr]) -> Optional[bytes]:
		"""Safelyencodes a binary string tounicode"""
		"""Safelyencode a binary string toUnicode."""
		if isinstance(s, str):
		return s.encode(defenc)
		elif isinstance(s, bytes):
Expand All		@@ -94,7 +95,7 @@ def win_encode(s: AnyStr) -> bytes:


		def win_encode(s: Optional[AnyStr]) -> Optional[bytes]:
		"""Encodeunicodes for process arguments on Windows."""
		"""EncodeUnicode strings for process arguments on Windows."""
		if isinstance(s, str):
		return s.encode(locale.getpreferredencoding(False))
		elif isinstance(s, bytes):
Expand Down