ó Á£ô_c@sÆdZddlZddlZddlZddlZddlmZddlZddl Z ddl m Z ddl mZddl mZddl mZddl mZdd l mZdd lmZdd lmZdd lmZdd lmZejeƒZd„Zd„ZejdƒZ ejdej!ƒZ"e j#j$ej%ƒde&fd„ƒYƒZ'de'fd„ƒYZ(de&fd„ƒYZ)de&fd„ƒYZ*d„Z+d„Z,dS(sPlugin common functions.iÿÿÿÿN(tutil(tList(t achallenges(t crypto_util(terrors(t interfaces(treverter(t constants(t filesystem(tos(t PluginStoragecCs|dS(s9ArgumentParser options namespace (prefix of all options).t-((tname((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytoption_namespacescCs|jddƒdS(s;ArgumentParser dest namespace (prefix of all destinations).R t_(treplace(R ((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytdest_namespacessX(^127\.0\.0\.1)|(^10\.)|(^172\.1[6-9]\.)|(^172\.2[0-9]\.)|(^172\.3[0-1]\.)|(^192\.168\.)s3^(([a-z0-9]|[a-z0-9][a-z0-9\-]*[a-z0-9])\.)*[a-z]+$tPlugincBsqeZdZd„Zejd„ƒZed„ƒZe d„ƒZ d„Z e d„ƒZ d„Z d„ZRS( sGeneric plugin.cCs||_||_dS(N(tconfigR (tselfRR ((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt__init__0s cCsdS(séAdd plugin arguments to the CLI argument parser. :param callable add: Function that proxies calls to `argparse.ArgumentParser.add_argument` prepending options with unique plugin name prefix. N((tclstadd((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytadd_parser_arguments4scs‡‡fd†}|j|ƒS(sYInject parser options. See `~.IPlugin.inject_parser_options` for docs. cs%ˆjdjtˆƒ|ƒ||ŽS(Ns--{0}{1}(t add_argumenttformatR (targ_name_no_prefixtargstkwargs(R tparser(s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyRFs(R(RRR R((R Rs:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytinject_parser_options>scCs t|jƒS(s9ArgumentParser options namespace (prefix of all options).(R R (R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR LscCs |j|S(s'Option name (include plugin namespace).(R (RR ((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt option_nameQscCs t|jƒS(s;ArgumentParser dest namespace (prefix of all destinations).(RR (R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyRUscCs|j|jddƒS(s.Find a destination for given variable ``var``.R R(RR(Rtvar((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytdestZscCst|j|j|ƒƒS(s0Find a configuration value for variable ``var``.(tgetattrRR!(RR ((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytconf`s(t__name__t __module__t__doc__Rt jose_utiltabstractclassmethodRt classmethodRtpropertyR RRR!R#(((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR*s    t InstallercBsqeZdZd„Zed„Zd„Zd„Zd„Zdd„Z e d„ƒZ e d „ƒZ d „Z RS( s‹An installer base class with reverter and ssl_dhparam methods defined. Installer plugins do not have to inherit from this class. cOsJtt|ƒj||Žt|j|jƒ|_tj|jƒ|_dS(N( tsuperR+RR RR tstorageRtReverter(RRR((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyRkscCsd|r|jj}n |jj}y|||ƒWn+tjk r_}tjt|ƒƒ‚nXdS(s´Add files to a checkpoint. :param set save_files: set of filepaths to save :param str save_notes: notes about changes during the save :param bool temporary: True if the files should be added to a temporary checkpoint rather than a permanent one. This is usually used for changes that will soon be reverted. :raises .errors.PluginError: when unable to add to checkpoint N(Rtadd_to_temp_checkpointtadd_to_checkpointRt ReverterErrort PluginErrortstr(Rt save_filest save_notest temporarytcheckpoint_functerr((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR0ps  cCsFy|jj|ƒWn+tjk rA}tjt|ƒƒ‚nXdS(s±Timestamp and save changes made through the reverter. :param str title: Title describing checkpoint :raises .errors.PluginError: when an error occurs N(Rtfinalize_checkpointRR1R2R3(RttitleR8((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR9†scCsCy|jjƒWn+tjk r>}tjt|ƒƒ‚nXdS(sÉRevert all previously modified files. Reverts all modified files that have not been saved as a checkpoint :raises .errors.PluginError: If unable to recover the configuration N(Rtrecovery_routineRR1R2R3(RR8((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR;“scCsCy|jjƒWn+tjk r>}tjt|ƒƒ‚nXdS(skRollback temporary checkpoint. :raises .errors.PluginError: when unable to revert config N(Rtrevert_temporary_configRR1R2R3(RR8((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR< sicCsFy|jj|ƒWn+tjk rA}tjt|ƒƒ‚nXdS(súRollback saved checkpoints. :param int rollback: Number of checkpoints to revert :raises .errors.PluginError: If there is a problem with the input or the function is unable to correctly revert the configuration N(Rtrollback_checkpointsRR1R2R3(RtrollbackR8((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR=«s cCstjj|jjtjƒS(s(Full absolute path to ssl_dhparams file.(R tpathtjoinRt config_dirRtSSL_DHPARAMS_DEST(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt ssl_dhparams¹scCstjj|jjtjƒS(s:Full absolute path to digest of updated ssl_dhparams file.(R R?R@RRARtUPDATED_SSL_DHPARAMS_DIGEST(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytupdated_ssl_dhparams_digest¾scCst|j|jtjtjƒS(sJCopy Certbot's ssl_dhparams file into the system's config dir if required.(tinstall_version_controlled_fileRCRERtSSL_DHPARAMS_SRCtALL_SSL_DHPARAMS_HASHES(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytinstall_ssl_dhparamsÃs (R$R%R&RtFalseR0R9R;R<R=R*RCRERI(((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR+es   tAddrcBsƒeZdZed„Zed„ƒZd„Zd„Zd„Z d„Z d„Z d„Z d „Z d „Zd „Zd „ZRS( sˆRepresents an virtual host address. :param str addr: addr part of vhost address :param str port: port number or \*, or "" cCs||_||_dS(N(ttuptipv6(RRLRM((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyRÓs cCs®|jdƒrƒ|jdƒ}||d }d}t|ƒ|dkrm||ddkrm||d}n|||fdtƒS|jdƒ}||d|dfƒSd S( sInitialize Addr from string.t[t]itit:RMiN(t startswithtrfindtlentTruet partition(Rtstr_addrtendIndexthosttportRL((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt fromstring×s*cCs#|jdrd|jS|jdS(Nis%s:%si(RL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt__str__æs  cCs'|jr |jƒ|jdfS|jS(s5Normalized representation of addr/port tuple i(RMtget_ipv6_explodedRL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytnormalized_tupleës cCs,t||jƒr(|jƒ|jƒkStS(N(t isinstancet __class__R^RJ(Rtother((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt__eq__òscCs t|jƒS(N(thashRL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt__hash__úscCs |jdS(s Return addr part of Addr object.i(RL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytget_addrýscCs |jdS(s Return port.i(RL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pytget_portscCs |j|jd|f|jƒS(s6Return new address object with same addr and new port.i(R`RLRM(RRZ((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt get_addr_objscCs+|jdƒ}|jdƒ}|j|ƒS(s7Return IPv6 address in normalized form, helper functionRNRO(tlstriptrstript _explode_ipv6(Rtaddr((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyt_normalize_ipv6 scCs*|jr&dj|j|jdƒƒSdS(sReturn IPv6 in normalized formRQiRP(RMR@RlRL(R((s:/usr/lib/python2.7/site-packages/certbot/plugins/common.pyR]s cCsëddddddddg}|jdƒ}t|ƒt|ƒkr[|dt|ƒ!}nt}xƒt|ƒD]u\}}|sŒt}qnnt|ƒdkr°|jdƒ}n|sÉt|ƒ||s>         :gb( 2