+ 4j)Rt^RIHt^RIt^RIt^RIt^RIt^RIHt^RI H t ^RI H t ^RI Ht^RIHt^RIHt^R IHt^R IHt^R IHtHtHtHtHt] 'd^R IHt^R IHt^RIH t .R*Ot!]PD!]#4t$!RR]%4t&]!RRR7!RR44t']!RRR7!RR44t(RRlt)RRlt*RRlt+RRlt,R^R R!/R"R#llt-R$R%lt.R&R'lt/R(R)lt0R#)+a}Download every distribution referenced by a finished resolve. Consumes a :class:`~nab_python.lockfile.LockInput` and writes every recorded wheel, sdist, and direct-URL archive into a target directory, verifying the recorded hash. Local and VCS pins are skipped: their contents live elsewhere on disk and the lockfile carries no ``sha256`` for them. An artefact with a local ``file://`` URL (a find-links index entry or a direct-URL archive) is copied from its on-disk path rather than fetched over HTTP. Use as a one-shot from the CLI ``nab download`` command, or programmatically after :func:`~nab_python.resolve.build_lock_input`. ) annotationsN) dataclass)Path) TYPE_CHECKING)urlsplit) atomic_write)AsyncSimpleClient)parse_file_url) HttpError) ArchivePinIndexPinLocalPin LockInputVcsPin)Iterable)AsyncHttpTransport)PinShape DownloadEntry DownloadErrorDownloadResultc]tRt^4tRtRtR#)rzAA downloaded artefact failed hash verification or the HTTP fetch.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__re/home/user/pdf2html-billing-ledger-validate/.venv/lib/python3.14/site-packages/nab_python/download.pyrr4sKrT)frozenslotscf]tRt^8t$RtR]R&R]R&R]R&R]R&R]R&R]R&R tR ]R &R tR #) raOne artefact to fetch into the output directory. ``hash_algo`` is one of ``sha256``, ``sha384``, ``sha512`` and ``digest`` is the recorded hex digest under that algorithm. The downloader verifies against the first acceptable algorithm the index published, preferring sha256 over sha384 over sha512. ``local_path`` is set for an artefact read from disk instead of fetched over ``url``: a wheel or sdist from a local ``file://`` (find-links) index, or a direct-URL archive whose ``url`` is ``file://``. strpackageversionfilenameurl hash_algodigestNz Path | None local_pathr)rrrrr__annotations__r*rrrrrr8s1 L LM HN K"J "rc0]tRt^Pt$RtR]R&R]R&RtR#)rzSummary of a download run.ztuple[Path, ...]writtenskippedrN)rrrrrr+rrrrrrPs$  rc V^8dQhRRRR/#) lock_inputrreturnIterable[DownloadEntry]r)formats"r __annotate__r5Xs  y -D rc#\"\4p\VP4Fp\VPV,PP 44FIwr4\ W44F5pVP V9gKVPVP 4VxK7 KK K R#5i)a0Yield every downloadable artefact referenced by ``lock_input``. A wheel, sdist, or direct-URL archive for each pin, deduplicated by URL across the targets the resolve ran against so an artefact shared by several of them is downloaded once. Local and VCS pins carry no downloadable URL and are skipped. N)setsortedtargetspinsitems_entries_for_pinr'add)r1seenlabel canonicalpinentrys& riter_artifactsrCXsUD **+$Z%7%7%>%C%C%I%I%KLNI))999D(HHUYY'K:M,s A8B,?-B,c$V^8dQhRRRRRR/#)r0r@r#rArr2r3r)r4s"rr5r5is"(7Nrc #0"\V\4'd\W4RjxL R#\V\4'dVPwr#\ VP 4pVPR8Xd\VP 4MRp\VVP\P!VP4VP VVP4VR7xR#\V\\ 34'dR#RV: 2p\#V4hL5i)Nfiler$r%r&r'r(r)r*zunknown pin shape: ) isinstancer _iter_index_pinr primary_digestrr'schemer rr% posixpathbasenamepathlowerr r TypeError)r@rAalgor)partsr*msgs&& rr<r<is#x  "9222 C $ $)) !05 0F^CGG,D KK'' 3<<>!   C(F+ , ,#C7+n% 3s%DDC-Dc$V^8dQhRRRRRR/#)r0r@r#rAr r2r3r)r4s"rr5r5s"  s  6M rc #"VPeVPPwr#\VVPVPPVPP VVP 4VPPR7xVPF[pVPwr#\VVPVPVP VVP 4VPR7xK] R#5i)NrG) sdistrJrr%r&r'rOr*wheels)r@rArQr)wheels&& rrIrIs yyyy// KKYY'' <<>yy++  ++ KK^^ <<>''  sCc V^8dQhRRRR/#)r0 artefactslist[DownloadEntry]r2Noner)r4s"rr5r5s(()<((rc L/pVFpVPVP4pVelVPVP8wdQRVP: RVP RVP RVP RVP R2 p\ V4hW!VP&K R#)aRefuse two distinct artefacts that would write to one output filename. Index sdist/wheel filenames embed the package name and version, so they never collide. A direct-URL archive's filename is the bare basename of its URL, which is arbitrary: two archives from different repositories commonly share one (e.g. a GitHub ``v1.0.0.tar.gz`` tag tarball). Two artefacts with different digests but the same basename would clobber each other in the flat output dir, silently dropping one, so refuse it loudly. Nz%artefacts collide on output filename : ==z and z/ differ. Download them to separate directories.)getr&r)r$r%r)rZby_namerBpriorrSs& r_reject_colliding_targetsrcs)+G ENN+  !=77IJMM?"U]]O4MM?"U]]O4::   $ $"'rmax_concurrencyofflineFc 0V^8dQhRRRRRRRRR R R R /#) r0r1r transportr output_dirrrdintreboolr2rr)r4s"rr5r5sD!    rc VPRRR7\\V44p\V4\P !\ WQW#VR74#)aDownload every artefact in ``lock_input`` into ``output_dir``. Already-present files whose digest matches the recorded algorithm are left alone so the command is idempotent. Mismatched files are re-fetched and overwritten. HTTP failures and post-download hash mismatches both raise :class:`DownloadError` after the fetcher has shut down. ``offline`` refuses any artefact that would need an HTTP fetch; already-present files and local ``file://`` artefacts are still served. T)parentsexist_okre)mkdirlistrCrcasynciorun_run_downloads)r1rgrhrdrerZs&&&$$ r download_lockrtsN(TD1^J/0Ii( ;; *w  rc 0V^8dQhRRRRRRRRR R R R /#) r0rZr[rgrrhrrdrirerjr2rr)r4s"rr5r5sL5J5J"5J!5J5J 5J  5J5Jrcaaa a a a "\P!V4o \V4o .o .o RV VVV V V 3RllpVUu.uFp\P!V!V44NK! pp\P!V!GRjxL S P4GRjxL \\S 4\S 4R7#uupiLA \ dSTF+pTP 4'dKTP4K- \P!TRR/GRjxL hi;iL S P4GRjxL i;i5i)c V^8dQhRRRR/#)r0rBrr2r\r)r4s"rr5$_run_downloads..__annotate__s,,-,D,rc H<"S;_uu_4GRjxL VP'd/\VP4PVP8wd5VP RVP RVP: 2p\ V4hSVP, p\ W PVP4'dPS PV4\PRVPVP4RRR4GRjxL R#\VSSR7GRjxL p\P!VPV4P4pW@P8wdQVP RVP RVP RVP RVP RV 2 p\ V4h\!W#4S PV4\PR V4RRR4GRjxL R#ELLLL +GRjxL 'giR#;i5i) Nr_z: unsafe artefact filename: zskip %s (%s matches)rnr^z mismatch for z expected: z actual: zwrote %s)r&rnamer$r%r_already_presentr(r)appendloggerinfo _fetch_byteshashlibnew hexdigestr) rBrStargetdataactualclientrerhsemr.r-s & r_one_run_downloads.._ones33>>>T%..%9%>%>%..%P}}oR 7227..1CE$C((%..0FFFv& 2ENNEOOT33&eVWEED[[$7AACF%}}oR b8I$U^^$45##(<<.vhH $C((  & NN6 " KK F +533F333s|H"G<H"C+H H" G? H"H$H%CH* H"5H6H"?H"HH"H H H H  H"Nreturn_exceptionsT)r-r.) rq Semaphorer create_taskgather BaseExceptiondonecancelaclosertuple) rZrgrhrdrerataskstrrr.r-s &&f&d @@@@rrsrss   O ,C y )FGG,,:4= =9aW a )9E = nne$$$mmo %.%. II >$ A6688 nners #! !).0)GG(6"    8 $LIL $d###$#. $d#$ "2 6(0    <5Jp*>Qr