a `Dfv@sdgZddlmZddlZddlmZddlZddlZddlZddl m Z m Z ddl Z ddl mZmZmZm Z mZddlZddlmZddlmZdd lmZdd lmZmZmZmZd d lmZd d l m!Z!d dl"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3e j4dkr8ddl)m5Z5n ddl6m5Z5ddl7m8Z8e1rnddl9m:Z:ddl;mZ?Gdddej@e$ee#ZAdS)Commit) defaultdictN)BytesIO)PopenPIPE)altzonedaylight localtimetimetimezone)IStream)Git)Diffable)ActorStatsfinalize_process hex_to_bin)base)Tree) SerializableTraversableIterableObjaltz_to_utctz_strfrom_timestampparse_actor_and_date parse_date) AnyDictIOIteratorListSequenceTuple TYPE_CHECKINGUnioncast))Literal)PathLike)SymbolicReference)RepocseZdZUdZdZdZdZdZdZe de d<dZ d Z e de d <dFd eeed feed feed fed efeed feed fed efeeed fee dd feed feed fd d fdd ZededdddZed dedddZeddddZed dfdd ZeejdddZeejdd d!Z eeeefdd"d#Z!dGee"e e"feed%d&d'Z#eedd(d)Z$edHd eedd*fee"e e"fee%dd+d,d-Z&dIee"e e"fee%dd%d.d/Z'ee(dd0d1Z)ee*eefdd2d3Z+ee,eeefdd4d5Z-ee*ee,efdd6d7Z.ed ee/e0fe%dd8d9d:Z1edJd eeefeed e,dfe2ed efed efed eejfed eejfdd< d=d>Z3e4dd?d@dAZ5e4dd?dBdCZ6ee,eddDdEZ7Z8S)Kra1Wraps a git commit object. See :manpage:`gitglossary(7)` on "commit object": https://git-scm.com/docs/gitglossary#def_commit_object :note: This class will act lazily on some of its attributes and will query the value on demand only if it involves calling the git binary. ZGIT_AUTHOR_DATEZGIT_COMMITTER_DATEzi18n.commitencodingzUTF-8committype) treeauthor authored_dateauthor_tz_offset committercommitted_datecommitter_tz_offsetmessageparentsencodinggpgsighexshar6Nr+)repobinshar.r/r0r1r2r3r4r5r6r7r8returncst||||_|dur6t|ts6Jdt||durD||_|durR||_|dur`||_|durn||_ |dur|||_ |dur||_ | dur| |_ | dur| |_ | dur| |_| dur| |_| dur| |_dS)aInstantiate a new :class:`Commit`. All keyword arguments taking ``None`` as default will be implicitly set on first query. :param binsha: 20 byte sha1. :param tree: A :class:`~git.objects.tree.Tree` object. :param author: The author :class:`~git.util.Actor` object. :param authored_date: int_seconds_since_epoch The authored DateTime - use :func:`time.gmtime` to convert it into a different format. :param author_tz_offset: int_seconds_west_of_utc The timezone that the `authored_date` is in. :param committer: The committer string, as an :class:`~git.util.Actor` object. :param committed_date: int_seconds_since_epoch The committed DateTime - use :func:`time.gmtime` to convert it into a different format. :param committer_tz_offset: int_seconds_west_of_utc The timezone that the `committed_date` is in. :param message: string The commit message. :param encoding: string Encoding of the message, defaults to UTF-8. :param parents: List or tuple of :class:`Commit` objects which are our parent(s) in the commit dependency graph. :return: :class:`Commit` :note: Timezone information is in the same format and in the same sign as what :func:`time.altzone` returns. The sign is inverted compared to git's UTC timezone. Nz(Tree needs to be a Tree instance, was %s)super__init__r; isinstancerr-r.r/r0r1r2r3r4r5r6r7r8)selfr:r;r.r/r0r1r2r3r4r5r6r7r8 __class___/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/git/objects/commit.pyr>ms4?zCommit.__init__)r.)r,r<cCs t|jSN)tupler6)clsr,rCrCrD_get_intermediate_itemsszCommit._get_intermediate_items)r:r,r<cCs>t}|||}|d|jt|j||}|jS)zCalculate the sha of a commit. :param repo: :class:`~git.repo.base.Repo` object the commit should be part of. :param commit: :class:`Commit` object for which to generate the sha. r) r _serializetellseekodbstorer r-r;)rGr:r,streamZ streamlenistreamrCrCrD_calculate_sha_s   zCommit._calculate_sha_)kwargsr<c sffddjD}|D]}|jvrtdq||jjjfi|}j||_|S)zCreate new commit object from an existing commit object. Any values provided as keyword arguments will replace the corresponding attribute in the new object. csi|]}|t|qSrC)getattr).0kr@rCrD z"Commit.replace..zinvalid attribute name) __slots__ ValueErrorupdaterBr: NULL_BIN_SHArPr;)r@rQattrsattrname new_commitrCrUrDreplaces   zCommit.replace)attrr<csH|tjvr8|jj|j\}}|_}|t| n t |dSrE) rrXr:rLrNr;size _deserializerreadr= _set_cache_)r@r`Z_binshaZ _typenamerNrArCrDrds zCommit._set_cache_)r<cCst|j|jSrE)rr0r1rUrCrCrDauthored_datetimeszCommit.authored_datetimecCst|j|jSrE)rr3r4rUrCrCrDcommitted_datetimeszCommit.committed_datetimecCs4t|jtr|jdddS|jdddSdS)z):return: First line of the commit message rr N)r?r5strsplitrUrCrCrDsummarys zCommit.summary)pathsrQr<cKsH|r(t|jjj|jd|fi|St|jjj|jfi|S)aCount the number of commits reachable from this commit. :param paths: An optional path or a list of paths restricting the return value to commits actually containing the paths. :param kwargs: Additional options to be passed to :manpage:`git-rev-list(1)`. They must not alter the output style of the command, or parsing will yield incorrect results. :return: An int defining the number of reachable commits --)lenr:gitrev_listr9 splitlines)r@rmrQrCrCrDcount s$z Commit.countcCs|jj|S)z :return: String describing the commits hex sha based on the closest `~git.refs.reference.Reference`. :note: Mostly useful for UI purposes. )r:rpname_revrUrCrCrDrts zCommit.name_revr*)r:revrmrQr<cKsjd|vrtddg}|rDt|ttjfr2|f}nt|}|||jj||fddi|}| ||S)aFind all commits matching the given criteria. :param repo: The :class:`~git.repo.base.Repo`. :param rev: Revision specifier. See :manpage:`git-rev-parse(1)` for viable options. :param paths: An optional path or list of paths. If set only :class:`Commit`\s that include the path or paths will be considered. :param kwargs: Optional keyword arguments to :manpage:`git-rev-list(1)` where: * ``max_count`` is the maximum number of commits to fetch. * ``skip`` is the number of commits to skip. * ``since`` selects all commits since some date, e.g. ``"1970-01-01"``. :return: Iterator yielding :class:`Commit` items. prettyz<--pretty cannot be used as parsing expects single sha's onlyrn as_processT) rYr?riosr)rFextendrprq_iter_from_process_or_stream)rGr:rurmrQZ args_listZ paths_tupprocrCrCrD iter_items+s zCommit.iter_itemscKs8|dd}|dkrd}||d<|j|j||fi|S)aIterate _all_ parents of this commit. :param paths: Optional path or list of paths limiting the :class:`Commit`\s to those that contain at least one of the paths. :param kwargs: All arguments allowed by :manpage:`git-rev-list(1)`. :return: Iterator yielding :class:`Commit` objects which are parents of ``self`` skiprr)getr|r:)r@rmrQr}rCrCrD iter_parents_s  zCommit.iter_parentscCs|jsb|jjj|jddddd}d}|ddD]&}|d\}}}|d|||f7}q4|}n"|jjj|jd j|jdddd }t |j|S) zCreate a git stat from changes between this commit and its first parent or from all changes done if this is the very first commit. :return: :class:`Stats` rnT)numstat no_renamesrootrlrN z %s %s %s r)rr) r6r:rpZ diff_treer9rrrjdiffrZ_list_from_string)r@textZtext2lineZ insertionsZ deletionsfilenamerCrCrDstatsts"z Commit.statscCs$tjdtdddd|jDS)alDeprecated. Get the trailers of the message as a dictionary. :note: This property is deprecated, please use either :attr:`trailers_list` or :attr:`trailers_dict`. :return: Dictionary containing whitespace stripped trailer information. Only contains the latest instance of each trailer key. zWCommit.trailers is deprecated, use Commit.trailers_list or Commit.trailers_dict instead) stacklevelcSsi|]\}}||dqS)rrC)rSrTvrCrCrDrVrWz#Commit.trailers..)warningswarnDeprecationWarning trailers_dictitemsrUrCrCrDtrailerss zCommit.trailerscCsgd}|jjj|dtd}|t|jdd}| }|sJgSg}| dD]*}| dd\}}| | | fqX|S) aGet the trailers of the message as a list. Git messages can contain trailer information that are similar to :rfc:`822` e-mail headers. See :manpage:`git-interpret-trailers(1)`. This function calls ``git interpret-trailers --parse`` onto the message to extract the trailer information, returns the raw trailer data as a list. Valid message with trailer:: Subject line some body information another information key1: value1.1 key1: value1.2 key2 : value 2 with inner spaces Returned list will look like this:: [ ("key1", "value1.1"), ("key1", "value1.2"), ("key2", "value 2 with inner spaces"), ] :return: List containing key-value tuples of whitespace stripped trailer information. )rpzinterpret-trailersz--parseT)rwrOrutf8rg:r) r:rpexecuter communicaterir5encodedecodestriprjappend)r@cmdr{trailerZ trailer_listtkeyvalrCrCrD trailers_lists!zCommit.trailers_listcCs.tt}|jD]\}}|||qt|S)aGet the trailers of the message as a dictionary. Git messages can contain trailer information that are similar to :rfc:`822` e-mail headers. See :manpage:`git-interpret-trailers(1)`. This function calls ``git interpret-trailers --parse`` onto the message to extract the trailer information. The key value pairs are stripped of leading and trailing whitespaces before they get saved into a dictionary. Valid message with trailer:: Subject line some body information another information key1: value1.1 key1: value1.2 key2 : value 2 with inner spaces Returned dictionary will look like this:: { "key1": ["value1.1", "value1.2"], "key2": ["value 2 with inner spaces"], } :return: Dictionary containing whitespace stripped trailer information, mapping trailer keys to a list of their corresponding values. )rlistrrdict)r@drrrCrCrDrs#zCommit.trailers_dict)r:proc_or_streamr<ccst|dr&tt|}|jdur>|j}nt|dr>tt|}|}|j}|}|sPq|}t|dkrt|dd\}}t|dksJd|||t |VqDt|drtt|}t |dS)aParse out commit information into a list of :class:`Commit` objects. We expect one line per commit, and parse the actual commit information directly from our lighting fast object database. :param proc: :manpage:`git-rev-list(1)` process instance - one sha per line. :return: Iterator supplying :class:`Commit` objects waitNreadline(rzInvalid line: %s) hasattrr%rstdoutrrrrorjrr)rGr:rrNrrr9_rCrCrDrzs&        z#Commit._iter_from_process_or_streamF) r:r.r5parent_commitsheadr/r2 author_date commit_dater<c  Cs |dur0z|jjg}WqXty,g}YqX0n(|D]"} t| |s4td| d|q4|} tj} |prt| }|pt | }t t } t ot jdk}|rtnt}| |jd}|rt|\}}n|rt|\}}n | |}}| |jd}| rt| \}}n|rt|\}}n | |}}|jd\}}| |||j}t|tsXtdt|trn||}|||j|||||||||| }||||_|rddl}z|jj ||dWnFty|j!j"j#||jj$|d |d}|jj%|d |dYn0|S) aCommit the given tree, creating a :class:`Commit` object. :param repo: :class:`~git.repo.base.Repo` object the commit should be part of. :param tree: :class:`~git.objects.tree.Tree` object or hex or bin sha. The tree of the new commit. :param message: Commit message. It may be an empty string if no message is provided. It will be converted to a string, in any case. :param parent_commits: Optional :class:`Commit` objects to use as parents for the new commit. If empty list, the commit will have no parents at all and become a root commit. If ``None``, the current head commit will be the parent of the new commit object. :param head: If ``True``, the HEAD will be advanced to the new commit automatically. Otherwise the HEAD will remain pointing on the previous commit. This could lead to undesired results when diffing files. :param author: The name of the author, optional. If unset, the repository configuration is used to obtain this value. :param committer: The name of the committer, optional. If unset, the repository configuration is used to obtain this value. :param author_date: The timestamp for the author field. :param commit_date: The timestamp for the committer field. :return: :class:`Commit` object representing the new commit. :note: Additional information about the committer and author are taken from the environment or from the git configuration. See :manpage:`git-commit-tree(1)` for more information. NzParent commit 'z' must be of type rrl.z)conf_encoding could not be coerced to str)Zlogmsgzcommit (initial): %szcommit: Switching to %s)&rr,rYr?Z config_readerrxenvironrr2r/intr rr tm_isdstrr r~env_author_daterenv_committer_date conf_encodingrj get_valuedefault_encodingri TypeErrorr.r[rPr;git.refsZ set_commitrefsZHeadcreaterefZ set_reference)rGr:r.r5rrr/r2rrpZcrenvZ unix_timeZis_dstoffsetZauthor_date_strZ author_timeZ author_offsetZcommitter_date_strZcommitter_timeZcommitter_offsetZ enc_sectionZ enc_optionrr^rpZmasterrCrCrDcreate_from_tree'sz;           zCommit.create_from_tree)rNr<c CsX|j}|d|jd|jD]}|d|dq |j}|j}|j}d}||d||j|jt |j f|j |j}||d||j|j t |j f|j |j |jkr|d|j dzF|dr|d |jd d D]}|d |d dqWntyYn0|d t|jtrJ||j|j n ||j|S) Nztree %s asciiz parent %s z%s %s <%s> %s %s r/r2z encoding %s r8sgpgsigrg rh)writer.rr6r/namer2emailr0rr1r7r3r4r__getattribute__r8rstriprjAttributeErrorr?r5ri) r@rNrraanamecfmtZsiglinerCrCrDrIsb      zCommit._serializec Cs|j}t|jt|dtjd>d|_g|_d}|}|dsL|}qx|j t ||jt|d dq6t |j|_|}|}|}|dr|}|dr|}qq|j |_d|_|}|}|r|d d d kr||ddd |jd |_n|d d dkr||dddd} d} |} | sNq| d ddkrp| }d} q| | dd7} q>| d |jd |_| rq|}qz"t| |jd\|_|_|_Wn(tytjd||jddYn0z"t| |jd\|_|_|_Wn(tyDtjd||jddYn0||_z|j |jd|_Wn*tytjd|j|jddYn0|S)Nr rlsparentrs mergetag  r s encoding ignoresgpgsig rhFTr_z3Failed to decode author line '%s' using encoding %s)exc_infoz6Failed to decode committer line '%s' using encoding %sz/Failed to decode message '%s' using encoding %s)rrr:rrjZtree_idr.r6 startswithrr-rrFrr7r8rfindrrr/r0r1UnicodeDecodeError_loggererrorr2r3r4rcr5) r@rNr next_lineZ parent_lineZ author_lineZcommitter_lineencbufsigZis_next_headerZsigbufrCrCrDrbs& ,    $    zCommit._deserializecCs8g}|jr4td|jtj}|D]}|t|q |S)aSearch the commit message for any co-authors of this commit. Details on co-authors: https://github.blog/2018-01-29-commit-together-with-co-authors/ :return: List of co-authors for this commit (as :class:`~git.util.Actor` objects). z^Co-authored-by: (.*) <(.*?)>$)r5refindall MULTILINErr)r@ co_authorsresultsr/rCrCrDrns zCommit.co_authors) NNNNNNNNNNN)rl)rl)rl)NFNNNN)9__name__ __module__ __qualname____doc__rrrrr-r(__annotations__rXZ_id_attribute_r!bytesr$rrrfloatrir> classmethodr"rHrPrr_rdpropertydatetimererfrkr)rsrtrr|rrrrrr rrrrrzboolrrrIrbr __classcell__rCrCrArDrCs             Z    3$3' 0   ";j)B__all__ collectionsrriorloggingrxr subprocessrrsysr rrr r rZgitdbr Zgit.cmdr Zgit.diffrZgit.utilrrrrrlrr.rutilrrrrrrtypingrrrrr r!r"r#r$r% version_infor(Ztyping_extensionsZ git.typesr)rr*Zgit.repor+ getLoggerrrZObjectrrCrCrCrDs6        0