Mh%dZddlZddlZddlmZmZddlmZmZm Z ej dkr ddl m Z m Z nddlm Z m Z ddlmZmZmZdd lmZGd d eZdS) zKernel Provisioner ClassesN)getenvpath)AnyDictList) ) EntryPoint entry_points)SingletonConfigurableUnicodedefault)KernelProvisionerBasecHeZdZUdZdZiZeeefe d<dZ e ddZ e dd efd Zd ed d ffd Zded efdZdededed efdZded efdZded eeeffdZd eeeffdZed eefdZded efdZxZS)KernelProvisionerFactorya :class:`KernelProvisionerFactory` is responsible for creating provisioner instances. A singleton instance, `KernelProvisionerFactory` is also used by the :class:`KernelSpecManager` to validate `kernel_provisioner` references found in kernel specifications to confirm their availability (in cases where the kernel specification references a kernel provisioner that has not been installed into the current Python environment). It's ``default_provisioner_name`` attribute can be used to specify the default provisioner to use when a kernel_spec is found to not reference a provisioner. It's value defaults to `"local-provisioner"` which identifies the local provisioner implemented by :class:`LocalProvisioner`. z"jupyter_client.kernel_provisioners provisioners JUPYTER_DEFAULT_PROVISIONER_NAMETzIndicates the name of the provisioner to use when no kernel_provisioner entry is present in the kernelspec.)confighelpdefault_provisioner_namereturnc,t|jdS)zThe default provisioner name.local-provisioner)rdefault_provisioner_name_env)selfs c/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/jupyter_client/provisioning/factory.py!_default_provisioner_name_defaultz:KernelProvisionerFactory._default_provisioner_name_default-sd79LMMMkwargsNc tjdi|tD]}||j|j<dS)z(Initialize a kernel provisioner factory.N)super__init__r_get_all_provisionersrname)rr ep __class__s rr$z!KernelProvisionerFactory.__init__2sW""6"""*@@BB , ,B)+D bg & & , ,r kernel_speccd}||}t|d}||s(d}|jd|jd|d|S)aO Reads the associated ``kernel_spec`` to determine the provisioner and returns whether it exists as an entry_point (True) or not (False). If the referenced provisioner is not in the current cache or cannot be loaded via entry_points, a warning message is issued indicating it is not available. Tprovisioner_nameFzKernel 'z(' is referencing a kernel provisioner ('zW') that is not available. Ensure the appropriate package has been installed and retry.)_get_provisioner_configstrget_check_availabilitylogwarning display_name)rr) is_availableprovisioner_cfgr+s ris_provisioner_availablez1KernelProvisionerFactory.is_provisioner_available9s" 66{CC223EFFGG''(899  L H  P;3PP!1PPP    r kernel_idparentc||}t|d}||sd|d}t ||jd|jd||j| }|d}|d|||d|} | S) a$ Reads the associated ``kernel_spec`` to see if it has a `kernel_provisioner` stanza. If one exists, it instantiates an instance. If a kernel provisioner is not specified in the kernel specification, a default provisioner stanza is fabricated and instantiated corresponding to the current value of ``default_provisioner_name`` trait. The instantiated instance is returned. If the provisioner is found to not exist (not registered via entry_points), `ModuleNotFoundError` is raised. r+zKernel provisioner 'z' has not been registered.zInstantiating kernel 'z' with kernel provisioner: r)r6r)r7r") r,r-r.r/ModuleNotFoundErrorr0debugr2rload) rr6r)r7r4r+msgprovisioner_classprovisioner_config provisioners rcreate_provisioner_instancez4KernelProvisionerFactory.create_provisioner_instanceLs66{CC223EFFGG''(899 +U)9UUUC%c** *  6[%= 6 6#3 6 6   !-.>?DDFF,00::->->. [. . K]. . rr+cd}||jvr3 ||}||j|<n#t$rd}YnwxYw|S)a. Checks that the given provisioner is available. If the given provisioner is not in the current set of loaded provisioners an attempt is made to fetch the named entry point and, if successful, loads it into the cache. :param provisioner_name: :return: TF)r_get_provisioner Exception)rr+r3r's rr/z,KernelProvisionerFactory._check_availabilityjsk 4#4 4 4 %**+;<<68!"233 % % %$  %s - <<c|jdi}d|vrd|vr|dii|S|jidS)a  Return the kernel_provisioner stanza from the kernel_spec. Checks the kernel_spec's metadata dictionary for a kernel_provisioner entry. If found, it is returned, else one is created relative to the DEFAULT_PROVISIONER and returned. Parameters ---------- kernel_spec : Any - this is a KernelSpec type but listed as Any to avoid circular import The kernel specification object from which the provisioner dictionary is derived. Returns ------- dict The provisioner portion of the kernel_spec. If one does not exist, it will contain the default information. If no `config` sub-dictionary exists, an empty `config` dictionary will be added. kernel_provisionerr+r)r+r)metadatar.updater)rr)env_provisioners rr,z0KernelProvisionerFactory._get_provisioner_config}sb(&.223GLL  0 0//&&"~666" "$($ARPPPrc\i}|jD]\}}|j||<|S)z Returns a dictionary of provisioner entries. The key is the provisioner name for its entry point. The value is the colon-separated string of the entry point's module name and object name. )ritemsvalue)rentriesr&r's rget_provisioner_entriesz0KernelProvisionerFactory.get_provisioner_entriess=)//11 % %HD"HGDMMrc6ttjS)zaWrapper around entry_points (to fetch the set of provisioners) - primarily to facilitate testing.)group)r r GROUP_NAMEr"rrr%z.KernelProvisionerFactory._get_all_provisionerss":"EFFFFrr&c6ttj|}|r|dS|dkrntjt jt jt d}|jd|tdddS)z^Wrapper around entry_points (to fetch a single provisioner) - primarily to facilitate testing.)rOr&rrz-*aKernel Provisioning: The 'local-provisioner' is not found. This is likely due to the presence of multiple jupyter_client distributions and a previous distribution is being used as the source for entrypoints - which does not include 'local-provisioner'. That distribution should be removed such that only the version-appropriate distribution remains (version >= 7). Until then, a 'local-provisioner' entrypoint will be automatically constructed and used. The candidate distribution locations are: zjupyter_client.provisioningLocalProvisioner) r rrPglobrdirname__file__r0r1r )rr&epsdistross rrBz)KernelProvisionerFactory._get_provisioners!9!D4PPP  q6M & & &i4< X0F0F#G#G K K KLLG H  R IP RR   #%BDV  r)__name__ __module__ __qualname____doc__rPrrr-r __annotations__rr rrrrr$boolr5rr@r/r,rM staticmethodrr%rB __classcell__)r(s@rrrs  6J*,L$sJ',,,#E &wN     W '((N3NNN)(N,,,,,,,,CD&+.8; <CD&Q3Q4S>QQQQ: c3h    G4 #3GGG\GSZrr)r[rSsysosrrtypingrrr version_infoimportlib_metadatar r importlib.metadatatraitlets.configr r rprovisioner_baserrr"rrrhs  """"""""""g;;;;;;;;;;;;;;;;;DDDDDDDDDD333333ttttt4tttttr