o ﯪg&] @sdZgdZddlmZmZddlZddlmZddlmZm Z m Z ddl Z ddl m Z ddlZddlZddlmZmZmZdd lmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!dd l"m#Z#m$Z$erdd l%m&Z&m'Z'dd l(m)Z)dd l"m*Z*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5m6Z6neZ*ddZ+GdddeZ7edddZ8eeeddfdfZ9e dZ:dee;ed"e;deed#ed$ed%ed&ffd'd(Z?d)ee7}q |S)aConvert mode bits from an octal mode string to an integer mode for git. :param modestr: String like ``755`` or ``644`` or ``100644`` - only the last 6 chars will be used. :return: String identifying a mode compatible to the mode methods ids of the :mod:`stat` module regarding the rwx permissions for user, group and other, special flags and file system flags, such as whether it is a symlink. r N) enumeratereversedr!r strr?)rDmode iterationcharr2r2r4mode_str_to_int[s  rNobject_type_namer,r.r0r+cCsx|dkr ddlm}|jS|dkrddlm}|jS|dkr'ddlm}|jS|dkr4dd lm}|jSt d | ) aRetrieve the Python class GitPython uses to represent a kind of Git object. :return: A type suitable to handle the given as `object_type_name`. This type can be called create new instances. :param object_type_name: Member of :attr:`Object.TYPES `. :raise ValueError: If `object_type_name` is unknown. scommitr*)commitstag)tagsblob)blobstree)treez%Cannot handle unknown object type: %s) rPr,rQr.rRr+rSr0 ValueErrordecode)rOrPrQrRrSr2r2r4ros    rutctzcCs:t|}t|ddt|dd}|dkr|S| S)zConvert a git timezone offset into a timezone offset west of UTC in seconds (compatible with :attr:`time.altzone`). :param utctz: git utc timezone string, e.g. +0200 d<r )r?abs)rW int_utctzsecondsr2r2r4rs raltzcCs:t|d}t|dd}|dkrdnd}d|||S)zConvert a timezone offset west of UTC in seconds into a Git timezone offset string. :param altz: Timezone offset in seconds west of UTC. rYrZ-+z {}{:02}{:02})r[format)r^hoursminutessignr2r2r4rs roffsetcCsdtd|}t|dkr||ddvr||dtvs.|dtvs.|dtvs.|dtvr0||S) z] :raise ValueError: If `offset` is incorrect. :return: `offset` z"Invalid timezone offset format: %sr z+-r*rG)rUlenr)refmt_excr2r2r4rs   0rc@seZdZddededefddfddZdeedeeefffddZ d ee dfde fd d Z d ee dfdefd d Z d ee dfde fddZdS)r Nsecs_west_of_utcnamerEcCst| d|_|p d|_dS)N)r]fixed)r_offset_name)selfrkrlr2r2r4__init__sztzoffset.__init__cCst|j |jffSr1)r rn total_secondsrorpr2r2r4 __reduce__sztzoffset.__reduce__dtcC|jSr1)rnrprur2r2r4 utcoffsetztzoffset.utcoffsetcCrvr1)rorwr2r2r4tznameryztzoffset.tznamecCstSr1)ZEROrwr2r2r4dstr5z tzoffset.dstr1)r<r=r>floatr rJrqrrrtrrrxrzr|r2r2r2r4r s  "r UTC timestamp tz_offsetcCs8t|t}z |t|}|WSty|YSw)z[Convert a `timestamp` + `tz_offset` into an aware :class:`~datetime.datetime` instance.)r fromtimestampr astimezoner rU)rrutc_dtlocal_dtr2r2r4from_timestamps  r string_datec Cs"t|tr(|jr!tt|}t| }t|t  |fSt d|z| ddkrU| ddkrU|\}}|drH|dd}t|}|tt|fWSd}|d d vrkt|d d}|dd }t|}g}d}d |vr|d | d}n"|d|d|d|d| d}|dkr| d}|dksJ||dd}|d|} t|d} |D]2} z't| | } t| j| j| j| j| j| j| j| j| jf } t| |fWWSt yYqwt dt y}z t d|dt!||d}~ww)a Parse the given date as one of the following: * Aware datetime instance * Git internal format: timestamp offset * :rfc:`2822`: ``Thu, 07 Apr 2005 22:13:13 +0200`` * ISO 8601: ``2005-04-07T22:13:13`` - The ``T`` can be a space as well. :return: Tuple(int(timestamp_UTC), int(offset)), both in seconds since epoch :raise ValueError: If the format could not be understood. :note: Date can also be ``YYYY.MM.DD``, ``MM/DD/YYYY`` and ``DD.MM.YYYY``. z,string_date datetime object without tzinfo,  r*:@Nz+0000z-+rF,z %a, %d %b %Yz%Y-%m-%dz%Y.%m.%dz%m/%d/%Yz%d.%m.%YTz%H:%M:%Szno format matchedz!Unsupported date format or type: z, type=)" isinstancerrr!rrxr?rrrr rrUcountrfindsplit startswithrrappendtimestrptimecalendartimegmtm_yeartm_montm_mdaytm_hourtm_mintm_sectm_wdaytm_ydaytm_isdst Exceptiontype)rrxrer offset_str timestamp_int date_formatssplitter time_part date_parttstructfmtdtstructutctimeer2r2r4rst                   rz^.+? (.*) (\d+) ([+-]\d+).*$z ^.+? (.*)$linecCs`d\}}}t|}|r|\}}}nt|}|r |dn|p#d}t|t|t|fS)zParse out the actor (author or committer) info from a line like:: author Tom Preston-Werner 1191999972 -0700 :return: [Actor, int_seconds_since_epoch, int_timezone_offset] )rT0rr*rT) _re_actor_epochsearchgroups_re_only_actorgroupr _from_stringr?r)ractorepochremr2r2r4rFs   rc@s<eZdZdZdZdddeddfdd Zd edefd d ZdS) ra%Class wiring all calls to the contained Process instance. Use this type to hide the underlying process to provide access only to a specified stream. The process is usually wrapped into an :class:`~git.cmd.Git.AutoInterrupt` class to kill it if the instance goes out of scope. )_proc_streamprocessr' stream_namerENcCs||_t|||_dSr1)rgetattrr)rprrr2r2r4rqhszProcessStreamAdapter.__init__attrcCs t|j|Sr1)rr)rprr2r2r4 __getattr__ls z ProcessStreamAdapter.__getattr__) r<r=r>__doc__ __slots__rJrqrrr2r2r2r4r^s rc@seZdZdZdZeedededfddZ edededefd d Z d#d e dedede e d fddZedededefddZddddddddd fdee ddefege fdee ddefege fdede de ded e de ee deeffd d!Zd"S)$rauSimple interface to perform depth-first or breadth-first traversals in one direction. Subclasses only need to implement one function. Instances of the subclass must be hashable. Defined subclasses: * :class:`Commit ` * :class:`Tree ` * :class:`Submodule ` r2r9rEcCtd)aA :return: Tuple of items connected to the given item. Must be implemented in subclass. class Commit:: (cls, Commit) -> Tuple[Commit, ...] class Submodule:: (cls, Submodule) -> Iterablelist[Submodule] class Tree:: (cls, Tree) -> Tuple[Tree, ...] To be implemented in subclassNotImplementedError)clsr9r2r2r4_get_intermediate_items z#Traversable._get_intermediate_itemsargskwargscO tjdtdd|j|i|S)zTraverse self and collect all items found. Calling this directly on the abstract base class, including via a ``super()`` proxy, is deprecated. Only overridden implementations should be called. zlist_traverse() method should only be called from subclasses. Calling from Traversable abstract class will raise NotImplementedError in 4.0.0. The concrete subclasses in GitPython itself are 'Commit', 'RootModule', 'Submodule', and 'Tree'.rg stacklevel)warningswarnDeprecationWarning_list_traverserprrr2r2r4 list_traverse zTraversable.list_traverseFas_edge)r,r-r0r+cOsXt|tr |j}nd}|s t|}||j|d|i||St|j|i|}|S)ajTraverse self and collect all items found. :return: :class:`~git.util.IterableList` with the results of the traversal as produced by :meth:`traverse`:: Commit -> IterableList[Commit] Submodule -> IterableList[Submodule] Tree -> IterableList[Union[Submodule, Tree, Blob]] rTr)rr#_id_attribute_rextendtraverse)rprrridoutout_listr2r2r4rs zTraversable._list_traversecOr)zIterator yielding items found when traversing self. Calling this directly on the abstract base class, including via a ``super()`` proxy, is deprecated. Only overridden implementations should be called. ztraverse() method should only be called from subclasses. Calling from Traversable abstract class will raise NotImplementedError in 4.0.0. The concrete subclasses in GitPython itself are 'Commit', 'RootModule', 'Submodule', and 'Tree'.rgr)rrr _traverserr2r2r4rrzTraversable.traversecCdSNTr2idr2r2r4zTraversable.cCrNFr2rr2r2r4rrrTr* predicater+pruner7 branch_first visit_once ignore_selfr8c #st}t} | tdddttdddtdtddf fd d } | rr| \} } |r4|vr4q$|r;||rB| f} n} || | rJq$|oOu}|sZ|| | rZ| V| d }|d krg||krgq$| | ||| s&dSdS) aIterator yielding items found when traversing `self`. :param predicate: A function ``f(i,d)`` that returns ``False`` if item i at depth ``d`` should not be included in the result. :param prune: A function ``f(i,d)`` that returns ``True`` if the search should stop at item ``i`` at depth ``d``. Item ``i`` will not be returned. :param depth: Defines at which level the iteration should not go deeper if -1. There is no limit if 0, you would effectively only get `self`, the root of the iteration. If 1, you would only get the first level of predecessors/successors. :param branch_first: If ``True``, items will be returned branch first, otherwise depth first. :param visit_once: If ``True``, items will only be returned once, although they might be encountered several times. Loops are prevented that way. :param ignore_self: If ``True``, `self` will be ignored and automatically pruned from the result. Otherwise it will be the first item to be returned. If `as_edge` is ``True``, the source of the first edge is ``None``. :param as_edge: If ``True``, return a pair of items, first being the source, second the destination, i.e. tuple(src, dest) with the edge spanning from source to destination. :return: Iterator yielding items found when traversing `self`:: Commit -> Iterator[Union[Commit, Tuple[Commit, Commit]] Submodule -> Iterator[Submodule, Tuple[Submodule, Submodule]] Tree -> Iterator[Union[Blob, Tree, Submodule, Tuple[Union[Submodule, Tree], Union[Blob, Tree, Submodule]]] ignore_self=True is_edge=True -> Iterator[item] ignore_self=True is_edge=False --> Iterator[item] ignore_self=False is_edge=True -> Iterator[item] | Iterator[Tuple[src, item]] ignore_self=False is_edge=False -> Iterator[Tuple[src, item]] r Nstacksrc_itemrrr7rEcshs dS|r|fddDdSfddttdddD}||dS)Nc3s|] }t|VqdSr1r6.0r)r7rr2r4 sz.addToStack..c3s |] }t|VqdSr1rrr7lstrr2r4rsr*r)r extendleftrangerir)rrrr7reviterr9rprr4 addToStacks &z)Traversable._traverse..addToStackr*r) setrrr6rboolr?popadd)rprrr7rrrrvisitedrrrr;rval skipStartItemnext_dr2rr4rsD:      zTraversable._traverseN)F)r<r=r>rr classmethodrrrrrrrr rrr TraversedTupr?rrr2r2r2r4rpsX   # c@s(eZdZdZdZd ddZd dd Zd S) SerializablezUDefines methods to serialize and deserialize objects from and into a data stream.r2streamr%rEcCr)aSerialize the data of this object into the given data stream. :note: A serialized object would :meth:`_deserialize` into the same object. :param stream: A file-like object. :return: self rrrprr2r2r4 _serializeKrzSerializable._serializecCr)zDeserialize all information regarding this object from the stream. :param stream: A file-like object. :return: self rrrr2r2r4 _deserializeZs zSerializable._deserializeN)rr%rEr)r<r=r>rrrrr2r2r2r4rCs  rcs~eZdZdZeeedfefZdededede effdd Z e dede efd d Z e ded eeeeeedfeffegefd eeeeeedfeffegefd ededededdedde efdd Z e ded eeeeeedfeffegefd eeeeeedfeffegefd ededededdedde eeedfeffdd Z e ded eeeefegefd eeeefegefd ededededdedde eeeffdd Z dddddddddfded eeeefegefd eeeefegefd edededededee ee eeefe efffdd Z ZS)rBr2NrprrrEcstj|i|Sr1)superrr __class__r2r4rksz$TraversableIterableObj.list_traversecCdSr1r2rsr2r2r4rnr5zTraversableIterableObj.traverserrr7rrrTrFcCr r1r2rprrr7rrrrr2r2r4rq cCr r1r2r r2r2r4r}r cCr r1r2r r2r2r4rr cCrrr2rr2r2r4rrzTraversableIterableObj.cCrrr2rr2r2r4rrrr*c s>tttttttdtftfft|||||||S)z5For documentation, see :meth:`Traversable._traverse`.N)r!r rrArrrr rr2r4rs")r<r=r>rrr rA TIobj_tuplerrrr"rrrr?rr$ __classcell__r2r2rr4rBfs"&&  &&     )Pr__all__abcr rr collectionsrrrrrestringrrrgit.utilr rrtypingrrrrrrrrrrr r!r" git.typesr#r$ior%r& subprocessr'r(r)rRr+rPr,submodule.baser-rQr.rSr/r0r6rArr{bytesrJr?rNrrr}rrr r rrcompilerrrrrrrBr2r2r2r4sn  <       #   " d S"