ZjRdZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZmZe rddlmZddlmZddlmZmZmZmZmZmZddlmZmZej>dgd Z d Z!d Z"d Z#d Z$dZ%dZ&dZ'dZ(dZ)dZ*defdZ+dZ,dBdede ede e-fdZ. dBdede e/e fde e-ddfdZ0de-de-fdZ1Gdde2Z3d d!d"eee/e/e-fde/fd#Z4d d!d$e3de/fd%Z5 dCd&ee/d'e e/gee/e-ffd d!d(e e/deeee e/e e/fee e-e e-fee e/e e/fff d)Z6 dBd*e/d+e-de e-fd,Z7 dDd.Z8d/Z9d0Z:d1Z;e:fd2ZdEd5Z?d6Z@d7ZAdBd$e3fd8ZBejjd9ZEd:e/fd;ZFd<ZGdBd=ZH dBd e d!fd>ZId?ZJdFd@ZKdAZLy)Gz%Parser for the git index file format.N) AnyBinaryIOCallableDictListOptional TYPE_CHECKINGIterableIteratorTuple)BaseObjectStore)GitFile)Blob S_IFGITLINK S_ISGITLINKTree hex_to_sha sha_to_hex) SHA1Reader SHA1Writer IndexEntry) ctimemtimedevinomodeuidgidsizeshaflagsi0ii@c\ |jdd\}}||fS#t$rd|fcYSwxYw)zSplit a /-delimited path into a directory part and a basename. Args: path: The path to split. Returns: Tuple with directory name and basename /)rsplit ValueError)pathdirnamebasenames lib/third_party/dulwich/index.py pathsplitr-TsD#"kk$2("" T{s  ++cPdj|Dcgc]}|s| c}Scc}w)zJoin a /-delimited path.r$)join)argsps r,pathjoinr2ds% 99+Aa+ ,,+s##cLtjd|jdS)zRead a cache time. Args: f: File-like object to read from Returns: Tuple with seconds and nanoseconds >LL)structunpackread)fs r,read_cache_timer:is ==q **r&c t|tr|df}nTt|tr)t|d\}}t|t|dzf}nt|ts t ||j tjdg|y)zWrite a cache time. Args: f: File-like object to write to t: Time to write (as int, float or tuple with secs and nsecs) rg?iʚ;r4N) isinstanceintfloatdivmodtuple TypeErrorwriter6pack)r9tsecsnsecss r,write_cache_timerGtsv!S F Au q# u YEJ./ 0 5 !lGGFKK " "#r&c |j}t|}t|}tjd|j d\}}}}}} } } |j | dz} |j|z dzdz} |j || z|jz | |||||||| t | | dzf S)zRead an entry from a cache file. Args: f: File-like object to read from Returns: tuple with: device, inode, mode, uid, gid, size, sha, flags z >LLLLLL20sH.ir5)tellr:r6r7r8r)r9 beginoffsetrrrrrrrrr r!name real_sizes r,read_cache_entryrPs&&(K A E A E  mQVVN%;<         6656> #DK'!+r1IFFK) #qvvx /0         3   r&c|j}|\ }}}}}}} } } } } t||t||t|| dzz} |jt j d|dz|dz|| | | t | | |j||j|z dzdz}|jd||z|jz zy)zWrite an index entry to a file. Args: f: File object entry: Entry to write, tuple with: (name, ctime, mtime, dev, ino, mode, uid, gid, size, sha, flags) rKs >LLLLLL20sHlr5rJN)rLrGlenrBr6rCr)r9entryrMrNrrrrrrrrr r!rOs r,write_cache_entryrUs&&(KGLDT5%c4c4eQQ I )EGG  *  *      sO   GGDMK'!+r1IGGEkI-9 :;r&r9c#K|jd}|dk7rtd|ztjd|jd\}}|dvsJt |D]}t |yw)z4Read an index file, yielding the individual entries.DIRCzInvalid index file header: %r>LLr5)r%r"N)r8AssertionErrorr6r7rangerP)r9headerversion num_entriesis r, read_indexr`sq VVAYF >22DNNCCr&riNct|jd} t|}t||j|j |j y#|j wxYw)z(Write current contents of index to disk.wbrkN)rr}rro_bynamer~close)rr9s r,rBz Index.write+sG DNND ) 1 A Q dmm D GGIAGGIs -AA(ctjj|jsyt |jd} t |}t |D]}t|dd||d<|jtjj|j|jz dz |j|jy#|jwxYw)z)Read current contents of index from disk.Nrbr%r) osr)existsr}rrr`rr8getsizerL check_shar)rr9rcs r,r8z Index.read4sww~~dnn-  DNND ) 1 A]'12/QqT # FF277??4>>2QVVX=B C KKM GGIAGGIs BCC-c,t|jS)z%Number of entries in this index file.)rSrrs r,__len__z Index.__len__Cs4<<  r&rNc |j|S)zRetrieve entry by relative path. Returns: tuple with (ctime, mtime, dev, ino, mode, uid, gid, size, sha, flags) rrrNs r, __getitem__zIndex.__getitem__Gs ||D!!r&c,t|jS)z%Iterate over the paths in this index.)iterrrs r,__iter__zIndex.__iter__OsDLL!!r&r)c ||jS)z6Return the (git object) SHA1 for the object at a path.)r rr)s r,get_sha1zIndex.get_sha1SsDz~~r&c ||jS)z4Return the POSIX file mode for the object at a path.rrs r,get_modezIndex.get_modeWsDzr&c#lK|D]+}||}||jt|jf-yw)z=Iterate over path, sha, mode tuples for use with commit_tree.Nr ryr)rr)rTs r, iterobjectszIndex.iterobjects[s3DJE < #;; ;s24cVddl}|jdt|jS)NrzUse iterobjects() instead.)warningswarnPendingDeprecationWarningr)rrs r, iterblobszIndex.iterblobsas$ 24MN!!r&ci|_y)z$Remove all contents from this index.Nrrs r,rz Index.cleargs  r&crt|tsJt|dk(sJt||j|<y)N )r<bytesrSrr)rrNrcs r, __setitem__zIndex.__setitem__ks4$&&&1v||'^ Tr&cBt|tsJ|j|=yr)r<rrrs r, __delitem__zIndex.__delitem__qs$&&& LL r&c6|jjSrritemsrs r, iteritemszIndex.iteritemsu||!!##r&c6|jjSrrrs r,rz Index.itemsxrr&c>|jD] \}}|||< yr)r)rrerNvalues r,updatez Index.update{s"==?KD%DJ+r&c#Kfd}tjj||||D] \}}}|||fyw)aFind the differences between the contents of this index and a tree. Args: object_store: Object store to use for retrieving tree contents tree: SHA1 of the root tree want_unchanged: Whether unchanged files should be reported Returns: Iterator over tuples with (oldpath, newpath), (oldmode, newmode), (oldsha, newsha) cP|}|jt|jfSrr)r)rTrs r, lookup_entryz-Index.changes_from_tree..lookup_entrys$JE99l5::66 6r&)want_unchangedN)changes_from_treerkeys)r object_storetreerrrNrr s` r,rzIndex.changes_from_treesO 7"3 LL      ) " T4s# #" s?Ac6t||jS)zCreate a new tree from an index. Args: object_store: Object store to save the tree in Returns: Root tree SHA  commit_treer)rrs r,commitz Index.commits<)9)9);<?< " , $$$0=r&r{rr blobsc dii  fd|D]#\}}}t|\}}|}||f||<% fd  dS)zCommit a new tree. Args: object_store: Object store to add trees to blobs: Iterable over blob path, sha, mode entries Returns: SHA1 of the created tree. r&c|vr|St|\}}|}t|tsJi}|||<||<|Sr)r-r<r)r)r*r+rDnewtreeadd_treetreess r,rzcommit_tree..add_treesX 5=; %dO W (E***( d r&ct}|jD]P\}}t|tr#tj }t ||}n|\}}|j|||Rj||jSr) rrr<dictrsrwr2add add_objectid) r)rr+rTrr build_treerrs r,rzcommit_tree..build_trees{v$T{002OHe%&|| $!9:# s HHXtS ) 3 %wwr&)r-) rrr)r r tree_pathr+rrrrs ` @@@r,rrs["IE !c4'o 8 "X!  c?r&indexc6t||jS)zCreate a new tree from an index. Args: object_store: Object store to save the tree in index: Index file Note: This function is deprecated, use index.commit() instead. Returns: Root tree sha. r)rrs r, commit_indexrs |U%6%6%8 99r&namesrrc#^Kt|}|Q|j|D]=\}}} ||\} } |j||s | |k7s| |k7s1||f|| f|| ff?|D]} ||\} } d|fd| fd| ffy#t$r|df|df|dffYywxYw#t$rYFwxYww)aFind the differences between the contents of a tree and a working copy. Args: names: Iterable of names in the working copy lookup_entry: Function to lookup an entry in the working copy object_store: Object store to use for retrieving tree contents tree: SHA1 of the root tree, or None for an empty tree want_unchanged: Whether unchanged files should be reported Returns: Iterator over tuples with (oldpath, newpath), (oldmode, newmode), (oldsha, newsha) N)setiter_tree_contentsremoveKeyError) rrrrr other_namesrNrr other_sha other_modes r,rrs4e*K !-!@!@!F T4 O*6t*<'J ""4(!Y#%5t9K $<$ );c9=MNN"G H&24&8 #Y $<$ !3dI5FG G  @d|dD\C;?? @   sQ&B- BB-B-' B2B-BB-BB- B*'B-)B**B-hex_shar!c |t|j}t|j|j|j |j ||j|j|j|| S)zCreate a new index entry from a stat value. Args: stat_val: POSIX stat_result instance hex_sha: Hex sha of the object flags: Index flags ) ryst_moderst_ctimest_mtimest_devst_inost_uidst_gidst_size)stat_valrr!rs r,index_entry_from_statr sf |H,,-     r&Tc tj|}|j}t j |rc|rtj |tjdk(r"|j|}|j|}tj||n|L|jt|k(r4t|d5}|j|k(r |cdddS dddt|d5}|j|ddd|rtj ||tj|S#t$rd}Y7wxYw#1swYnxYw#1swYTxYw)aSBuild a file or symlink on disk based on a Git object. Args: obj: The git object mode: File mode target_path: Path to write to honor_filemode: An optional flag to honor core.filemode setting in config file, default is core.filemode=True, change executable bit Returns: stat object for the file Nwin32rr)rlstatFileNotFoundError as_raw_stringrsrtunlinksysplatformdecodesymlinkrrSopenr8rBchmod)blobr target_pathhonor_filemode tree_encodingoldstatcontentsr9s r,build_file_from_blobr's#((;'!!#H ||D  IIk " <<7 "}5H%,,];K 8[)  7??c(m#Ck4(A668x'")(')+t $ GGH %  HH[$ ' 88K  3 )(% $s)EE9E EEEE').git.s..r&c.|jtvSr)lowerINVALID_DOTNAMES)elements r,validate_path_element_defaultrUs ==?"2 22r&c`|jdj}|tvry|dk(ryy)Ns. Fsgit~1T)rstripr r )r strippeds r,validate_path_element_ntfsrYs3~~e$**,H##8 r&cH|jd}|D] }||r yy)z2Default path validator that just checks for .git/.r$FT)split)r)element_validatorpartsr1s r, validate_pathrbs* JJt E  #r&c pt|}t|tstj|}|j |D]}t |j|st||j}tjjtjj|s2tjtjj|t|jrJtjj|stj|tj |} n(||j"} t%| |j||} |rt|jr|j| j&| j(| j*| j,| j.| j0| j2| j4| j6f } | j9| } t;| |j"d||j<|j=y)aGenerate and materialize index from a tree Args: tree_id: Tree to materialize root_path: Target dir for materialized index files index_path: Target path for generated index object_store: Non-empty object store holding tree contents honor_filemode: An optional flag to honor core.filemode setting in config file, default is core.filemode=True, change executable bit validate_path_element: Function to validate path elements to check out; default just refuses .git and .. directories. Note: existing index is wiped and contents are not merged in a working dir. Suitable only for fresh clones. )rrN)r{r<rrfsencoderrr)_tree_to_fs_pathrr*makedirsrrisdirmkdirrr rrrst_nlinkrrrst_atimerrrrrB) root_path index_pathrtree_idrvalidate_path_elementrrT full_pathstobjst_tuples r,build_index_from_treer(ls0 * E i 'KK * 009UZZ)>? $Y ; ww~~bggooi89 KK 2 3 uzz "77==+#)$Buyy)C%UZZ>B UZZ!8            Hh'B1"eiiCejjM:P KKMr&ct|tsJt}tj|rot j dk(r@tj|}tj|j||_ |Stj||_ |St|d5}|j|_ ddd|S#1swY|SxYw)Create a blob from a path and a stat object. Args: fs_path: Full file system path to file st: A stat object Returns: A `Blob` object rrN)r<rrrsrtrrrfsdecodereadlinkencodedatarr8)fs_pathrrrr9s r,blob_from_path_and_moder0s gu %% % 6D ||D <<7 "kk'*G G,33MBDI K  G,DI K'4 ADI! K! Ks -C  Cc0t||j|S)r*)r0r)r/r%rs r,blob_from_path_and_statr2s #7BJJ FFr&cddlm}ddlm}t |t st j|} ||} |jS#|$rYywxYw#t$rYywxYw)zRead the head commit of a submodule. Args: path: path to the submodule Returns: HEAD sha, None if not a valid head/repository r)NotGitRepository)RepoN) dulwich.errorsr4 dulwich.repor5r<strrr+headr)r)r4r5repos r,read_submodule_headr;sj0! dC {{4 Dzyy{  s"A A AA A#"A#ctjjtjj|drt |}|j |k7ryyy)aCheck if a directory has changed after getting an error. When handling an error trying to create a blob from a path, call this function. It will check if the path is a directory. If it's a directory and a submodule, check the submodule head to see if it's has changed. If not, consider the file as changed as Git tracked a file and not a directory. Return true if the given path should be considered as changed and False otherwise or if the path is not a directory. rTF)rr)rr/r;r )rrTr9s r,_has_directory_changedr=sF ww~~bggll9g67"9- 99  r&c#8Kt|tstj|}|j D]\}}t ||} tj |}tj|jrt||r|Xtj|js tj|jst||}| |||}|j|jk7s|y#t $r|YwxYww)zWalk through an index and check for differences against working tree. Args: index: index to check root_path: path in which to find files Returns: iterator over paths with unstaged changes N)r<rrrrrrrsrvrr=S_ISREGrtr2rr r)rr filter_blob_callbackrrTr$r%rs r,get_unstaged_changesrAs i 'KK * !OO- 5$Y :  )$B||BJJ'))U;#O<< +DLL4L*9b9D#/+D)< ww%))#-. ! O sIAD ADD>DDD&DD DDDDasciirct|tsJtdk7r|jdt}n|}tj j ||S)zConvert a git tree path to a file system path. Args: root_path: Root filesystem path tree_path: Git tree path as bytes Returns: File system path. r$)r<r os_sep_bytesreplacerr)r/)r rsep_corrected_paths r,rr.sK i '' 't&..t\B& 77<< #5 66r&ct|tstj|}n|}tdk7r|j td}|S|}|S)zConvert a file system path to a git tree path. Args: fs_path: File system path. Returns: Git tree path as bytes r$)r<rrrrDrE)r/ fs_path_bytesrs r,_fs_to_tree_pathrI?sP gu % G,  t!)),=  " r&c6t|tsJtj|}t j |j r_tjjtjj|dr!t|}|yt||dtSyt j|j st j|j r6t||}||j!|t||j"dSy)agCreate an index from a filesystem path. This returns an index value for files, symlinks and tree references. for directories and non-existant files it returns None Args: path: Path to create an index entry for object_store: Optional object store to save new blobs in Returns: An index entry; None for directories rNrr)r<rrrrsrvrr)rr/r;rrr?rtr2rr)r)rr%r9rs r,index_entry_from_pathrKRs dE "" " $B ||BJJ 77>>"'',,tW5 6&t,D|(T1;G G ||BJJ4<< #;&tR0  #  # #D )$R!44 r&c#K|D]"}t||} t||}||f$y#ttf$rd}YwxYww)zIterate over current versions of index entries on disk. Args: paths: Paths to iterate over root_path: Root path to access from store: Optional store to save new blobs in Returns: Iterator over path, index_entry rN)rrKrIsADirectoryError)pathsr rr)r1rTs r,iter_fresh_entriesrPrsV Y - )!,GEEk "#45 E s A + A?A?Ac#Kddl}|jtdt||dD]}|d||d=|yw)aRIterate over versions of blobs on disk referenced by index. Don't use this function; it removes missing entries from index. Args: index: Index file root_path: Root path to access from include_deleted: Include deleted entries with sha and mode set to None Returns: Iterator over path, sha, mode rNzUse iter_fresh_objects instead.T)include_deletedr%)rrriter_fresh_objects)rr rrTs r,iter_fresh_blobsrTsI MM+-NO#E9dK 8 eAhK Ls?Ac#Kt|||D]>\}}| |s |ddft|}||jt|jf@yw)a7Iterate over versions of objecs on disk referenced by index. Args: root_path: Root path to access from include_deleted: Include deleted entries with sha and mode set to None object_store: Optional object store to report new items to Returns: Iterator over path, sha, mode rMN)rPrr ryr)rOr rRrr)rTs r,rSrSsY*%V e =D$&&&E < #;; ; Ws A7Ac6t||D] \}}|||< y)zRefresh the contents of an index. This is the equivalent to running 'git commit -a'. Args: index: Index to update root_path: Root filesystem path N)rP)rr r)rTs r, refresh_indexrWs"*%; ed res*,    4  $[ # #  "    # - +$"%P<>"("   8  d3i  (3-  &" 2 2 %# $ 2c] 2 2ss,J=FJ=Z)#),4U5%;L5M,N) )X :0 : :5 :" /H E?/HE7E%*$556/H$/H 5/ /H   huox./ hsmXc]*+ huox./ 1 /HfAE%(08 8AH(!V/3+H7 DN.G02" " Jvv}}W% 757"&BCG$,->$?(,<& r&