o U h.@sdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl mZmZddlmZddlmZmZdd lmZdd lmZdd lmZmZmZmZdd lmZm Z m!Z!m"Z"m#Z#m$Z$dd l%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0m1Z1m2Z2ddl3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9m:Z:m;Z;ddlZ>m?Z?m@Z@mAZAmBZBddlCmDZDmEZEddlFmGZGddlHmIZImJZJddlKmLZLmMZMmNZNmOZOmPZPddlQmRZRmSZSmTZTddlUmVZVmWZWmXZXmYZYddlUmZZ[ddl\m]Z]m^Z^m_Z_e ddZ`Gdd d eZaebejcd!dpeaZdebejed!dp"eaZfd"ZgGd#d$d$ehZiGd%d&d&eiZjGd'd(d(eiZkGd)d*d*eiZld+d,Zmd-d.Znd/d0Zoe d1d2Zpd3d4Zqegfd5d6ZrGd7d8d8eiZsdd:d;Ztdedeff dd       A AddFdGZwddHdIZxddAddJdKeeyfdLdMZzddAdefddNdddddf dNee{dOee|dPeee{e}fdQeedRee|f dSdTZ~ddUdVZdWdXZdddYdZZddd[d\ZeZegfd]d^Zegfd_d`ZejcfddadbZejcfddcddZejcfddedfZejcfddgdhZejcfddidjZejcfddkdlZdmdnZdodpZd>dejcddAdAf ddqdrZd>dejcegf ddsdtZedfddudvZejcfddwdxZdye{d9e{fdzd{Zddd|d}Zdd~dZddZdddAddddAegfdee{e}fdeee{e}fdeee{e}fdee{e}fdeyde{d9dfddZejcfddZdddZddddZ ddeSdeee{e}fd9eee{e{ffddZddedefdAf dddZddedefddAddf dddZdddZdddZ dddZddZddddZddddZdd9e|fddZdd9e|fddZdee{e}fd9eOfddZdee{e}fd9eOfddZdddZddddZddZddZddZdejcefdddAdAdAfddZ > ddeeSe{fdeee{e}fd9eee}e}e}ffddZddQeefddZddd„Z   d dddĄZdejcdAdAf dddDŽZdee}e{fdyee}e{fd9dfddɄZdeSdee}e{fd9dfdd˄Zddd̈́ZddddτZdde{de}d9dfddӄZddՄZddee}e{fdeyd9dfdd؄Z d deydeeydffddۄZdd݄Zddd߄ZdddZddZddZddZdddZdddZdddZddZddZŐdddZƐdddZddZdS( aSimple wrapper that provides porcelain-like functions on top of Dulwich. Currently implemented: * archive * add * branch{_create,_delete,_list} * check-ignore * checkout_branch * clone * cone mode{_init, _set, _add} * commit * commit-tree * daemon * describe * diff-tree * fetch * for-each-ref * init * ls-files * ls-remote * ls-tree * pull * push * rm * remote{_add} * receive-pack * reset * sparse_checkout * submodule_add * submodule_init * submodule_list * rev-list * tag{_create,_delete,_list} * upload-pack * update-server-info * status * symbolic-ref These functions are meant to behave similarly to the git subcommands. Differences in behaviour are considered bugs. Note: one of the consequences of this is that paths tend to be interpreted relative to the current working directory rather than relative to the repository root. Functions should generally accept both unicode strings and bytestrings N) namedtuple)closingcontextmanager)BytesIO RawIOBase)Path)OptionalUnion) tar_stream)get_transport_and_path)Config ConfigFile StackedConfigread_submodules) CHANGE_ADD CHANGE_COPY CHANGE_DELETE CHANGE_MODIFY CHANGE_RENAMERENAME_CHANGE_TYPES) SendPackError)ensure_dir_exists)can_fast_forward)IgnoreFilterManager)_fs_to_tree_pathblob_from_path_and_statbuild_file_from_blobget_unstaged_changesindex_entry_from_stat)iter_tree_contentstree_lookup_path)CommitTagformat_timezoneparse_timezonepretty_format_tree_entry) parse_commit parse_object parse_refparse_reftuples parse_treeto_bytes)write_pack_from_containerwrite_pack_index)write_tree_diff)ZERO_SHAProtocol)LOCAL_BRANCH_PREFIXLOCAL_REMOTE_PREFIXLOCAL_TAG_PREFIXRef_import_remote_refs)BaseRepoRepoget_user_identity)FileSystemBackendReceivePackHandler TCPGitServerUploadPackHandler)update_server_info)SparseCheckoutConflictErrorapply_included_pathsdetermine_included_paths GitStatuszstaged unstaged untrackedc@s>eZdZdZd dddZdefddZdd d Zdd d ZdS) NoneStreamz;Fallback if stdout or stderr are unavailable, does nothing.returnNcCdSN)selfsizerHrHe/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/dulwich/porcelain.pyreadzNoneStream.readcCsdS)NrH)rIrHrHrKreadallrMzNoneStream.readallcCrFrGrHrIbrHrHrKreadintorMzNoneStream.readintocCrFrGrHrPrHrHrKwriterMzNoneStream.write)rDrEN) __name__ __module__ __qualname____doc__rLbytesrOrRrSrHrHrHrKrCs   rCbufferzutf-8cs"eZdZdZdfdd ZZS)ErrorzPorcelain-based error.rENcst|dSrG)super__init__)rImsg __class__rHrKr]szError.__init__rT)rUrVrWrXr] __classcell__rHrHr_rKr[sr[c@eZdZdZdS) RemoteExistsz&Raised when the remote already exists.NrUrVrWrXrHrHrHrKrcrcc@rb)TimezoneFormatErrorzBRaised when the timezone cannot be determined from a given string.NrdrHrHrHrKrfrerfc@rb) CheckoutErrorz.Indicates that a checkout cannot be performed.NrdrHrHrHrKrgrergc Csddl}|d}|||r*zt|ddt}|dWSty)Ynwddl}|j |}|r:|dS|d}| ||}d}|ro| \} } } |t | d7}| rb|t | d 7}| d krk| }|S|}|St|) aParse given string and attempt to return a timezone offset. Different formats are considered in the following order: - Git internal format: - RFC 2822: e.g. Mon, 20 Nov 1995 19:12:08 -0500 - ISO 8601: e.g. 1995-11-20T19:12:08-0500 Args: tz_str: datetime string Returns: Timezone offset as integer Raises: TimezoneFormatError: if timezone information cannot be extracted rNz^[0-9]+ [+-][0-9]{,4}$ r z5[0-9] ?([+-])([0-9]{2})(?::(?=[0-9]{2}))?([0-9]{2})?$i<-)recompilematchr%splitencodeDEFAULT_ENCODING ValueError email.utilsutils parsedate_tzsearchgroupsintrf) tz_strrlinternal_format_pattern tz_internalemailrfc_2822iso_8601_patternrn total_secssignhoursminutesrHrHrKparse_timezone_formats8      rcCsXtj}tjdrttjd}n|}tjdr&ttjd}||fS|}||fS)zRetrieve local timezone as described in https://raw.githubusercontent.com/git/git/v2.3.0/Documentation/date-formats.txt Returns: A tuple containing author timezone, committer timezone. GIT_AUTHOR_DATEGIT_COMMITTER_DATE)time localtime tm_gmtoffosenvirongetr)local_timezoneauthor_timezonecommit_timezonerHrHrKget_user_timezoness   rcCst|tr|St|S)zEOpen an argument that can be a repository or a path for a repository.) isinstancer7r8 path_or_reporHrHrK open_repo s rccs |VdS)zBContext manager that has the same api as closing but does nothing.NrH)objrHrHrK_noop_context_managers rcCst|tr t|Stt|S)zOpen an argument that can be a repository or a path for a repository. returns a context manager that will close the repo on exit if the argument is a path, else does nothing if the argument is a repo. )rr7rrr8rrHrHrKopen_repo_closings  rcCstjdkr tj|}t|}|}tjdkrtj|}t|}z||}WntyG| rD|j }||j |}nYnwtjdkrZt | tjjd|St|S)aConvert a path to a path usable in an index, e.g. bytes and relative to the repository root. Args: repopath: Repository path, absolute or relative to the cwd path: A path, absolute or relative to the cwd Returns: A path formatted for use in e.g. an index win32/)sysplatformrpathabspathrresolve relative_torr is_symlinkparentnamestrreplaceseprprY)repopathr tree_encoding resolved_pathrelpathrrHrHrKpath_to_tree_path s&       rc@seZdZdZdddZdS)DivergedBranchesz8Branches have diverged and fast-forward is not possible.rENcCs||_||_dSrG) current_shanew_sha)rIrrrHrHrKr]Ls zDivergedBranches.__init__rT)rUrVrWrXr]rHrHrHrKrIsrrEcCs:zt|||}Wn tyd}Ynw|st||dS)zCheck if updating to a sha can be done with fast forwarding. Args: repo: Repository object current_sha: Current head sha new_sha: New head sha FN)rKeyErrorr)reporrcanrHrHrKcheck_divergedQs  rcCsl|durd}t|"}t||}t|j|j|j|jD]}||qWddS1s/wYdS)zCreate an archive. Args: repo: Path of repository for which to generate an archive. committish: Commit SHA1 or ref to use outstream: Output stream (defaults to stdout) errstream: Error stream (defaults to stderr) NHEAD)rr'r object_storetree commit_timerS)r committish outstream errstreamrepo_objcchunkrHrHrKarchiveas   "r.cCs6t| }t|WddS1swYdS)z]Update server info files for a repository. Args: repo: path to the repository N)rserver_update_server_inforrrHrHrKr>ys  "r>FcCsft|%}t|}|s||jvrtd|d|jd|WddS1s,wYdS)zSet git symbolic ref into HEAD. Args: repo: path to the repository ref_name: short name of the new ref force: force settings without checking if it exists in refs/heads z fatal: ref `z` is not a refHEADN)r_make_branch_refrefskeysr[set_symbolic_ref)rref_nameforcerref_pathrHrHrK symbolic_refs "rcsRt|}|jfddD}|WddS1s"wYdS)Ncs,i|]}s |tr|dkr||qSr) startswithr4).0refallrrHrK szpack_refs..)rradd_packed_refs)rrr packed_refsrHrrK pack_refss   "rc Cst|ddr ||p t}t|ddr||pt}t|ddr'||p%t}t} |dur2| d}|dur:| d}t|} | j|||||||t|ttfrQ|nddWdS1s_wYdS)a-Create a new commit. Args: repo: Path to repository message: Optional commit message author: Optional author name and email author_timezone: Author timestamp timezone committer: Optional committer name and email commit_timezone: Commit timestamp timezone no_verify: Skip pre-commit and commit-msg hooks signoff: GPG Sign the commit (bool, defaults to False, pass True to use default GPG key, pass a str containing Key ID to use a specific GPG key) Returns: SHA1 of the new commit rpNrr )messageauthorr committerrencoding no_verifyr) getattrrprqrr do_commitrrbool) rrrrrrrrsignoffrrrHrHrKcommits.    $rcCs>t|}|j||||dWdS1swYdS)zCreate a new commit object. Args: repo: Path to repository tree: An existing tree object author: Optional author name and email committer: Optional committer name and email )rrrrN)rr)rrrrrrrHrHrK commit_trees $r)baresymlinksrcCs2tj|s t||rt|Stj||dS)zCreate a new git repository. Args: path: Path to repository. bare: Whether to create a bare repository. symlinks: Whether to create actual symlinks (defaults to autodetect) Returns: A Repo instance )r)rrexistsmkdirr8 init_bareinit)rrrrHrHrKrs  rorigindepthbranchconfigprotocol_versionc  Ks|durddl} | jdtdd| durt} |dur| }|r'|r'td|dur2|dd}t|tr<| t }t j | }t|fd | i| \}}| rV| d } |j||||||||j|| | d S) aXClone a local or remote git repository. Args: source: Path or URL for source repository target: Path to target repository (optional) bare: Whether or not to create a bare repository checkout: Whether or not to check-out HEAD after cloning errstream: Optional stream to write progress to outstream: Optional stream to write progress to (deprecated) origin: Name of remote from the repository used to clone depth: Depth to fetch at branch: Optional branch or tag to be used as HEAD in the new repository instead of the cloned repository's HEAD. config: Configuration to use refspecs: refspecs to fetch. Can be a bytestring, a string, or a list of bytestring/string. filter_spec: A git-rev-list-style object filter spec, as an ASCII string. Only used if the server supports the Git protocol-v2 'filter' feature, and ignored otherwise. protocol_version: desired Git protocol version. By default the highest mutually supported protocol version will be used. Returns: The new repository Nrz7outstream= has been deprecated in favour of errstream=.) stacklevelz"checkout and bare are incompatiblerrDrascii) rrrcheckoutrprogressr filter_specr)warningswarnDeprecationWarningrdefaultr[rorrrprqrrrr clonerS)sourcetargetrrrrrrrrrrkwargsrrclientrrHrHrKrsD&   rc Cst}t|i}t|j}t|}|s*ttt tt t || }g}t |ts4|g}|D]*}t|}t ||} |rPt j| d} || r[|| q6|| q6||Wd||fS1sswY||fS)aAdd files to the staging area. Args: repo: Repository for the files paths: Paths to add. No value passed stages all modified files. Returns: Tuple with set of added files and ignored files If the repository contains ignored directories, the returned set will contain the path to an ignored directory (with trailing slash). Individual files within ignored directories will not be returned. N)setrrrrr from_repolistget_untracked_pathsrrgetcwd open_indexrris_dirjoin is_ignoredaddappendstage) rpathsignoredr repo_pathignore_managerrelpathsprrrHrHrKrFs:        rcCs2tj|tjj}tj|tjj}||S)zCheck whether subdir is parentdir or a subdir of parentdir. If parentdir or subdir is a relative path, it will be disamgibuated relative to the pwd. )rrrealpathrr)subdir parentdir parentdir_abs subdir_absrHrHrK _is_subdiros rcCs|durt}t|k}t||jstd|}|ddd|}t |}t ||j}t t |D]7\}}|rNtt|dk} | rMt|q7t|j|} | |v} tj||j} || } | sn| snt|q7WddS1szwYdS)aRemove any untracked files from the target directory recursively. Equivalent to running ``git clean -fd`` in target_dir. Args: repo: Repository where the files may be tracked target_dir: Directory to clean - current directory if None Nz,target_dir must be in the repo's working dir)scleans requireForceTr)rrrrrr[get_config_stack get_booleanrrr_walk_working_dir_pathsreversedrlenlistdirrmdirrrrremove)r target_dirrrindexr paths_in_wdapris_emptyip is_trackedrprrHrHrKclean{s2         "r!c Csdt|}|}|D]}ttj|}t|j|}z||j}Wnty7} zt |d| d} ~ ww|szt |} Wn t yJYnNwzt || } Wn t y[Yn=wzt |j||j|d} Wn tywd} Ynw| j|kr|| krt d||| krt d|t|||=q |WddS1swYdS)zuRemove files from the staging area. Args: repo: Repository for the files paths: Paths to remove z did not match any filesNr z?file has staged content differing from both the file and head: zfile has staged changes: )rrrfsencoderrrsharr[lstatOSErrorrr! __getitem__headridrrS) rrcachedrrr  full_path tree_path index_shaexcstblob committed_sharHrHrKrsV       "rcCs$|jr |jd}n|}||dS)Nrr)rdecodercontentsdefault_encodingrrHrHrK commit_decodes r5cCs"|jr |jd}n|}||S)Nr)rr1rpr2rHrHrK commit_encodes r6c Cs|d|d|jddt|jdkr/|dddd |jdd Dd|d ||jd|j|jkrM|d ||jdt |j |j }t d |}t |j d}|d|d|d|d|||jd|dd S)zWrite a human-readable commit log entry. Args: commit: A `Commit` object outstream: A stream file to write to z3-------------------------------------------------- zcommit: r r zmerge: z...cSsg|]}|dqS)rr1rrrHrHrK z print_commit..NzAuthor: z Committer: %a %b %d %Y %H:%M:%SDate: rh)rSr(r1rparentsrrrrgmtime author_timerstrftimer$r)rr1r time_tupletime_str timezone_strrHrHrK print_commits(    rEcCs|d||jdt|j|j}td|}t|jd}|d|d|d|d|||j |ddS)zWrite a human-readable tag. Args: tag: A `Tag` object decode: Function for decoding bytes to unicode string outstream: A stream to write to zTagger: r7r<rr=rhN) rStaggerrr?tag_time tag_timezonerAr$r1r)tagr1rrBrCrDrHrHrK print_tags  rJcCs|||jdS)zWrite a blob to a stream. Args: repo: A `Repo` object blob: A `Blob` object decode: Function for decoding bytes to unicode string outstream: A stream file to write to N)rSdata)rr/r1rrHrHrK show_blobs rLcCsht|||d|jr||jd}|j}nd}t}t||j||j|d|t|| dS)zShow a commit to a stream. Args: repo: A `Repo` object commit: A `Commit` object decode: Function for decoding bytes to unicode string outstream: Stream to write to )r1rrN) rEr>rrr/rseekrSr5getvalue)rrr1r parent_commit base_tree diffstreamrHrHrK show_commit&s  rRcCs |D] }|||dqdS)zPrint a tree to a stream. Args: repo: A `Repo` object tree: A `Tree` object decode: Function for decoding bytes to unicode string outstream: Stream to write to r7N)rS)rrr1rnrHrHrK show_tree;s rTcCs(t|||t|||jd||dS)zPrint a tag to a stream. Args: repo: A `Repo` object tag: A `Tag` object decode: Function for decoding bytes to unicode string outstream: Stream to write to r N)rJ show_objectobject)rrIr1rrHrHrKshow_tagHs rWcCsttttd|j||||S)N)streesblobscommitstag)rTrLrRrW type_name)rrr1rrHrHrKrUUsrUccs|D]\}|sqt|tr|d}|jtkr|jj}d}d}n8|jtkr-|jj}d}d}n*|jtkr;|jj}d}d}n|jt vrW|jj}|jj}|jt krPd}n|jt krWd}d|||fVqd S) z5Print a simple status summary, listing changed files.rrADMRCz%-8s%-20s%-20sN) rrtypernewrroldrrrr)changeschangepath1path2kindrHrHrKprint_name_status^s6       rfc st|3}|j|||d}|D]fdd}tj|||r.|ddtDqWddS1s:wYdS)aQWrite commit logs. Args: repo: Path to repository paths: Optional set of specific paths to print entries for outstream: Stream to write log output to reverse: Reverse order in which entries are printed name_status: Print name status max_entries: Optional maximum number of entries to display ) max_entriesrreversecs tj|SrG)r5rxentryrHrKr1 zlog..decodecSsg|]}|dqS)r7rH)rlinerHrHrKr:zlog..N)r get_walkerrEr writelinesrfra) rrrrgrh name_statusrwalkerr1rHrkrKlog{s  "rtcs|durdg}t|ts|g}t|-}|D]!}t||ttr*fdd}nfdd}t|||qWddS1sCwYdS)zPrint the changes in a commit. Args: repo: Path to repository objects: Objects to show (defaults to [HEAD]) outstream: Stream to write to default_encoding: Default encoding to use if none is set in the commit Nrcs t|SrG)r5rir4orHrKr1rmzshow..decodecs |SrGr8ri)r4rHrKr1s )rrrr(r"rU)robjectsrr4r objectishr1rHrurKshows     "rycCs>t|}t||j||WddS1swYdS)zCompares the content and mode of blobs found via two tree objects. Args: repo: Path to repository old_tree: Id of old tree new_tree: Id of new tree outstream: Stream to write to N)rr/r)rold_treenew_treerrrHrHrK diff_trees "r|cs`t|"jfdd|DdD] }||jjdqWddS1s)wYdS)zLists commit objects in reverse chronological order. Args: repo: Path to repository commits: Commits over which to iterate outstream: Stream to write to csg|]}|jqSrH)r(r9rrHrKr:r;zrev_list..)include N)rrprSrr()rcommitsrrlrHr}rKrev_lists "rurlcCs*|ddd}|dr|dd}|S)Nrr rD.git)rsplitendswith)rrrHrHrK_canonical_parts  rc Cst|R}|durtjt||j}|dur|}tj|jd}zt|}Wnty7t}||_Ynw| d|fd|| d|fd|| WddS1sYwYdS)zAdd a new submodule. Args: repo: Path to repository url: URL of repository to add as submodule path: Path where submodule should live N .gitmodules submodulerr) rrrrrrr from_pathFileNotFoundErrorr write_to_path)rrrrrgitmodules_pathrrHrHrK submodule_adds    "rcCst|5}|}tj|jd}t|D]\}}}|d|fdd|d|fd|q|WddS1s}z td|d|d}~ww|sM||vrMt||||||<||<q|S)Nrz No valid ref z in local repository)extendr*rr0rr[r)rnew_refslhrh force_reflocalshar-rrrefspecsremote_changed_refs selected_refsrHrK update_refss"   zpush..update_refsr)generate_pack_datarzPush to z failed -> rsPush to s successful. sPush of ref %s failed: %s sRef %s updated )r active_branchrr rrrqget_url send_packrrSrr[argsr1rp ref_statusitemsr6r)rrrrrrrrrrr err_encodingresultr-rerrorrHrrKpushsZ     :"rTc  stt|t|\} }gdurdgfdd} t|fdi| \} } |r3|d}| j| |j| ||d}D]:\}}}|ss|jvrsztj |d|j|Wnt yr}z|rit d |d}~ww|j|j|<qAr|jd dd<dj }j |d | durtj| |jWddSWddS1swYdS) aPull from remote via dulwich.client. Args: repo: Path to repository remote_location: Location of the remote refspecs: refspecs to fetch. Can be a bytestring, a string, or a list of bytestring/string. outstream: A stream file to write to output errstream: A stream file to write to errors filter_spec: A git-rev-list-style object filter spec, as an ASCII string. Only used if the server supports the Git protocol-v2 'filter' feature, and ignored otherwise. protocol_version: desired Git protocol version. By default the highest mutually supported protocol version will be used Nrcs,tjdfddDS)Nrcs(g|]\}}}|jvr|qSrH)r)rrrr)r remote_refsrHrKr:s z1pull..determine_wants..)rr*r)rrrrrrr)rrKdetermine_wantss  zpull..determine_wantsrr)rrrrr zmerge is not yet supportedr)r)rrr rrpfetchrSrrfollowrNotImplementedErrorrrr6)rrrrr fast_forwardrrrrrrrr fetch_resultrrrr-rrHrrKpullsV    "   /"rrc Cst|C}t|}|}|}|j}tt||j|}t|j|j|| |d} t j dkr6dd| D} nt| } t ||| WdS1sJwYdS)a0Returns staged, unstaged, and untracked changes relative to the HEAD. Args: repo: Path to repository or repository object ignored: Whether to include ignored files in untracked untracked_files: How to handle untracked files, defaults to "all": "no": do not return untracked files "all": include all files in untracked directories Using untracked_files="no" can be faster than "all" when the worktreee contains many untracked files/directories. Note: untracked_files="normal" (git's default) is not implemented. Returns: GitStatus tuple, staged - dict with lists of staged paths (diff index/HEAD) unstaged - list of unstaged paths (diff index/working-tree) untracked - list of untracked, un-ignored & non-.git paths )exclude_ignoreduntracked_filesrcSsg|] }|tjjdqSr)rrrr)rrrHrHrKr:hszstatus..N) rget_tree_changesrget_blob_normalizercheckin_normalizerrrrrrrB) rrrrtracked_changesr normalizerfilter_callbackunstaged_changesuntracked_pathsuntracked_changesrHrHrKstatusDs(   $rccst|D]F\}}}d|vr|d||krqd|vr'|d||kr'q||kr0|dfV|D]}tj||}|dfVq2|rL||||dd<qdS)a#Get path, is_dir for files in working dir from frompath. Args: frompath: Path to begin walk basepath: Path to compare to prune_dirnames: Optional callback to prune dirnames during os.walk dirnames will be set to result of prune_dirnames(dirpath, dirnames) rTFN)rwalkrrr)frompathbasepathprune_dirnamesdirpathdirnames filenamesfilenamefilepathrHrHrKrqs&     rc #s|dkr td|dvrtd|dkrdSt }t|Wdn1s+wYgfdd}t|d D]#\}}|sft|} | |vrfr^tj |sftj |VqCEdHdS) aVGet untracked paths. Args: frompath: Path to walk basepath: Path to compare to index: Index to check against exclude_ignored: Whether to exclude ignored paths untracked_files: How to handle untracked files: - "no": return an empty list - "all": return all files in untracked directories - "normal": Not implemented Note: ignored directories will never be walked for performance reasons. If exclude_ignored is False, only the path to an ignored directory will be yielded, no files inside the directory will be returned normalznormal is not yet supported)norz(untracked_files must be one of (no, all)rNc sztt|dddD]0}tj|||}tjtj|d}|r:s7tjtj|d||=q |S)Nr rDr)rangerrrrrrr)rrirrrrrr ignored_dirsrHrKrs z+get_untracked_paths..prune_dirnames)r) rrrrrrrrrrrr) rrrrrrrrrrrHrrKrs0     rc Cst|p}|}gggd}z|dj}Wn ty!d}Ynw||j|D]A}|dds=|d|ddq)|ddsO|d|ddq)|dd|ddkrg|d|ddq)td |WdS1swwYdS) zReturn add/delete/modify changes to tree by comparing index to HEAD. Args: repo: repo path or object Returns: dict with lists for each type of change )rdeletemodifyrNrrr rrzgit mv ops not yet supported)rrrrchanges_from_treerrr)rrrrtree_idrbrHrHrKrs*    $rcCs t|}t|||}|dS)zRun a daemon serving Git requests over TCP/IP. Args: path: Path to the directory to serve. address: Optional address to listen on (defaults to ::) port: Optional port to listen on (defaults to TCP_GIT_PORT) N)r:r< serve_forever)raddressportbackendserverrHrHrKdaemons  rc CsFddlm}m}m}m}t|}||}||||||d} | dS)zRun a daemon serving Git requests over HTTP. Args: path: Path to the directory to serve address: Optional address to listen on (defaults to ::) port: Optional port to listen on (defaults to 80) r )WSGIRequestHandlerLoggerWSGIServerLogger make_servermake_wsgi_chain) handler_class server_classN)webrrrrr:r) rrrrrrrrapprrHrHrK web_daemons rcxdur ttjdtj|durttjdtj}tj|}t|}dfdd }t|j |}t ||g|}| dS)zUpload a pack file after negotiating its contents using smart protocol. Args: path: Path to the repository inf: Input stream to communicate with client outf: Output stream to communicate with client NrZrEc|dSrGrSflushrKoutfrHrKsend_fn'  zupload_pack..send_fnrrT) rrstdoutstdinrr expanduserr:r1rLr=handlerinfrrrprotohandlerrHrrK upload_pack  rcr)zReceive a pack file after negotiating its contents using smart protocol. Args: path: Path to the repository inf: Input stream to communicate with client outf: Output stream to communicate with client NrZrEcrrGrrrrHrKrArzreceive_pack..send_fnrrT) rrrrrrrr:r1rLr;r r rHrrK receive_pack2rrrcCt|tr |t}t|SrG)rrrprqr2rrHrHrKrL  rcCrrG)rrrprqr4rrHrHrKrRrrcCsZt|}t|tr |}n|g}|D]}|jt|=qWddS1s&wYdS)zbDelete a branch. Args: repo: Path to the repository name: Name of the branch N)rrrrrrrHrHrK branch_deleteXs  "rcCst|G}|dur d}t||}t|}d|t}|r)|jj|d|j|dn|jj||j|ds;t d|dWddSWddS1sNwYdS)zCreate a branch. Args: repo: Path to the repository name: Name of the new branch objectish: Target object to point new branch at (defaults to HEAD) force: Force creation of branch, even if it already exists Nrsbranch: Created from )rzBranch with name z already exists.) rr(rrprqr set_if_equalsr( add_if_newr[)rrrxrrrVrefname ref_messagerHrHrK branch_createhs  "rcCs:t|}|jjtdWdS1swYdS)zEList all branches. Args: repo: Path to the repository baseN)rrrr2rrHrHrK branch_list~s  $rcCsbt|#}|jddd}|tst||ttdWdS1s*wYdS)zReturn the active branch in the repository, if any. Args: repo: Repository to open Returns: branch name Raises: KeyError: if the repository does not have a working tree IndexError: if HEAD is floating rrr N)rrrrr2rrr)rr active_refrHrHrKrs  $rc Cs|t|0}t|j}|}z |d|fd}Wn ty#d}Yn wWd|SWd|S1s7wY|S)zReturn the active branch's remote name, if any. Args: repo: Repository to open Returns: remote name Raises: KeyError: if the repository does not have a working tree sbranchrsoriginN)rrrrrr)rr branch_namerrrHrHrKrs    rc  Kst|K} t| |\} }|durd|t}t|fd| i| \} } | j| | |j|d}| durGt| j | |j |||dWd|SWd|S1sRwY|S)aFetch objects from a remote server. Args: repo: Path to the repository remote_location: String identifying a remote server outstream: Output stream (defaults to stdout) errstream: Error stream (defaults to stderr) message: Reflog message (defaults to b"fetch: from ") depth: Depth to fetch at prune: Prune remote removed refs prune_tags: Prune reomte removed tags Returns: Dictionary with refs on the remote Ns fetch: from r)rr)prune prune_tags) rrrprqr rrrSr6r)rrrrrrrr rrrrrrrrHrHrKrs8    rpatternc st|tr t|}t| }Wdn1swY|r`i}|d}|D].\}}d}|d}t|t|krCq/t ||D]\} } t | | }|sVnqH|r]|||<q/|}fddt |dddD} | S) zIterate over all refs that match the (optional) pattern. Args: repo: Path to the repository pattern: Optional glob (7) patterns to filter the refs with Returns: List of bytes tuples with: (sha, object_type, ref_name) N/Fcs*g|]\}}|dkr||j|fqSr) get_objectrX)rrr#r}rHrKr:s z for_each_ref..cSs|dS)NrrH)ref_sharHrHrK szfor_each_ref..)key) rrrr"rget_refsrorrzipfnmatch fnmatchcaser) rr!r matching_refs pattern_partsrr#matches ref_partspatref_partretrHr}rK for_each_refs:        r2cKs2|durt}t|fd|i|\}}||S)zList the refs in a remote. Args: remote: Remote repository location config: Configuration to use Returns: Dictionary with remote refs Nr)rrr r')remoterrr host_pathrHrHrK ls_remotes  r5cCs8t|}|jWddS1swYdS)zRepack loose files in a repository. Currently this only packs loose objects. Args: repo: Path to the repository N)rrpack_loose_objectsrrHrHrKrepack!s  "r7c Cst|}t|j|jdd|D|||d\}} Wdn1s"wY|dur>tdd|D}t||| dSdS)aPack objects into a file. Args: repo: Path to the repository object_ids: List of object ids to write packf: File-like object to write to idxf: File-like object to write to (can be None) delta_window_size: Sliding window size for searching for deltas; Set to None for default window size. deltify: Whether to deltify objects reuse_deltas: Allow reuse of existing deltas while deltifying cSsg|]}|dfqSrGrH)roidrHrHrKr:Froz pack_objects..)deltifydelta_window_size reuse_deltasNcSs"g|] \}}||d|dfqS)rr rH)rkvrHrHrKr:Ls")rr-rSrrrr.) r object_idspackfidxfr:r9r;rentriesdata_sumrHrHrK pack_objects-s    rCrcs\dfdd t|}t||}|j|jdWddS1s'wYdS)zList contents of a tree. Args: repo: Path to the repository treeish: Tree id to list outstream: Output stream (defaults to stdout) recursive: Whether to recursively list files name_only: Only print item name rENcsl||D]-\}}}|rt||}r|dn t|||t|r3r3|||qdS)Nr) iteritems posixpathrrSr&statS_ISDIR)storetreeidrrrr# list_tree name_onlyr recursiverHrKrKas  zls_tree..list_treerrT)rr+rr()rrrrMrLrrrHrJrKls_treePs  "rNcCst|ts |t}t|ts|t}t|%}|}d|f}||r*t|||d|| WddS1s@wYdS)znAdd a remote. Args: repo: Path to the repository name: Remote name url: Remote URL rrN) rrYrprqrrrrcrr)rrrrrrrHrHrK remote_addqs       "rOcCs`t|ts |t}t|}|}d|f}||=|WddS1s)wYdS)z[Remove a remote. Args: repo: Path to the repository name: Remote name rN)rrYrprqrrr)rrrrrrHrHrK remote_removes    "rPccst|8}|}t|}|D]#}|st|j||vrqtj|r,tj||j}| |r4|VqWddS1s@wYdS)zDebug gitignore files. Args: repo: Path to the repository paths: List of paths to check for no_index: Don't check index Returns: List of ignored files N) rrrrrrrisabsrr)rrno_indexrrrrrHrHrK check_ignores    "rScCst|A}|durt|}nd}|r |j|=t||j|j|<n |j|t|||dur=|jd|WddSWddS1sHwYdS)aUpdate HEAD to point at a new branch/commit. Note that this does not actually update the working tree. Args: repo: Path to the repository detached: Create a detached head target: Branch or committish to switch to new_branch: New branch to create Nr)rrrr'r(rr))rrdetached new_branchrto_setrHrHrK update_heads   "rW file_pathrc Csdt||d}t|}||jj|}tjt|j|}|j|d}|d} t || ||ddS)zReset the file to specific commit or branch. Args: repo: dulwich Repo object file_path: file to reset, relative to the repository path target: branch or commit or b'HEAD' to reset )rr r) symlink_fnN) r+r lookup_pathrr&rrrr"r) rrXrrYrr+ file_entryr*r/rrHrHrK reset_files r\cCsd}|dkr |S||jjtdvrt|||S|}|dd}d|f}||rT||dd}z t||t | Wn t yJYnwt|t||St||dd|S) Nrrr"rrrNT)rT) rrr2rWrrorrrr3r1r[)rrcheckout_targetrrrrHrHrK#_update_head_during_checkout_branchs.   r^rcCst|}t||}t||}|r||jt||nt|}tt|dd|dd|dd|d}d}|t |kr||}z(| |j j |z| |j j ||d7}Wnt yntd|wWnt y~||Ynw|t |ksDt||} | durt|| }t} |} t|j |jD]8} | | j| j|vrqtjt|j| j} |j | j}ttj| t|| j| }t|| j| | j<q| t|j |jD]} | j| vr|| jgq|} | |j |jD]Q}|d}|ddurP|d}tj|j|} tj!| r't"| tj| }||jkrPt t#|dk}|rDt$|tj|}||jks3qdS)aSwitch branches or restore working tree files. The implementation of this function will probably not scale well for branches with lots of local changes. This is due to the analysis of a diff between branches before any changes are applied. Args: repo: dulwich Repo object target: branch name or commit sha to checkout force: true or not to force checkout rrrrr zLYour local changes to the following files would be overwritten by checkout: N)%r,r+r'rr(r^rrrrrZrr&rrgr1poprr rrrrr"r#rdirnamerrrrSunstagerisfilerrr)rrr current_tree target_tree status_reportrarrbr] dealt_with repo_indexrlr*r/r. path_change file_namedir_pathrrHrHrKcheckout_branchs                       rkconec Cst|K}|dur |}|dur|}|durtdn|}||t|||}z t|||dWntyF}zt|j |d}~wwWddS1sRwYdS)aPerform a sparse checkout in the repository (either 'full' or 'cone mode'). Perform sparse checkout in either 'cone' (directory-based) mode or 'full pattern' (.gitignore) mode, depending on the ``cone`` parameter. If ``cone`` is ``None``, the mode is inferred from the repository's ``core.sparseCheckoutCone`` config setting. Steps: 1) If ``patterns`` is provided, write them to ``.git/info/sparse-checkout``. 2) Determine which paths in the index are included vs. excluded. - If ``cone=True``, use "cone-compatible" directory-based logic. - If ``cone=False``, use standard .gitignore-style matching. 3) Update the index's skip-worktree bits and add/remove files in the working tree accordingly. 4) If ``force=False``, refuse to remove files that have local modifications. Args: repo: Path to the repository or a Repo object. patterns: Optional list of sparse-checkout patterns to write. force: Whether to force removal of locally modified files (default False). cone: Boolean indicating cone mode (True/False). If None, read from config. Returns: None Nz"No sparse checkout patterns found.r) rinfer_cone_modeget_sparse_checkout_patternsr[set_sparse_checkout_patternsrAr@r?rgr)rpatternsrrlrlinesincluded_pathsr-rHrHrKsparse_checkoutJs&    "rscCsNt|}|ddg}t||dddWddS1s wYdS)aqInitialize a repository to use sparse checkout in 'cone' mode. Sets ``core.sparseCheckout`` and ``core.sparseCheckoutCone`` in the config. Writes an initial ``.git/info/sparse-checkout`` file that includes only top-level files (and excludes all subdirectories), e.g. ``["/*", "!/*/"]``. Then performs a sparse checkout to update the working tree accordingly. If no directories are specified, then only top-level files are included: https://git-scm.com/docs/git-sparse-checkout#_internalscone_mode_handling Args: repo: Path to the repository or a Repo object. Returns: None /*!/*/TrrlN)rconfigure_for_cone_moders)rrrprHrHrKcone_mode_inits "rxcCsZt|}||j|d|}t|||ddWddS1s&wYdS)aOverwrite the existing 'cone-mode' sparse patterns with a new set of directories. Ensures ``core.sparseCheckout`` and ``core.sparseCheckoutCone`` are enabled. Writes new patterns so that only the specified directories (and top-level files) remain in the working tree, and applies the sparse checkout update. Args: repo: Path to the repository or a Repo object. dirs: List of directory names to include. force: Whether to forcibly discard local modifications (default False). Returns: None dirsTrvN)rrwset_cone_mode_patternsrnrs)rrzrr new_patternsrHrHrK cone_mode_sets  "r}cst|4}|ddgfdd|D}||pg}|j|d|}t|||ddWddS1s;wYdS) a Add new directories to the existing 'cone-mode' sparse-checkout patterns. Reads the current patterns from ``.git/info/sparse-checkout``, adds pattern lines to include the specified directories, and then performs a sparse checkout to update the working tree accordingly. Args: repo: Path to the repository or a Repo object. dirs: List of directory names to add to the sparse-checkout. force: Whether to forcibly discard local modifications (default False). Returns: None rtrucsg|] }|vr|dqSr)strip)rr/ base_patternsrHrKr:s z!cone_mode_add..ryT)rprrlN)rrwrnr{rs)rrzrr existing_dirs added_dirsr|rHrrK cone_mode_adds    "rc Csvt|-}ddlm}z |tj|jd}Wn ty$|}Ynw||WdS1s4wYdS)zCheck canonical name and email of contact. Args: repo: Path to the repository contact: Contact name and/or email Returns: Canonical contact data r )Mailmapz.mailmapN) rmailmaprrrrrrlookup)rcontactrrrrHrHrK check_mailmaps    $rc cst|1}|jD]$}|j|}z|Wq ty-}z ||fVWYd}~q d}~wwWddS1s9wYdS)zsCheck a repository. Args: repo: A path to the repository Returns: Iterator over errors/warnings N)rrcheck Exception)rrr#rverHrHrKfscks    "rcCsRt|}ddlm}||}tt|WdS1s"wYdS)z!List all stashes in a repository.r StashN)rstashrr enumeraterstashesrrrrrHrHrK stash_lists   $rcCLt|}ddlm}||}|WddS1swYdS)z Push a new stash onto the stack.r rN)rrrrrrrHrHrK stash_push    "rcCr)zPop a stash from the stack.r rN)rrrrr_rrHrHrK stash_pop rrcCsNt|}ddlm}||}||WddS1s wYdS)zDrop a stash from the stack.r rN)rrrrdrop)rrrrrrHrHrK stash_drop s    "rcCs8t|}t|WdS1swYdS)zList all files in an index.N)rrrrrHrHrKls_files s  $rcCs|dddS)z"For now, just return 7 characters.rNr8)r object_idrHrHrKfind_unique_abbrev src Cstd|dur|nd}t|}|}i}|D]E\}}|}||}d|vr,q|dd\} } z|j} Wn tyBYqw|| d} t j t | j dd| j dg|| <qt|d d d d } ||} t| dkr|durd | j d|WdSdt|j| j WdSd}|}|D]I}|jj d}| D]9} | d}| dd}||kr|dkr|WdSd||| j d|WdSq|d7}qd | j d|WdS1swYdS)aDescribe the repository version. Args: repo: git repository abbrev: number of characters of commit to take, default is 7 Returns: a string description of the current git revision Examples: "gabcdefh", "v0.1" or "v0.1-5-gabcdefh". rNrrrr rcSs |ddS)Nr rrH)rIrHrHrKr%D s zdescribe..T)r&rhzg{}gz {}-{}-g{})slicerr'rr1r#rrVAttributeErrordatetimerr?rr(rr'rformatrrrpr)rabbrev abbrev_slicerrrr&valuer_rIr sorted_tags latest_commit commit_countrsrl commit_idtag_name tag_commitrHrHrKdescribe! s`         #  1 - &rcCsx|durd}t|(}t||}|j}t|tst||}t|jj||\}}||WdS1s5wYdS)zGet an object by path. Args: repo: A path to the repository path: Path to look up committish: Commit to look up path in Returns: A `ShaFile` object Nr) rr'rrrYr6r!rr&)rrrrrrPrr#rHrHrKget_object_by_pathj s     $rcCs<t|}||jWdS1swYdS)zWrite a tree object from the index. Args: repo: Repository for which to write tree Returns: tree id for the tree that was written N)rrrrrrHrHrK write_tree s $rrT)r)F) rNNNNNNFF)NNN)rN)rNF)NN)rrG)rFr)Fr)rNN)NF)NNT)FN)rN)NFN)rXrr)rrErFrr collectionsr contextlibrriorrpathlibrtypingrr rr rr rr rrrr|rrrrrrerrorsrfilergraphrignorerrrrrrrrr r!rwr"r#r$r%r& objectspecr'r(r)r*r+r,packr-r.patchr/protocolr0r1rr2r3r4r5r6rr7r8r9rr:r;r<r=r>rsparse_patternsr?r@rArBrCrrdefault_bytes_out_streamstderrdefault_bytes_err_streamrqrr[rcrfrgrrrrrrrrrrrrrrrrxrYrrrr!rrmr5r6rErJrLrRrTrWrUrfrtryrrrrrrrrrtuplerrrrrrrrrrrrrrrrrrrrr2r5r7rCrNrOrPrSrWr\r^rkrsrxr}rrrrrrrrrrrrrHrHrHrKs0             7  )     3   T) .0       " #        G   T O -! ;#   /  6  % &!  X  5      I