ó Ù^íhò&ãóš•SrSSKrSSKJrJrJr SSKJrJrJ r J r J r SSK J r JrJr SSKJr "SS \\"\55r"S S \\\S 9rg) zKernel Provisioner ClasseséN)ÚABCÚABCMetaÚabstractmethod)ÚAnyÚDictÚListÚOptionalÚUnion)ÚInstanceÚLoggingConfigurableÚUnicodeé)ÚKernelConnectionInfocó•\rSrSrSrg)ÚKernelProvisionerMetaé ©N)Ú__name__Ú __module__Ú __qualname__Ú__firstlineno__Ú__static_attributes__róÚf/home/james-whalen/.local/lib/python3.13/site-packages/jupyter_client/provisioning/provisioner_base.pyrr s†Úrrcó>•\rSrSr%Sr\"SSS9r\\S'\ "SSS9r \ \ \ 4\S'0r \\S '\\S \4S j55r\S \\4S j5r\S \\4S j5r\S\S S4Sj5r\S%S\S S4Sjj5r\S%S\S S4Sjj5r\S\\ S\S \4Sj5r\S%S\S S4Sjj5rS%S\S S4SjjrS\S \\ \44SjrS\S S4Sjr S \\ \44Sjr!S\S S4Sjr"S&S\#S \#4Sjjr$S'S\#S \#4Sjjr%S \\ \ 4S S4S!jr&S"\\ \ 4S \\ \ 44S#jr'S$r(g)(ÚKernelProvisionerBaseéaÇ Abstract base class defining methods for KernelProvisioner classes. A majority of methods are abstract (requiring implementations via a subclass) while some are optional and others provide implementations common to all instances. Subclasses should be aware of which methods require a call to the superclass. Many of these methods model those of :class:`subprocess.Popen` for parity with previous versions where the kernel process was managed directly. z$jupyter_client.kernelspec.KernelSpecT)Ú allow_noneÚ kernel_specNÚ kernel_idÚconnection_infoÚreturncó•g)z¹ Returns true if this provisioner is currently managing a process. This property is asserted to be True immediately following a call to the provisioner's :meth:`launch_kernel` method. Nr©Úselfs rÚ has_processÚ!KernelProvisionerBase.has_process$s€ð rcƒó # •g7f)zÄ Checks if kernel process is still running. If running, None is returned, otherwise the process's integer-valued exit code is returned. This method is called from :meth:`KernelManager.is_alive`. Nrr$s rÚpollÚKernelProvisionerBase.poll/ó é€ð ùó‚cƒó # •g7f)zË Waits for kernel process to terminate. This method is called from `KernelManager.finish_shutdown()` and `KernelManager.kill_kernel()` when terminating a kernel gracefully or immediately, respectively. Nrr$s rÚwaitÚKernelProvisionerBase.wait9s é€ð ùr,Úsignumcƒó # •g7f)z› Sends signal identified by signum to the kernel process. This method is called from `KernelManager.signal_kernel()` to send the kernel process a signal. Nr)r%r0s rÚ send_signalÚ!KernelProvisionerBase.send_signalDr+r,Úrestartcƒó # •g7f)a Kill the kernel process. This is typically accomplished via a SIGKILL signal, which cannot be caught. This method is called from `KernelManager.kill_kernel()` when terminating a kernel immediately. restart is True if this operation will precede a subsequent launch_kernel request. Nr©r%r4s rÚkillÚKernelProvisionerBase.killNs é€ð ùr,cƒó # •g7f)aq Terminates the kernel process. This is typically accomplished via a SIGTERM signal, which can be caught, allowing the kernel provisioner to perform possible cleanup of resources. This method is called indirectly from `KernelManager.finish_shutdown()` during a kernel's graceful termination. restart is True if this operation precedes a start launch_kernel request. Nrr6s rÚ terminateÚKernelProvisionerBase.terminate[s é€ð ùr,ÚcmdÚkwargsc‹ó # •g7f)z± Launch the kernel process and return its connection information. This method is called from `KernelManager.launch_kernel()` during the kernel manager's start kernel sequence. Nr)r%r<r=s rÚ launch_kernelÚ#KernelProvisionerBase.launch_kernelir+r,cƒó # •g7f)zú Cleanup any resources allocated on behalf of the kernel provisioner. This method is called from `KernelManager.cleanup_resources()` as part of its shutdown kernel sequence. restart is True if this operation precedes a start launch_kernel request. Nrr6s rÚcleanupÚKernelProvisionerBase.cleanupsó é€ð ùr,cƒó # •g7f)aR Allows the provisioner to determine if the kernel's shutdown has been requested. This method is called from `KernelManager.request_shutdown()` as part of its shutdown sequence. This method is optional and is primarily used in scenarios where the provisioner may need to perform other operations in preparation for a kernel's shutdown. Nrr6s rÚshutdown_requestedÚ(KernelProvisionerBase.shutdown_requestedrDr,c‹óÔ# •URS[R5R5nUR UR U55 UR U5 X!S'U$7f)aÈ Perform any steps in preparation for kernel process launch. This includes applying additional substitutions to the kernel launch command and environment. It also includes preparation of launch parameters. NOTE: Subclass implementations are advised to call this method as it applies environment variable substitutions from the local environment and calls the provisioner's :meth:`_finalize_env()` method to allow each provisioner the ability to cleanup the environment variables that will be used by the kernel. This method is called from `KernelManager.pre_start_kernel()` as part of its start kernel sequence. Returns the (potentially updated) keyword arguments that are passed to :meth:`launch_kernel()`. Úenv)ÚpopÚosÚenvironÚcopyÚupdateÚ/_KernelProvisionerBase__apply_env_substitutionsÚ _finalize_env)r%r=rIs rÚ pre_launchÚ KernelProvisionerBase.pre_launch‹sUé€ð$j‰j˜¤§ ¡ Ó+×0Ñ0Ó2ˆØ ‰ 4×1Ñ1°#Ó6Ô7Ø ×ј3Ô؈u‰ àˆ ùs‚A&A(c‹ó # •g7f)zž Perform any steps following the kernel process launch. This method is called from `KernelManager.post_start_kernel()` as part of its start kernel sequence. Nr)r%r=s rÚ post_launchÚ!KernelProvisionerBase.post_launch¤s é€ð ùr,cƒóN# •0nURUS'URUS'U$7f)a® Captures the base information necessary for persistence relative to this instance. This enables applications that subclass `KernelManager` to persist a kernel provisioner's relevant information to accomplish functionality like disaster recovery or high availability by calling this method via the kernel manager's `provisioner` attribute. NOTE: The superclass method must always be called first to ensure proper serialization. r r!©r r!©r%Úprovisioner_infos rÚget_provisioner_infoÚ*KernelProvisionerBase.get_provisioner_info­s4é€ð,.ÐØ(,¯©Ð˜Ñ%Ø.2×.BÑ.BÐÐ*Ñ+ØÐùs‚#%rYcƒó4# •USUlUSUlg7f)a¯ Loads the base information necessary for persistence relative to this instance. The inverse of `get_provisioner_info()`, this enables applications that subclass `KernelManager` to re-establish communication with a provisioner that is managing a (presumably) remote kernel from an entirely different process that the original provisioner. NOTE: The superclass method must always be called first to ensure proper deserialization. r r!NrWrXs rÚload_provisioner_infoÚ+KernelProvisionerBase.load_provisioner_info¼s!é€ð*¨+Ñ6ˆŒØ/Ð0AÑBˆÕùs‚Ú recommendedcó•U$)a Returns the time allowed for a complete shutdown. This may vary by provisioner. This method is called from `KernelManager.finish_shutdown()` during the graceful phase of its kernel shutdown sequence. The recommended value will typically be what is configured in the kernel manager. r©r%r_s rÚget_shutdown_wait_timeÚ,KernelProvisionerBase.get_shutdown_wait_timeÊs €ðÐrcó•U$)zº Returns the expected upper bound for a kernel (re-)start to complete. This may vary by provisioner. The recommended value will typically be what is configured in the kernel restarter. rras rÚget_stable_start_timeÚ+KernelProvisionerBase.get_stable_start_timeÕs €ðÐrrIcóÒ•URR(aLURRR5RS5(aUR SS5 ggg)zÖ Ensures env is appropriate prior to launch. This method is called from `KernelProvisionerBase.pre_launch()` during the kernel's start sequence. NOTE: Subclasses should be sure to call super()._finalize_env(env) ÚpythonÚPYTHONEXECUTABLEN)rÚlanguageÚlowerÚ startswithrJ)r%rIs rrPÚ#KernelProvisionerBase._finalize_envÞsS€ð × Ñ × $× $¨×)9Ñ)9×)BÑ)B×)HÑ)HÓ)J×)UÑ)UÐV^×)_Ñ)_ð G‰GÐ&¨Õ -ð*`Ð $rÚsubstitution_valuescóä•0nUR(a\SSKJn URRnUR 5H,upVUR XS"U5R U505 M. U$)aA Walks entries in the kernelspec's env stanza and applies substitutions from current env. This method is called from `KernelProvisionerBase.pre_launch()` during the kernel's start sequence. Returns the substituted list of env entries. NOTE: This method is private and is not intended to be overridden by provisioners. r)ÚTemplate)rÚstringrprIÚitemsrNÚsafe_substitute)r%rnÚsubstituted_envrpÚ templated_envÚkÚvs rÚ__apply_env_substitutionsÚ/KernelProvisionerBase.__apply_env_substitutionsìsf€ðˆØ × × Ý 'ð !×,Ñ,×0Ñ0ˆMØ%×+Ñ+Ö-‘Ø×&Ñ&¨¨8°A«;×+FÑ+FÐGZÓ+[Ð'\Ö]ñ.àÐr)r!r )F)g@)g$@))rrrrÚ__doc__r rrÚ__annotations__r r r Ústrr!rÚpropertyrÚboolr&r Úintr)r.r2r7r:rr?rBrFrrQrTrZr]ÚfloatrbrerPrOrrrrrrs*‡ñ ñ Ð FÐSWÑX€KÓXÙ%,¨T¸dÑ%C€IˆuS˜'\Ñ"ÓCØ,.€OÐ)Ó.à Øð ˜Tó óóð ðð ˜H S™Mó óð ðð ˜H S™Mó óð ðð ¨ð °ó óð ðñ   $ð  °4ô  óð  ðñ   tð  ¸ô  óð  ðð  t¨C¡yð ¸Cð ÐDXó óð ðñ   Tð  °dô  óð  ñ  °ð  Àõ  ð¨ð°°c¸3°h±ôð2 ¨#ð °$ô ð  ¨D°°c°©Nô  ð C¸Dð CÀTô Cñ °%ð À%õ ñ°ðÀ%õð .  c¨3 h¡ð .°Dô .ð¸TÀ#ÀsÀ(¹^ðÐPTÐUXÐZ]ÐU]ÑP^÷rr)Ú metaclass)rzrKÚabcrrrÚtypingrrrr r Útraitlets.configr r r ÚconnectrÚtyperrrrrÚr‡sKðÙ ó ß,Ñ,ß3Õ3çCÑCå*ô ˜G¡TÐ*=Ó%>ô ôpØÐ Ð(=ópr