o U h@sdZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZe rBddlmZmZddlmZdd lmZmZmZmZmZmZmZmZmZdd l m!Z!dd l"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ddl;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNdZOdZPdZQdZRdZSdZTdZUdZVdZWdgeQgeQeRgeQeSgdgdggZXdZYGdddeZZ[Gd d!d!eZZ\d"e]e^e^ffd#d$Z_dAd%d&d'ee^d"e`fd(d)ZadBd*d+Zbd,ee`d"ece`ede`ffd-d.Zed,ece`ede`fd"e`fd/d0ZfdBd1d2ZgGd3d4d4ZhGd5d6d6Zid7d8ZjGd9d:d:eZZkGd;d<dd>eiZmGd?d@d@eiZndS)CzRepository access. This module contains the base class for git repositories (BaseRepo) and an implementation which uses a repository on local disk (Repo). N)Iterable)BytesIO) TYPE_CHECKINGAnyBinaryIOCallableOptionalUnion ConfigFile StackedConfigIndex) CommitError HookErrorNoIndexPresent NotBlobErrorNotCommitErrorNotGitRepository NotTagError NotTreeErrorRefFormatError)GitFile)CommitMsgShellHookHookPostCommitShellHookPostReceiveShellHookPreCommitShellHook)BlobNormalizerTreeBlobNormalizer)DiskObjectStoreMemoryObjectStoreMissingObjectFinderObjectStoreGraphWalkerPackBasedObjectStorepeel_sha)BlobCommitObjectIDShaFileTagTree check_hexsha valid_hexsha)generate_unpacked_objects)ANNOTATED_TAG_SUFFIXLOCAL_BRANCH_PREFIXLOCAL_TAG_PREFIXSYMREFDictRefsContainerDiskRefsContainerInfoRefsContainerRef RefsContainer_set_default_branch _set_head_set_origin_headcheck_ref_formatread_packed_refsread_packed_refs_with_peeledserialize_refswrite_packed_refsz.gitobjectsrefstagsheadsindex commondirgitdir worktreesbrancheshooksinfosmasterc@eZdZdZdddZdS)InvalidUserIdentityz2User identity is not of the format 'user '.returnNcC ||_dSN)identity)selfrQrS`/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/dulwich/repo.py__init__ zInvalidUserIdentity.__init__rNN__name__ __module__ __qualname____doc__rUrSrSrSrTrMrMc@seZdZdZdS)DefaultIdentityNotFoundz)Default identity could not be determined.N)rYrZr[r\rSrSrSrTr^sr^rNcCsddl}dD] }tj|}|rnqd}zddl}Wn ty&d}Yn.wz |t}Wn ty;d}Ynwt |ddrK|j dd}nd}|durT|j }|s`|dur^t d|}tjd}|dur{|durrt d|d|}||fS)Nr)LOGNAMEUSERLNAMEUSERNAMEgecos,zno username foundEMAIL@)socketosenvirongetpwd ImportErrorgetpwuidgetuidKeyErrorgetattrpw_gecossplitpw_namer^ gethostname)rgnameusernamerkfullnameentryemailrSrSrT_get_default_identitys@      rzconfigr kindcCsd}d}|r,tjd|d}|dur|d}tjd|d}|dur,|d}|durDz|dd}Wn tyCd}Ynw|dur\z|dd}Wn ty[d}Ynwt\}}|durj|d}|durs|d}|d r|d r|d d }|d |d S)aaDetermine the identity to use for new commits. If kind is set, this first checks GIT_${KIND}_NAME and GIT_${KIND}_EMAIL. If those variables are not set, then it will fall back to reading the user.name and user.email settings from the specified configuration. If that also fails, then it will fall back to using the current users' identity as obtained from the host system (e.g. the gecos field, $EMAIL, $USER@$(hostname -f). Args: kind: Optional kind to return identity for, usually either "AUTHOR" or "COMMITTER". Returns: A user identity NGIT__NAMEutf-8_EMAIL)userrury<>r  <)rhrirjencoderorz startswithendswith)r{r|rryuser_ucemail_uc default_user default_emailrSrSrTget_user_identitys:        rc Csdz |dd\}}Wnty}zt||d}~wwd|vr$t|d|vs,d|vr0t|dS)zVerify that a user identity is formatted correctly. Args: identity: User identity bytestring Raises: InvalidUserIdentity: Raised when identity is invalid rr Nr )rr ValueErrorrM)rQfstsndexcrSrSrTcheck_user_identitys r graftpointscCsfi}|D],}|dd}|d}t|dkr|d}ng}|g|D]}t|dq$|||<q|S)a;Convert a list of graftpoints into a dict. Args: graftpoints: Iterator of graftpoint lines Each line is formatted as: []* Resulting dictionary is: : [*] https://git.wiki.kernel.org/index.php/GraftPoint Nr rInvalid graftpoint)rrlenr-)rgraftsline raw_graftcommitparentssharSrSrTparse_graftpointss    rcCsHg}|D]\}}|r||dd|q||qd|S)aConvert a dictionary of grafts into string. The graft dictionary is: : [*] Each line is formatted as: []* https://git.wiki.kernel.org/index.php/GraftPoint  r)itemsappendjoin)r graft_linesrrrSrSrTserialize_graftpointss    rcCsptjdkr4ddl}ddlm}m}m}d}||||d|jj f}t |t r,t |}|||s6 dSdSdS)zMark path as to be hidden if supported by platform and filesystem. On win32 uses SetFileAttributesW api: win32rN)BOOLDWORDLPCWSTRrSetFileAttributesW)sysplatformctypesctypes.wintypesrrr WINFUNCTYPEwindllkernel32 isinstancebytesrhfsdecode)pathrrrrFILE_ATTRIBUTE_HIDDENrrSrSrT_set_filesystem_hidden4s       rc@s&eZdZigfdddZdddZdS) ParentsProviderrNNcCs||_||_t||_dSrP)storersetshallows)rRrrrrSrSrTrULszParentsProvider.__init__cCsFz|j|WStyYnw||jvrgS|dur |j|}|jSrP)rrorrr)rR commit_idrrSrSrT get_parentsQs    zParentsProvider.get_parentsrWrP)rYrZr[rUrrSrSrSrTrKsrc@s6eZdZdZdededdfddZdefdd Zdefd d Z dpd ed e eddfddZ de de e fddZde deddfddZde ddfddZdqddZdrddZ  dsddZ  dsde efdd Z  dsd!eed"eed#e ee gdfd$e efd%d&Z dpd'e eedefd(d)Zdeeeffd*d+Zdefd,d-Zd.d/Z d0ede!fd1d2Z"de#fd3d4Z$dpd0ed5e e%deefd6d7Z&dtd9d:Z'dtd;d<Z(de e fd=d>Z)dud?d@Z*dvdBdCZ+de,efdDdEZ-dudFdGZ.dHe/defdIdJZ0dpdKe eefdLdMZ1dNe2ee/ffdOdPZ3dNedefdQdRZ4dNedSe2e!efddfdTdUZ5dNeddfdVdWZ6 dpdXdAdYe e defdZd[Z7d\eeeefddfd]d^Z8gfd_eeddfd`daZ9dbdcZ:          d  e edwdfe edge edhe edie edje edHe/dke eedledmefdndoZ;dS)xBaseRepoakBase class for a git repository. This base class is meant to be used for Repository implementations that e.g. work on top of a different transport than a standard filesystem path. Attributes: object_store: Dictionary-like object for accessing the objects refs: Dictionary-like object with the refs in this repository object_storerBrNNcCs||_||_i|_i|_dS)zOpen a repository. This shouldn't be called directly, but rather through one of the base classes, such as MemoryRepo or Repo. Args: object_store: Object store to use refs: Refs container to use N)rrB _graftpointsrJ)rRrrBrSrSrTrUjs  zBaseRepo.__init__cC t|j)Probe the file-system to determine whether permissions can be trusted. Returns: True if permissions can be trusted, False otherwise. )NotImplementedError_determine_file_moderRrSrSrTrz zBaseRepo._determine_file_modecC tjdkSzProbe the filesystem to determine whether symlinks can be created. Returns: True if symlinks can be created, False otherwise. rrrrrSrSrT_determine_symlinks zBaseRepo._determine_symlinksbaresymlinkscCsddlm}|ddt}|}|ddd|r%|ddd n|ddd |d ur6|s6|}|d urA|dd ||dd ||ddd |||d||t j dddd S)z(Initialize a default set of named files.r r descriptionsUnnamed repositorycorerepositoryformatversion0filemodeTFNrrlogallrefupdatesr{rKexclude) r{r _put_named_filerrrr write_to_filegetvaluerhrr)rRrrr fcfrSrSrT _init_filess"    zBaseRepo._init_filesrcCr)aGet a file from the control dir with a specific name. Although the filename should be interpreted as a filename relative to the control dir in a disk-based Repo, the object returned need not be pointing to a file in that location. Args: path: The path to the file, relative to the control dir. Returns: An open file object, or None if the file does not exist. )rget_named_filerRrrSrSrTrs zBaseRepo.get_named_filecontentscCr)Write a file to the control dir with the given name and contents. Args: path: The path to the file, relative to the control dir. contents: A string to write to the file. )rrrRrrrSrSrTr zBaseRepo._put_named_filecCr)z;Delete a file in the control directory with the given name.)r_del_named_filerrSrSrTr zBaseRepo._del_named_filercCr)Open the index for this repository. Raises: NoIndexPresent: If no index is present Returns: The matching `Index` )r open_indexrrSrSrTrrzBaseRepo.open_indexcCsB|dur|jj}|j||||d\}}|j||||S)a=Fetch objects into another repository. Args: target: The target repository determine_wants: Optional function to determine what refs to fetch. progress: Optional progress function depth: Optional shallow fetch depth Returns: The local refs N)progressdepth)rdetermine_wants_allfetch_pack_dataget_graph_walker add_pack_dataget_refs)rRtargetdetermine_wantsrrcount pack_datarSrSrTfetchs  zBaseRepo.fetchc Cs>|j|||||d}|}t|}t|t|j|||dfS)aFetch the pack data required for a set of revisions. Args: determine_wants: Function that takes a dictionary with heads and returns the list of heads to fetch. graph_walker: Object that can iterate over the list of revisions to fetch and has an "ack" method that will be called to acknowledge that a revision is present. progress: Simple progress function that will be called with updated progress strings. get_tagged: Function that returns a dict of pointed-to sha -> tag sha for including tags. depth: Shallow fetch depth Returns: count and iterator over pack data r)r other_haves)find_missing_objectsget_remote_haslistrr/r) rRr graph_walkerr get_taggedrmissing_objects remote_has object_idsrSrSrTrs  zBaseRepo.fetch_pack_datac s|dvrtdt|j|}||}t|tstdt|dt}t|dt} |gkr?|s3| r5dSGddd} | S|j |} |sI| rKg} t |j|d fd d } t |j| || ||| d S) aFetch the missing objects required for a set of revisions. Args: determine_wants: Function that takes a dictionary with heads and returns the list of heads to fetch. graph_walker: Object that can iterate over the list of revisions to fetch and has an "ack" method that will be called to acknowledge that a revision is present. progress: Simple progress function that will be called with updated progress strings. get_tagged: Function that returns a dict of pointed-to sha -> tag sha for including tags. depth: Shallow fetch depth Returns: iterator over objects, with __len__ implemented Nrzdepth not supported yetz'determine_wants() did not return a listshallow unshallowNc@s,eZdZd ddZdefddZddZdS) z?BaseRepo.find_missing_objects..DummyMissingObjectFinderrNNcSsdSrPrSrrSrSrTr)zNBaseRepo.find_missing_objects..DummyMissingObjectFinder.get_remote_hascSsdSrrSrrSrSrT__len__,rzGBaseRepo.find_missing_objects..DummyMissingObjectFinder.__len__cssgEdHdSrPrSrrSrSrT__iter__/szHBaseRepo.find_missing_objects..DummyMissingObjectFinder.__iter__rW)rYrZr[rintrrrSrSrSrTDummyMissingObjectFinder(s  r)rc|j|SrPridrparents_providerrSrTrBz2BaseRepo.find_missing_objects..get_parents)haveswantsrrrr) rr?rrrr TypeErrorrp frozensetfind_common_revisionsrr# get_shallow) rRrrrrrrBr r unshallowsrr rrSr rTrs:   zBaseRepo.find_missing_objectshavewantr ofs_deltacCs|jj|||||dS)a9Generate pack data objects for a set of wants/haves. Args: have: List of SHA1s of objects that should not be sent want: List of SHA1s of objects that should be sent ofs_delta: Whether OFS deltas can be included progress: Optional progress reporting method )rrr)rgenerate_pack_datar)rRrrrrrSrSrTrOszBaseRepo.generate_pack_datarDcsD|durfddjdD}tj}t||jdS)aRetrieve a graph walker. A graph walker is used by a remote repository (or proxy) to find out which objects are present in this repository. Args: heads: Repository heads to use (optional) Returns: A graph walker object Ncsg|] }|jvr|qSrSr.0rrrSrT ss  z-BaseRepo.get_graph_walker.. refs/heads)r)rBas_dictvaluesrrr$rr)rRrDr rSrrTrfs   zBaseRepo.get_graph_walkercCs |jS)z^Get dictionary with all refs. Returns: A ``dict`` mapping ref names to SHA1s )rBrrrSrSrTr}rzBaseRepo.get_refscCs |jdS)z#Return the SHA1 pointed at by HEAD.HEAD)rBrrSrSrTheadrz BaseRepo.headcCst|dvsJ||}t||s>|turt||tur"t||tur*t||t ur2t |t d|j d|j |S)N(zType invalid: z != ) r get_objectrr(rr'rr,rr+r Exception type_name)rRrclsretrSrSrT _get_objects  zBaseRepo._get_objectrcCs |j|S)zRetrieve the object with the specified SHA. Args: sha: SHA to retrieve Returns: A ShaFile object Raises: KeyError: when the object can not be found r)rRrrSrSrTr#s zBaseRepo.get_objectcCst|j|j|dS)N)rr)rrrrrrSrSrTr s zBaseRepo.parents_providerrcCs|||S)a>Retrieve the parents of a specific commit. If the specific commit is a graftpoint, the graft parents will be returned instead. Args: sha: SHA of the commit for which to retrieve the parents commit: Optional commit matching the sha Returns: List of parents )r r)rRrrrSrSrTrs zBaseRepo.get_parentsr cCr)hRetrieve the config object. Returns: `ConfigFile` object for the ``.git/config`` file. )r get_configrrSrSrTr*rzBaseRepo.get_configcCr)z$Retrieve the worktree config object.)rget_worktree_configrrSrSrTr+rzBaseRepo.get_worktree_configcCr)zRetrieve the description for this repository. Returns: String with the description of the repository as set by the user. )rget_descriptionrrSrSrTr,rzBaseRepo.get_descriptioncCr)Set the description for this repository. Args: description: Text to set as description for this repository. )rset_descriptionrRrrSrSrTr.rzBaseRepo.set_descriptionr cCsRddlm}m}|}|g}|dddr||||7}|||dS)aReturn a config stack for this repository. This stack accesses the configuration for both this repository itself (.git/config) and the global configuration, which usually lives in ~/.gitconfig. Returns: `Config` instance for this repository r r s extensionsworktreeconfigF)writable)r{r r r* get_booleanrr+default_backends)rRr r local_configbackendsrSrSrTget_config_stacks   zBaseRepo.get_config_stackcCsN|d}|dur tS|dd|DWdS1s wYdS)zRGet the set of shallow commits. Returns: Set of shallow commits. rNcSsh|]}|qSrSstriprrrSrSrT z'BaseRepo.get_shallow..)rr)rRrrSrSrTrs  $zBaseRepo.get_shallowcCsV|}|r |||r|||r$|dddd|DdS|ddS)zUpdate the list of shallow objects. Args: new_shallow: Newly shallow objects new_unshallow: Newly no longer shallow objects rrcSsg|]}|dqS)rrSrrSrSrTrr<z+BaseRepo.update_shallow..N)rupdatedifference_updaterrr)rR new_shallow new_unshallowrrSrSrTupdate_shallows   zBaseRepo.update_shallowrefcCs0|j|}|dur |St|j|j|djS)aGet the peeled value of a ref. Args: ref: The refname to peel. Returns: The fully-peeled SHA1 of a tag object, after peeling all intermediate tags; if the original ref does not point to a tag, this will equal the original SHA1. Nr )rB get_peeledr&rr)rRrBcachedrSrSrTrCs zBaseRepo.get_peeledincludecsHddlm}|durg}fdd|d<|j|g|Ri|S)aObtain a walker for this repository. Args: include: Iterable of SHAs of commits to include along with their ancestors. Defaults to [HEAD] exclude: Iterable of SHAs of commits to exclude along with their ancestors, overriding includes. order: ORDER_* constant specifying the order of results. Anything other than ORDER_DATE may result in O(n) memory usage. reverse: If True, reverse the order of output, requiring O(n) memory. max_entries: The maximum number of entries to yield, or None for no limit. paths: Iterable of file or subtree paths to show entries for. rename_detector: diff.RenameDetector object for detecting renames. follow: If True, follow path across renames/copies. Forces a default rename_detector. since: Timestamp to list commits after. until: Timestamp to list commits before. queue_cls: A class to use for a queue of commits, supporting the iterator protocol. The constructor takes a single argument, the Walker. Returns: A `Walker` object r )WalkerNcrrPrrrrSrT.sz%BaseRepo.get_walker..r)walkrFrr)rRrEargskwargsrFrSrrT get_walkers  zBaseRepo.get_walkerruc Cst|tstdt|jdt|dvr(z|j|WSttfy'Ynwz |j|j |WSt yB}zt||d}~ww)zRetrieve a Git object by SHA1 or ref. Args: name: A Git object SHA1 or a ref name Returns: A `ShaFile` object, such as a Commit or Blob Raises: KeyError: when the specified ref or object does not exist z'name' must be bytestring, not z.80r N) rrrtyperYrrrorrBr)rRrurrSrSrT __getitem__2s    zBaseRepo.__getitem__cCs>t|dkst|dkrt|r||jvp||jvS||jvS)zuCheck if a specific Git object or ref is present. Args: name: Git object SHA1 or ref name r!r")rr.rrBrRrurSrSrT __contains__Gs  zBaseRepo.__contains__valuecCsT|ds |dkr&t|tr|j|j|<dSt|tr"||j|<dSt|t|)z~Set a ref. Args: name: ref name value: Ref value - either a ShaFile object, or a hex sha refs/rN)rrr*rrBrrr)rRrurPrSrSrT __setitem__Rs  zBaseRepo.__setitem__cCs&|ds |dkr|j|=dSt|)zORemove a ref. Args: name: Name of the ref to remove rQrN)rrBrrNrSrSrT __delitem__cs zBaseRepo.__delitem__r{r|cCstdtt|S)z.Determine the identity to use for new commits.z;use get_user_identity() rather than Repo._get_user_identity)warningswarnDeprecationWarningr)rRr{r|rSrSrT_get_user_identityns zBaseRepo._get_user_identityupdated_graftpointscCs<|D]\}}|g|D]}t|dq q|j|dS)z|Add or modify graftpoints. Args: updated_graftpoints: Dict of commit shas to list of parent shas rN)rr-rr=)rRrXrrrrSrSrT_add_graftpointsxs  zBaseRepo._add_graftpoints to_removecCs|D]}|j|=qdS)zTRemove graftpoints. Args: to_remove: List of commit shas N)r)rRrZrrSrSrT_remove_graftpointss zBaseRepo._remove_graftpointscCsP||}|dur gS|dd|DWdS1s!wYdS)NcSg|] }|r|qSrSr8r:rSrSrTrz(BaseRepo._read_heads..)r readlines)rRrurrSrSrT _read_headss $zBaseRepo._read_headsrFmessage committerauthortreeencoding merge_heads no_verifysignc Cshz | s |jdWnty}zt||d}~wty$Ynwt}|dur8|}||j|_ n t |dkrBt d||_ | }| durR| d} |dur\t|dd}t|||_|durkt}t||_|durvd}||_|durt|d d}||_t||dur|}t||_|dur|}||_| durz|d d } Wn tyYnw| dur| |_|durt d z| r||_n|jd ||_|jdur||_Wnty}zt||d}~wty||_Ynwt| tr| nd}| dur| |_| r|||j|n`z+|j | }|g| |_| r.|||j||j j!| ||j"d||||d}Wn*tyo| |_| rX|||j||j j#| |j"d||||d}Ynw|szt| d|$dz |jdW|j"Sty}zt%&d|t'WYd}~|j"Sd}~wtyY|j"Sw)aCreate a new commit. If not specified, committer and author default to get_user_identity(..., 'COMMITTER') and get_user_identity(..., 'AUTHOR') respectively. Args: message: Commit message committer: Committer fullname author: Author fullname commit_timestamp: Commit timestamp (defaults to now) commit_timezone: Commit timestamp timezone (defaults to GMT) author_timestamp: Author timestamp (defaults to commit timestamp) author_timezone: Author timestamp timezone (defaults to commit timestamp timezone) tree: SHA1 of the tree root to use (if not specified the current index will be committed). encoding: Encoding ref: Optional ref to commit to (defaults to current branch) merge_heads: Merge heads (defaults to .git/MERGE_HEAD) no_verify: Skip pre-commit and commit-msg hooks sign: 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: New commit SHA1 pre-commitNr"z%tree must be a 40-byte hex sha string MERGE_HEAD COMMITTER)r|rAUTHOR)i18ncommitEncodingzNo commit message specified commit-msgscommit: )r`ra timestamptimezonez changed during commit post-commitzpost-commit hook failed: )(rJexecuterrror(rrrrcrrr7r_rrratimer commit_timecommit_timezonerb author_timeauthor_timezonerjrdr`rstrrrg add_objectrB set_if_equalsr add_if_newrrTrU UserWarning)rRr`rarbcommit_timestampruauthor_timestamprwrcrdrBrerfrgrcrEr{keyidold_headokerSrSrT do_commits-                          zBaseRepo.do_commitrPrNr)NNNNNrNr rW)rNr ) NNNNNNNNNrNFF)d?Z&e d*dddd@dedAed=eeddfdBdCZ'e dgdDdEZ(e d*ddddFdGdHZ)e)Z*d`dIdJZ+dKdLZ,dMdNZ-dOdPZ.defdQdRZ/d`dSdTZ0defdUdVZ1deefdWdXZ2dYeeddfdZd[Z3dbd\eeedfddfd]d^Z4dS)hRepoaA git repository backed by local disk. To open an existing repository, call the constructor with the path of the repository. To create a new repository, use the Repo.init class method. Note that a repository object may hold on to resources such as file handles for performance reasons; call .close() to free up those resources. Attributes: path: Path to the working copy (if it exists) or repository control directory (if the repository is bare) bare: Whether this is a bare repository rrNrootrrNc Cstj|t}|durEtj|stjtj|trd}n&tjtj|tr8tjtj|tr8d}n tdj dit |d||_ |durwtj|rst | }t |}Wdn1sewYtj|||_n||_n||_|t}|dur|tj|t|d|_Wdn1swYn|j|_||_|}z|dd} | durd nt| } Wn tyd } Ynw| d vrt| |d D]\} } | d vrt| q|durttj| t|}t!| |j|j"d } t#$||| i|_%|jtjdd| d}|r?||j%&t'|Wdn 1s:wY|jd| d}|rf||j%&t'|Wdn 1sawYt(|j||j)d<t*||j)d<t+||j)d<t,||j)d<dS)aOpen a repository on disk. Args: root: Path to the repository's root. object_store: ObjectStore to use; if omitted, we use the repository's default object store bare: True if this is a bare repository. NFT%No git repository was found at {path}rs rrr)rr r0)r1loggerrKr)basedirrrhrnrqz post-receiverS)-rhrr CONTROLDIRisfileisdir OBJECTDIRREFSDIRrformatrropenr _controldirr COMMONDIR controldirrrr _commondirr*rjrrorrlowerrr! from_configrFr5 _write_reflogrrUrr=rrrJrrr)rRrrr hidden_pathrrrFr{repository_format_versionformat_versionr_valuerB graft_filerSrSrTrUls         z Repo.__init__c Csddlm}tj|dt|} z ttj| Wn t y'Ynw|dur4| } t | }t ||durBt t}|durHd}t| d} | |||||||dWddS1sgwYdS)Nr )format_reflog_linelogsrabr)reflogrrhrrrrmakedirsdirnameFileExistsErrorr7rrrrsrwrite) rRrBold_shanew_shararorpr`rrr{rrSrSrTrs0     "zRepo._write_reflog.cCs`d}tj|}|r#z||WSty tj|\}}Ynw|s tdjdit|d)zIterate parent directories to discover a repository. Return a Repo object for the first parent directory that looks like a Git repository. Args: start: The directory to start discovery from (defaults to '.') TrrNrS)rhrabspathrrrrr)r&start remainingrrSrSrTdiscovers   z Repo.discovercC|jS)z)Return the path of the control directory.)rrrSrSrTrszRepo.controldircCr)zReturn the path of the common directory. For a main working tree, it is identical to controldir(). For a linked working tree, it is the control directory of the main working tree. )rrrSrSrTrFszRepo.commondircCstj|jd}t|d }|dWdn1swYt|}z t||jtj AWn t y=YdSwt|}t ||j|jk}|jtj @dk}|oY|S)rz.probe-permissionswNFr) rhrrrrlstatchmodst_modestatS_IXUSRPermissionErrorunlink)rRfnamerst1st2 mode_differs st2_has_execrSrSrTrs       zRepo._determine_file_modecCrrrrrSrSrTrrzRepo._determine_symlinkscCsV|tjj}ttj||d}||WddS1s$wYdS)rwbN)lstriprhrseprrrr)rRrrrrSrSrTr%s "zRepo._put_named_filecCs4zttj||WdStyYdSwrP)rhrrrrFileNotFoundErrorrrSrSrTr0s  zRepo._del_named_filecCsJ|dur|}|tjj}z ttj||dWSty$YdSw)aGet a file from the control dir with a specific name. Although the filename should be interpreted as a filename relative to the control dir in a disk-based Repo, the object returned need not be pointing to a file in that location. Args: path: The path to the file, relative to the control dir. basedir: Optional argument that specifies an alternative to the control dir. Returns: An open file object, or None if the file does not exist. Nrb)rrrhrrrrr)rRrrrSrSrTr6s zRepo.get_named_filecCstj|tS)zReturn path to the index file.)rhrrrINDEX_FILENAMErrSrSrT index_pathMszRepo.index_pathrcCs$ddlm}|s t||S)rr r)rEr has_indexrr)rRrrSrSrTrQs  zRepo.open_indexcCs|j S)zCheck if an index is present.rrrSrSrTr^szRepo.has_indexfs_pathsc Cst|j}t|tttjfr|g}t|}ddlm }m }m }m }| }|}|D]} t| ts8t| } tj| rFtd| d|| } tj|| } zt| } Wntypz|| =Wn tymYnwYq,wt| jr|| | } | r| || <q,z|| =Wq,tyYq,wt| jst| jsz|| =Wq,tyYq,w|| | }||| }|j||| |j|| <q,|dS)zpStage a set of paths. Args: fs_paths: List of paths, relative to the repository path r )_fs_to_tree_pathblob_from_path_and_statindex_entry_from_directoryindex_entry_from_statzpath z4 should be relative to repository root, not absoluteN)rhfsencoderrrxrPathLikerrErrrrrget_blob_normalizerisabsrrrOSErrorrorS_ISDIRrS_ISREGS_ISLNKcheckin_normalizerryrr)rRrroot_path_bytesrrrrrEblob_normalizerfs_path tree_path full_pathstrxblobrSrSrTstageds\                   z Repo.stagec Csddlm}m}|}z|dj}Wnty-|D] }||}||=q|YdSw|D]}||}z|j|}t|t sCJ| |jj |} Wn%tyqz||=WYq0typ} z td| d| d} ~ wwwd} z t t j|j|} Wn tyYnw||djdf|djdf| r| jnd| r| jnd| d| r| jnd| r| jndt|| dj| dddd } | ||<q0|dS) zUnstage specific file in the index Args: fs_paths: a list of files to unstage, relative to the repository path. r ) IndexEntryrrNzfile 'z' not in indexr) ctimemtimedevinomodeuidgidsizerflagsextended_flags)rErrrrcrorrrr, lookup_pathrMdecoderhrrrrrtst_devst_inost_uidst_gidrdata) rRrrrrEtree_idrrrc tree_entryrr index_entryrSrSrTunstages^             z Repo.unstageTFsorigin)mkdirrorigincheckoutbranchrrrcCst|j} |r t|z|stj|| d} |durd}n |r$tdt|} z| } | d|fd| | d|fdd|d | d | } |j | |d | j j d ||j d | d| j j d|j d| d|j d\}}|r}|dnd}|r|s|| j d<nt| j ||t| j |||| }|rt| j || }nd}|r|dur| WW| SWW| SWW| Sty| wty|rddl}||w)aClone this repository. Args: target_path: Target path mkdir: Create the target directory bare: Whether to create a bare repository checkout: Whether or not to check-out HEAD after cloning origin: Base name for refs in target repository cloned from this repository branch: Optional branch or tag to be used as HEAD in the new repository instead of this repository's HEAD. progress: Optional progress function depth: Depth at which to fetch symlinks: Symlinks setting (default to autodetect) Returns: Created repository as `Repo` )rNTz"checkout and bare are incompatiblesremotesurlsfetchs+refs/heads/*:refs/remotes/s/*s clone: from rs refs/remotes/r)r`s refs/tagsrrr)rhrrrrinitr init_barer*r write_to_pathrrB import_refsrfollowr;r9r: reset_index BaseExceptioncloseshutilrmtree)rR target_pathrrrrrrrr encoded_pathr target_config ref_message head_chain origin_sha origin_headhead_refrr rSrSrTclonesv              z Repo.clonercc Csddlm}m}m}m}|dur&|d}t|tr#|j\}}||}|j }| } | ddt j dk} | ddt j dkrA|} n|} | dd d rM|} ndd d } ||j||j|| | | dS)zReset the index back to a specific tree. Args: tree: Tree SHA to reset to, None for current HEAD tree. r )build_index_from_treesymlinkvalidate_path_element_defaultvalidate_path_element_ntfsNrcoresfilemodentscore.protectNTFSssymlinksTrNcSsLt|dt|tr dnd}||WddS1swYdS)Nrbr)rrrr)sourcerrrSrSrT symlink_fn[s  "z$Repo.reset_index..symlink_fn)honor_filemodevalidate_path_elementrrW)rErrrrrr+objectr#rcr*r3rhrurrr) rRrcrrrrr_clsobjr{r r!rrSrSrTr >s0    zRepo.reset_indexr cCsNddlm}tj|d}z||WSty&|}||_|YSw)Nr rzconfig.worktree)r{r rhrrrF from_pathr)rRr rrrSrSrTr+ks   zRepo.get_worktree_configcCsLddlm}tj|jd}z||WSty%|}||_|YSw)r)r rr{)r{r rhrrrr%r)rRr rr'rSrSrTr*vs   zRepo.get_configcCs`tj|jd}zt|d }|WdWS1swYWdSty/YdSw)zsRetrieve the description of this repository. Returns: A string describing the repository or None. rrN)rhrrrrrrrRrrrSrSrTr,s ( zRepo.get_descriptioncCsd|jdS)Nz rrrSrSrT__repr__r z Repo.__repr__cCs|d|dS)r-rN)rr/rSrSrTr.szRepo.set_descriptionrc CstD]}ttjj|g|Rq|dur ttj|t}||||d} |durM|dur9ddlm } | }z| dd}Wn t yLt }Ynw| jdt|| j||d| S)N)rrr )r r defaultBranchr)rr)BASE_DIRECTORIESrhrrrr!rrr{r defaultrjroDEFAULT_BRANCHrBset_symbolic_refr1r) r&rrrrr{default_branchrdr'r rSrSrT_init_maybe_bares"   zRepo._init_maybe_bare)rr{r.rrcCsD|rt|tj|t}t|t||j||d|||dS)zCreate a new repository. Args: path: Path in which to create the repository mkdir: Whether to create the directory Returns: `Repo` instance F)r{r.r)rhrrrrrr0)r&rrr{r.rrrSrSrTrs  z Repo.initc Cs|rt||durtj|}tj|t}tj||}tj|t}t|d}| dt |dWdn1sDwYzt|Wn t yYYnwzt|Wn t yjYnwttj|t d}| t |dWdn1swYttj|t d }| dWdn1swYttj|dd}| |dWdn1swY||} | | S)a6Create a new working directory linked to a repository. Args: path: Path in which to create the working tree. main_repo: Main repository to reference identifier: Worktree identifier mkdir: Whether to create the directory Returns: `Repo` instance Nrsgitdir: rs../.. HEAD)rhrrbasenamerr WORKTREESrrrrrGITDIRrrr ) r&r main_repo identifierrmain_worktreesdirworktree_controldir gitdirfilerrrSrSrT_init_new_working_directorys@      z Repo._init_new_working_directory)rrr{r.cCs$|rt||j||d|||dS)zCreate a new bare repository. ``path`` should already exist and be an empty directory. Args: path: Path to create bare repository in Returns: a `Repo` instance T)rr{r.)rhrr0)r&rrrr{r.rSrSrTrs zRepo.init_barecCs|jdS)z*Close any files opened by this repository.N)rr rrSrSrTr sz Repo.closecCs|SrPrSrrSrSrT __enter__rzRepo.__enter__cCs |dSrP)r )rRexc_typeexc_valexc_tbrSrSrT__exit__s z Repo.__exit__cCsNi}|}z|j|jdj}t|||j|WSty&t||YSw)zReturn a BlobNormalizer object.r)r7rrBrcr ror)rRgit_attributes config_stackrcrSrSrTr!s zRepo.get_blob_normalizercCstj|ddS)zGReturn the path of the sparse-checkout file in this repo's control dir.rKzsparse-checkout)rhrrrrrSrSrT_sparse_checkout_file_path1szRepo._sparse_checkout_file_pathcCs0|}|ddd|ddd|dS)zBEnsure the repository is configured for cone-mode sparse-checkout.rssparseCheckouttruesparseCheckoutConeN)r*rr)rRr{rSrSrTconfigure_for_cone_mode5s zRepo.configure_for_cone_modecCs4|}z |dd}|dkWStyYdSw)zPReturn True if 'core.sparseCheckoutCone' is set to 'true' in config, else False.rDrFrEF)r*rjro)rRr{sc_conerSrSrTinfer_cone_mode<s   zRepo.infer_cone_modecCsb|}z!t|dd}dd|DWdWS1swYWdSty0gYSw)zReturn a list of sparse-checkout patterns from info/sparse-checkout. Returns: A list of patterns. Returns an empty list if the file is missing. rrdcSr\rSr8r:rSrSrTrOr]z5Repo.get_sparse_checkout_patterns..N)rCrrr&rSrSrTget_sparse_checkout_patternsFs ( z!Repo.get_sparse_checkout_patternspatternscCsttj|d}tj|dd|}t|ddd}|D] }||dqWddS1s3wYdS) zWrite the given sparse-checkout patterns into info/sparse-checkout. Creates the info/ directory if it does not exist. Args: patterns: A list of gitignore-style patterns to store. rKT)exist_okrrrJrN)rhrrrrrCrr)rRrLinfo_dirrrpatrSrSrTset_sparse_checkout_patternsSs"z!Repo.set_sparse_checkout_patternsdirscCsPddg}|r!|D]}|d}d|d}|r ||vr ||q||dS)a!Write the given cone-mode directory patterns into info/sparse-checkout. For each directory to include, add an inclusion line that "undoes" the prior ``!/*/`` 'exclude' that re-includes that directory and everything under it. Never add the same line twice. z/*z!/*//N)r9rrP)rRrQrLr/rrSrSrTset_cone_mode_patternscs    zRepo.set_cone_mode_patternsrrW)rrPr)rNrr)NNNN)NF)5rYrZr[r\rx__annotations__rrr%rUr classmethodrrrFrrrrrrrrr rrhrrrrrrr r+r*r,r(r.r0rr;rcreater r<r@rrCrGrIrKrPrSrSrSrSrTrWs  ]        B= _ -     %    $rc@seZdZdZdddZdddZddd Zd d Zd d ZddZ dddZ dddZ dddZ dddZ ddZeddZdS) MemoryRepozRepo that stores refs, objects, and named files in memory. MemoryRepos are always bare: they have no working tree and no index, since those have a stronger dependency on the filesystem. rNNcCsNddlm}g|_ti|jd}t|t|i|_d|_ ||_ d|_ dS)z"Create a new repository in memory.r rrTN) r{r _reflogr4_append_reflogrrUr" _named_filesr_config _description)rRr refs_containerrSrSrTrU{s  zMemoryRepo.__init__cGs|j|dSrP)rXr)rRrIrSrSrTrYszMemoryRepo._append_reflogcCrOrPr\r/rSrSrTr.rVzMemoryRepo.set_descriptioncCrrPr^rrSrSrTr,szMemoryRepo.get_descriptioncCrrrrrrSrSrTrrzMemoryRepo._determine_file_modecCrr_rrrSrSrTrrzMemoryRepo._determine_symlinkscCs||j|<dS)rN)rZrrSrSrTrszMemoryRepo._put_named_filecCs$z|j|=WdStyYdSwrP)rZrorrSrSrTrs  zMemoryRepo._del_named_filecCs"|j|d}|dur dSt|S)aGet a file from the control dir with a specific name. Although the filename should be interpreted as a filename relative to the control dir in a disk-baked Repo, the object returned need not be pointing to a file in that location. Args: path: The path to the file, relative to the control dir. Returns: An open file object, or None if the file does not exist. N)rZrjr)rRrrrrSrSrTrs zMemoryRepo.get_named_filercCst)zFail to open index for this repo, since it is bare. Raises: NoIndexPresent: Raised when no index is present )rrrSrSrTrszMemoryRepo.open_indexcCr)zKRetrieve the config object. Returns: `ConfigFile` object. )r[rrSrSrTr*szMemoryRepo.get_configcCsL|}|D]}|j|q|D] \}}|j||q|jdd|S)zCreate a new bare repository in memory. Args: objects: Objects for the new repository, as iterable refs: Refs as dictionary, mapping names to object SHA1s Tr)rryrrBr{r)r&rArBr'r$refnamerrSrSrTrs  zMemoryRepo.init_barerWrPr)rYrZr[r\rUrYr.r,rrrrrrr*rUrrSrSrSrTrWts     rWrPrW)or\rhrrrsrTcollections.abcriortypingrrrrrr r{r r rErerrorsrrrrrrrrrfilerrJrrrrr line_endingrr rr!r"r#r$r%r&rAr'r(r)r*r+r,r-r.packr/rBr0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rrr REFSDIR_TAGS REFSDIR_HEADSrrr4r3r*r,r$rMr^tuplerxrzrrrrrrrrrrrrrrrWrSrSrSrTs     ,  ( L & 2 ! b#