Ii$\SrSSKrSSKJr SSKJr SSKJrJrJ r SSK J r "SS5r g) z& Implementation of an SSH2 "message". N)BytesIO)util) zero_bytemax_byteone_byte)uc\rSrSrSrSrS#SjrSrSrSr S r S r S r S r S rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr S r!S!r"S"r#g)$Messageab An SSH2 message is a stream of bytes that encodes some combination of strings, integers, bools, and infinite-precision integers. This class builds or breaks down such a byte stream. Normally you don't need to deal with anything this low-level, but it's exposed for people implementing custom extensions, or features that paramiko doesn't support yet. l~NcJUb[U5Ulg[5Ulg)z Create a new SSH2 message. :param bytes content: the byte stream to use as the message content (passed in only when decomposing a message). N)rpacket)selfcontents 6/venv/lib/python3.13/site-packages/paramiko/message.py__init__Message.__init__,s  !'*DK!)DKc"UR5$N)asbytesrs r __bytes__Message.__bytes__9s||~rcTS[URR55-S-$)z@ Returns a string representation of this object, for debugging. zparamiko.Message())reprr getvaluers r__repr__Message.__repr__<s&#T$++*>*>*@%AACGGrc6URR5$)z? Return the byte stream content of this Message, as a `bytes`. )r rrs rrMessage.asbytesCs{{##%%rc:URRS5 g)zS Rewind the message to the beginning as if no items had been parsed out of it yet. rN)r seekrs rrewindMessage.rewindIs rcURR5nURR5nURRU5 U$)zS Return the `bytes` of this message that haven't already been parsed and returned. )r tellreadr#)rposition remainders r get_remainderMessage.get_remainderPs@ ;;##%KK$$&  "rcURR5nUR5 URRU5$)z Returns the `bytes` of this message that have been parsed and returned. The string passed into a message's constructor can be regenerated by concatenating ``get_so_far`` and `get_remainder`. )r r'r$r()rr)s r get_so_farMessage.get_so_farZs4 ;;##% {{))rcURRU5nSn[U5Us=:aU:aO U$U[U[U5- --$U$)z Return the next ``n`` bytes of the message, without decomposing into an int, decoded string, etc. Just the raw bytes are returned. Returns a string of ``n`` zero bytes if there weren't ``n`` bytes remaining in the message. i)r r(lenr)rnb max_pad_sizes r get_bytesMessage.get_bytesdsR KK  Q  q6A $ $yAAJ// /rc$URS5$)z Return the next byte of the message, without decomposing it. This is equivalent to `get_bytes(1) `. :return: the next (`bytes`) byte of the message, or ``b''`` if there aren't any bytes remaining. )r5rs rget_byteMessage.get_byteqs~~a  rc6URS5nU[:g$)z" Fetch a boolean from the stream. r8)r5rrr3s r get_booleanMessage.get_boolean|s NN1 I~rcURS5nU[:Xa$[R"UR 55$XRS5- n[ R "SU5S$)zB Fetch an int from the stream. :return: a 32-bit unsigned `int`. r8>Ir)r5rr inflate_long get_binarystructunpack)rbytes rget_adaptive_intMessage.get_adaptive_intsY ~~a  8 $$T__%67 7 q!!}}T4(++rcT[R"SURS55S$)z Fetch an int from the stream. rArrDrEr5rs rget_intMessage.get_ints#}}T4>>!#45a88rcT[R"SURS55S$)zR Fetch a 64-bit int from the stream. :return: a 64-bit unsigned integer (`int`). >QrrKrs r get_int64Message.get_int64s# }}T4>>!#45a88rcJ[R"UR55$)zZ Fetch a long int (mpint) from the stream. :return: an arbitrary-length integer (`int`). )rrBrCrs r get_mpintMessage.get_mpints   !233rc@URUR55$)z Fetch a "string" from the stream. This will actually be a `bytes` object, and may contain unprintable characters. (It's not unheard of for a string to contain another byte-stream message.) r5rLrs r get_stringMessage.get_strings ~~dlln--rc4[UR55$)zz Fetch a Unicode string from the stream. This currently operates by attempting to encode the next "string" as ``utf-8``. )rrXrs rget_textMessage.get_texts"##rc@URUR55$)z0 Alias for `get_string` (obtains a bytestring). rWrs rrCMessage.get_binarys~~dlln--rc@UR5RS5$)zv Fetch a list of `strings ` from the stream. These are trivially encoded as comma-separated values in a string. ,)r[splitrs rget_listMessage.get_lists }}$$S))rc<URRU5 U$)zR Write bytes to the stream, without any formatting. :param bytes b: bytes to add r writer<s r add_bytesMessage.add_bytes ! rc<URRU5 U$)zY Write a single byte to the stream, without any formatting. :param bytes b: byte to add rer<s radd_byteMessage.add_byterircU(a!URR[5 U$URR[5 U$)zI Add a boolean value to the stream. :param bool b: boolean value to add )r rfrrr<s r add_booleanMessage.add_booleans9 KK  h '  KK  i ( rcfURR[R"SU55 U$z= Add an integer to the stream. :param int n: integer to add rAr rfrDpackrr2s radd_intMessage.add_int& &++dA./ rcU[R:aFURR[5 UR [ R"U55 U$URR[R"SU55 U$rq) r big_intr rfr add_stringr deflate_longrDrsrts radd_adaptive_intMessage.add_adaptive_intsd   KK  h ' OOD--a0 1  KK  fkk$2 3 rcfURR[R"SU55 U$)z@ Add a 64-bit int to the stream. :param int n: long int to add rOrrrts r add_int64Message.add_int64rwrcPUR[R"U55 U$)z Add a long int to the stream, encoded as an infinite-precision integer. This method only works on positive numbers. :param int z: long int to add )rzrr{)rzs r add_mpintMessage.add_mpints  ))!,- rc[R"U5nUR[U55 URR U5 U$)zC Add a bytestring to the stream. :param byte s: bytestring to add )rrrur1r rf)rss rrzMessage.add_strings8 LLO SV ! rcFURSRU55 U$)z Add a list of strings to the stream. They are encoded identically to a single string of values separated by commas. (Yes, really, that's how SSH2 does it.) :param l: list of strings to add r`)rzjoin)rls radd_listMessage.add_lists  $ rc[U5[LaURU5$[U[5(aUR U5$[U5[ LaURU5$URU5$r) typeboolrn isinstanceintr|listrrz)ris r_add Message._add'se 7d?##A& & 3  ((+ + !W_==# #??1% %rc8UHnURU5 M g)z Add a sequence of items to the stream. The values are encoded based on their type: bytes, str, int, bool, or list. .. warning:: Longs are encoded non-deterministically. Don't use this method. :param seq: the sequence of items N)r)rseqitems radd Message.add3sD IIdOr)r r)$__name__ __module__ __qualname____firstlineno____doc__ryrrrrr$r+r.r5r9r=rGrLrQrTrXr[rCrbrgrkrnrur|rrrzrrr__static_attributes__rrr r sG $H& *  ! ,9 94.$. *    & rr ) rrDiorparamikorparamiko.commonrrr paramiko.utilrr rrrrs*&99__r