o ][C@s8dZddlZddlZddlZddlZddlZddlZddlZddl ZdZ dZ dZ e dZejr;ddZd d Znd dZd d Zd dZddZddZddZd2ddZddZejjddZddejdfdd Zd3d"d#Zd4d$d%Z d5d&d'Z!d(d)Z"d*d+Z#d,d-Z$d.d/Z%d5d0d1Z&eZ'e Z(e!Z)e"Z*dS)6a Toolkit for various string activity. .. versionchanged:: 1.3.0 Dropped the get_* prefix from several function names. The old names still work, but are deprecated aliases. **Module Overview:** :: crop - shortens string to a given length size_label - human readable label for a number of bytes time_label - human readable label for a number of seconds time_labels - human readable labels for each time unit short_time_label - condensed time label output parse_short_time_label - seconds represented by a short time label N))gBz Pbz Petabit)g@Bz Tbz Terabit)gAz Gbz Gigabit)gAz Mbz Megabit)g`@z Kbz Kilobit)g?z bz Bit))gCz PBz Petabyte)gpBz TBz Terabyte)gAz GBz Gigabyte)g0Az MBz Megabyte)g@z KBz Kilobyte)?z Bz Byte))g@dz day)g @hz hour)gN@mz minute)rsz secondz/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})cCst|tr t|ddS|SNreplacer) isinstancestrcodecslatin_1_encodemsgr5/usr/lib/python3/dist-packages/stem/util/str_tools.py_to_bytes_implAs rcC"|durt|ts|ddS|SNzutf-8r)r r decoder rrr_to_unicode_implG rcCs&|durt|trt|ddS|Sr)r unicoder r r rrrrMscCrr)r rrr rrrrSrcCt|S)aW Provides the ASCII bytes for the given string. This is purely to provide python 3 compatability, normalizing the unicode/ASCII change in the version bump. For an explanation of this see... http://python3porting.com/problems.html#nicer-solutions :param str,unicode msg: string to be converted :returns: ASCII bytes for string )rr rrr _to_bytesZs rcCr)z Provides the unicode string for the given ASCII bytes. This is purely to provide python 3 compatability, normalizing the unicode/ASCII change in the version bump. :param str,unicode msg: string to be converted :returns: unicode conversion )rr rrr _to_unicodejs rcCs0t|d}t|tr dnd}t|||S)z. Base64 decode, without padding concerns. ==)lenr bytesbase64Z b64decode)rZmissing_paddingZ padding_chrrrr _decode_b64xs r!csHtjrttrtfddtDStfddtDS)z Serializes a string to a number. :param str msg: string to be serialized :returns: **int** representation of the string cs*g|]\}}tdt|d|qS)powr.0icr rr s*z_to_int..cs.g|]\}}tdt|dt|qSr")r%rordr&r rrr*s.)stemprereq is_python_3r rsum enumerater rr r_to_ints r1_ cCstg}||D]-}t|dkr|dqt|dkr#||q||d|ddq||S)a* Converts the given string to camel case, ie: :: >>> _to_camel_case('I_LIKE_PEPPERJACK!') 'I Like Pepperjack!' :param str label: input string to be converted :param str divider: word boundary :param str joiner: replacement for word boundaries :returns: camel cased string rr$N)splitrappendupperlowerjoin)labelZdividerZjoinerZwordsentryrrr_to_camel_cases   $ r<cs fddtdtDS)a Splits a string into a list of strings up to the given size. :: >>> _split_by_length('hello', 2) ['he', 'll', 'o'] :param str msg: string to split :param int size: number of characters to chunk into :returns: **list** with chunked string components csg|] }||qSrr)r'r(rsizerrr*sz$_split_by_length..r)rangerr=rr=r_split_by_lengths r@ELLIPSEHYPHENrFc Cst||kr|r |dfS|S|dkrtd||r$|dkr$td||dkr.td||tjkrD|dkr?|r=d|fSdS|d8}n |rO|tjkrO|d7}|durVtj}|d d|d}|d krr||kro|rmd|fSdSd }nt|d|}||d|k}|r|r| d |}|d krt|}||d|k}|r|d|||d} } |tjkr| d | } | dd d } n |d|||d} } |s| r| d d vr| dd } |tjkr| d} |r| | fS| S)a Shortens a string to a given length. If we crop content then a given ending is included (counting itself toward the size limitation). This crops on word breaks so we only include a word if we can display at least **min_word_length** characters of it. If there isn't room for even a truncated single word (or one word plus the ellipse if including those) then this provides an empty string. If a cropped string ends with a comma or period then it's stripped (unless we're providing the remainder back). For example... >>> crop('This is a looooong message', 17) 'This is a looo...' >>> crop('This is a looooong message', 12) 'This is a...' >>> crop('This is a looooong message', 3) '' The whole point of this method is to provide human friendly croppings, and as such details of how this works might change in the future. Callers should not rely on the details of how this crops. .. versionadded:: 1.3.0 :param str msg: text to be processed :param int size: space available for text :param int min_word_length: minimum characters before which a word is dropped, requires whole word if **None** :param int min_crop: minimum characters that must be dropped if a word is cropped :param Ending ending: type of ending used when truncating, no special truncation is used if **None** :param bool get_remainder: returns a tuple with the second part being the cropped portion of the message :returns: **str** of the text truncated to the given length r4rz)Crop size can't be negative (received %i)z6Crop's min_word_length can't be negative (received %i)z/Crop's min_crop can't be negative (received %i)r$Nr3T-),.z...) r ValueErrorEndingrArBsysmaxsizerfindrstripfind) rr>Zmin_word_lengthZmin_cropZendingZ get_remainderZlast_wordbreakZ include_cropZnext_wordbreakZ return_msgZ remainderrrrcropsP -            rOTcCs$|r tt||||Stt||||S)a Converts a number of bytes into a human readable label in its most significant units. For instance, 7500 bytes would return "7 KB". If the is_long option is used this expands unit labels to be the properly pluralized full word (for instance 'Kilobytes' rather than 'KB'). Units go up through petabytes. :: >>> size_label(2000000) '1 MB' >>> size_label(1050, 2) '1.02 KB' >>> size_label(1050, 3, True) '1.025 Kilobytes' .. versionchanged:: 1.6.0 Added round argument. :param int byte_count: number of bytes to be converted :param int decimal: number of decimal digits to be included :param bool is_long: expands units label :param bool is_bytes: provides units in bytes if **True**, bits otherwise :param bool round: rounds normally if **True**, otherwise rounds down :returns: **str** with human readable representation of the size ) _get_labelSIZE_UNITS_BYTESSIZE_UNITS_BITS)Z byte_countdecimalis_longZis_bytesroundrrr size_label9srVcCstt|||S)a  Converts seconds into a time label truncated to its most significant units. For instance, 7500 seconds would return "2h". Units go up through days. This defaults to presenting single character labels, but if the is_long option is used this expands labels to be the full word (space included and properly pluralized). For instance, "4h" would be "4 hours" and "1m" would become "1 minute". :: >>> time_label(10000) '2h' >>> time_label(61, 1, True) '1.0 minute' >>> time_label(61, 2, True) '1.01 minutes' :param int seconds: number of seconds to be converted :param int decimal: number of decimal digits to be included :param bool is_long: expands units label :returns: **str** with human readable representation of the time )rP TIME_UNITS)secondsrSrTrrr time_label^srYcCs@g}tD]\}}}t||kr|tt|d|||;}q|S)a Provides a list of label conversions for each time unit, starting with its most significant units on down. Any counts that evaluate to zero are omitted. For example... :: >>> time_labels(400) ['6m', '40s'] >>> time_labels(3640, True) ['1 hour', '40 seconds'] :param int seconds: number of seconds to be converted :param bool is_long: expands units label :returns: **list** of strings with human readable representations of the time r)rWabsr6rP)rXrT time_labelscount_per_unitr2rrrr[}s r[cCs|dkr td|i}tD]\}}}t||}||;}|||<qd|d|df}|dr?d|d|d|f}|S|drKd |d|f}|S) aQ Provides a time in the following format: [[dd-]hh:]mm:ss :: >>> short_time_label(111) '01:51' >>> short_time_label(544100) '6-07:08:20' :param int seconds: number of seconds to be converted :returns: **str** with the short representation for the time :raises: **ValueError** if the input is negative rz2Input needs to be a non-negative integer, got '%i'z %02i:%02iZminutesecondZdayz %i-%02i:%sZhourz%02i:%s)rHrWintstrip)rX time_compamountr2r:countrrrshort_time_labels  rccCsd\}}}}d|vr|dd\}}|d}t|dkr#|\}}}nt|dkr.|\}}ntd|z!tt|}|t|d7}|t|d 7}|t|d 7}|WStybtd |w) a Provides the number of seconds corresponding to the formatting used for the cputime and etime fields of ps: [[dd-]hh:]mm:ss or mm:ss.ss :: >>> parse_short_time_label('01:51') 111 >>> parse_short_time_label('6-07:08:20') 544100 :param str label: time entry to be parsed :returns: **int** with the number of seconds represented by the label :raises: **ValueError** if input is malformed )0rdrdrdrEr$:rCzDInvalid time format, we expected '[[dd-]hh:]mm:ss' or 'mm:ss.ss': %s<iiQz#Non-numeric value in time entry: %s)r5rrHr^float)r:ZdaysZhoursZminutesrXr`Ztime_sumrrrparse_short_time_labels$          ric Cstj|stdt|zddt|D}Wn ty)td|wt |d|d|d|d|d |d S) a Parses the date and time that in format like like... :: 2012-11-08 16:48:41 :param str entry: timestamp to be parsed :returns: **datetime** for the time represented by the timestamp :raises: **ValueError** if the timestamp is malformed z/parse_timestamp() input must be a str, got a %scSsg|]}t|qSr)r^)r'xrrrr*sz$_parse_timestamp..z9Expected timestamp in format YYYY-MM-DD HH:MM:ss but got rr$rfrCr) r,util_is_strrHtype _timestamp_rematchgroupsAttributeErrordatetime)r;timerrr_parse_timestamps   ,rucCstj|stdt|d|vr|d\}}n|d}}t|dks)|s-tdt|dkrH|ddkrH|ddd |d d}ntd t|}|t j t |d S) a Parses the ISO 8601 standard that provides for timestamps like... :: 2012-11-08T16:48:41.420251 :param str entry: timestamp to be parsed :returns: **datetime** for the time represented by the timestamp :raises: **ValueError** if the timestamp is malformed z3parse_iso_timestamp() input must be a str, got a %srGZ000000z-timestamp's microseconds should be six digits TNr3 zsL      r % (- &3