_hash_attr_hash)selfparsed_content raw_contentr6s r1__init__ControlMessage.__init__sR  7 88$.jC 4DDO)#DI%%dN;DJrHcBURHun nUS:XdM g g)z Checks if any of our lines have a 250 response. :returns: **True** if any lines have a 250 response code, **False** otherwise 250TF)rN)rRcode_s r1is_okControlMessage.is_oks)** a + rHc ([RR5(aTU(dMURVVVs/sH1up#oBU[RR R U54PM3 snnn$[UR5$s snnnf)a Provides the parsed message content. These are entries of the form... :: (status_code, divider, content) **status_code** Three character code for the type of response (defined in section 4 of the control-spec). **divider** Single character to indicate if this is mid-reply, data, or an end to the message (defined in section 2.3 of the control-spec). **content** The following content is the actual payload of the line. For data entries the content is the full multi-line payload with newline linebreaks and leading periods unescaped. The **status_code** and **divider** are both strings (**bytes** in python 2.x and **unicode** in python 3.x). The **content** however is **bytes** if **get_bytes** is **True**. .. versionchanged:: 1.1.0 Added the get_bytes argument. :param bool get_bytes: provides **bytes** for the **content** rather than a **str** :returns: **list** of (str, str, str) tuples for the components of this message )r.prereq is_python_3rNr>r? _to_unicodelist)rR get_bytesrYdivrBs r1rBControlMessage.contentsnD {{  `d`t`t u`tH\T[S$))--99'BC`t uu $&& ''vs8B c[RR5(a:U(d3[RRR UR 5$UR $)a Provides the unparsed content read from the control socket. .. versionchanged:: 1.1.0 Added the get_bytes argument. :param bool get_bytes: if **True** then this provides **bytes** rather than a **str** :returns: **str** of the socket data used to generate this message )r.r^r_r>r?r`rJ)rRrbs r1rTControlMessage.raw_contentsF {{   YY , ,T->-> ??   rHcrURcSR[U55UlUR$)zR Content of the message, stripped of status code and divider protocol formatting. r5)rOjoinrarRs r1__str__ControlMessage.__str__s,  yy))DJ'di 99rHc## URH_u p[RR5(a)[RR R U5n[U5v Ma g7f)a Provides :class:`~stem.response.ControlLine` instances for the content of the message. This is stripped of status codes and dividers, for instance... :: 250+info/names= desc/id/* -- Router descriptors by ID. desc/name/* -- Router descriptors by nickname. . 250 OK Would provide two entries... :: 1st - "info/names= desc/id/* -- Router descriptors by ID. desc/name/* -- Router descriptors by nickname." 2nd - "OK" NrNr.r^r_r>r?r`r )rRrZrBs r1__iter__ControlMessage.__iter__ sS.-- 1  " "))%%11':   .sA1A3c,[UR5$)z" :returns: number of ControlLines )lenrNris r1__len__ControlMessage.__len__&s t## $$rHcURUSn[RR5(a)[RR R U5n[U5$)z< :returns: :class:`~stem.response.ControlLine` at the index rm)rRindexrBs r1 __getitem__ControlMessage.__getitem__-sQ ""5)!,G {{   ##//8g w rHcUR$N)rQris r1__hash__ControlMessage.__hash__9s ::rHc^[U[5(a[U5[U5:H$S$NF)rr hashrRothers r1__eq__ControlMessage.__eq__<s&(25.(I(I4:e $TuTrHc X:X+$rzrrs r1__ne__ControlMessage.__ne__?s  rH)rQrNrJrOr6r~rzF)__name__ __module__ __qualname____firstlineno____doc__ staticmethodrFrUr[rBrTrjrnrrrwr{rr__static_attributes__rrHr1r r sT > < %(N" !:%  UrHr c^\rSrSrSrSrSrSrSrSSjr SS jr S r SS jr SS jr S rg)r iCaF String subclass that represents a line of controller output. This behaves as a normal string with additional methods for parsing and popping entries from a space delimited series of elements like a stack. None of these additional methods effect ourselves as a string (which is still immutable). All methods are thread safe. c,[RX5$rz)str__new__rRvalues r1rControlLine.__new__Ms ;;t ##rHcDXl[R"5Ulgrz) _remainder threadingRLock_remainder_lockrs r1rUControlLine.__init__PsO$??,DrHcUR$)z Provides our unparsed content. This is an empty string after we've popped all entries. :returns: **str** of the unparsed content rris r1 remainderControlLine.remainderTs ??rHc URS:H$)zy Checks if we have further content to pop or not. :returns: **True** if we have additional content, **False** otherwise rris r1is_emptyControlLine.is_empty^s ??b  rHcT[URU5up#US:H=(a US:g$)z Checks if our next entry is a quoted value or not. :param bool escaped: unescapes the string :returns: **True** if the next entry can be parsed as a quoted value, **False** otherwise r)_get_quote_indicesr)rRescaped start_quote end_quotes r1is_next_quotedControlLine.is_next_quotedgs+0IK !  / R/rHNcURn[RU5nU(aQU(aXR5S:wagU(a+[ XC5upgXeR 5:H=(a US:g$gg)a^ Checks if our next entry is a KEY=VALUE mapping or not. :param str key: checks that the key matches this value, skipping the check if **None** :param bool quoted: checks that the mapping is to a quoted value :param bool escaped: unescapes the string :returns: **True** if the next entry can be parsed as a key=value mapping, **False** otherwise rFrT)rKEY_ARGmatchgroupsrend)rRkeyquotedrr key_matchrrs r1is_next_mappingControlLine.is_next_mappingsseI i(I ((*1-- !3I!G mmo-A)r/A rHczURn[RU5nU(aUR5S$g)z Provides the key of the next entry, providing **None** if it isn't a key/value mapping. :returns: **str** with the next entry's key rN)rrrr)rRrrs r1peek_keyControlLine.peek_keys5I i(I     "" rHcUR [URXS5up4X@lUsSSS5 $!,(df  g=f)a! Parses the next space separated entry, removing it and the space from our remaining content. Examples... :: >>> line = ControlLine("\"We're all mad here.\" says the grinning cat.") >>> print line.pop(True) "We're all mad here." >>> print line.pop() "says" >>> print line.remainder() "the grinning cat." >>> line = ControlLine("\"this has a \\\" and \\\\ in it\" foo=bar more_data") >>> print line.pop(True, True) "this has a \" and \\ in it" :param bool quoted: parses the next entry as a quoted value, removing the quotes :param bool escaped: unescapes the string :returns: **str** of the next space separated entry :raises: * **ValueError** if quoted is True without the value being quoted * **IndexError** if we don't have any remaining content left to parse FN)r _parse_entryr)rRrr next_entryrs r1rAControlLine.pops6:   *4??FUSj!o    s !8 AcUR UR5(a [S5e[R UR 5nU(d[ SUR -5eUR5SnUR UR5Sn[XaX#5upvX`lXW4sSSS5 $!,(df  g=f)a] Parses the next space separated entry as a KEY=VALUE mapping, removing it and the space from our remaining content. .. versionchanged:: 1.6.0 Added the get_bytes argument. :param bool quoted: parses the value as being quoted, removing the quotes :param bool escaped: unescapes the string :param bool get_bytes: provides **bytes** for the **value** rather than a **str** :returns: **tuple** of the form (key, value) :raises: **ValueError** if this isn't a KEY=VALUE mapping or if quoted is **True** without the value being quoted :raises: **IndexError** if there's nothing to parse from the line no remaining content to parsez*the next entry isn't a KEY=VALUE mapping: rN) rr IndexErrorrrrrKrrr)rRrrrbrrrrs r1 pop_mappingControlLine.pop_mappings&    899--0i EWXX    q !c//)--/"23i*9gQj!o    s B%B<< C )rrr)NFF)FF)FFF)rrrrrrrUrrrrrrArrrrHr1r r Cs5$-! 08 D"rHr cBUS:Xa [S5eSUpTU(a3[XR5upgUS:wdUS:Xa[SU-5eUSUXWS-SpTOSU;aURSS5upEOUSpTU(al[R "U5Sn[ RR5(a0U(d)[ RRRU5nU(a)[ RRRU5nXER54$) a Parses the next entry from the given space separated content. :param str line: content to be parsed :param bool quoted: parses the next entry as a quoted value, removing the quotes :param bool escaped: unescapes the string :returns: **tuple** of the form (entry, remainder) :raises: * **ValueError** if quoted is True without the next value being quoted * **IndexError** if there's nothing to parse from the line rrrrz%the next entry isn't a quoted value: N )rrrKsplitcodecs escape_decoder.r^r_r>r?r`r@lstrip)linerrrbrrrrs r1rrs RZ 4 55di / CKa9? >E FF%a 2I!mn4M  i'ooc15j)') %%j1!4J {{  99&&22:>j$$..z:J &&( ))rHc/Sp2[S5HinURSUS-5nU(a9US:a3XS- S:Xa(URSUS-5nUS:a XS- S:XaM(URU5 Mk [U5$)z Provides the indices of the next two quotes in the given content. :param str line: content to be parsed :param bool escaped: unescapes the string :returns: **tuple** of two ints, indices being -1 if a quote doesn't exist rru"r\)rangefindappendtuple)rrindices quote_indexrZs r1rr"sR; 8a))Cq1K 1 Ao!6$!>ii[1_5  1 Ao!6$!> NN;  wrHc(\rSrSrSrSSjrSrSrg)r i<a Reply to a request that performs an action rather than querying data. These requests only contain a single line, which is 'OK' if successful, and a description of the problem if not. :var str code: status code for our line :var str message: content of the line cnU(aUR5SS:H$UR5SSS:H$)aa Checks if the response code is "250". If strict is **True** then this checks if the response is "250 OK" :param bool strict: checks for a "250 OK" message if **True** :returns: * If strict is **False**: **True** if the response code is "250", **False** otherwise * If strict is **True**: **True** if the response is "250 OK", **False** otherwise r)rXrOKrX)rB)rRstricts r1r[SingleLineResponse.is_okFs9 \\^A "4 44 <<>! Q 5 ((rHcUR5n[U5S:a[R"S5e[U5S:Xa[R"S5eUSuUlo lg)NrzReceived multi-line responserzReceived empty response)rBrqr. ProtocolErrorrYr,)rRrBrZs r1r*!SingleLineResponse._parse_messageWs[llnG 7|a   = >> W    8 99#*1: diLrH)rYr,Nr)rrrrrr[r*rrrHr1r r <s)".rHr )rrr<r8rMr stem.socketr. stem.utilstem.util.str_tools__all__compilerr objectr rr rrr rrHr1rsw6   **Z C#LAVAH`#`F9*x4#.#.rH