+ Q(iRt^RIt^RIHt^RIHtHt^RIHtH t H t ]'d ^RI H t ^RI Ht] !RR44tR#) z9Lazy-loadable command specification for deferred imports.N)chain) TYPE_CHECKINGAny)FactorydefinefieldApp)Groupca]tRt^toRtRt]!]4tRt Rt Rt ] !RRR7t ]V3RlRl4t] !RRRR7tV3R lR lt]V3R lR l4tV3R ltRtVtR#) CommandSpeca>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() Nshow)defaultaliasc <V^8dQhRS[/#returnbool)format __classdict__s"[/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/command_spec.py __annotate__CommandSpec.__annotate__4sdc:VPfR#VP#)NT)_showselfs&rr CommandSpec.show3s :: zzrF)initrreprc"<V^8dQhRRRR/#)r parent_appr r)rrs"rrr;snn%nEnrc  VPe VP#VPPR4wr#pV'd V'g\RVP: R24h\P !V4p\YT4p^R I H p\Yx4'dTP'd)\R TP: R TP: R24hTPeTP^,TP8wd_\RTP: RTP^,: RTP: RTP RTP^, R2 4h^RI Hp T !Yq4YpnM\TP4p ^RI Hp T P#RTP$4T P#RTP&4RT 9dTP(eTP(T R&T !Y4T!RRTP/T BTnTPP+T4TP,eTP,TPnTP.eTP.TPnTP0eTP0TPnTP2eTP2TPnTPP6fTP8TPn\;TPP$TPP&4Fp RTPT ,nK TP# \ d$p\ RT: RTP: 24ThRp?ii;i \d)p\RT: RT: R TP: R 24ThRp?ii;i)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 )rz8Cannot 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_flagsversionnameFr%) _resolved import_path rpartition ValueError importlib import_module ImportErrorgetattrAttributeError cyclopts.corer isinstance app_kwargsr.r)dictr* setdefaultr+r,r-rhelpsort_keygrouprr _name_transformname_transformr) rr$ module_path_ attr_namemoduleetargetr r)r:r*flags && rresolveCommandSpec.resolve;sV. >> %>> !%)$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 * 99 "&))DNN  == $&*mmDNN # :: !#'::DNN :: !"&**DNN  >> ) ) 1,6,E,EDNN )$..33T^^5Q5QRD(-DNN4 %S~~U h 5k_F4K[K[J^_`fg g h   +(:9-GZ[_[k[kZnnop  s0$M#; N# N.N  N O#OOc <V^8dQhRS[/#rr)rrs"rrrs**T*rc VPRJ#)z9Check if this command has been imported and resolved yet.Nr/rs&r is_resolvedCommandSpec.is_resolveds~~T))rc<V^8dQh/S[;R&S[S[S[R3,,R,;R&S[S[S[3,;R&S[R,;R&S[;R&R;R &S[R,;R &R ;R &#) rr0.Nr.r:r=r>z,Group | str | tuple[Group | str, ...] | Noner?rz App | Noner/)strtupler;rr)rrs"rrrs:;< c3h $ &-=>S#X.?@ *ABCD :@EF $;:GVIWrrM)__name__ __module__ __qualname____firstlineno____doc__r.rr;r:r=r>r?rrpropertyr r/rIrN__annotate_func____static_attributes____classdictcell__)rs@rr r s8*.D!(JDH<@Et6:E  $5IInn`**}rr )rWr3 itertoolsrtypingrrattrsrrrr8r cyclopts.groupr r r%rrr`s<?%((!$_*_*_*r