ó Á£ô_c@s9dZddlmZddlZddlmZddlmZddlmZddlm Z ddl m Z dd l m Z dd l m Z ddlm ZejeƒZd „Zd „Zd „Zd„ZeƒZd„Zd„ZgZd„Zd„Zd„Zd„Zd„Z d„Z!d„Z"dS(s;Facilities for implementing hooks that call shell commands.iÿÿÿÿ(tprint_functionN(tList(tSet(terrors(tutil(t filesystem(tmisc(toscCsDt|jdƒt|jdƒt|jdƒt|jdƒdS(s#Check hook commands are executable.tpretposttdeploytrenewN(t validate_hooktpre_hookt post_hookt deploy_hookt renew_hook(tconfig((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pytvalidate_hooksscCsBtj|ƒs2tj|ƒtj|ƒs2dSntjj|ƒS(sÁExtract the program run by a shell command. :param str shell_cmd: command to be executed :returns: basename of command or None if the command isn't found :rtype: str or None N(Rt exe_existst plug_utilt path_surgerytNoneRtpathtbasename(t shell_cmd((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyt_progs  cCsŠ|r†|jddƒd}t|ƒs†tjd}tjj|ƒr\dj||ƒ}ndj|||ƒ}tj |ƒ‚q†ndS(s‹Check that a command provided as a hook is plausibly executable. :raises .errors.HookCommandNotFound: if the command is not found iitPATHs3{1}-hook command {0} exists, but is not executable.s>Unable to find {2}-hook command {0} in the PATH. (PATH is {1})N( tsplitRRRtenvironRtexiststformatRtHookCommandNotFound(Rt hook_nametcmdRtmsg((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR *s  cCs_|jdkr?|jr?x$t|jƒD]}t|ƒq(Wn|j}|r[t|ƒndS(såRun pre-hooks if they exist and haven't already been run. When Certbot is running with the renew subcommand, this function runs any hooks found in the config.renewal_pre_hooks_dir (if they have not already been run) followed by any pre-hook in the config. If hooks in config.renewal_pre_hooks_dir are run and the pre-hook in the config is a path to one of these scripts, it is not run twice. :param configuration.NamespaceConfig config: Certbot settings R N(tverbtdirectory_hookst list_hookstrenewal_pre_hooks_dirt_run_pre_hook_if_necessaryR (RthookR"((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR <s  cCs=|tkrtjd|ƒntd|ƒtj|ƒdS(sÑRun the specified pre-hook if we haven't already. If we've already run this exact command before, a message is logged saying the pre-hook was skipped. :param str command: pre-hook to be run s*Pre-hook command already run, skipping: %sspre-hookN(texecuted_pre_hookstloggertinfot _run_hooktadd(tcommand((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR(Ts  cCsx|j}|jdkr^|jrHx$t|jƒD]}t|ƒq1Wn|rtt|ƒqtn|rttd|ƒndS(s…Run post-hooks if defined. This function also registers any executables found in config.renewal_post_hooks_dir to be run when Certbot is used with the renew subcommand. If the verb is renew, we delay executing any post-hooks until :func:`run_saved_post_hooks` is called. In this case, this function registers all hooks found in config.renewal_post_hooks_dir to be called followed by any post-hook in the config. If the post-hook in the config is a path to an executable in the post-hook directory, it is not scheduled to be run twice. :param configuration.NamespaceConfig config: Certbot settings R s post-hookN(RR$R%R&trenewal_post_hooks_dirt_run_eventuallyR-(RR"R)((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyRds  cCs |tkrtj|ƒndS(súRegisters a post-hook to be run eventually. All commands given to this function will be run exactly once in the order they were given when :func:`run_saved_post_hooks` is called. :param str command: post-hook to register to be run N(t post_hookstappend(R/((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR1†s cCs"xtD]}td|ƒqWdS(sGRun any post hooks that were saved up in the course of the 'renew' verbs post-hookN(R2R-(R"((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pytrun_saved_post_hooks“s cCs)|jr%t|j|||jƒndS(sRun post-issuance hook if defined. :param configuration.NamespaceConfig config: Certbot settings :param domains: domains in the obtained certificate :type domains: `list` of `str` :param str lineage_path: live directory path for the new cert N(Rt_run_deploy_hooktdry_run(Rtdomainst lineage_path((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR™s  cCs tƒ}|jrRx=t|jƒD])}t||||jƒ|j|ƒq"Wn|jrœ|j|kr€tj d|jƒqœt|j|||jƒndS(s]Run post-renewal hooks. This function runs any hooks found in config.renewal_deploy_hooks_dir followed by any renew-hook in the config. If the renew-hook in the config is a path to a script in config.renewal_deploy_hooks_dir, it is not run twice. If Certbot is doing a dry run, no hooks are run and messages are logged saying that they were skipped. :param configuration.NamespaceConfig config: Certbot settings :param domains: domains in the obtained certificate :type domains: `list` of `str` :param str lineage_path: live directory path for the new cert s0Skipping deploy-hook '%s' as it was already run.N( tsetR%R&trenewal_deploy_hooks_dirR5R6R.RR+R,(RR7R8texecuted_dir_hooksR)((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR§s      cCsN|rtjd|ƒdSdj|ƒtjd<|tjdôst~(RtlistdirRt is_executabletendswithtsorted(RItallpathsRthooks((RIs;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyR&ës 8(#t__doc__t __future__Rtloggingtacme.magic_typingRRtcertbotRRtcertbot.compatRRRtcertbot.pluginsRt getLoggert__name__R+RRR R R9R*R(RR2R1R4RRR5R-R&(((s;/usr/lib/python2.7/site-packages/certbot/_internal/hooks.pyts4