U Pet=@sNdZdZddlmZmZddlmZddlm Z m Z m Z m Z m Z ddlmZddZd d Zd d ZdddZddZddZddZddZdddZddZdddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0dd1d2d3d4d4d5d6d7d8d9d:d;dd?d?d@dAdBdCdDdDdEdFdGdHdIdJdKdLdMdNdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`d`dadbdcdddededfdgdhdidjdIdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~ddddddddddddddddddddddddddddddddddddddddddZddeDZgZdddZGdddeZ Gddde!Z"dddZ#ddZ$e$ZddZ%Gddde&Z'ddZ(e(Z)dS)a9 Utils ===== The Utils module provides a selection of general utility functions and classes that may be useful for various applications. These include maths, color, algebraic and platform functions. .. versionchanged:: 1.6.0 The OrderedDict class has been removed. Use collections.OrderedDict instead. ) intersection difference strtotupleget_color_from_hexget_hex_from_colorget_random_coloris_color_transparent hex_colormapcolormapboundary deprecatedSafeList interpolate QueryDictplatform escape_markupreifyrgba pi_version)environpath)r)matchsplitsearch MULTILINE IGNORECASE) string_typescCstt|||S)z.Limit a value between a minvalue and maxvalue.)minmax)valueZminvalueZmaxvaluer ./tmp/pip-unpacked-wheel-xzebddm3/kivy/utils.pyr sr csfdd|DS)z#Return the intersection of 2 lists.csg|]}|kr|qSr r .0sset2r r! $sz intersection..r Zset1r&r r%r!r"srcsfdd|DS)z&Return the difference between 2 lists.csg|]}|kr|qSr r r"r%r r!r')szdifference..r r(r r%r!r'sr cCsVt|ttfkr>g}t||D]\}}|t|||q|S|||t|SdS)aInterpolate between two values. This can be useful for smoothing some transitions. For example:: # instead of setting directly self.pos = pos # use interpolate, and you'll have a nicer transition self.pos = interpolate(self.pos, new_pos) .. warning:: These interpolations work only on lists/tuples/doubles with the same dimensions. No test is done to check the dimensions are the same. N)typelisttuplezipappendr float)Z value_fromZvalue_tostepoutxyr r r!r ,s r cCsntd|std|d|dkr.td|d|dkrJtdt|}t|ttfkrjtd |S) zConvert a tuple string into a tuple with some security checks. Designed to be used with the eval() function:: a = (12, 54, 68) b = str(a) # return '(12, 54, 68)' c = strtotuple(b) # return (12, 54, 68) z^[,.0-9 ()\[\]]*$z1Invalid characters in string for tuple conversion()zInvalid count of ( and )[]zInvalid count of [ and ]zConversion failed)r Exceptioncountevalr*r+r,)r$rr r r!rCs rcGst|trt|St|ttfrHdd|D}t|dkrD|d|St|ttfr|dg}| dd|Dt|dkr|d|St dd S) zReturn a Kivy color (4 value from 0-1 range) from either a hex string or a list of 0-255 values. .. versionadded:: 1.10.0 cSsg|] }|dqS)o@r r#r2r r r!r'dszrgba..r<css|]}|dVqdS)r<Nr r=r r r! jszrgba..z+Invalid value (not a string / list / tuple)N) isinstancerrr+r,lenr.intr/extendr8)r$argsr r r!r[s      rcCsL|drt|ddSddtd|D}t|dkrH|d|S) zNTransform a hex string color to a kivy :class:`~kivy.graphics.Color`. #r?NcSs"g|]}|dkrt|ddqS)r<rCr=r r r!r'xsz&get_color_from_hex..z ([0-9a-f]{2})r>?) startswithrrlowerrBr.)r$rr r r!rqs    rcCsdddd|DS)zTransform a kivy :class:`~kivy.graphics.Color` to a hex value:: >>> get_hex_from_color((0, 1, 0)) '#00ff00' >>> get_hex_from_color((.25, .77, .90, .5)) '#3fc4e57f' .. versionadded:: 1.5.0 rFrGcSsg|]}dt|dqS)z{0:02x})formatrCr=r r r!r'sz&get_hex_from_color..)join)colorr r r!rs rrJcCs>ddlm}|dkr(||||gS||||gSdS)zReturns a random color (4 tuple). :Parameters: `alpha`: float, defaults to 1.0 If alpha == 'random', a random alpha value is generated. rrandomrRNrQ)alpharRr r r!rs rcCs(t|dkrdSt|ddkr$dSdS)z&Return True if the alpha channel is 0.Fr>gT)rBr/)cr r r!rs  rz#f0f8ffz#faebd7z#00ffffz#7fffd4z#f0ffffz#f5f5dcz#ffe4c4z#000000z#ffebcdz#0000ffz#8a2be2z#a52a2az#deb887z#5f9ea0z#7fff00z#d2691ez#ff7f50z#6495edz#fff8dcz#dc143cz#00008bz#008b8bz#b8860bz#a9a9a9z#006400z#bdb76bz#8b008bz#556b2fz#ff8c00z#9932ccz#8b0000z#e9967az#8fbc8fz#483d8bz#2f4f4fz#00ced1z#9400d3z#ff1493z#00bfffz#696969z#1e90ffz#b22222z#fffaf0z#228b22z#ff00ffz#dcdcdcz#f8f8ffz#ffd700z#daa520z#808080z#008000z#adff2fz#f0fff0z#ff69b4z#cd5c5cz#4b0082z#fffff0z#f0e68cz#e6e6faz#fff0f5z#7cfc00z#fffacdz#add8e6z#f08080z#e0ffffz#fafad2z#90ee90z#d3d3d3z#ffb6c1z#ffa07az#20b2aaz#87cefaz#778899z#b0c4dez#ffffe0z#00ff00z#32cd32z#faf0e6z#800000z#66cdaaz#0000cdz#ba55d3z#9370dbz#3cb371z#7b68eez#00fa9az#48d1ccz#c71585z#191970z#f5fffaz#ffe4e1z#ffe4b5z#ffdeadz#000080z#fdf5e6z#808000z#6b8e23z#ffa500z#ff4500z#da70d6z#eee8aaz#98fb98z#afeeeez#db7093z#ffefd5z#ffdab9z#cd853fz#ffc0cbz#dda0ddz#b0e0e6z#800080z#ff0000z#bc8f8fz#4169e1z#8b4513z#fa8072z#f4a460z#2e8b57z#fff5eez#a0522dz#c0c0c0z#87ceebz#6a5acdz#708090z#fffafaz#00ff7fz#4682b4z#d2b48cz#008080z#d8bfd8z#ff6347z#40e0d0z#ee82eez#f5deb3z#ffffffz#f5f5f5z#ffff00z#9acd32)Z aliceblueZ antiquewhiteZaquaZ aquamarineZazureZbeigeZbisqueZblackZblanchedalmondZblueZ bluevioletZbrownZ burlywoodZ cadetblueZ chartreuseZ chocolateZcoralZcornflowerblueZcornsilkZcrimsonZcyanZdarkblueZdarkcyanZ darkgoldenrodZdarkgrayZdarkgreyZ darkgreenZ darkkhakiZ darkmagentaZdarkolivegreenZ darkorangeZ darkorchidZdarkredZ darksalmonZ darkseagreenZ darkslateblueZ darkslategrayZ darkslategreyZ darkturquoiseZ darkvioletZdeeppinkZ deepskyblueZdimgrayZdimgreyZ dodgerblueZ firebrickZ floralwhiteZ forestgreenZfuchsiaZ gainsboroZ ghostwhiteZgoldZ goldenrodZgrayZgreyZgreenZ greenyellowZhoneydewZhotpinkZ indianredZindigoZivoryZkhakiZlavenderZ lavenderblushZ lawngreenZ lemonchiffonZ lightblueZ lightcoralZ lightcyanZlightgoldenrodyellowZ lightgreenZ lightgrayZ lightgreyZ lightpinkZ lightsalmonZ lightseagreenZ lightskyblueZlightslategrayZlightslategreyZlightsteelblueZ lightyellowZlimeZ limegreenZlinenZmagentaZmaroonZmediumaquamarineZ mediumblueZ mediumorchidZ mediumpurpleZmediumseagreenZmediumslateblueZmediumspringgreenZmediumturquoiseZmediumvioletredZ midnightblueZ mintcreamZ mistyroseZmoccasinZ navajowhiteZnavyZoldlaceZoliveZ olivedrabZorangeZ orangeredZorchidZ palegoldenrodZ palegreenZ paleturquoiseZ palevioletredZ papayawhipZ peachpuffZperuZpinkZplumZ powderblueZpurpleZredZ rosybrownZ royalblueZ saddlebrownZsalmonZ sandybrownZseagreenZseashellZsiennaZsilverZskyblueZ slateblueZ slategrayZ slategreyZsnowZ springgreenZ steelbluetanZtealZthistleZtomatoZ turquoiseZvioletZwheatZwhiteZ whitesmokeZyellowZ yellowgreencCsi|]\}}|t|qSr )r)r#kvr r r! 9srYNrGcsDddlddl}dkr&|jtdS|fdd}|S)zThis is a decorator which can be used to mark functions as deprecated. It will result in a warning being emitted the first time the function is used.rN)msgcsddd\}}}d|||f}|tkrt|djjjjjd|||f}rld|}d|}ddlm }| |j r| j ||S) Nr?rTz%s:%s:%szLCall to deprecated function %s in %s line %d.Called from %s line %d by %s().z{}: {}z Deprecated: r)Logger) stackDEPRECATED_CALLERSr.__name____code__ co_filenameco_firstlinenorNZ kivy.loggerr[warning__doc__)rEkwargsfilelineZcallerZ caller_idrbr[funcinspectrZr r!new_funcIs,       zdeprecated..new_func)ri functoolspartialr wraps)rhrZrkrjr rgr!r >sr cs:eZdZdZefddZddZed ddZZS) r zzList with a clear() method. .. warning:: Usage of the iterate() function will decrease your performance. cstj||dSN)super__init__)selfrErd __class__r r!rplszSafeList.__init__cCs|dd=dSrnr )rqr r r!clearpszSafeList.clearFcCs|rtt|St|Srn)iterreversed)rqreverser r r!iteratess zSafeList.iterate)F) r^ __module__ __qualname__rcr rprtrx __classcell__r r rrr!r es r cs(eZdZdZfddZddZZS)rzQueryDict is a dict() that can be queried with dot. :: d = QueryDict() # create a key named toto, with the value 1 d.toto = 1 # it's the same as d['toto'] = 1 .. versionadded:: 1.0.4 cs6z ||WStk r0tt||YSXdSrn) __getitem__KeyErrorror __getattr__)rqattrrrr r!r~s zQueryDict.__getattr__cCs|||dSrn) __setitem__)rqrrr r r! __setattr__szQueryDict.__setattr__)r^ryrzrcr~rr{r r rrr!rzs rcCs>t|}d|}dD]$}|dkr0|||fS|d}qdS)aFormat a byte value to a human readable representation (B, KB, MB...). .. versionadded:: 1.0.8 :Parameters: `size`: int Number that represents the bytes value `precision`: int, defaults to 2 Precision after the comma Examples:: >>> format_bytes_to_human(6463) '6.31 KB' >>> format_bytes_to_human(646368746541) '601.98 GB' z %%1.%df %%s)BZKBZMBZGBZTBg@NrI)sizeZ precisionfmtunitr r r!format_bytes_to_humans rcCshtdd}|dkr|Sdtkr$dSdtkr0dStdkriosandroidZ P4A_BOOTSTRAPrZANDROID_ARGUMENT)win32cygwinwindarwinmacosxlinuxZfreebsdunknown)rget _sys_platformrK)Z kivy_buildr r r! _get_platforms    rcCs|ddddddS)aB Escape markup characters found in the text. Intended to be used when markup text is activated on the Label:: untrusted_text = escape_markup('Look at the example [1]') text = '[color=ff0000]' + untrusted_text + '[/color]' w = Label(text=text, markup=True) .. versionadded:: 1.3.0 &z&r6z&bl;r7z&br;)replace)textr r r!rs rc@s eZdZdZddZddZdS)ra  Put the result of a method which uses this (non-data) descriptor decorator in the instance dict after the first call, effectively replacing the decorator with an instance variable. It acts like @property, except that the function is only ever called once; after that, the value is cached as a regular attribute. This gives you lazy attribute creation on objects that are meant to be immutable. Taken from the `Pyramid project `_. To use this as a decorator:: @reify def lazy(self): ... return hard_to_compute_int first_time = self.lazy # lazy is reify obj, reify.__get__() runs second_time = self.lazy # lazy is hard_to_compute_int cCs||_|j|_dSrn)rhrc)rqrhr r r!rpszreify.__init__cCs*|dkr |S||}t||jj||Srn)rhsetattrr^)rqinstclsretvalr r r!__get__s  z reify.__get__N)r^ryrzrcrprr r r r!rsrc CsttdsdStdd}|}W5QRXtd|ttBd}|sFdSt|ddd}|d @rp|d @d ?dSdS) a*Detect the version of the Raspberry Pi by reading the revision field value from '/proc/cpuinfo' See: https://www.raspberrypi.org/documentation/hardware/raspberrypi/revision-codes/README.md Based on: https://github.com/adafruit/Adafruit_Python_GPIO/blob/master/Adafruit_GPIO/Platform.py z /proc/cpuinfoNr;z^Revision\s+:\s+(\w+)$)flagsr?rH)baseii ) risfileopenreadrrrrCgroup)fZcpuinforevisionr r r!_get_pi_versions  r)r))rJ)NrG)r)*rc__all__osrrsysrrrerrrrrZ kivy.compatrr rrr rrrrrrritemsr r]r r+r dictrrrrobjectrrrr r r r!sb      ' "