|dS ) 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)Commitc Z e Zd ZU dZdZdZdZdZdZe d e
d< dZ d Z d=d d d
e
deed
f deed
f deed
f ded
ef deed
f deed
f ded
ef deee
d
f deed d
f deed
f deed
f dd
f fd
Zedd ded fd Zed d dd de
fd Zd edd fd Zd edd
f fd! Z e de j fd" Z e de j fd# Z e deee
f fd$ Z!d>d&ee"ee" f d edefd'Z#e defd( Z$e d>d d d)eed d*f d&ee"ee" f d ede%d f
d+ Z&d>d&ee"ee" f d ede%d fd,Z'e de(fd- Z)e de*eef fd. Z+e de,eeef fd/ Z-e de*ee,e f fd0 Z.ed d d1ee/e0f de%d fd2 Z1e d?d d deeef ded4ed
e,d f d5e2ded
ef ded
ef d6ed
ee j f d7ed
ee j f dd fd8 Z3d9e4dd fd:Z5d9e4dd fd;Z6e de,e fd< Z7 xZ8S )@r* 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.GIT_AUTHOR_DATEGIT_COMMITTER_DATEzi18n.commitencodingzUTF-8committype) treeauthor
authored_dateauthor_tz_offset committercommitted_datecommitter_tz_offsetmessageparentsencodinggpgsighexshaNrepor( binshar0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: returnc t t | || || _ |/t |t
sJ dt
| z ||| _ ||| _ ||| _ ||| _
||| _ ||| _ | | | _
|
|
| _ | | | _ | | | _ |
|
| _ dS dS )a Instantiate 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__r=
isinstancer
r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: )selfr< r= r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: __class__s d/builddir/build/BUILD/cloudlinux-venv-1.0.12/venv/lib/python3.11/site-packages/git/objects/commit.pyrA zCommit.__init__` s d fd$$T6222 dD)) b b+UX\]aXbXb+b b b) DI DK $!.D '$4D ! &DN %"0D *':D $ "DL "DL $DM DKKK )r* .c * t |j S N)tupler8 )clsr. s rE _get_intermediate_itemsz Commit._get_intermediate_items s V^$$$rF c t }| | | }| d |j t
| j || }|j S )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
_serializetellseekodbstorer r/ r= )rJ r< r. stream streamlenistreams rE _calculate_sha_zCommit._calculate_sha_ sf &!!!KKMM A(..9f!E!EFF~ rF kwargsc fd j D }|D ]}| j vrt d | | j j j fi |} 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.
c 2 i | ]}|t | S )getattr).0krC s rE
z"Commit.replace.. s% ===GD!$$===rF zinvalid attribute name) __slots__
ValueErrorupdaterD r< NULL_BIN_SHArU r= )rC rV attrsattrname
new_commits ` rE replacezCommit.replace s >===dn=== ; ;Ht~-- !9::: . V #T^DIt/@JJEJJ
0 0J G G
rF attrc < |t j v rd| j j | j \ }}| _ }| t | d S t t | | d S rH ) r* r^ r< rP rR r= size _deserializer readr@ _set_cache_)rC rf _binsha _typenamerR rD s rE rk zCommit._set_cache_ s 6# # #48IM4H4H4U4U 1GY 6 gfkkmm 4 4 5 5 5 5 5 &$ + +D 1 1 1 1 1rF c 6 t | j | j S rH )r r2 r3 rC s rE authored_datetimezCommit.authored_datetime s d 0$2GHHHrF c 6 t | j | j S rH )r r5 r6 ro s rE committed_datetimezCommit.committed_datetime s d 143KLLLrF c t | j t r!| j dd d S | j dd d S )z):return: First line of the commit message
r r
)rB r7 strsplitro s rE summaryzCommit.summary sR dlC ( ( 3<%%dA..q1 1<%%eQ//2 2rF pathsc |r>t | j j j | j d|fi | S t | j j j | j fi | S )a Count 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--)lenr< gitrev_listr;
splitlines)rC rz rV s rE countz Commit.count s} `-ty}-dk4QQ&QQ\\^^__ _)49=)$+@@@@KKMMNNNrF c @ | j j | S )z
:return:
String describing the commits hex sha based on the closest Reference.
Mostly useful for UI purposes)r< r~ name_revro s rE r zCommit.name_rev s y}%%d+++rF revr) c d|v rt d dg}|rIt |t t j f r|f}nt | }| | |j j ||fddi|}| || S )an Find 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 onlyr|
as_processT)
r_ rB rv osr& rI extendr~ r _iter_from_process_or_stream)rJ r< r rz rV args_list paths_tupprocs rE
iter_itemszCommit.iter_items s * v [\\ \ &*F (%#r{!344
) "H !%LL Y ' ' ' !tx iKKDKFKK//d;;;rF c r | dd }|dk rd}||d< | j | j | |fi |S )aA Iterate _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 )getr r< )rC rz rV r s rE iter_parentszCommit.iter_parents1 sN zz&!$$ 199D v tty$@@@@@rF c | j st| j j | j dddd }d}| dd D ])}| d \ }}}||d|d|dz
}*|}n9| j j | j d j | j ddd
}t j | 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.Statsr| T)numstat
no_renamesrootry r N rt r )r r )
r8 r< r~ diff_treer; r rw diffr _list_from_string)rC texttext2line
insertions deletionsfilenames rE statsz Commit.statsA s | p9=**4;dW[bf*ggDE ))!""-
L
L48JJt4D4D1Y:::yyy(((KKDD9=%%dl1o&.\ s/
1Aqt
rF )
trailers_dictitemsro s rE trailerszCommit.trailersR s2
$ 2 8 8 : :
rF c g d}| j j |dt }| t | j d d }| }|sg S g }|
d D ]V}|
dd \ }}| | | f W|S ) a Get 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.
)r~ zinterpret-trailersz--parseT)r rT r utf8rt :r ) r< r~ executer communicaterv r7 encodedecodestriprw append)rC cmdr trailer trailer_listtkeyvals rE
trailers_listzCommit.trailers_list` s F 766"&)-"7"7VZ"7"["[''DL(9(9(@(@(B(BCCAFMMfUU--// I t$$ < 6 * * $ !% 8 8N $0'.
^Z
0
0 $ !"n 5 5N#F? 08::D
ZZ\\F6{{R JJtQ / / v;;"$$$&86&A$$$#dJv . .// / / / 0 >6 * * - !% 8 8N ^ , , , , , - -rF Fparent_commitshead author_date commit_datec
n |! |j j g}n<# t $ r g }Y n.w xY w|D ]'}
t |
| st d|
d| (| } t
j } |pt j | }|pt j | }t t }
t ot j dk }|rt nt }| | j d }|rt' | \ }}n|rt' | \ }}n|
|}}| | j d }| rt' | \ }}n|rt' | \ }}n|
|}}| j d \ }}| ||| j }t |t2 st5 d t |t2 r| | } | || j |||||||||| }| || |_ |rddl } |j || n_# t $ rR |j! j" # ||j j$ |d |z }|j % |d
|z Y nw xY w|S ) a2 Commit 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 r ry .z)conf_encoding could not be coerced to str)logmsgzcommit (initial): %szcommit: Switching to %s)&r r. r_ rB
config_readerr environr r4 r1 intr r r tm_isdstr r r env_author_dater env_committer_date
conf_encodingrw get_valuedefault_encodingrv TypeErrorr0 ra rU r= git.refs
set_commitrefsHeadcreateref
set_reference) rJ r< r0 r7 r r r1 r4 r r pcrenv unix_timeis_dstoffsetauthor_date_str author_time
author_offsetcommitter_date_strcommitter_timecommitter_offset enc_section
enc_optionr rd r~ masters rE create_from_treezCommit.create_from_tree sJ V !
$"&)"2!3
$
$
$!#
$
$
U
U!!S)) U$%Sq%S%Sc%S%STTTU
!
!j 4 !4!4 +5<++ KK 6ikk 2Q 6 "0 ''#"5r:: ;)3K)@)@ &K
;)3O)D)D &K )2F K !WWS%;R @ @ A/9+/F/F ,N , ,
A/9:L/M/M ,N , ,/8& ,N #&"3"9"9#">"> Z [*c>RSS
--- I GHH H dC #99T??D S
/ /j A A
[
OOO
[ $$Z$@@@@
[
[
[ --IM 1G; . ''7PSY7Y'ZZZZZ
[ s
!!9 I AJ21J2rR c
B |j } |d| j z d | j D ]#} |d|z d $| j }|j }| j }d} ||d||j | j t | j
fz | j |j } ||d||j | j t | j
fz | j | j | j k r& |d| j z d | d r_ |d | j d
d
D ]&} |d |z d
z d 'n# t& $ r Y nw xY w |d t) | j t, r) || j | j n || j | S )
Nztree %s
asciiz
parent %s
z%s %s <%s> %s %s
r1 r4 z encoding %s
r: s gpgsigrt ru )writer0 r r8 r1 namer4 emailr2 r r3 r9 r5 r6 r __getattribute__r: rstriprw AttributeErrorrB r7 rv ) rC rR r r aanamecfmtsiglines rE rM zCommit._serializey sh
{TY&..w77888 7 7A E=1$,,W55 6 6 6 6 K N"
G&%d&;<< fT]##
G'%d&>?? fT]##
=D 1 1 1 E?T]2::7CC D D D $$X..
Bi #{ 1 1$ 7 7 = =d C C B BGE3=4/77@@AAAA D e dlC ( ( E$,%%dm44 5 5 5 5 E$, s =F>c
X |j }t | j t | d t j dz d | _ g | _ d} | }| d s|}no| j t | | j t | d d t | j | _ |} | } | }| d rS | }| d
r | }| d
| d S| j
| _ d| _ |}| }|r|d d d
k r?|| d
dz d | j d | _ n|d d dk r|| d
dz d dz } d}
| } | sn3| d d d
k r| }d}
n| | dd z
} @| d | j d | _ |
r | }| t' | | j d \ | _ | _ | _ n3# t. $ r& t0 d|| j d Y nw xY w t' | | j d \ | _ | _ | _ n3# t. $ r& t0 d|| j d Y nw xY w| | _ | j | j d | _ n8# t. $ r+ t0 d| j | j d Y nw xY w| 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 ry NTs parentr s mergetag r
s encoding ignore s gpgsig ru Fre 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) r r
r< r rw tree_idr0 r8
startswithr r/ r rI r r9 r: r findr r r1 r2 r3 UnicodeDecodeErrorlogerrorr4 r5 r6 rj r7 ) rC rR r next_line parent_line author_linecommitter_lineencbufsigis_next_headersigbufs rE ri zCommit._deserialize s
?Jxxzz/?/?/A/A!/D$E$Et|WYGY[]^^ l"(**K )))44
' L
T
49jARARATATUWAXA_A_`gAhAh6i6i j j k k k
l T\** ! HJJ ""<00 '
I&&t,,
' $HJJ &&t,,
' ""<00 ' -
iikk %1R4yL(( #CHHTNNQ$6$8$8 9 @ @ PX Y Y
QqSZ''#((4..1,../%7!&& %XZZF! ac{d** $llnn)- 6!"":%C& "jj / / 6 6t}h O O ! (**""$$C' %,
%[%7%7
y%Q%QRR
"%%! IIE
%^%:%:4=)%T%TUU
#((! IIH
{{}} <..t}iHHDLL! IIA
s6 ;L -L?>L?;M? ?-N/.N/ %O2 22P'&P'c g }| j rFt j d| j t j }|D ] }| t | |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: (.*) <(.*?)>$)r7 refindall MULTILINEr r )rC
co_authorsresultsr1 s rE r zCommit.co_authors! sc
< 2j1 G
"
2
2!!%.1111rF ) NNNNNNNNNNN)ry )NFNNNN)9__name__
__module__ __qualname____doc__r r r r r/ r' __annotations__r^ _id_attribute_bytesr" r
r r floatrv r rA classmethodr! rK rU r re rk propertydatetimerp rr rx r& r r r r r r r r% r r r r r r r boolr r rM ri r
__classcell__)rD s @rE r* r* = s C C (O- *M 'D'(
&&& I N #'%)*./3(,+/26+/37%)#' K! K!K! K! D$J K!
eTk" K! S$Y'
K! e ,K! %K! c4i(K! #4; /K! sE4'(K! x)4/0K! T "K! c4i K!
K! K! K! K! K! K!Z %X %%
:N % % % [%
6
8
[
&2 2 2 2 2 2 2 2 I8#4 I I I XI MH$5 M M M XM 3sEz* 3 3 3 X3O O58H+=!=> Os OWZ O O O O" ,# , , , X,
68 (< (<(< 3"55
6(< Xx 112 (<
(<
(
(< (< (< [(r5 s " " " " " " " " ? ? ? ? ? ? ? ? ? ? ? ? > = = = = = = = = = = = = = # # # # # #
( ' ' ' ' ' ' ' + ****** g,-- "w"$$ % % %
w w w w w T[0(L w w w w w rF