jS UdZddlZddlZddlmZddlmZmZddlm Z m Z m Z ddl m Z mZmZddlmZdd lmZdd lmZdd lmZdd lmZeeeefeeeeefzZe ed <ee zZ!e ed<eeeefeeeeefzZ"e ed<GddZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*de$e%e$e%e$de%e&d Z+de'e%e(e%e(de%e&d Z,de$de$de$de&d Z-de'de(de(de&d Z.dd DZ/d!ej0zZ1ed"e#Gd$d%ej2Z3d&ee d'fd(e#fd)Z4d&e d(e#fd*Z5dOd+ee zd,ee zd-ee zd.edzd(e#f d/Z6dPd&ee zd1ed(efd2Z7d&de zezezd(edzfd3Z8dOd4e d5e d6e d7e d.edzd(e#f d8Z9d9ed(efd:Z:id;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\id]d^d_d`dadbdcd@dddedfdgdhdidjdkdldmdndkdodpdqdrdsdtdudvdwdxdydzd{d|id}d~ddddddddddddddddddddddddddddddddiddddddddddddddddddddddddddddddddddiddddddÓddœddǓddœddʓdd̓ddΓddГddғddғddՓddדddٓddۓddݓiddddddddddddddddddddddddddddddddddiddddddddddd d d d d ddddddddddddddddddd id!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d:d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdM Z;dNe;<DZ=dS(QaZColor definitions are used as per the CSS3 [CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification. A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`. In these cases the _last_ color when sorted alphabetically takes preferences, eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua". Warning: Deprecated The `Color` class is deprecated, use `pydantic_extra_types` instead. See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md) for more information. N)Callable) hls_to_rgb rgb_to_hls)Any TypeAliascast) CoreSchemaPydanticCustomError core_schema) deprecated)_repr)GetJsonSchemaHandler)JsonSchemaValue)PydanticDeprecatedSince20 ColorTuple ColorType HslColorTuplec DeZdZdZdZdededededzfdZd ed efd ZdS) RGBAz1Internal use only as a representation of a color.rgbalpha_tuplerrrrNcT||_||_||_||_||||f|_dSNr)selfrrrrs >C:\Projects\Muse2API\.venv\Lib\site-packages\pydantic/color.py__init__z RGBA.__init__'s2 ABAq%@P itemreturnc|j|Sr)r)rr#s r __getitem__zRGBA.__getitem__/s{4  r") __name__ __module__ __qualname____doc__ __slots__floatr!rr&r"r rr"s};;0IQ%QEQeQEDLQQQQ!!!!!!!!r"rz(\d{1,3}(?:\.\d+)?)z\s*,\s*z(\d(?:\.\d+)?|\.\d+|\d{1,2}%)z((-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?z(\d{1,3}(?:\.\d+)?)%z8\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*zD\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*z \s*rgba?\(\s*z(?:z )?\s*\)\s*z \s*hsla?\(\s*z\s+z (?:\s*/\s*c4h|]}t|dzdS)int.0cs r r6Es$<<->-@-@AAC m&s++ m m mm;;==(((((($%deekll  m ;;== s$ A B$B9B?BBc d|jddD}|jj,|t|jjdd|Dt d|Dr=dfdt dtd Dd zS) aSReturns the hexadecimal representation of the color. Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string a "short" representation of the color is possible and whether there's an alpha channel. Returns: The hexadecimal representation of the color. c,g|]}t|Sr- float_to_255r3s r z Color.as_hex..s:::a,q//:::r"Nc3K|]}|dV dS)02xNr-r4vs r zColor.as_hex..s&44A444444r"c3(K|] }|tvVdSr) repeat_colorsr3s r rizColor.as_hex..s'22aqM!222222r"c3(K|] }|V dSrr-)r4r5rYs r rizColor.as_hex..s'II1VAYIIIIIIr"rr/#)r<rappendrajoinallrangelen)rvaluesrYs @r rYz Color.as_hexs;:4:bqb>::: :  ' MM,tz'788 9 9 944V44444 226222 2 2 JWWIIIIaVa0H0HIIIIIFV|r"c |jjQdt|jjdt|jjdt|jjdSdt|jjdt|jjdt|jjdt |dd S)zFColor as an `rgb(, , )` or `rgba(, , , )` string.Nzrgb(, )zrgba(r/)r<rrarrrround _alpha_floatrQs r as_rgbz Color.as_rgbs :  #s,tz|44ss TZ\8R8RssVbcgcmcoVpVpsss s4 TZ\2244l4:<6P6P44T`aeakamTnTn44**,,a00444 r"rrcd|jddD\}}}|)|jj|||fS||||fS|r||||fS|||fS)aReturns the color as an RGB or RGBA tuple. Args: alpha: Whether to include the alpha channel. There are three options for this input: - `None` (default): Include alpha only if it's set. (e.g. not `None`) - `True`: Always include alpha. - `False`: Always omit alpha. Returns: A tuple that contains the values of the red, green, and blue channels in the range 0 to 255. If alpha is included, it is in the range 0 to 1. c34K|]}t|VdSrr`r3s r riz%Color.as_rgb_tuple..s(;;q<??;;;;;;r"Nrc)r<rrx)rrrrrs r rVzColor.as_rgb_tuples<;DJrrN;;;1a =z'!Qw!Q 1 1 3 333  aD--/// /a7Nr"c |jj,|d\}}}d|dzdd|dd|dd S|d \}}}}d|dzdd|dd|ddt|d d S) zEColor as an `hsl(, , )` or `hsl(, , , )` string.NFrzzhsl(hz0.0fruz0.0%rvTr/)r<r as_hsl_tuplerw)rhslias r as_hslz Color.as_hsls :  #((u(55HAq">!c'>>>!>>>B>>>> >++$+77KAq"aM!c'MMM!MMMBMMMuQ{{MMM Mr"ct|jj|jj|jj\}}}|)|jj|||fS||||fS|r||||fS|||fS)aSReturns the color as an HSL or HSLA tuple. Args: alpha: Whether to include the alpha channel. - `None` (default): Include the alpha channel only if it's set (e.g. not `None`). - `True`: Always include alpha. - `False`: Always omit alpha. Returns: The color as a tuple of hue, saturation, lightness, and alpha (if included). All elements are in the range 0 to 1. Note: This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`. )rr<rrrrrx)rrrlrs r rzColor.as_hsl_tuples"TZ\4:<FF1a =z'!Qw!Q 1 1 3 333  aD--/// /a7Nr"c6|jjdn |jjS)Nr )r<rrQs r rxzColor._alpha_floatsJ$,qq$*2BBr"sourcecZtj|jtjS)N) serialization)r "with_info_plain_validator_function _validateto_string_ser_schema)rMrrFs r __get_pydantic_core_schema__z"Color.__get_pydantic_core_schema__s.= M)I)K)K    r"_Color__input_value_c||Srr-)rMrrs r rzColor._validatess=!!!r"c.|dS)NTrS)r]rQs r __str__z Color.__str__s}}d}+++r"_repr.ReprArgscdd|dfgd|fgzS)NTrSr[)r]rVrQs r __repr_args__zColor.__repr_args__s7t}}d}3345%ARARATAT9U8VVVr"otherct|to)||kSr)r@r:rV)rrs r __eq__z Color.__eq__s4%''WD,=,=,?,?5CUCUCWCW,WWr"cDt|Sr)hashrVrQs r __hash__zColor.__hash__sD%%''(((r")r$r)$r'r(r)r*r+rr! classmethodr r _GetJsonSchemaHandlerrrOrRboolrDr]rYryrrVrrrr,rxrJrrrrrrrr2rr-r"r r:r:Is $IiD$%0;P [),1!!!D!S!!!!4$48TD[J4NNNNN48TD[M:CeCCCC #Y )13%2C)D     [ "c"c"g"""[",,,,,WWWWXCXDXXXX)#))))))r"r:r=.r$c ,t|dkr"d|D\}}}t|||dSt|dkr=d|ddD\}}}t|||t|dStdd)zParse a tuple or list to get RGBA values. Args: value: A tuple or list. Returns: An `RGBA` tuple parsed from the input tuple. Raises: PydanticCustomError: If tuple is not valid. rcc34K|]}t|VdSrparse_color_valuergs r rizparse_tuple..s+77A$Q''777777r"Nc34K|]}t|VdSrrrgs r rizparse_tuple..s+;;A$Q'';;;;;;r"r?z:value is not a valid color: tuples must have length 3 or 4)rrrparse_float_alphar )r=rrrs r rCrCs 5zzQ777771aAq!T""" Uq;;rr;;;1aAq!.uQx88999!-1mnnnr"c|} t|\}}}t|||dS#t$rYnwxYwt jt |}|rT|^}}d|D\}}}|rt|dzddz }nd}t||||St jt|}|rQ|^}}d|D\}}}|rt|ddz }nd}t||||St jt|pt jt|}|rt|St jt|pt jt|}|rt|Stdd) a8Parse a string representing a color to an RGBA tuple. Possible formats for the input string include: * named color, see `COLORS_BY_NAME` * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) * `rgb(, , )` * `rgba(, , , )` Args: value: A string representing a color. Returns: An `RGBA` tuple parsed from the input string. Raises: ValueError: If the input string cannot be parsed to an RGBA tuple. Nc3<K|]}t|dzdVdS)r/r0Nr1rgs r rizparse_str..8s.//a3q1ub>>//////r"r/r0c36K|]}t|dVdS)r0Nr1rgs r rizparse_str..Bs*++!3q"::++++++r"r?zBvalue is not a valid color: string not recognised as a valid color)lowerCOLORS_BY_NAME ints_to_rgbarXre fullmatch r_hex_shortgroupsr2 r_hex_longr_rgbr_rgb_v4_styler_hslr_hsl_v4_style parse_hslr ) r= value_lowerrrrmr[rrs r rErEs(++--K+ -1aAq!T***      [+..A,((**a//3///1a  "%a!eR..3"6EEEAq!U+++ Z--A,((**a++s+++1a  2JJ$EEEAq!U+++ UK((UBL,U,UA)QXXZZ(( UK((UBL,U,UA&!((**%% m-q r rrs9 AArrrrctt|t|t|t|S)aConverts integer or string values for RGB color and an optional alpha value to an `RGBA` object. Args: r: An integer or string representing the red color value. g: An integer or string representing the green color value. b: An integer or string representing the blue color value. alpha: A float representing the alpha value. Defaults to None. Returns: An instance of the `RGBA` class with the corresponding color and alpha values. )rrr)rrrrs r rrTs= !!$$&7&:&:value is not a valid color: alpha values must be a valid floatr rzDvalue is not a valid color: alpha values must be in the range 0 to 1)r@rDendswithr,rZr mathisclose)r=rs r rr~s }ts eS ! ! !ennS&9&9 !%*%%+EE%LLE sss!-1qrrrs |E1yt eq !-1wxxxs AAA6rh_unitssatlightct|dt|d}}t|}|dvr |dzdz }n|dkr|tztz }n|dz}t|||\}} } t || | t |S)a.Parse raw hue, saturation, lightness, and alpha values and convert to RGBA. Args: h: The hue value. h_units: The unit for hue value. sat: The saturation value. light: The lightness value. alpha: Alpha value. Returns: An instance of `RGBA`. r>Ndegr~radr )rr,radsrrr) rrrrrs_valuel_valueh_valuerrrs r rrs)c224EeS4Q4QWGAhhG-C-#% E  D.4'A+'733GAq! 1a*511 2 22r"r5c@tt|dzS)aConverts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive). Args: c: The float value to be converted. Must be between 0 and 1 (inclusive). Returns: The integer equivalent of the given float value rounded to the nearest whole number. Raises: ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive). r)r2rw)r5s r raras uQW~~  r" aliceblue)r antiquewhite)aqua)rrr aquamarine)razure)rrrbeige)rbisque)rblack)rrrblanchedalmond)rrblue)rrr blueviolet)+brown)*r burlywood) cadetblue)_ chartreuse)rrr chocolate)icoral)rrPcornflowerblue)rcornsilk)rrrcrimson)r<cyandarkblue)rrdarkcyan)rrr darkgoldenrod)r darkgray)r r  darkgreen)rrrdarkgrey darkkhaki)k darkmagenta)rrrdarkolivegreen)Ur/ darkorange)rr darkorchid)2darkred)rrr darksalmon)z darkseagreen)r! darkslateblue)H=r darkslategray)rOr' darkslategrey darkturquoise)r darkviolet)rdeeppink)rr deepskyblue)rrdimgray)rrrdimgrey dodgerblue)rr firebrick)"r9 floralwhite)rrr forestgreen)r9rr9fuchsia)rrr gainsboro)rrr ghostwhite)rrrgold)rrr goldenrod)r gray)rDrDgreen)rrDr greenyellow)rrgreyhoneydew)rrrhotpink)rr indianred)r\rMindigo)Krivory)rrrkhaki)rrlavender)rSrSr lavenderblush)rrr lawngreen)|r lemonchiffon)rrr lightblue)rGrS lightcoral)rrDrD lightcyan)rrlightgoldenrodyellow)rrr lightgray)r.r.r. lightgreen)r6r6 lightgrey lightpink)r lightsalmon)rrr lightseagreen)rBr8 lightskyblue)rr*rlightslategray)wrlightslategreylightsteelblue)rr lightyellow)rrr^lime)rrr limegreen)rrrlinen)rrrSmagentamaroon)rDrrmediumaquamarine)frri mediumblue)rrr mediumorchid)rr. mediumpurple)r0pmediumseagreen)rqmediumslateblue){hrbmediumspringgreen)rrmediumturquoise)r$r+rmediumvioletred) midnightblue)rr} mintcream)rrr mistyrose)rrmoccasin)rr navajowhite)rrrGnavy)rrrDoldlace)rrSolive)rDrDr olivedrab)r#orange)rrr orangered)rErorchid)rAr} palegoldenrod)rbri palegreen)r paleturquoise)rbrb palevioletred)r~r}r0 papayawhip)r peachpuff)rrAperu)rr?pink)rplum)rr powderblue)rpr^rSpurple)rDrrDred)rrr rosybrown)r"r!r! royalblue)Arr saddlebrown)rrsalmon)rrDr sandybrown)`seagreen).rWseashell)rrrbsienna)rR-silver)rrrskyblue)rr*r slateblue)jZr slategray)r}rDr6 slategreysnow)rrr springgreen)rrr steelblue)FrPrK)rrKr)rrDrD)r[r2r[)rcG)@r^)rbrPrb)rrr)rrr)rrr)rrr)rrr) tantealthistletomato turquoisevioletwheatwhite whitesmokeyellow yellowgreenci|]\}}|| Sr-r-)r4krhs r r]s;;;DAq1a;;;r"r)r)>r*rrcollections.abcrcolorsysrrtypingrrr pydantic_corer r r typing_extensionsr _internalr#_internal._schema_generation_sharedrr json_schemarwarningsrrAr2r,r__annotations__rDrrr_r_255_r_comma_r_alpha_r_h_r_slrrrrrrrkpirRepresentationr:rCrErrrrraritemsrWr-r"r rs     $$$$$$++++++++''''''''''FFFFFFFFFF((((((^^^^^^((((((//////c3m,uS#sE5I/JJ IJJJ!C' 9''' u!45eUESX>X8YY yYYY!!!!!!!!$   +2I T fff6f8fVfffRZfffbbxbbb%bbHbhbbb^&^^V^^^^(^^^Z$ZZ5ZZUZZhZZZ=<);<<< 47{ l & r)r)r)r)r)E r)r)  r)jouS#Xo4oooo,8sS8sT8s8s8s8sv l lC#I l#) lc l%$, lZ^ l l l l  S3Y  u    6yTCZ%/#5y%$,yyyy<333s33S33Y]33338 E c    TTOT MT/ T  _ T  _ T oT YToT KT.T ]TTT-T !T" ^#TT$o%T&'T(})T* M+T, -T. /T0^1T23T45T67T89T:=;T<m=T>-?T@.ATB{CTD/ETTTFOGTH]ITJ\KTL\MTN]OTP-QTRSTT=UTVWTXYTZ.[T\]T^?_T`=aTb}cTdeTf/gTTTh MiTjkTl OmTn [oTp>qTr OsTtuTvwTxyTz l{T| _}T~ _T@ATB_CTDETFOGTHITTTJ/KTLMTNOOTPQTR/STTUTVWTX?YTZ^[T\O]T^o_T`oaTbocTd?eTf KgThiTj _kTTTl}mTn koTpqTr+sTtNuTvOwTxnyTz{T|}T~~T@~ATBMCTDETFGTHITJ?KTL KMTTTNOTP ]QTRSTT mUTVWTX oYTZ_[T\]T^__T`_aTb/cTdeTf NgTh OiTj OkTl/mTn moTTTp ;qTrsTtuTv=wTx oyTz.{T| }T~T@ mATB oCTDETFGTHITJKTL OMTN=OTPQTTR    !!gTTTl<;N$8$8$:$:;;;r"