+ 4jXRt^RIHt^RIHtHt^RIHt^RIt^RI H t ^RI H t H t ^RIHt^RIHt^R IHt^R IHt^R IHt^R IHt]'d^R IHt^RIHt^RIHt.R?Ot!RR] 4t!!RR]"4t#RRlt$RR/RRllt%RRlt&RRlt'RRlt(RR lt)R!R"lt*R#R$lt+R%R&lt,R'R(lt-R@R)R*llt.R+R,lt/R-R.lt0R/R0lt1R1R2lt2R3R4lt3R5R6lt4R7R8lt5R9R:lt6R;R<lt7R=R>lt8R#)AzBRead dependencies and dependency groups from pyproject.toml files.) annotations)MappingSequence) TYPE_CHECKINGN)ResolutionError)dependency_marker_holds marker_set)resolve_dependency_groups)ExceptionGroup)Marker) Requirementcanonicalize_name)validate_specifier_versions)Iterator)Path) VersionRangeInvalidProjectRequirementErrorInvalidProjectTableErrorc]tRt^.tRtRtR#)rzIA pyproject.toml dependency or metadata value is invalid or unresolvable.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rn/home/user/pdf2html-billing-ledger-validate/.venv/lib/python3.14/site-packages/nab_python/requirements_file.pyrr.sSrc]tRt^2tRtRtR#)ra*A pyproject.toml table such as ``[project]`` is not a table. A subclass of :class:`TypeError`, so existing ``except TypeError`` and ``pytest.raises(TypeError)`` sites keep working, but the CLI catches it specifically so an unrelated internal ``TypeError`` is not mislabelled as a user-file error. rNrrrrrr2src$V^8dQhRRRRRR/#)dep_strstr extra_namereturnr)formats"r __annotate__r(<s!src\V4p\VRR7pRV R2pVPeRVP RV 2pMTpRVnV RV 2#) aAppend ``extra == "name"`` to a :pep:`508` dep string. Parses with :class:`Requirement` rather than splitting on the first ``;`` so a semicolon inside a direct-reference URL is not mistaken for the marker separator; an existing marker is combined with ``and``. ``extra_name`` is a table key interpolated into the quoted marker, so it is canonicalised with ``validate=True`` (PEP 685). A key that is not a valid name (say one containing a quote) then raises :class:`InvalidName` instead of producing a marker that gates the dep wrongly. T)validatez extra == ""N(z) and z ; )r rmarker)r#r%reqcanonical_extra extra_markerr-s&& r_add_extra_markerr1<sf g C' TBO02L zzSZZL|n5CJU#fX rextrac(V^8dQhRRRRRRRR/#)r"r#r$sourcer2 str | Noner&r r)r's"rr(r(Ts, )3rcVe \W4MTp\V4p\VP4V# \dpRT RT 2p\ T4ThRp?ii;i)aParse one PEP 508 dependency string, raising if it is malformed. An ``extra`` name is folded in as an ``extra == "name"`` marker. A string that is not valid PEP 508, or one whose specifier carries a version that will not convert, raises :class:`InvalidProjectRequirementError`, so a candidate declaring one malformed dependency is rejected whole rather than resolved with the dependency silently dropped. Nzinvalid requirement in : )r1r r specifier ValueErrorr)r#r4r2textr.excmsgs&&$ rparse_project_requirementr=Tsg;494E 07$#CMM2 J ;'xr#7,S1s:;s15 AAAc$V^8dQhRRRRRR/#)r"strings Sequence[str]r4r$r&list[Requirement]r)r's"rr(r(is'CC CsC?PCrcBVUu.uFp\W!4NK up#uupi)z=Parse PEP 508 strings, naming ``source`` if one is malformed.)r=)r?r4ss&& rparse_requirementsrDis :A B'Q %a 0' BB Bsc$V^8dQhRRRRRR/#)r"valueobjectr4r$r& list[str]r)r's"rr(r(ns!  v s y rc\V\4'd;\;QJdRV4F 'dK RM RM !RV44'gV R2p\V4hV#)aValidate that a PEP 621 dependency value is an array of strings. A bare string passes the type checker as ``Sequence[str]`` but iterates character by character, so ``dependencies = "requests"`` would parse as eight single-character requirements rather than fail. c3B"TFp\V\4xK R#5iN) isinstancer$).0items& r &require_string_list..us-VPUjs.C.CPUFTz must be an array of strings)rLlistallr)rFr4r<s&& rrequire_string_listrTnsP eT " "##-VPU-V###-VPU-V*V*V45,S11 Lrc V^8dQhRRRR/#)r"pathrr&zMapping[str, object]r)r's"rr(r({sd';rc2VPR4;_uu_4p\P!V4pRRR4XPR/4p\ V\ 4'g$R\ V4P 2p\V4hV# +'giL];i)aWLoad a pyproject.toml and return its ``[project]`` table. Returns an empty mapping when ``[project]`` is absent (a workspace-root pyproject without its own distribution). Raises :class:`TypeError` when ``[project]`` is present but not a table, so the readers below fail with a named diagnostic instead of a raw subscript or attribute error. rbNproject[project] must be a table, got opentomliloadgetrLdicttyperr)rVfdatarYr<s& r_load_project_tablerd{sq 4Azz!} hhy"%G gt $ $/W 0F0F/GH&s++ N  B B c V^8dQhRRRR/#r"rVrr&rAr)r's"rr(r(s33d3/@3rcVPR4;_uu_4p\P!V4pRRR4XR,p\V\4'g$R\ V4P 2p\V4hRpRV9d<VPR4p\V\4'dRV9dRp\V4h\VPR.4V4p\Wu4# +'giL;i) a(Read [project].dependencies from a pyproject.toml file. Returns a list of Requirement objects parsed from the dependency strings. The key is optional under PEP 621, so an absent ``dependencies`` reads as an empty list. Raises FileNotFoundError if the file doesn't exist, KeyError if [project] is missing, TypeError if [project] is not a table, and InvalidProjectRequirementError if a dependency string is malformed or if ``dependencies`` is declared dynamic. The root-project lock path cannot run the build backend that would compute a dynamic value. rXNrYrZz[project].dependencies dependenciesdynamicz[project].dependencies is declared dynamic; computing it requires the build backend, which the root-project lock path does not support) r\r]r^rLr`rarrr_rRrrTrD)rVrbrcrYr<r4rj dep_stringss& rread_pyproject_dependenciesrls 4Azz!} 9oG gt $ $/W 0F0F/GH&s++ %FW$++i( gt $ $7)B)  15 5%gkk."&EvNK k 22% s C&& C6 c V^8dQhRRRR/#rgr)r's"rr(r(s#V#V#V1B#VrcVPR4;_uu_4p\P!V4pRRR4RX9dV R2p\V4hVR,p\ V\ 4'g$R\ V4P 2p\V4hRpRV9dV RV R 2p\V4h\\VR,V4V4# +'giL;i) aRead [build-system].requires from a pyproject.toml file (PEP 518). A project that declares no ``[build-system]`` gets no fallback to the PEP 517 default backend: pinning an implied ``setuptools`` would put a build requirement in the lock that the project never asked for. Absent ``[build-system]`` and a table without the mandatory ``requires`` key both raise :class:`InvalidProjectRequirementError`; a ``[build-system]`` that is not a table raises :class:`InvalidProjectTableError`. Only the static list is read. What a backend adds from ``get_requires_for_build_wheel`` is known only once that backend runs, and nothing runs this project's own backend to find out. rXNz build-systemzD declares no [build-system], so it has no build requirements to lockz$[build-system] must be a table, got z[build-system].requiresrequiresz is required by PEP 518 and z does not declare it) r\r]r^rrLr`rarrrDrT)rVrbrcr<tabler4s& rread_pyproject_build_requiresrqs 4Azz!} T!f$ $ -S11  E eT " "4T%[5I5I4JK&s++ &F4TF:NO,S11 1% 2CVLf UU) s C  C c V^8dQhRRRR/#)r"rVrr&r5r)r's"rr(r(s33d3z3rcj\V4PR4p\V\4'dV#R#)zRead [project].name from a pyproject.toml file. Returns the project name as a string, or ``None`` when the file has no ``[project]`` table or no ``name`` key (a workspace-root pyproject without its own distribution). nameN)rdr_rLr$)rVrts& rread_pyproject_namerus0 t $ ( ( 0DdC((42d2rc V^8dQhRRRR/#)r"rVrr&Mapping[str, Sequence[str]]r)r's"rr(r(s  rc\V4PR/4p\V\4'g$R\ V4P 2p\ V4hV#)zRead [project.optional-dependencies] from a pyproject.toml file. Returns the raw mapping of extra name to requirement strings. Returns an empty dict when ``[project.optional-dependencies]`` is absent. zoptional-dependenciesz5[project.optional-dependencies] must be a table, got )rdr_rLr`rarr)rVrawr<s& r$read_pyproject_optional_dependenciesrzsU d # ' '(? DC c4 CDIDVDVCW X 's++ Jrc V^8dQhRRRR/#)r" optional_depsrwr&zdict[str, list[str]]r)r's"rr(r(s  .  rc/pVP4F>wr#RV: 2pVP\V4.4P\ W444K@ V#)zDMap each extra name to its requirements under PEP 685 normalization.&[project.optional-dependencies] extra )items setdefaultrextendrT)r| canonicalrtreqsr4s& r_canonicalize_optional_depsrs[')I#))+ 9$B.t4b9@@  - , rc ,V^8dQhRRRRRRRRR R /#) r"r|rw project_namer5selectedr@ environmentzMapping[str, str] | Noner&rHr)r's"rr(r(s:<<.<<<* <  <rc 6a Vf \V4#\V4p\V4p.p\4o VUu.uFp\V4NK ppV'dVP ^4p V S 9dK"S P V 4VP V 4\WTV 4Fqp Ve=V Pe/\V P/VCR\V 04/C4'gKCVPV 3Rl\V P444Ks KV#uupi)a:Return ``selected`` plus every extra reachable through self-references. When an extra's contents include a requirement of the form ``{project_name}[a, b]`` (the project depending on itself with other extras activated), the referenced extras are walked transitively. Without this, an ``[all] = ["{name}[graphviz, otel, ...]"]`` self-reference leaves the actual third-party deps (graphviz, opentelemetry-api, etc.) out of the resolver's root requirements and look-ahead loses the ability to predict candidates. A self-reference carrying a PEP 508 marker (``{name}[fast]; python_version < "3.10"``) activates its extra only when the marker evaluates true under ``environment``. ``extra`` binds to the one-name set of the extra being walked, so ``extra == "all"`` resolves against it. ``environment`` ``None`` skips that check and walks every self-reference, which is what a caller that defers marker evaluation to each target wants. The original ``selected`` order is preserved at the front of the result; reachable extras are appended in BFS order without duplicates. ``project_name`` ``None`` short-circuits to the input list (no project name = nothing to self-reference). Unknown extras are tolerated here; the caller is expected to feed the result into :func:`expand_extra_requirements`, which raises if an extra is not declared. r2c3^<"TF"p\V4S9gK\V4xK$ R#5irKr )rMsubseens& rrO%expand_self_extras..5s0-C$S)5'!#&&-s--)rRrrsetpopaddappend_self_referencesr-r frozensetrsortedextras) r|rrrcanonical_projectcanonical_depsoutrCworklistr2r.rs &&&& @rexpand_self_extrasrsBH~),70?NCUD9ABA,Q/HB  Q D=   5#NuMC'JJ*/JJ L; LE79K L OO!#**- N J+CsDc(V^8dQhRRRRRRRR/#)r"rrwrr$r2r&zIterator[Requirement]r)r's"rr(r(=s0/  rc#"VPVR4F/p\V4p\ TP 4T8XgK+TxK1 R# \\3dKIi;i5i)zYield the requirements of ``extra`` that name the project itself. An unparseable requirement is skipped rather than raised on: this walk only decides which extras are reachable. Nr)r_r r9 TypeErrorrrt)rrr2req_strr.s&&& rrr=s^"%%eR0 g&C SXX &*; ;I 1I&   s-A" A A" A" AA"AA"c(V^8dQhRRRRRRRR/#) r"r|rwrr5rr@r&z list[Marker]r)r's"rr(r(Ps0. rc Vf.#\V4p\V4p\WV4UUu.uF2p\WCV4FpVPfKVPNK! K4 upp#uuppi)zReturn the markers gating the self-references ``selected`` reaches. The closure is walked without an environment, so the result holds every clause :func:`expand_self_extras` could read under any environment. )rrrrr-)r|rrrrr2r.s&&& rself_extra_markersrPss ),70?N( XN NE#NuMC ::  M N  s A(A(c$V^8dQhRRRRRR/#)r"r-z Marker | Nonegatesfrozenset[str]r&r r)r's"rr(r(fs!999~9&9rcVe \V4.M.pVP\V44\RP RV444#)z6AND a non-empty set of marker strings onto ``marker``.z and c3."TF pRV R2xK R#5i)r,)Nr)rMps& rrO_and_markers..js7A1#Qxs)r$rrr join)r-rpartss&& r _and_markersrfs>#/S[MRE LL ',,777 88rc$V^8dQhRRRRRR/#)r"r-r r2r$r&z str | boolr)r's"rr(r(ms!**&***rc\V4PR\V04/RR7pVP4'dR#VP 4pVfR#T#)a=Reduce a self-ref activation marker against a bound ``extra``. A self-reference is reached only because its extra is selected, so its ``extra == ""`` clause is already decided at expansion. Restricts the marker's environment set with ``extra`` bound to that one name and reads off what survives: ``True`` (tautology, a bare dep), ``False`` (contradiction, does not activate), or a residual marker string of the surviving environment conditions. ``extra`` binds as a one-name set, the PEP 685 set model the algebra evaluates ``extra ==`` / ``extra !=`` under. Environment variables the binding leaves untouched stay in the residual, so a variable-vs-variable clause naming ``extra`` (``sys_platform == extra``) is kept as a residual atom over the target's own value rather than decided against the machine running nab. r2residual)on_unknown_variableFT)rrestrictris_emptyto_marker_string)r-r2rr:s&& r_environment_residualrms`"&!** )UG$%:+H  $ $ &D<4)T)rc(V^8dQhRRRRRRRR/#) r"r|rwrr5rr@r&rAr)r's"rr(r(s055.555 5rcV'g.#Ve \V4MRp\V4p.p\4pVUu.uFp\V4\43NK ppV'dVP ^4wrW3V9dK%VP W34W9dRV : R\ V4: 2p \V 4h\WI,RV : 24Frp Ve8\V P4V8XdVP\WV 44K>V 'd\V PV 4V n VPV 4Kt KV#uupi)aFlatten ``selected`` extras to requirements, propagating self-ref markers. Flattens each selected extra over the self-reference closure :func:`expand_self_extras` walks, carrying a self-reference's PEP 508 marker onto the requirements it pulls in. With ``all = ["pkg[fast]; python_version < '3.10'"]`` and ``fast = ["dep"]``, selecting ``all`` yields ``dep; python_version < '3.10'`` rather than a bare ``dep`` that survives on every environment, so the per-tuple universal parser drops the dep on the tuples it excludes. Each activation path is walked separately, so a dep reachable through two markers is required under their disjunction. Unknown extras raise ``LookupError``. Nzextra z> is not declared in [project.optional-dependencies]; defined: r~)rrrrrrr LookupErrorrDrtr_self_ref_edgesrr-r) r|rrrrrvisitedrCrr2rr<r.s &&& rexpand_extra_requirementsrsA&  +7+C,'1?NC/2uG5=25= 1 y{+X 2 ||A  >W $  UN#  & ">>D^>T=WY c" "%  !4UI > C!,!#((+/@@E BC)#**e< JJsO  J52sEc(V^8dQhRRRRRRRR/#) r"r.r r2r$rrr&z list[tuple[str, frozenset[str]]]r)r's"rr(r(s2JJ J J)7J%JrcTpVPe>\VPV4pVRJd.#\V\4'd W$0,p\ VP 4Uu.uFp\ V4V3NK up#uupi)aEWorklist entries for the extras a self-reference activates. The self-ref's own marker is reduced against the walked ``extra``: a contradiction means it does not activate (no entries), a tautology propagates the inherited ``gates`` unchanged, and an environment residual is added to the gate carried onto the reached extras. F)r-rrLr$rrr)r.r2redgerrs&&& rrrsu D zz(U; u I h $ $:%D6c$V^8dQhRRRRRR/#)r"groups/Mapping[str, Sequence[str | Mapping[str, str]]]rr@r&rHr)r's"rr(r(s&)) ;)))rc/pVP4F]wr4\V\4'g\V\4'gK3VP \ V4.4P V4K_ .p\4pVUu.uFp\ V4NK ppV'dVP^4p W9dK!VPV 4VPV 4VPV R4F^p \V \4'gKV PR4p \V \4'gKDVP\ V 44K` KV#uupi)a{Return ``selected`` plus every group reached through ``include-group``. PEP 735 lets one group pull in another with ``{include-group = "other"}``. A conflict declared on a group must see the groups an umbrella group includes, so the membership test runs over the transitive closure rather than the literal selection. Group names compare canonicalised (PEP 503), matching the loaders. Unknown or cyclic includes are tolerated here; :func:`resolve_groups_to_requirements` raises on them when the requirements themselves are loaded. A group whose value is not a list is skipped, and the loader reports it when that group is selected. z include-groupr) rrLr$rrrrrrrrr_r) rrcanonical_groupsrtentriesrrrCrgroupentryincludes && rexpand_group_includesrs$BD  gs # #:gx+H+H ##$5d$;R@GGP ( CUD.67h!!$hH7  Q =   5%))%4E%))))O4gs++OO$5g$>? 5 J8sEc V^8dQhRRRR/#)r"rVrr&rr)r's"rr(r(s 4rc2VPR4;_uu_4p\P!V4pRRR4XPR/4p\ V\ 4'g$R\ V4P 2p\V4hV# +'giL];i)a[Read [dependency-groups] from a pyproject.toml file (PEP 735). Returns the raw group table: a mapping of group name to a list of requirement strings or include records (``{"include-group": "other-group"}``). Returns an empty dict when the table is absent so callers can pass the result to :func:`resolve_groups_to_requirements` unconditionally. rXNzdependency-groupsz)[dependency-groups] must be a table, got r[)rVrbrcryr<s& rread_pyproject_groupsrsr 4Azz!}  ((& +C c4 9$s):L:L9MN&s++ J rec$V^8dQhRRRRRR/#)r"rrrr@r&rAr)r's"rr(r(s&?? ;???rcV'g.#\V.VO5!p\TR4# \dpRPRTP44p\;QJd&RTP4F 'dK RM RM!RTP44'd \ T4ThRT 2p\ T4ThRp?ii;i) atResolve PEP 735 group includes and return the union of requirements. ``selected`` names the groups whose requirements should be expanded. An unknown group name surfaces as :class:`LookupError`; a malformed requirement string, cyclic include, or duplicate group name surfaces as :class:`InvalidProjectRequirementError`. Returns an empty list when ``selected`` is empty. z; c38"TFp\V4xK R#5irK)r$rMes& rrO1resolve_groups_to_requirements..&s<+;a3q66+;sc3B"TFp\V\4xK R#5irK)rLrrs& rrOr'sD3Caz![))3CrQFTzinvalid [dependency-groups]: Nz[dependency-groups])r r r exceptionsrSrrrD)rrresolvedrdetailr<s&& rresolve_groups_to_requirementsrs  =,V?h? h(= >> =<5+;+;<< 3D53C3CD333D53C3CD D Df%5 0-fX6,S1u< =s! % CAB=;$B= B==Cc(V^8dQhRRRRRRRR/#) r"rangeszMapping[str, VersionRange]sourcesrwkindr$r&Noner)r's"rr(r(.s0 & (    rcaVP4UUu.uFwr4VP'gKVNK pppV'gR#RPV3RlV44pRV RV 2p\V4huuppi)a?Raise :class:`ResolutionError` if any folded range is empty. ``ranges`` holds one intersected range per package and ``sources`` the requirement strings folded into each. An empty range means those requirements share no version; the error lists them. ``kind`` ("requirement" or "constraint") only shapes the wording. N c3`<"TF#pRV RRPSV,4 2xK% R#5i)z r7z, N)r)rMrtrs& rrO*raise_for_unsatisfiable..?s/rsH"- /?J4-761(6 (TZTy06:*C $3B#VL3$ <~&,9*85pJ()X(?2r