o i?@sVdZddlZddlmZmZddlmZmZmZer ddl m Z eGdddZ dS)z9Lazy-loadable command specification for deferred imports.N) TYPE_CHECKINGAny)FactorydefinefieldAppc@seZdZUdZeed<dZeeedfBdBed<ee Z e ee fed<e ddddZ d ed <dddZed efddZdS) 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_kwargsF)initdefaultreprz App | None _resolved parent_apprreturnc Cs|jdur|jS|jd\}}}|r|std|jdzt|}Wnty=}z td|d|j|d}~wwzt||}Wntya}ztd|d|d |jd |d}~wwd d l m }t ||r|j r}td |jd|j d|j dur|j d |j krtd|jd|j d d|j d|jd|j d d d dl m} | ||||_|jSt|j } d dl m} | d|j| d|jd| vr|jdur|j| d<| | ||dd|j i| |_|j||jS)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 )rrz8Cannot 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_flagsversionr )rr rpartition ValueError importlib import_module ImportErrorgetattrAttributeError cyclopts.corer isinstancer r rdictr setdefaultrrrr) selfr module_path_ attr_namemoduleetargetrrr rrr[/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/command_spec.pyresolve/sz          zCommandSpec.resolvecCs |jduS)z9Check if this command has been imported and resolved yet.N)r)r&rrr- is_resolveds zCommandSpec.is_resolved)rrrr)__name__ __module__ __qualname____doc__str__annotations__r tuplerr$r rrrr.propertyboolr/rrrr-r s  _r ) r3rtypingrrattrsrrrr"rr rrrr-s