>tyyG[G[GqGqryMQGqHR jN^N^N`bgh ii yy))$//7>>#.55c:CItyyG[G[GqGqryMQGqHRST zGWGWGY[_afg hh%)rc"[SU5nUS:Xa/OURS5nX0lUH^nURU5S:a [ UR 5<SU<35eUS:XdM@[ UR 5<SU<35e g)Nsr0r9z had duplicate flags: s z) had extra whitespace on its 's' line: s )rr?flagscountrBrC)rSrTrUrkflags r, _parse_s_linerns g % "S!1%d {{41 9I9I9KUS TT  *JZJZJ\^cd ee rc[SU5nX lURS5(a)[RR USS5Ulgg![ a)n[ UR5<SU<SU<35eSnAff=f)NvzTor r<z has a malformed tor version (z): v )r version_line startswithrversion _get_versionrBrCrSrTrUexcs r, _parse_v_linerws g %! fg<<44U12Y?j g jFVFVFXZ]_de ffgs'A B$BBc^[SU5nURS5n[U5S:a [UR 5<SU<35eUSR S5(d [UR 5<SU<35eSnSnSn/nUGHnS U;aURS S5upOUSpU S :XaIU (aU R 5(d [UR 5<S U<35e[U 5nMqU S :XaIU (aU R 5(d [UR 5<S U<35e[U 5nMU S:Xa*U S:wa [UR 5<SU<35eSnMURU5 GM X@l XPl X`l Xpl g)Nwr0r9z 'w' line is blank: w rz Bandwidth=z6 'w' line needs to start with a 'Bandwidth=' entry: w F= Bandwidthz5 'Bandwidth=' entry needs to have a numeric value: w Measuredz4 'Measured=' entry needs to have a numeric value: w Unmeasured1z4 'Unmeasured=' should only have the value of '1': w T) rr?rArBrCrrisdigitrNrb bandwidthmeasured is_unmeasuredunrecognized_bandwidth_entries) rSrTrUw_comprrrrw_entryw_keyw_values r, _parse_w_liners g % ;;s &[1_ Z5E5E5GO PP !9   - - U_UeUeUgino pp) (-#% g g~}}S!,neWW '//++XbXhXhXjlqrssg,i * '//++WaWgWgWikpqrrWh ,  CWaWgWgWikpqrrm$++G4-0# *.L+rc[SU5n[RRU5Ulg![a)n[ UR 5<SU<SU<35eSnAff=f)Npz exit policy is malformed (z): p )rr exit_policyMicroExitPolicyrBrCrus r, _parse_p_liners^ g %b!--==eDJ b AQAQASUXZ_` aabs$3 A&$A!!A&cF[SU5nU(aUR(a;URR(d [UR 5<SU<35eUR 5n[ U5S:aUSUlUSUlg[SU-5eg)Nidz+ 'id' line should only appear in votes: id r1rr9z='id' lines should contain both the key type and digest: id %s) rdocumentis_voterBrCr?rAidentifier_type identifier)rSrTrU value_comps r,_parse_id_liners w % :#6#6#>#> JL\L\L^`ef ggJ :!#-a=j (mj VY^^ __ rc/n[SU5GH5nURS5nUR(aURR(d9UR(aSOSn[ UR 5<SU<SU<35e[ U5S:a [ UR 5<SU<35eUS RS 5Vs/sHn[U5PM nn0nUSSHAnS U;a [ UR 5<S U<35eURS S5upXU 'MC URXx45 GM8 X l gs snf![a! [ UR 5<S U<35ef=f)Nmr0votezz5 'm' line should only appear in votes (appeared in a z): m r9z5 'm' line needs to start with a series of methods: m r,zK microdescriptor methods should be a series of comma separated integers: m rzzL can only have a series of 'algorithm=digest' mappings after the methods: m ) rr?rrrBrCrArNrbmicrodescriptor_hashes) rSrT all_hashesrUm_comp vote_statusentrymethodshashes hash_namerLs r, _parse_m_liner5s*sG$e [[ F   J$7$7$?$?(11F7Mk ]g]m]m]oq|DE FF Vq V`VfVfVhjop qqH)/)=>)=U)=g>F E oyoopBDIJK K++c1-i Y w'(/%2'1#? H lvl|l|l~AFG HHHs9EE$EE+FcX[SU5Ul[[SU5SS9Ulg)NrF)check_if_fingerprint)rmicrodescriptor_digestrJrL)rSrTs r,_parse_microdescriptor_m_linerWs,'-S'&:*#%VC%9RWX*rcr[RRR[RRR U55n[ R"U5R5n[RR5(a)[RRRU5nU(aB[RRRU5(d[SU<SU<S35eU$![ [ R4a [SU-5ef=f)a Decodes a base64 value to hex. For example... :: >>> _base64_to_hex('p1aag7VwarGxqctS7/fS0y5FU+s') 'A7569A83B5706AB1B1A9CB52EFF7D2D32E4553EB' :param str identity: encoded fingerprint from the consensus :param bool check_if_fingerprint: asserts that the result is a fingerprint if **True** :returns: **str** with the uppercase hex encoding of the relay's fingerprint :raises: **ValueError** if the result isn't a valid fingerprint z%Unable to decode identity string '%s'z Decoded 'z ' to be 'z"', which isn't a valid fingerprint)rrr _decode_b64 _to_bytes TypeErrorbinasciiErrorrBhexlifyupperprereq is_python_3rrDis_valid_fingerprint)identityridentity_decodedrKs r,rJrJbs"Iyy**66tyy7J7J7T7TU]7^_  !1288:+ [[))%%11+>K 99   3 3K @ @ U]_jk ll  X^^ $I [[U] X(+S9 X0l[ X5nU(Ga UR 5H6nXT;dM [ URS5<SU<S[U5<35e UR5HPnXT;dM [XE5S:dM[ SURS5U[XE5[U54-5e S[UR55S:wa*[ URS5<S [U5<35eURXB5 g X@lg ) a_ Parse a router descriptor in a network status document. :param str content: router descriptor content to be parsed :param NetworkStatusDocument document: document this descriptor came from :param bool validate: checks the validity of the content if **True**, skips these checks otherwise :raises: **ValueError** if the descriptor data is invalid ) lazy_loadTz must have a 'z' line: r9z/%s can only have a single '%s' line, got %i: %sr/rz( are expected to start with a 'r' line: N)superr__init__rr_required_fieldsrBrCstr_single_fieldsrArkeys_parse_entries)selfrr!rrTkeyword __class__s r,rRouterStatusEntry.__init__s8 T+G+NM$W7G**,'  !djj>NPWY\]aYbcd d-((*'  #g&6"7!";MQUQ[Q[\`QacjlopwqAmBDGHLDMQNNO O+ W\\^$Q' 'DJJW[L\^abf^ghii kk'$mrcU(aS$S$)z Name for this descriptor type. zRouter status entrieszRouter status entryr is_plurals r,rCRouterStatusEntry._names '0 "J5JJrcg)z4 Provides lines that must appear in the descriptor. rrrs r,r"RouterStatusEntry._required_fields rcg)z= Provides lines that can only appear in the descriptor once. rrrs r,r RouterStatusEntry._single_fieldsrr)rr)FNF)__name__ __module__ __qualname____firstlineno____doc__rYrnrw ATTRIBUTESPARSER_FOR_LINE classmethodrrrCrr__static_attributes__ __classcell__)rs@r,rrs*}%-( &m$m$}%M "=)m$ *   / yy(@Krrct\rSrSrSrSr\"\R40SS\ 40D6r\ S Sj5r S Sjr S r S rSrg) RouterStatusEntryV2ia Information about an individual router stored within a version 2 network status document. :var str digest: **\*** router's upper-case hex digest **\*** attribute is either required when we're parsed with validation or has a default value, others are left as **None** if undefined znetwork-status-consensus-2rLNrc U(a[SUR-5e[XS[5<S[ 5<S[ 5<S3445$)NSigning of %s not implementedr/9 p1aag7VwarGxqctS7/fS0y5FU+s oQZFLYe9e4A7bOkWKR7TaNxb0JE r0 9001 0rrrr r r rattrexcludesigns r,rRouterStatusEntryV2.content sW  ?#,, N OO t YiYkmym{~R~T UV/ rcU(aS$S$)NzRouter status entries (v2)zRouter status entry (v2)rrs r,rCRouterStatusEntryV2._name+4 'T:TTrcg)Nr/rrs r,r$RouterStatusEntryV2._required_fieldss rcg)Nrrrs r,r"RouterStatusEntryV2._single_fields rNrFr)rrrrrTYPE_ANNOTATION_NAMEdictrrrYrrrCrrrrrr,rrsZ6%00 t]#5*Urrc\rSrSrSrSrSrg)RouterStatusEntryBridgeV2iz Information about an individual router stored within a bridge flavored version 2 network status document. .. versionadded:: 1.8.0 zbridge-network-statusrN)rrrrrrrrrr,rrs1rrc\rSrSrSrSr\"\R40S\ 4/\ 4S\ 4S\ 4S\ 4S\ 4S\ 4/\ 4S\ 40\4/\4S. D6r\"\R 40\ \ \ \\ \S.D6r\S S j5rSS jrS rS rSrg)RouterStatusEntryV3i'a Information about an individual router stored within a version 3 network status document. :var list or_addresses: **\*** relay's OR addresses, this is a tuple listing of the form (address (**str**), port (**int**), is_ipv6 (**bool**)) :var str identifier_type: identity digest key type :var str identifier: base64 encoded identity digest :var str digest: **\*** router's upper-case hex digest :var int bandwidth: bandwidth measured to be available by the relay, this is an arbitrary units (currently kilobytes per second) heuristic generated by the Bandwidth authoritites to weight relay selection :var int measured: *bandwidth* vote provided by a bandwidth authority :var bool is_unmeasured: *bandwidth* measurement isn't based on three or more measurements :var list unrecognized_bandwidth_entries: **\*** bandwidth weighting information that isn't yet recognized :var stem.exit_policy.MicroExitPolicy exit_policy: router's exit policy :var dict protocols: mapping of protocols to their supported versions :var list microdescriptor_hashes: **\*** tuples of two values, the list of consensus methods for generating a set of digests and the 'algorithm => digest' mappings **\*** attribute is either required when we're parsed with validation or has a default value, others are left as **None** if undefined .. versionchanged:: 1.5.0 Added the identifier and identifier_type attributes. .. versionchanged:: 1.6.0 Added the protocols attribute. znetwork-status-consensus-3NF) rLrerrrrrrrrr)r[ryrrrrrc U(a[SUR-5e[XS[5<S[ 5<S[ 5<S34S45$)Nrr/rr0r)rizFast Named Running Stable Validrrs r,rRouterStatusEntryV3.contentgsZ  ?#,, N OO t YiYkmym{~R~T UV./ rcU(aS$S$)NzRouter status entries (v3)zRouter status entry (v3)rrs r,rCRouterStatusEntryV3._nameqrrcg)N)r/rirrs r,r$RouterStatusEntryV3._required_fieldsts rcg)N)r/rirpryrrrrs r,r"RouterStatusEntryV3._single_fieldsw *rrr)rrrrrrrrrrYrgrrr_parse_pr_linerrrrrCrrrrrr,rr's"H6%00]#'n-( &}%]+')=&9-(n%!=15* *::       ?/U+rrc \rSrSrSrSr\"\R40/\ 4S\ 4S\ 4S\ 4/\ 40\ 4S\ 4S\ 4S.D6r\"\R40\ \ \ \ S.D6r \S S j5rSS jrS rS rSrg)r>i{a Information about an individual router stored within a microdescriptor flavored network status document. :var list or_addresses: **\*** relay's OR addresses, this is a tuple listing of the form (address (**str**), port (**int**), is_ipv6 (**bool**)) :var int bandwidth: bandwidth claimed by the relay (in kb/s) :var int measured: bandwidth measured to be available by the relay :var bool is_unmeasured: bandwidth measurement isn't based on three or more measurements :var list unrecognized_bandwidth_entries: **\*** bandwidth weighting information that isn't yet recognized :var dict protocols: mapping of protocols to their supported versions :var str digest: **\*** router's hex encoded digest of our corresponding microdescriptor (**deprecated**, use microdescriptor_digest instead) :var str microdescriptor_digest: **\*** router's base64 encoded digest of our corresponding microdescriptor .. versionchanged:: 1.6.0 Added the protocols attribute. .. versionchanged:: 1.7.0 Added the or_addresses attribute. .. versionchanged:: 1.7.0 Added the microdescriptor_digest attribute to replace our now deprecated digest attribute. **\*** attribute is either required when we're parsed with validation or has a default value, others are left as **None** if undefined z$network-status-microdesc-consensus-3NF)rerrrrrrrL)r[ryrrrc U(a[SUR-5e[XS[5<S[ 5<S[ 5<S34SS45$)Nrr/z ARIJF2zbqirB9IwsW0mQznccWww r0z 9001 9030)rz+aiUklwBrua82obG5AsTX+iEpkjQA2+AQHxZ7GwMfY70)riz1Fast Guard HSDir Named Running Stable V2Dir Validrrs r,r RouterStatusEntryMicroV3.contentsO  ?#,, N OO t @P@RT`Tbdxdz {|:@/ rcU(aS$S$)Nz Router status entries (micro v3)zRouter status entry (micro v3)rrs r,rCRouterStatusEntryMicroV3._names1: -`@``rcg)N)r/rirrrs r,r)RouterStatusEntryMicroV3._required_fieldsrrcg)N)r/rirpryrrrrs r,r'RouterStatusEntryMicroV3._single_fieldsr rrr)rrrrrrrrrrgrrrrrrrCrrrrrr,r>r>{s>@%00 ' &}%]+')=&9n%#%BC23 5 **::   &  ?/a+rr>)r/NNrr)T)$rrrstem.exit_policyr stem.prereqstem.util.str_toolsstem.descriptorrrrrrrr r r r r rr-rYrgrnrwrrrrrrJrrrrr>rrr,rs(     &dK8@ F1Lh). fg$,M^ b `.1DYDq qh!+!H1 31Q++Q+hG+0G+r