U 楡c`j@sbddlZddlZddlmZmZddlmZddlmZm Z m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZmZmZmZmZmZdd lmZmZmZmZmZddl Z dd l!m"Z"ddl#Z#dd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.ddl/m0Z0m1Z1e,r*ddl2m3Z3ddl4m5Z5e#6dZ7e78e#9dZ:Gdddej;ee eZZ4ee/edd?d@Z5Z6S)Fr(zWraps a git Commit object. 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_offsetmessageparentsencodinggpgsighexshaNr&)repobinshar+r,r-r.r/r0r1r2r3r4r5returncstt|||||_|dk r:t|ts:tdt||dk rH||_|dk rV||_ |dk rd||_ |dk rr||_ |dk r||_ |dk r||_ | dk r| |_| dk r| |_| dk r| |_| dk r| |_| dk r| |_dS)aInstantiate a new Commit. All keyword arguments taking None as default will be implicitly set on first query. :param binsha: 20 byte sha1 :param parents: tuple( Commit, ... ) is a tuple of commit ids or actual Commits :param tree: Tree object :param author: Actor is the author Actor object :param authored_date: int_seconds_since_epoch is the authored DateTime - use time.gmtime() to convert it into a different format :param author_tz_offset: int_seconds_west_of_utc is the timezone that the authored_date is in :param committer: Actor is the committer string :param committed_date: int_seconds_since_epoch is the committed DateTime - use time.gmtime() to convert it into a different format :param committer_tz_offset: int_seconds_west_of_utc is the timezone that the committed_date is in :param message: string is the commit message :param encoding: string encoding of the message, defaults to UTF-8 :param parents: List or tuple of Commit objects which are our parent(s) in the commit dependency graph :return: git.Commit :note: Timezone information is in the same format and in the same sign as what time.altzone returns. The sign is inverted compared to git's UTC timezone.Nz(Tree needs to be a Tree instance, was %s)superr(__init__r8 isinstancer AssertionErrorr*r+r,r-r.r/r0r1r2r3r4r5)selfr7r8r+r,r-r.r/r0r1r2r3r4r5 __class__6/tmp/pip-unpacked-wheel-_pbxsds5/git/objects/commit.pyr;_s42zCommit.__init__)r(.)r)r9cCs t|jSN)tupler3)clsr)rArArB_get_intermediate_itemsszCommit._get_intermediate_items)r7r)r9cCs>t}|||}|d|jt|j||}|jS)zCalculate the sha of a commit. :param repo: Repo object the commit should be part of :param commit: Commit object for which to generate the sha r) r _serializetellseekodbstorerr*r8)rEr7r)streamZ streamlenistreamrArArB_calculate_sha_s   zCommit._calculate_sha_)kwargsr9c sbfddjD}|D]}|jkrtdq||jjjf|}j||_|S)zCreate new commit object from existing commit object. Any values provided as keyword arguments will replace the corresponding attribute in the new object. csi|]}|t|qSrA)getattr).0kr>rArB sz"Commit.replace..zinvalid attribute name) __slots__ ValueErrorupdater@r7 NULL_BIN_SHArNr8)r>rOattrsattrname new_commitrArSrBreplaces   zCommit.replace)attrr9csL|tjkr8|jj|j\}}|_}|t| nt t| |dSrC) r(rUr7rJrLr8size _deserializerreadr: _set_cache_)r>r]Z_binshaZ _typenamerLr?rArBras zCommit._set_cache_)r9cCst|j|jSrC)rr-r.rSrArArBauthored_datetimeszCommit.authored_datetimecCst|j|jSrC)rr0r1rSrArArBcommitted_datetimeszCommit.committed_datetimecCs4t|jtr|jdddS|jdddSdS)z):return: First line of the commit message r r N)r<r2strsplitrSrArArBsummarys zCommit.summary)pathsrOr9cKs@|r$t|jjj|jd|f|St|jjj|jf|S)aCount the number of commits reachable from this commit :param paths: is 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 git-rev-list. They must not alter the output style of the command, or parsing will yield incorrect results :return: int defining the number of reachable commits--)lenr7gitrev_listr6 splitlines)r>rjrOrArArBcounts  z Commit.countcCs|jj|S)z :return: String describing the commits hex sha based on the closest Reference. Mostly useful for UI purposes)r7rmname_revrSrArArBrqszCommit.name_revr')r7revrjrOr9cKsjd|krtddg}|rDt|ttjfr2|f}nt|}|||jj||fddi|}| ||S)anFind all commits matching the given criteria. :param repo: is the Repo :param rev: revision specifier, see git-rev-parse for viable options :param paths: is an optional path or list of paths, if set only Commits that include the path or paths will be considered :param kwargs: optional keyword arguments to git rev-list where ``max_count`` is the maximum number of commits to fetch ``skip`` is the number of commits to skip ``since`` all commits since i.e. '1970-01-01' :return: iterator yielding Commit itemsprettyz<--pretty cannot be used as parsing expects single sha's onlyrk as_processT) rVr<rfosr$rDextendrmrn_iter_from_process_or_stream)rEr7rrrjrOZ args_listZ paths_tupprocrArArB iter_itemss zCommit.iter_itemscKs4|dd}|dkrd}||d<|j|j||f|S)aAIterate _all_ parents of this commit. :param paths: Optional path or list of paths limiting the Commits to those that contain at least one of the paths :param kwargs: All arguments allowed by git-rev-list :return: Iterator yielding Commit objects which are parents of selfskipr r)getryr7)r>rjrOrzrArArB iter_parents0s zCommit.iter_parentscCs|js`|jjj|jdddd}d}|ddD]&}|d\}}}|d|||f7}q2|}n |jjj|jd j|jddd }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: git.StatsrkT)numstatrootrir N z %s %s %s r)r}) r3r7rmZ diff_treer6rorgZdiffrZ_list_from_string)r>textZtext2lineZ insertionsZ deletionsfilenamerArArBstats@s z Commit.statscCsi}dddg}|jjj|dtd}|t|jd}| drT|dd}|d kr| dD]$}| d d \}}| || <qf|S) aGet the trailers of the message as dictionary Git messages can contain trailer information that are similar to RFC 822 e-mail headers (see: https://git-scm.com/docs/git-interpret-trailers). This functions 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: .. code-block:: Subject line some body information another information key1: value1 key2 : value 2 with inner spaces dictionary will look like this: .. code-block:: { "key1": "value1", "key2": "value 2 with inner spaces" } :return: Dictionary containing whitespace stripped trailer information rmzinterpret-trailersz--parseT)rtrMrrdri:r ) r7rmexecuter communicaterfr2encodedecodeendswithrgstrip)r>dcmdrxtrailerrkeyvaluerArArBtrailersQs$   zCommit.trailers)r7proc_or_streamr9ccst|dr&tt|}|jdk r>|j}nt|dr>tt|}|}|j}|}|sPq|}t|dkrt|dd\}}t|dkst d|||t |VqDt|drtt|}t |dS)a;Parse out commit information into a list of Commit objects We expect one-line per commit, and parse the actual commit information directly from our lighting fast object database :param proc: git-rev-list process instance - one sha per line :return: iterator returning Commit objectswaitNreadline(r zInvalid line: %s) hasattrr"rstdoutrrrrlrgr=rr)rEr7rrLrrr6_rArArBrws&        z#Commit._iter_from_process_or_streamF) r7r+r2parent_commitsheadr,r/ author_date commit_dater9c  Cs|dkr2z|jjg}WqZtk r.g}YqZXn(|D]"} t| |s6td| d|q6|} tj} |ptt| }|pt | }t t } t ot jdk}|rtnt}| |jd}|rt|\}}n|rt|\}}n | |}}| |jd}| rt| \}}n|rt|\}}n | |}}|jd\}}| |||j}t|tsZtdt|trp||}|||j|||||||||| }||||_|r ddl}z|jj ||dWnHtk r|j!j"j#||jj$|d |d}|jj%|d |dYnX|S) a2Commit the given tree, creating a commit object. :param repo: Repo object the commit should be part of :param 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 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. Else 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: 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 git-commit-tree for more informationNzParent commit 'z' must be of type rri.z)conf_encoding could not be coerced to str)Zlogmsgzcommit (initial): %szcommit: Switching to %s)&rr)rVr<Z config_readerruenvironrr/r,intrrrtm_isdstrrr{env_author_daterenv_committer_date conf_encodingrg get_valuedefault_encodingrf TypeErrorr+rXrNr8git.refsZ set_commitrefsZHeadcreaterefZ set_reference)rEr7r+r2rrr,r/rrpZcrenvZ unix_timeZis_dstoffsetZauthor_date_strZ author_timeZ author_offsetZcommitter_date_strZcommitter_timeZcommitter_offsetZ enc_sectionZ enc_optionrr[rmZmasterrArArBcreate_from_treesz+          zCommit.create_from_tree)rLr9c CsZ|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 dqWntk r YnX|d t|jtrL||j|j n ||j|S) Nztree %s asciiz parent %s z%s %s <%s> %s %s r,r/z encoding %s r5sgpgsigrd re)writer+rr3r,namer/emailr-rr.r4r0r1r__getattribute__r5rstriprgAttributeErrorr<r2rf) r>rLrraanamecfmtZsiglinerArArBrG?sb      zCommit._serializec Cs|j}t|jt|dtjd>d|_g|_d}|}|dsL|}qx|j t ||jt|d dq6t |j|_|}|}|}|dr|}|d r|}qq|j |_d|_|}|}|r|d d d kr||d dd |jd |_n|d ddkr||d ddd} d} |} | sNq| d dd krp| }d} q| | dd7} q>| d |jd |_| rq|}qz"t| |jd\|_|_|_Wn*tk rtjd||jddYnXz"t| |jd\|_|_|_Wn*tk rHtjd||jddYnX||_z|j |jd|_Wn,tk rtjd|j|jddYnX|S)z :param from_rev_list: if true, the stream format is coming from the rev-list command Otherwise it is assumed to be a plain data stream from our object r riNsparentrrs mergetag  r s encoding ignoresgpgsig reFTr\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)rr r7rrgZtree_idr+r3 startswithappendr*rrDrr4r5rfindrrr,r-r.UnicodeDecodeErrorlogerrorr/r0r1r`r2) r>rLrZ next_lineZ parent_lineZ author_lineZcommitter_lineencbufsigZis_next_headerZsigbufrArArBr_zs& ,    $    zCommit._deserializecCs8g}|jr4td|jtj}|D]}|t|q |S)z Search 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 Actor objects). z^Co-authored-by: (.*) <(.*?)>$)r2refindall MULTILINErr)r> co_authorsresultsr,rArArBrszCommit.co_authors) NNNNNNNNNNN)ri)ri)ri)NFNNNN)7__name__ __module__ __qualname____doc__rrrrr*r%__annotations__rUZ_id_attribute_bytesr r rrfloatrfrr; classmethodrrFrNrr\rapropertydatetimerbrcrhr$rprqrryr|rrr#rrrrwrboolrrrGr_r __classcell__rArAr?rBr(<s            M   *$/ *     ;mr()=rr subprocessrrZgitdbrZgit.utilrrrrZgit.diffr Zgit.cmdr r+r rir utilrrrrrrrrrrrruiorloggingtypingrrrrrrr r!r"r#Z git.typesr$r%Zgit.repor&rr' getLoggerr addHandler NullHandler__all__ZObjectr(rArArArBs,       0