o ﯪgYw@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 j4dkrddl)m5Z5nddl6m5Z5ddl7m8Z8e1rddl9m: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 < dRd d dedeed fdeed fdeed fded efdeed fdeed fded efdeeed fd ee dd fdeed fdeed fdd ffdd ZedddedfddZed d dddefdd Zd!eddfd"d#Zd$edd ffd%d& Zedejfd'd(Zedejfd)d*Z edeeeffd+d,Z!dSd.ee"e e"fd!edefd/d0Z#edefd1d2Z$e -dSd d d3eedd4fd.ee"e e"fd!ede%df d5d6Z&dSd.ee"e e"fd!ede%dfd7d8Z'ede(fd9d:Z)ede*eeffd;d<Z+ede,eeeffd=d>Z-ede*ee,effd?d@Z.ed d dAee/e0fde%dfdBdCZ1e D dTd d deeefdedEed e,dfdFe2ded efded efdGed eejfdHed eejfddfdIdJZ3dKe4ddfdLdMZ5dKe4ddfdNdOZ6ede,efdPdQZ7Z8S)Ura1Wraps 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. GIT_AUTHOR_DATEGIT_COMMITTER_DATEzi18n.commitencodingzUTF-8committype) treeauthor authored_dateauthor_tz_offset committercommitted_datecommitter_tz_offsetmessageparentsencodinggpgsighexshar8Nrepor+binshar0r1r2r3r4r5r6r7r9r:returncst||||_|durt|tsJdt||dur"||_|dur)||_|dur0||_|dur7||_ |dur>||_ |durE||_ | durL| |_ | durS| |_ | durZ| |_| dura| |_| durj| |_dSdS)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/r0r1r2r3r4r5r6r7r8r9r:)selfr<r=r0r1r2r3r4r5r6r7r8r9r: __class__N/var/www/html/chatdoc2/venv/lib/python3.10/site-packages/git/objects/commit.pyr@ms6? zCommit.__init__)r.cCs t|jSN)tupler8)clsr.rErErF_get_intermediate_itemss zCommit._get_intermediate_itemscCs>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=)rIr<r.stream streamlenistreamrErErF_calculate_sha_s   zCommit._calculate_sha_kwargsc 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|qSrE)getattr).0krBrErF sz"Commit.replace..zinvalid attribute name) __slots__ ValueErrorupdaterDr< NULL_BIN_SHArSr=)rBrTattrsattrname new_commitrErXrFreplaces  zCommit.replaceattrcsJ|tjvr|jj|j\}}|_}|t| dSt |dSrG) rrZr<rNrPr=size _deserializerreadr? _set_cache_)rBrb_binsha _typenamerPrCrErFrfs zCommit._set_cache_cCt|j|jSrG)rr2r3rXrErErFauthored_datetimezCommit.authored_datetimecCrirG)rr5r6rXrErErFcommitted_datetimerkzCommit.committed_datetimecCs0t|jtr|jdddS|jdddS)z):return: First line of the commit message rr )rAr7strsplitrXrErErFsummarys zCommit.summarypathscKsH|rt|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_listr; splitlines)rBrsrTrErErFcount 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<rvname_revrXrErErFrzs zCommit.name_revrevr*cKsjd|vrtddg}|r"t|ttjfr|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 onlyrt as_processT) r[rAroosr)rHextendrvrw_iter_from_process_or_stream)rIr<r{rsrT args_list paths_tupprocrErErF iter_items+s  zCommit.iter_itemscKs8|dd}|dkr d}||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)getrr<)rBrsrTrrErErF iter_parents_s zCommit.iter_parentscCsdttdtfdd}|js'|jjj|jdddddddd }||}n|jjj|jd j|jddddd }||}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` linesr>cSsbd}t||t|ddD]\}}|ddd}|d\}}}|d||||f7}q|S)Nrr rz %s %s %s %s )ziprurp)rtext file_infoline change_type insertions deletionsfilenamerErErF process_lines}s "z#Commit.stats..process_linesrtT)numstat no_renamesrootrawrNr)rrr) r ror8r<rv diff_treer;rxdiffr_list_from_string)rBrrrrErErFstatsts   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 insteadr) stacklevelcSsi|] \}}||dqS)rrE)rVrWvrErErFrYsz#Commit.trailers..)warningswarnDeprecationWarning trailers_dictitemsrXrErErFtrailerss  zCommit.trailerscCsgd}|jjj|dtd}|t|jdd}| }|s%gSg}| dD]}| dd\}}| | | fq,|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. )rvzinterpret-trailersz--parseT)r}rRrutf8rm:r) r<rvexecuter communicateror7encodedecodestriprpappend)rBcmdrtrailer trailer_listtkeyvalrErErF 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)rBdrrrErErFrs#zCommit.trailers_dictproc_or_streamccst|drtt|}|jdur|j}n t|dr tt|}|}|j} |}|s*n'|}t|dkr<|dd\}}t|dksHJd|||t |Vq$t|dratt|}t |dSdS)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 waitNreadlineT(rzInvalid line: %s) hasattrr%rstdoutrrrrurprr)rIr<rrPrrr;_rErErFrs0         z#Commit._iter_from_process_or_streamFparent_commitshead author_date commit_datec  Cs|durz|jjg}Wntyg}Ynw|D]} t| |s*td| d|q|} tj} |p8t| }|p?t | }t t } t oLt jdk}|rQtnt}| |jd}|rct|\}}n|rlt|\}}n| |}}| |jd}| rt| \}}n|rt|\}}n| |}}|jd\}}| |||j}t|tstdt|tr||}|||j|||||||||| }||||_|rddl}z |jj ||dW|Sty|j!j"j#||jj$|d |d}|jj%|d |dY|Sw|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 rrr.z)conf_encoding could not be coerced to str)logmsgzcommit (initial): %szcommit: Switching to %s)&rr.r[rA config_readerr~environrr4r1intr rr tm_isdstrr renv_author_daterenv_committer_date conf_encodingrp get_valuedefault_encodingro TypeErrorr0r]rSr=git.refs set_commitrefsHeadcreateref set_reference)rIr<r0r7rrr1r4rrpcrenv unix_timeis_dstoffsetauthor_date_str author_time author_offsetcommitter_date_strcommitter_timecommitter_offset enc_section enc_optionrr`rvmasterrErErFcreate_from_tree1s;            zCommit.create_from_treerPc CsT|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 |jkrb|d|j dz"|dr|d |jd d D] }|d |d dquWn tyYnw|d t|jtr||j|j |S||j|S) Nztree %s asciiz parent %s z%s %s <%s> %s %s r1r4z encoding %s r:sgpgsigrm rn)writer0rr8r1namer4emailr2rr3r9r5r6r__getattribute__r:rstriprpAttributeErrorrAr7ro) rBrPrraanamecfmtsiglinerErErFrKs`      zCommit._serializec Cs|j}t|jt|dtjd>d|_g|_d} |}|ds'|}n|j t ||jt|d dqt |j|_|}|}|}|dre|}|d r`|}|d sX|dsP|j |_d|_|}|}|r|d d d kr||d dd |jd |_nD|d ddkr||d ddd} d} |} | sn| d dd kr| }d} n | | dd7} q| d |jd |_| rqr|}|stzt| |jd\|_|_|_Wntytjd||jddYnwzt| |jd\|_|_|_Wnty#tjd||jddYnw||_z |j |jd|_W|StyKtjd|j|jddY|Sw)Nr rrTsparentrrs mergetag  r s encoding ignoresgpgsig rnFraz3Failed 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<rrptree_idr0r8 startswithrr/rrHrr9r:rfindrrr1r2r3UnicodeDecodeError_loggererrorr4r5r6rer7) rBrPr next_line parent_line author_linecommitter_lineencbufsigis_next_headersigbufrErErFrds& *    $       zCommit._deserializecCs8g}|jrtd|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: (.*) <(.*?)>$)r7refindall MULTILINErr)rB co_authorsresultsr1rErErFr xs zCommit.co_authors) NNNNNNNNNNN)rr)NFNNNN)9__name__ __module__ __qualname____doc__rrrrr/r(__annotations__rZ_id_attribute_r!bytesr$rrrfloatror@ classmethodr"rJrSrrarfpropertydatetimerjrlrqr)ryrzrrrrrrrr rrrrrboolrrrKrdr  __classcell__rErErCrFrCs              Z $   (33'$0      ";j)B__all__ collectionsrriorloggingr~r subprocessrrsysr rrr r rgitdbr git.cmdr git.diffrgit.utilrrrrrrrr0rutilrrrrrrtypingrrrrr r!r"r#r$r% version_infor(typing_extensions git.typesr)rr*git.repor+ getLoggerr rObjectrrErErErFs8        0