k7ioxSrSSKrSSKJr SSKJrJr SSKJrJ r J r \(aSSK J r \ "SS55r g) z9Lazy-loadable command specification for deferred imports.N)chain) TYPE_CHECKINGAny)FactorydefinefieldAppc\rSrSr%Sr\\S'Sr\\\S4-S-\S'\ "\ 5r \ \\ 4\S'\ "SSSS 9rS \S 'SS jr\S \4Sj5rSrg) CommandSpec a>Specification for a command that will be lazily loaded on first access. This allows registering commands via import path strings (e.g., "myapp.commands:create") without importing them until they're actually used, improving CLI startup time. Parameters ---------- import_path : str Import path in the format "module.path:attribute_name". The attribute should be either a function or an App instance. name : str | tuple[str, ...] | None CLI command name. If None, will be derived from the attribute name via name_transform. For function imports: used as the name of the wrapper App. For App imports: must match the App's internal name, or ValueError is raised at resolution. app_kwargs : dict Keyword arguments to pass to App() if wrapping a function. Raises ValueError if used with App imports (Apps should be configured in their own definition). Examples -------- >>> from cyclopts import App >>> app = App() >>> # Lazy load - doesn't import myapp.commands until "create" is executed >>> app.command("myapp.commands:create_user", name="create") >>> app() import_pathN.name app_kwargsF)initdefaultreprz App | None _resolvedreturnc URb UR$URRS5up#nU(aU(d[SUR<S35e[R "U5n[XT5nS S K J n [Xx5(aUR(a([S UR<SUR<S35eURbsURS UR:waV[SUR<SURS <SUR<SURSURS S3 5eS SK Jn U "Xq5 XplO[UR5n S SK Jn U R#SUR$5 U R#SUR&5 SU ;aUR(bUR(U S'U "X5 U"SSUR0U D6UlURR+U5 [-URR$URR&5Hn SURU lM UR$![ a#n[ SU<SUR<35UeSnAff=f![a(n[SU<SU<S UR<S 35UeSnAff=f)a(Import and resolve the command on first access. Parameters ---------- parent_app : App Parent app to inherit defaults from (help_flags, version_flags, groups). Required to match the behavior of direct command registration. Returns ------- App The resolved App instance, either imported directly or wrapping a function. Raises ------ ValueError If import_path is not in the correct format "module.path:attribute_name". ImportError If the module cannot be imported. AttributeError If the attribute doesn't exist in the module. N:zInvalid import path: z/. Expected format: 'module.path:attribute_name'zCannot import module z from zModule z has no attribute z (from import path )rr z8Cannot apply configuration to imported App. Import path z0 resolves to an App, but kwargs were specified: z.. Configure the App in its definition instead.z(Imported App name mismatch. Import path z resolves to an App with name=z., but it was registered with CLI command name=z. Either use app.command('z ', name='z%') or change the App's name to match.)_apply_parent_defaults_to_app)_apply_parent_groups_to_kwargs help_flags version_flagsversionrF)rr rpartition ValueError importlib import_module ImportErrorgetattrAttributeError cyclopts.corer isinstancerrrdictr setdefaultrrrrrshow) self parent_app module_path_ attr_namemoduleetargetr rrrflags O/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/command_spec.pyresolveCommandSpec.resolve0s. >> %>> !%)$4$4$?$?$D! )'(8(8';;jk   h,,[9F V/F & f " " ##'#3#3"67226//1DECDyy$Q499)D ##'#3#3"66TU[U`U`abUcTfgCCG99-P//3/?/?.@ &++VW.IYZ9: D )& =#Ndoo.J D  ! !, 0E0E F  ! !/:3K3K L *z/A/A/M(2(:(: 9% *: B >dii>:>DN NN " "6 *$..33T^^5Q5QRD(-DNN4 %S~~} h 5k_F4K[K[J^_`fg g h   +(:9-GZ[_[k[kZnnop  s0!I38 J#3 J =JJ # K-#KKcURSL$)z9Check if this command has been imported and resolved yet.Nr)r+s r4 is_resolvedCommandSpec.is_resolveds~~T))r8)r,r rr )__name__ __module__ __qualname____firstlineno____doc__str__annotations__rtuplerr(rrrrr5propertyboolr9__static_attributes__rr;r4r r sv6)-D#c3h $ &-!(JS#X.#5II|IbH*T**r;r )r@r! itertoolsrtypingrrattrsrrrr&r r rr;r4rJs9?%((!I*I*I*r;