+ 4jy6Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI H t ^RI H t ^RIHt^RIHt.R&Ot]P&!]4t]P,!R 4t]P,!R 4tR t^xtR tR't!RR]4t] !RRR7!RR44t] !RRR7!RR 44t RRlt!RRlt"RRlt#RR/RRllt$RRlt%RR/R R!llt&R"R#lt'R$R%lt(R#)(adShallow VCS clone helper for nab-index. Performs ``git clone --depth 1`` against a directory under the cache root. URL admission lives upstream in :func:`nab_python._vcs_admission.admit_vcs_url`. Cache layout under ``cache_root / "vcs"``: // ``repo-key`` is the 16-char prefix of a SHA-256 over the canonicalised repo URL (``vcs+`` prefix stripped). ``commit-sha`` is always a concrete 40-char hash; floating refs are resolved via ``git ls-remote`` before the clone runs. A finished clone carries a ``.git/nab-complete`` marker file; a tree without it is discarded and recloned. ) annotationsN) dataclass)Path)urlsplit)subdirectory_escapesVcsClone VcsCloneError VcsRequestz^[0-9a-fA-F]{40}$z^git\+z nab-completeic]tRt^PtRtRtR#)rz,Raised when a clone or ref resolution fails.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r _/home/user/pdf2html-billing-ledger-validate/.venv/lib/python3.14/site-packages/nab_index/vcs.pyrrPs6rT)frozenslotsc>]tRt^Tt$RtR]R&R]R&RtR]R&RtR #) ra=Result of :func:`prepare_clone`. ``path`` is the absolute filesystem path to the (possibly cached) checked-out source tree. ``commit_sha`` is the 40-char hex SHA the clone is pinned to. ``subdirectory`` is the relative path inside the checkout that contains the project pyproject.toml; ``""`` means the repo root. rpathstr commit_sha subdirectoryr N)r r rrr__annotations__rrr rrrrTs JOL#rcZ]tRt^dt$RtR]R&R]R&R]R&R]R&]RRl4tR tR #) r a4Parsed representation of a ``git+https://repo.git@ref#...`` URL. ``ref`` may be a 40-char SHA or a branch / tag name. ``ref`` of ``""`` means "HEAD"; the caller is expected to have decided whether floating refs are permitted. ``subdirectory`` is parsed from the ``#subdirectory=...`` fragment if present. rschemerepo_urlrefrc V^8dQhRRRR/#)urlrreturnr r )formats"r __annotate__VcsRequest.__annotate__tsTTT Trc VPR4wr#p\PV4pVfRV: 2p\V4hV\ VP ^44Rp\ V4wrRp VPR4F"p V PR4wrp V R8XgK T p K$ \V 4'dRV : R V: 2p\V4hV!R WV R 7#) z.Parse a pip-style VCS URL into its components.#Nznot a recognised VCS URL: r&=rzunsafe VCS subdirectory z in git)rrr r) partition_VCS_PREFIX_REmatchrlengroup_split_repo_refsplitr)clsr# url_no_frag_fragmentr/msginnerrepor r fragment_partkeyvalues&& rparseVcsRequest.parsess$'==#5 $$[1 =.sg6C$ $C A/12#E*  %^^C0M)33C8MCEn$$ 1 - -,\,rr rrr r ds2 KM HTTrc V^8dQhRRRR/#)r"r9rr$ztuple[str, str]r )r%s"rr&r&s::3:?:rcTRV9dHRV9dVR3#VPR4wrpRV9dVPR4wrBpV RV 2V3#VR3#VPR4wrbpVPR4wrpV 'dRV9dVR3#VPR4wrBpV RV RV 2V3#)aSplit ``inner`` (no ``vcs+`` prefix, no fragment) into ``(repo, ref)``. For URL forms (``scheme://...``), the ref is everything after the last ``@`` that appears in the path component (after the netloc), so branch names containing ``/`` (e.g. ``release/1.0``) survive. A ``user@`` in the authority section is left alone. For the SSH shortcut form (``user@host:path[@]``), the first ``:`` separates the auth+host from the path; an optional ``@`` may follow the path. z://:r@/)r- rpartition) r9 host_partr6 path_part path_repor scheme_partrestnetlocslashs & rr2r2s E e 2; "'//#"6 i )  ) 4 4S 9 I# k9+.4 4r{ ??51KD#~~c2F9 Cy(r{!,,S1I#m3vha { 3S 99rc V^8dQhRRRR/#)r"rrr$r )r%s"rr&r&sEEEErcv\P!VPR44P4R,#)zutf-8:NN)hashlibsha256encode hexdigestrs&r _repo_keyrVs( >>(//'2 3 = = ? DDrc V^8dQhRRRR/#)r"rrr$boolr )r%s"rr&r&s / /S /T /rc2\V4PR8H#)aReturn True when ``repo_url`` reaches its repo through the filesystem. Offline means nab issues no network request of its own. A ``file`` URL is read by path, so it stays available offline whatever the authority says: git drops the authority outright on POSIX, and on Windows turns it into a UNC path, which is a filesystem call like any other. Whether that path is backed by a local disk, NFS, or SMB is the operating system's business, the same as it is for a ``file:`` index. file)rrrUs&r_is_local_repor[s H  $ $ ..rofflineFc ,V^8dQhRRRRRRRRRR /#) r" cache_rootrrequestr require_pinrXr\r$rr )r%s"rr&r&sACCC C C  C  CrcV'*;'g\VP4p\WVR7pVR, \VP4, V, p\ V4'd\ VVVP R7#V'gRVP RV R2p\V4hVPPRRR7VP4'd(\ V4'g\P!V4\\P!VPV R 2R R 74p\!VPWX4VP#V4\ VVVP R7# \$dUp \P!TRR 7\ T4'g"R TP RT RT 2p\T4T hRp ? LrRp ? ii;i)a^Resolve ``request.ref`` to a SHA and ensure a clone exists at it. When ``require_pin`` is True and the ref is not already a 40-char SHA, raises :class:`VcsCloneError` rather than fetching a floating ref. When False, the helper consults ``git ls-remote`` to resolve the named ref to a SHA, then performs a shallow clone of that commit. ``offline`` withholds every git call that would reach the remote: a complete cached clone is still served; anything else raises :class:`VcsCloneError`. A ``file://`` repo is read through the filesystem rather than the network, so it still clones. Idempotent: a destination carrying the completion marker is reused without a fetch. A fresh clone lands in a temporary sibling directory and is renamed into place only once fully checked out, so a concurrent or interrupted run never leaves a partial tree at the cache path. )r`may_reach_remotevcs)rrrzno cached clone of  @ z (offline mode)Tparentsexist_ok.z.tmp)dirprefixsuffix ignore_errors clone of z could not be moved into place: N)r[r _resolve_sharV_clone_completerrrparentmkdirexistsshutilrmtreertempfilemkdtemp_shallow_clonerenameOSError) r^r_r`r\rbshadestr8tmpexcs &&$$ r prepare_cloners4#{FFnW5E5E&F ;K C   '*:*: ; ;c ADt --  #G$4$4#5S_MC  KKdT2 {{}}_T22  d xDKK3%q &Q RC7##S. . 4  ))  . c.t$$G,,-S6&&)U,  $# - %.s E44 G?A GGc V^8dQhRRRR/#)r"r|rr$rXr )r%s"rr&r&s88$848rcFVR, \, P4#)zFReturn True when ``dest`` holds a fully fetched and checked-out clone..git)_COMPLETE_MARKERis_file)r|s&rrprps 6M, , 5 5 77rrbc(V^8dQhRRRRRRRR/#)r"r_r r`rXrbr$rr )r%s"rr&r&s8EE EE E  Erc VP'd2\PVP4'd VP#V'd+RVP: RVP: R2p\ V4hVP;'gRpV'g RV: RVP R2p\ V4hRR VPWD R 2.p\ P !VR R R \4\R 7pTPP4P4pT'gRT: RTP 2p\ T4h\RT4R4p T eT MT^,p T P!4^,p \PT 4'gRT : 2p\ T4hT # \\ P\ P3d'pR TP RT RT 2p\ T4ThRp?ii;i)zReturn a 40-char SHA for ``request.ref``. Raises when ``require_pin`` is True and ``ref`` is not already a SHA. Otherwise consults ``git ls-remote`` to look up the ref, which ``may_reach_remote=False`` refuses: no cache holds a ref-to-SHA mapping. z!refusing to resolve floating ref z for z: vcs.require-pin is trueHEADzcannot resolve ref z at z9 (offline mode): only a pinned commit resolves from cacher,z ls-remote^{}T)checkcapture_outputtextenvtimeoutzgit ls-remote  : Nzno ref z found at c3"TF4qP4R,PR4'gK0VxK6 R#5i)rN)r3endswith).0lns& r _resolve_sha..@s'H"B)@)@)G22s-> >zunexpected ls-remote output: )r FULL_GIT_SHA_REr/rr subprocessrun_git_env_LS_REMOTE_TIMEOUT_SECONDSFileNotFoundErrorCalledProcessErrorTimeoutExpiredstdoutstrip splitlinesnextr3) r_r`rbr8targetls_remote_argsprocr~linespeeledchosenr{s &$$ rroros{{{,,W[[99{{/ ?  ##< > C  [[ " "FF !&40@0@/AG I C  ['*:*:FheDTUN*~~  .   KK    * * ,E zG,<,<+=>C  HH$ OF)VuQxF ,,. C   % %-fZ8C  J1 %%!! * w//0&C5AC c) *s(F$$*G4!G//G4c(V^8dQhRRRRRRRR/#)r"rrr{r|rr$Noner )r%s"rr&r&Ks(6*6*S6*s6*$6*46*rcVPRRR7\4p.ROpRRRRRW.p.ROp\P!VRVVR7\P!VRVV\R 7\P!VRVVR7TR, \, P4R# \ \P \P3d5p\P!TRR 7R T R T R T 2p\T4ThRp?ii;i \d5p\P!TRR 7RT R T RT 2p\T4ThRp?ii;i)aShallow-clone ``repo_url`` at exactly ``sha`` to ``dest``. Uses ``git init`` + ``git fetch --depth 1`` to land precisely the chosen commit without pulling history. Hosts that disallow direct sha fetch surface as a :class:`VcsCloneError` from the fetch step. The completion marker is written last, so its presence proves the checkout finished. ``dest`` is the temporary directory ``prepare_clone`` created with :func:`tempfile.mkdtemp`, so it already exists. Trer,--quietfetchz--depth1)rcwdr)rrrrrlzfailed to clone rdrNrrnz could not be marked complete: )r,initr)r,checkoutr FETCH_HEAD)rrrrr_FETCH_TIMEOUT_SECONDSrrrrtrurrtouchrz) rr{r|r init_args fetch_args checkout_argsr~r8s &&& rrxrxKsI JJtdJ+ *C*I)YXKJ@M*    *      * ) )002 %%!! *  d$/  #cU"SE:C c)* * d$/(3se+J3%PC c)*s0AB'"D'*D/DD E/EEcV^8dQhRR/#)r"r$zdict[str, str]r )r%s"rr&r&s.rc\\P4p\FpVP VR4K RVR&VP RR4VP RR4V#)aReturn an environment for git subprocesses. Disables interactive prompts and any auto-detected user config so the clone fails fast on unauthenticated repos rather than hanging, and drops the inherited repo-selection variables so every call acts on the directory nab passes as ``cwd``. N0GIT_TERMINAL_PROMPTGIT_CONFIG_GLOBALz /dev/nullGIT_CONFIG_SYSTEM)dictosenviron_REPO_SELECTION_VARSpop setdefault)rnames rrrsZ rzz C$ d%"%CNN& 4NN& 4 Jr)rrrr r)GIT_DIR GIT_WORK_TREEGIT_INDEX_FILEGIT_OBJECT_DIRECTORY GIT_ALTERNATE_OBJECT_DIRECTORIESGIT_COMMON_DIR GIT_NAMESPACE))r __future__rrQloggingrrertrrv dataclassesrpathlibr urllib.parsersubdirr__all__ getLoggerr loggercompilerr.rrrr Exceptionrrr r2rVr[rrprorxrr rrrs$# !!(    8 $ **12I&" ! 7I7 $d#  $  $d#!T!T$!TH::E /C  CL8 E" EP6*rr