KizdZddlZddlmZddlmZmZddlmZm Z m Z er ddl m Z ddl mZe Gdd Zy) z9Lazy-loadable command specification for deferred imports.N)chain) TYPE_CHECKINGAny)FactorydefinefieldApp)Groupc eZdZUdZeed<dZeeedfzdzed<ee Z e ee fed<dZ edzed<dZ e ed<dZd ed <edd Zedzed <edefdZedddZded<ddZedefdZy) CommandSpecaSpecification 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_kwargshelpsort_keyz,Group | str | tuple[Group | str, ...] | Nonegroupshow)defaultalias_showreturnc4|jy|jS)NT)rselfs a/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/command_spec.pyrzCommandSpec.show3s :: zzF)initrreprz App | None _resolvedc |j |jS|jjd\}}}|r|std|jd t j |} t||}d d l m }t||r|jr&td |jd|jd|jo|jd |jk7rStd|jd|jd d|jd|jd|jd d d dl m} | ||||_nt|j} d dl m} | j#d|j$| j#d|j&d| vr|j(|j(| d<| | ||dd|ji| |_|jj+||j,|j,|j_|j.|j.|j_|j0|j0|j_|j2|j2|j_|jj6|j8|j_t;|jj$|jj&D]} d|j| _|jS#t $r!}t d|d|j|d}~wwxYw#t$r%}td|d|d |jd |d}~wwxYw)aImport 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)r r rpartition ValueError importlib import_module ImportErrorgetattrAttributeError cyclopts.corer isinstancerrr$dictr% setdefaultr&r'r(rrrrrr_name_transformname_transformr) r parent_app module_path_ attr_namemoduleetargetr r$rr%flags rresolvezCommandSpec.resolve;sa. >> %>> !%)$4$4$?$?$D! Q )'(8(8';;jk   h,,[9F VY/F & fc " ##'#3#3"67226//1DECDyy$Q499)D ##'#3#3"66TU[U`U`abUcTfgCCG99-P//3/?/?.@ &++VW.IYZ9: D )&* =#DNdoo.J D  ! !, 0E0E F  ! !/:3K3K L *z/A/A/M(2(:(: 9% *:z B >dii>:>DN NN " "6 * 99 "&))DNN  == $&*mmDNN # :: !#'::DNN :: !"&**DNN  >> ) ) 1,6,E,EDNN )$..33T^^5Q5QR .D(-DNN4 % .~~U h 5k_F4K[K[J^_`fg g h   +(:9-GZ[_[k[kZnnop  s0L#, M# M ,MM  M> M99M>c|jduS)z9Check if this command has been imported and resolved yet.N)r rs r is_resolvedzCommandSpec.is_resolveds~~T))r)r7r rr )__name__ __module__ __qualname____doc__str__annotations__rtuplerr3rrrrrrrboolpropertyrr r?rAr)rrr r s6)-D#c3h $ &-!(JS#X.D#*Hc<@E 9@t6:E4$;: d $5II|In`*T**rr )rEr, itertoolsrtypingrrattrsrrrr1r cyclopts.groupr r r)rrrOs<?%((!$_*_*_*r