IijSrSSKrSSKrSSKrSSKrSSKrSSKrSSKJr SSK J r SSK J r Sur rSSK r SSKJrJr S r"S S 5rS r"S S5r"SS\5rg!\a r\rSrCN:SrCff=f)z2 Configuration file (aka ``ssh_config``) support. N)sha1)StringIO)partial)NN)CouldNotCanonicalizeConfigParseErrorc\rSrSrSr\R "S5r/SQS//SQ/SQ/SQ/S QS .rS r \ S 5r \ S 5r \ S5r SrSrSSjrSrSrSrSrSrSrSrSrSrSrSrg) SSHConfig.ag Representation of config information as stored in the format used by OpenSSH. Queries can be made via `lookup`. The format is described in OpenSSH's ``ssh_config`` man page. This class is provided primarily as a convenience to posix users (since the OpenSSH format is a de-facto standard on posix) but should work fine on Windows too. .. versionadded:: 1.6 z(\w+)(?:\s*=\s*|\s+)(.+))%C%h%l%L%n%p%r%ur)r ~%drrrr)rrrr)rrr) r rrrrrrrr) controlpathhostname identityfile proxycommand proxyjump match-execc/Ulg)a Create a new OpenSSH config object. Note: the newer alternate constructors `from_path`, `from_file` and `from_text` are simpler to use, as they parse on instantiation. For example, instead of:: config = SSHConfig() config.parse(open("some-path.config") you could:: config = SSHConfig.from_file(open("some-path.config")) # Or more directly: config = SSHConfig.from_path("some-path.config") # Or if you have arbitrary ssh_config text from some other source: config = SSHConfig.from_text("Host foo\n\tUser bar") N_config)selfs 5/venv/lib/python3.13/site-packages/paramiko/config.py__init__SSHConfig.__init__Hs & c6UR[U55$)zO Create a new, parsed `SSHConfig` from ``text`` string. .. versionadded:: 2.7 ) from_filer)clstexts r! from_textSSHConfig.from_text]s}}Xd^,,r$cp[U5nURU5sSSS5 $!,(df  g=f)zZ Create a new, parsed `SSHConfig` from the file found at ``path``. .. versionadded:: 2.7 N)openr&)r'pathflos r! from_pathSSHConfig.from_pathfs#$Z3==%ZZs' 5c6U"5nURU5 U$)zX Create a new, parsed `SSHConfig` from file-like object ``flo``. .. versionadded:: 2.7 )parse)r'r.objs r!r&SSHConfig.from_filepse # r$cS/0S.nUGHnUR5nU(aURS5(aM3[R"URU5nU(d[ SR U55eURS5R5nURS5nUS;aQURRU5 S00nUS :XaURU5US 'MURU5US 'MUS :XaUR5S :Xa S USU'GM!URS5(aURS5(aUSSnUS;a.XRS;aUSURU5 GMzU/USU'GMXRS;dGMXbSU'GM URRU5 g )zv Read an OpenSSH config from the given file object. :param file_obj: a file-like object to read the config file from *)hostconfig#zUnparsable line {}r)r7matchr8r7matchesrnoneN")r localforward remoteforward)strip startswithrer;SETTINGS_REGEXrformatgrouplowerrappend _get_hosts _get_matchesendswith)r file_objcontextliner;keyvalues r!r2SSHConfig.parse{s 5B/D::# UHoTT;dM Uv M g7fN).0xrPrbs r! $SSHConfig._lookup..s(#(aWS\,A5s  ) SSHConfigDictr_pattern_matchesr] _does_matchitemsextend_expand_variables)r rrbrZr[rNrQrPs ` @r!r\SSHConfig._lookups ?#oG||G%%gkk&"&=xHH##KK 2. %h/557 Ug% 05/@58eGCLN*CL''(#((8$. ,,Wh?Gr$c SnUHJnSRX5n[Xb5nUbUSnO[R"U5nU(dMHUs $ UR SS5S:XaU$[ U5e![Ra NHf=f)a/ Return canonicalized version of ``hostname``. :param str hostname: Target hostname. :param options: An `SSHConfigDict` from a previous lookup pass. :param domains: List of domains (e.g. ``["paramiko.org"]``). :returns: A canonicalized hostname if one was found, else ``None``. .. versionadded:: 2.7 Fz{}.{}rcanonicalizefallbacklocalrU)rF_addressfamily_host_lookupsocket gethostbynamegaierrorr]r)r rrbrefounddomain candidatefamily_specifics r!raSSHConfig.canonicalizesFx8I8LO*(*"00;Eu! %, ;;2E :e CO#8,,sA66B  B ch[5nURHnURUS5 M U$)zo Return the set of literal hostnames defined in the SSH config (both explicit hostnames and wildcard entries). r7)setrupdate)r hostsentrys r! get_hostnamesSSHConfig.get_hostnamesEs. \\E LLv '" r$c [US5(aURS5nSnUHXnURS5(a [R"X$SS5(a g[R"X$5(dMVSnMZ U$)Nr`,F!rT)hasattrr`rCfnmatch)r patternstargetr;patterns r!rqSSHConfig._pattern_matchesOsx 8W % %~~c*HG!!#&&7?? ,,11  r$c /nUSSn[R"5nU(Ga_URS5n Sn URSS5n URSS5n U SU SpU S:XaUR X95(agU S:XaUn OU S :Xag U S :XaU =(d UnUR X5n OU S :XaUR X5n OU S:XaU =(d UnUR UU5n O^U S :XaUR X5n OFU S:Xa@UR XRSU5n[c[e[R"USS S9Rn U bUR X5(agURU 5 U(aGM_U$)NrrusertypeparamrZFr[allTr7 originalhost localuserexecrstdout)hidewarn) getpassgetuserpopr] _should_failrq _tokenizeinvokeinvoke_import_errorrunokrI)r match_listtarget_hostnamerZr[rbmatched candidateslocal_usernamerpassedconfigured_hostconfigured_usertype_rhostvalrexec_cmds r!rrSSHConfig._does_match`s]  *"q)IF&kk*d;O%kk&$7O$V,i.@5 #$$Y:: %&)<_..u>.(..uF&&8...ud;+%..uE&>>lE >--H8$GJJ!d&7&7&J&J NN9 %]j`r$c(US(aU$U(+$)Nnegaterk)r would_passrs r!rSSHConfig._should_fails&x0zD*nDr$c URU5nU(dU$UnUS:waURSU5nSU;aUSnO[n[R"5nSU;aUSn OUn [ R "5RS5Sn [X5n [RRS5n X-[U5-U -n [U R55R5U UU U UUU UU S. nUnUR!5H)unnUU;aMUR#U[%U55nM+ U$)aL Tokenize a string based on current config/hostname data. :param config: Current config data. :param target_hostname: Original target connection hostname. :param key: Config key being tokenized (used to filter token list). :param value: Config value being tokenized. :returns: The tokenized version of the input ``value`` string. rportrrXrr) r rrrrrrrrr)_allowed_tokensr]SSH_PORTrrrz gethostnamer`LazyFqdnosr- expanduserreprrencode hexdigestrsreplacestr)r r8rrPrQallowed_tokensconfigured_hostnamerr remoteuserlocal_hostname local_fqdnhomedirtohash replacements tokenizedfindrs r!rSSHConfig._tokenizesL--c2L. * "(**Z9L"M  V &>DD  V JJ++-33C8;f5 ''$$S)1DJ>Kv}}'113% " $ )//1MD'>)!))$G =I2 r$c:URRU/5$)a Given config ``key``, return list of token strings to tokenize. .. note:: This feels like it wants to eventually go away, but is used to preserve as-strict-as-possible compatibility with OpenSSH, which for whatever reason only applies some tokens to some config keys. )TOKENS_BY_CONFIG_KEYr]r rPs r!rSSHConfig._allowed_tokenss((,,S"55r$cUHinXcM [URXU5n[X[5(a%[ X5HupVU"U5XU'M M]U"X5X'Mk U$)a Return a dict of config options with expanded substitutions for a given original & current target hostname. Please refer to :doc:`/api/config` for details. :param dict config: the currently parsed config :param str hostname: the hostname whose config is being looked up )rr isinstancelist enumerate)r r8rk tokenizerirQs r!ruSSHConfig._expand_variablesstAy KI&)T** )&) 4HA#,U#3FIaL!5&fi0  r$c[R"U5$![a [SR U55ef=f)z. Return a list of host_names from host value. zUnparsable host {})shlexr` ValueErrorrrF)r r7s r!rJSSHConfig._get_hostss? F;;t$ $ F"#7#>#>t#DE E Fs%=c^ /n[R"U5nU(aSSSS.nURS5nURS5(a SUS'USSnXAS 'US ;aUR U5 M[U(d[ S R U55eURS5US 'UR U5 U(aMUVs/sHoUS PM nnS U;aSm [[U 4SjU55[[U 4SjU55pSn [U5(aSn O,SU;a&URS5URS 5:aSn U b [ U 5eU$s snf)zw Parse a specific Match config line into a list-of-dicts for its values. Performs some parse-time validation as well. NF)rrrrrTrrr)rrZr[z'Missing parameter to Match '{}' keywordrr)rrZc>UT;$rjrkrm allowables r!(SSHConfig._get_matches.."s a9nr$c>UT;$rjrkrs r!rr#s ay&8r$z>Match does not allow 'all' mixed with anything but 'canonical'rZz-Match does not allow 'all' before 'canonical') rr`rrCrIrrFrfilteranyindex) r r;r<tokensrrmkeywordsrbaderrrs @r!rKSSHConfig._get_matchessZ U#!DEBEJJqME$$"&hab !&M55u%&=DDUK$ZZ]E'N NN5 !#f((//w!fIw/ H ,IV4h?@V8(CDC3xxV"rxx '>@N   V #^^F!!                ??   sA*BB+*B+c(\rSrSrSrSSjrSrSrg)riTz/ Returns the host's fqdn on request as string. Nc*SUlXlX lgrj)fqdnr8r7)r r8r7s r!r"LazyFqdn.__init__Ys   r$cURceSn[URUR5nUb"UHnUupEpgnU(dMSU;dMUn O Uc[R "5nXlUR$)NrX)rryr7r8rzgetfqdn) r rresultsresafsocktypeproto canonnamesas r!__str__LazyFqdn.__str__^sy 99 D0DKKHG""C9<6B%B ySI%5( # |~~'Iyyr$)r8rr7rj)rrrrrr"r rrkr$r!rrTs r$rc$\rSrSrSrSrSrSrg)rpizac A dictionary wrapper/subclass for per-host configuration structures. This class introduces some usage niceties for consumers of `SSHConfig`, specifically around the issue of variable type conversions: normal value access yields strings, but there are now methods such as `as_bool` and `as_int` that yield casted values instead. For example, given the following ``ssh_config`` file snippet:: Host foo.example.com PasswordAuthentication no Compression yes ServerAliveInterval 60 the following code highlights how you can access the raw strings as well as usefully Python type-casted versions (recalling that keys are all normalized to lowercase first):: my_config = SSHConfig() my_config.parse(open('~/.ssh/config')) conf = my_config.lookup('foo.example.com') assert conf['passwordauthentication'] == 'no' assert conf.as_bool('passwordauthentication') is False assert conf['compression'] == 'yes' assert conf.as_bool('compression') is True assert conf['serveraliveinterval'] == '60' assert conf.as_int('serveraliveinterval') == 60 .. versionadded:: 2.5 c^Xn[U[5(aU$UR5S:H$)ar Express given key's value as a boolean type. Typically, this is used for ``ssh_config``'s pseudo-boolean values which are either ``"yes"`` or ``"no"``. In such cases, ``"yes"`` yields ``True`` and any other value becomes ``False``. .. note:: If (for whatever reason) the stored value is already boolean in nature, it's simply returned. .. versionadded:: 2.5 rU)rboolrH)r rPvals r!as_boolSSHConfigDict.as_bools.i c4 Jyy{e##r$c[X5$)z Express given key's value as an integer, if possible. This method will raise ``ValueError`` or similar if the value is not int-appropriate, same as the builtin `int` type. .. versionadded:: 2.5 )r^rs r!as_intSSHConfigDict.as_ints49~r$rkN)rrrrrrrrrkr$r!rprpzsB$& r$rp)rrrrrDrrzhashlibrior functoolsrrr ImportErrore ssh_exceptionrrrr ryrdictrprkr$r!rs( (B ~~B" J##L>D>ksA$$A6*A11A6