B %dq@snddlZddlZddlmZmZddlmZddlmZm Z m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZmZmZmZmZmZdd lmZmZmZmZmZddl Z dd l!m"Z"ddl#Z#dd l$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3e.r6ddl4m5Z5ddl6m7Z7e#8dZ9e9:e#;dZdS)N)PopenPIPE)IStream) hex_to_binActorStatsfinalize_process)Diffable)Git)Tree)base) SerializableTraversableIterableObj parse_datealtz_to_utctz_strparse_actor_and_datefrom_timestamp)timedaylightaltzonetimezone localtime)BytesIO) defaultdict) AnyIOIteratorListSequenceTupleUnion TYPE_CHECKINGcastDict)PathLikeLiteral)Repo)SymbolicReferencezgit.objects.commit)Commitcs eZdZUdZdZdZdZdZdZe de d<dZ d Z dEd e eed feed feed fed efeed feed fed efeee d feedd feed feed fd d fd d ZededdddZed de dddZeddddZed dfdd ZeejdddZeejddd Z eeee fdd!d"Z!dFee"ee"feed$d%d&Z#eedd'd(Z$edGd eedd)fee"ee"fee%dd*d+d,Z&dHee"ee"fee%dd$d-d.Z'ee(dd/d0Z)ee*eefdd1d2Z+ee,eeefdd3d4Z-ee*ee,efdd5d6Z.ed ee/e0fe%dd7d8d9Z1edId eeefeed e,dfe2ed efed efed eejfed eejfdd; dd?d@Z5e4dd>dAdBZ6ee,eddCdDZ7Z8S)Jr)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/r0r1r2r3r4r5r6returncstt|||||_|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__r9 isinstancer AssertionErrorr+r,r-r.r/r0r1r2r3r4r5r6)selfr8r9r,r-r.r/r0r1r2r3r4r5r6) __class___/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/git/objects/commit.pyr<`s42zCommit.__init__)r).)r*r:cCs t|jS)N)tupler4)clsr*rArArB_get_intermediate_itemsszCommit._get_intermediate_items)r8r*r:cCs>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+r9)rDr8r*streamZ streamlenistreamrArArB_calculate_sha_s   zCommit._calculate_sha_)kwargsr:c sffddjD}x|D]}|jkrtdqW||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).0k)r?rArB sz"Commit.replace..zinvalid attribute name) __slots__ ValueErrorupdater@r8 NULL_BIN_SHArMr9)r?rNattrsattrname new_commitrA)r?rBreplaces    zCommit.replace)attrr:csL|tjkr8|jj|j\}}|_}|t| nt t| |dS)N) r)rSr8rIrKr9size _deserializerreadr; _set_cache_)r?r[Z_binsha _typenamerK)r@rArBr_s zCommit._set_cache_)r:cCst|j|jS)N)rr.r/)r?rArArBauthored_datetimeszCommit.authored_datetimecCst|j|jS)N)rr1r2)r?rArArBcommitted_datetimeszCommit.committed_datetimecCs4t|jtr|jdddS|jdddSdS)z):return: First line of the commit message r r N)r=r3strsplit)r?rArArBsummarys zCommit.summary)pathsrNr:cKs@|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 commitsz--)lenr8gitrev_listr7 splitlines)r?rirNrArArBcounts  z Commit.countcCs|jj|S)z :return: String describing the commits hex sha based on the closest Reference. Mostly useful for UI purposes)r8rkname_rev)r?rArArBroszCommit.name_revr()r8revrirNr:cKsjd|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 onlyz-- as_processT) rTr=reosr%rCextendrkrl_iter_from_process_or_stream)rDr8rprirNZ 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)getrwr8)r?rirNrxrArArB iter_parents1s zCommit.iter_parentscCs|jsf|jjj|jddddd}d}x:|ddD]&}|d\}}}|d|||f7}q6W|}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: git.Statsz--T)numstat no_renamesrootrhr N z %s %s %s r)r{r|) r4r8rkZ diff_treer7rmrfdiffrZ_list_from_string)r?textZtext2line insertionsZ deletionsfilenamerArArBstatsAs"z Commit.statscCsdd|jDS)aMGet the trailers of the message as a dictionary :note: This property is deprecated, please use either ``Commit.trailers_list`` or ``Commit.trailers_dict``. :return: Dictionary containing whitespace stripped trailer information. Only contains the latest instance of each trailer key. cSsi|]\}}|d|qS)rrA)rPrQvrArArBrR\sz#Commit.trailers..) trailers_dictitems)r?rArArBtrailersRs zCommit.trailerscCsdddg}|jjj|dtd}|t|jdd}| }|sLgSg}x8| dD]*}| d d \}}| | | fq\W|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: https://git-scm.com/docs/git-interpret-trailers). This functions 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. rkzinterpret-trailersz--parseT)rrrLrutf8rc:r ) r8rkexecuter communicaterer3encodedecodestriprfappend)r?cmdrvtrailerZ trailer_listtkeyvalrArArB trailers_list`s# zCommit.trailers_listcCs2tt}x |jD]\}}|||qWt|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: 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:: 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?drrrArArBrs$zCommit.trailers_dict)r8proc_or_streamr:ccst|dr&tt|}|jdk r>|j}nt|dr>tt|}|}|j}x\|}|sRP|}t|dkrv|dd\}}t|dkst d|||t |VqFWt|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#rstdoutrrrrjrfr>rr)rDr8rrKrrr7_rArArBrus(        z#Commit._iter_from_process_or_streamF) r8r,r3parent_commitsheadr-r0 author_date commit_dater:c  Cs|dkr2y|jjg}Wq^tk r.g}Yq^Xn,x*|D]"} t| |s8td| d|q8W|} tj} |pxt| }|pt | }t t } t ot jdk}|rtnt}| |jd}|rt|\}}n|rt|\}}n | |}}| |jd}| r t| \}}n|r t|\}}n | |}}|jd\}}| |||j}t|ts^tdt|trt||}|||j|||||||||| }||||_|rddl}y|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 rrh.z)conf_encoding could not be coerced to str)Zlogmsgzcommit (initial): %szcommit: Switching to %s)&rr*rTr=Z config_readerrsenvironrr0r-intrrrtm_isdstrrryenv_author_daterenv_committer_date conf_encodingrf get_valuedefault_encodingre TypeErrorr,rVrMr9git.refsZ set_commitrefsZHeadcreaterefZ set_reference)rDr8r,r3rrr-r0rrpcrenvZ unix_timeZis_dstoffsetZauthor_date_strZ author_timeZ author_offsetZcommitter_date_strZcommitter_timeZcommitter_offsetZ enc_sectionZ enc_optionrrYrkZmasterrArArBcreate_from_treesv+            zCommit.create_from_tree)rKr:c Csb|j}|d|jdx |jD]}|d|dq"W|j}|j}|j}d}||d||j|jt |j f|j |j}||d||j|j t |j f|j |j |jkr|d|j dyJ|dr|d x0|jd d D]}|d |d dqWWntk r(YnX|d t|jtrT||j|j n ||j|S) Nztree %s asciiz parent %s z%s %s <%s> %s %s r-r0z encoding %s r6sgpgsigrc rd)writer,rr4r-namer0emailr.rr/r5r1r2r__getattribute__r6rstriprfAttributeErrorr=r3re) r?rKrraZanamecfmtZsiglinerArArBrFysN      zCommit._serializec Cs|j}t|jt|dtjd>d|_g|_d}xD|}|dsN|}P|j t ||jt|d dq8Wt |j|_|}|}|}x*|dr|}x|d r|}qWqW|j |_d|_|}|}x|r|d d d kr||d dd |jd |_n|d ddkr||d ddd} d} xD|} | s\P| d dd kr|| }d} P| | dd7} qNW| d |jd |_| rq|}qWy"t| |jd\|_|_|_Wn*tk r tjd||jddYnXy"t| |jd\|_|_|_Wn*tk rXtjd||jddYnX||_y|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 rhNsparentrs mergetag  r s encoding ignoresgpgsig rdFTrZz3Failed 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 r8rrfZtree_idr,r4 startswithrr+rrCrr5r6rfindrrr-r.r/UnicodeDecodeErrorlogerrorr0r1r2r^r3) r?rKrZ next_lineZ parent_lineZ author_lineZcommitter_lineencbufsigZis_next_headerZsigbufrArArBr]s& .   $"" zCommit._deserializecCs<g}|jr8td|jtj}x|D]}|t|q"W|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: (.*) <(.*?)>$)r3refindall MULTILINErr)r? co_authorsresultsr-rArArBr!s zCommit.co_authors) NNNNNNNNNNN)rh)rh)rh)NFNNNN)9__name__ __module__ __qualname____doc__rrrrr+r&__annotations__rSZ_id_attribute_bytesr!r rrfloatrerr< classmethodr rErMrrZr_propertydatetimerarbrgr%rnrorrwrzrrr$rrrrrrruboolrrrFr]r __classcell__rArA)r@rBr)=s~  z>  $$ 1( *P;mr))?rr subprocessrrZgitdbrZgit.utilrrrrZgit.diffr Zgit.cmdr r,r rhr utilrrrrrrrrrrrrsiorlogging collectionsrtypingrrrrrr r!r"r#r$Z git.typesr%r&Zgit.repor'rr( getLoggerr addHandler NullHandler__all__ZObjectr)rArArArBs.        0