+ 2j)ZRt^RIHt^RIt^RIHt^RIHtHt^RI t ^RI H t ^RI H t ^RIHtHt^RIHt]'d ^R IHt^R IHt.ROt]P0!]4t!R R ]4tRtRRltRRlt]!RRR7!RR 44t RRlt!RRlt"RRlt#RRlt$R#)a7Workspace discovery for member ``pyproject.toml`` files. A "workspace" is a table of members declared by a project: either ``[tool.nab.workspace]`` in its ``pyproject.toml`` or ``[workspace]`` in the project-dir ``nab.toml``. Every member is synthesised into a :class:`~nab_python.provider.LocalSource`. The provider then prefers those local sources over PyPI by canonical name, so a member package resolves against its in-tree source instead of being fetched from the index. A project that declares no workspace of its own walks up to an ancestor project file that does, in either spelling, so ``nab lock`` invoked against a member still resolves against the root's members. Members are listed literally; globs are refused with an error. Users coming from other tools that allow globs get a clear migration message. ) annotationsN) dataclass) TYPE_CHECKINGAny)tool_nab_section)canonicalize_name) path_state resolve_path) LocalSource)Iterable)PathWorkspaceConfigWorkspaceDiscoveryErrorc]tRt^3tRtRtR#)rz?Raised when a workspace member or root is structurally invalid.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r_/home/user/billing-ledger-validation/.venv/lib/python3.14/site-packages/nab_python/workspace.pyrr3sIrznab.tomlc V^8dQhRRRR/#) pyprojectr returndict[str, Any]r)formats"r __annotate__r:s444.4rcPVPR4;_uu_4p\P!V4uuRRR4# +'giR#;i \\P3dpT RT 2p\ T4ThRp?i\ dpRT RT 2p\ T4ThRp?ii;i)a Parse ``pyproject``, raising :class:`WorkspaceDiscoveryError` on a bad read. :func:`discover_workspace_root` swallows read and parse errors while walking, but a chosen root and its declared members must parse, so an unreadable or malformed file here is a hard error. rbNz is not valid TOML: z cannot read : )opentomliloadUnicodeDecodeErrorTOMLDecodeErrorrOSError)rfexcmsgs& r_load_member_tomlr,:s4 ^^D ! !Q::a=" ! ! !  5 5 64 /u5%c*3 4YKr#/%c*34sCA< A A A AB%+A>> B% B% B  B%c$V^8dQhRRRRRR/#)rdatar project_filer rztuple[Any, str]r)rs"rrrLs!'''t''rcVP\8XdVPR4R3#\V4pRp\ V\ 4'gRV3#VPR4V3#)aqReturn the workspace table ``project_file`` declares, and its name. A ``pyproject.toml`` spells it ``[tool.nab.workspace]``; the project-dir ``nab.toml`` spells it as a top-level ``[workspace]``. The value is returned unvalidated, so a malformed table still counts as a declaration and errors when its members are read. ``None`` means the file declares no workspace. workspacez [workspace]z[tool.nab.workspace]N)name _PROJECT_TOMLgetr isinstancedict)r.r/nablabels&& r_workspace_declarationr9Ls`M)xx $m33 4 C "E c4 U{ 77;  &&rT)frozenslotsc&]tRt^^t$RtR]R&RtR#)r zParsed workspace table. ``members`` is the literal list of paths declared at the workspace root. No globs, no path resolution; those happen later in :func:`workspace_local_sources`. ztuple[str, ...]membersrN)rrrrr__annotations__rrrrr r ^src V^8dQhRRRR/#)rmember_pyprojectr rz Path | Noner)rs"rrrjsd{rc VP4PpV.VPOFqpVR, V\, 3FTpVP R4;_uu_4p\ P !V4pRRR4\XT4wrgTfKPTuu# Ks R# +'giL2;i \\\ P3dKi;i)aFReturn the project file declaring the workspace for ``member_pyproject``. Walks upwards from ``member_pyproject``'s directory for the first project file that declares a workspace, checking ``pyproject.toml`` before ``nab.toml`` in each directory. Returns that file's path, or ``None`` when nothing on the walk declares one. The starting directory counts, so ``nab lock`` on a workspace root activates discovery too. Filesystem-level errors and TOML parse errors during the walk are swallowed: a malformed sibling should not prevent discovery from finding a valid root above it. pyproject.tomlr!N) resolveparentparentsr3r#r$r%r(r&r'r9)r@ start_dirrD candidater)r.declared_labels& rdiscover_workspace_rootrJjs!((*11I1y001 #33Vm5KLI ^^D))Q ::a=D* 6dIF H#  M2 *)/1F1FG  s0B4 B! 7B4! B1 ,B41B44 CCc(V^8dQhRRRRRRRR/#) rr=z Iterable[str]root_dirr declared_instrrtuple[LocalSource, ...]r)rs"rrrs2OO O)-O/pyproject.toml`` and requires ``[project].name``; missing pyproject or missing name is a hard error. Two members declaring the same canonical name raises :class:`WorkspaceDiscoveryError`. The returned tuple preserves declaration order, which makes ``nab lock`` output stable when the list of members is itself stable. Members are marked ``editable``; a workspace member installs editably by default, matching uv. Explicit ``[[tool.nab.local-sources]]`` entries default to non-editable. c3,<"TF qS9xK R#5i)Nr).0chentrys& r *workspace_local_sources..s+UrU{Usz*?[TFza: globs in workspace members are not supported in nab; list members literally. Offending entry: z: workspace member z is not a usable filesystem pathrBz has no pyproject.toml at projectz2: workspace member [project] must be a table, got r2z4: workspace member must declare [project].name (got )z5: workspace members declare duplicate canonical name z via entries z and )r2patheditable)anyrr r should_readr,r4r5r6typerrNrappendr tuple) r=rLrMsourcesseenr+ member_dirr@ member_data project_tabler2 canonicalrTs &$$ @rworkspace_local_sourcesrfs,"$GD 3+U+333+U+ + +- &&+Y0  *#. .!(E2  -25)23 *#. .%(88*+777-25)<&&6%79 *#. .'(89 # 26 -..#$%#M2;;<> *#. .  ($$$D#$%((,xq2 *#. .%d+  - ##,-}T_rc V^8dQhRRRR/#)r root_filer rrOr)rs"rrrs''d'/F'rcJ\V4p\W4wr#\V\4'g)V RV R\ V4P 2p\ V4hVPR4p\V\4'g)V RV R\ V4P 2p\ V4h.pVFVp\V\4'g-V RV R\ V4P RV: 2p\ V4hVPV4KX \VVP\V4R7#)aFSynthesise :class:`LocalSource` entries from a workspace root. Reads the members ``root_file`` declares, in the spelling its name calls for, and resolves each member path against the root's directory. This is the path taken for a root the ancestor walk found, which is read off disk rather than through the config registry. r"z must be a table, got r=z(.members must be a list of strings, got z&.members entries must be strings, got )rLrM) r,r9r5r6r]rrr4listrNr^rfrD)rh root_data raw_workspacer8r+ raw_membersr=rTs& rread_workspace_membersrns8"),I1)GM mT * *kE7"8m9L9U9U8V W &c**##I.K k4 ( (kE7#!+.778 : &c**G%%%+Rw'!!%e!5!5 6b C *#. .u #!! N rc$V^8dQhRRRRRR/#)rexplicitzIterable[LocalSource] discoveredrrOr)rs"rrrs&#%rcX\V4pVUu0uFp\VP4kK pp\V4pVF[p\VP4V9d.\P RVPVP 4KJVPV4K] \V4#uupi)aCombine explicit and workspace-discovered local sources. Explicit ``[[tool.nab.local-sources]]`` entries always win. When a discovered member shares a canonical name with an explicit entry, the discovered entry is dropped and one INFO log line records the shadow so the user can audit what was overridden. The order is explicit entries first, then unshadowed discovered entries in the order they were declared. zIworkspace member %r at %s shadowed by explicit [[tool.nab.local-sources]])r_rr2rjloggerinforYr^)rprqexplicit_tuplesexplicit_namesoutsrcs&& rmerge_workspace_local_sourcesrzs8_N9GHA'/NH ~ C SXX &. 8 KK.    3 :IsB')r rrJrzrnrf)%r __future__rlogging dataclassesrtypingrrr$_tomlr_vendor.packaging.utilsrpathsrr providerr collections.abcr pathlibr __all__ getLoggerrrs ValueErrorrr3r,r9r rJrfrnrzrrrrs&#!% #6+!(    8 $JjJ 4$'$ $d#$6Od'Tr