!hS dZddlZddlZddlmZmZddlmZmZm Z m Z m Z ddl m Z mZmZddlmZddlmZdd lmZdd lmZdd lmZe eeeefeeeeeffZe eefZ e eeeefeeeeeffZ!Gd d Z"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-ddDZ.dej/zZ0edeGd d!ej1Z2d"eed#fd$e"fd%Z3d"ed$e"fd&Z4dKd'e eefd(e eefd)e eefd*e ed$e"f d+Z5dLd"e eefd-ed$efd.Z6d"e deeefd$e efd/Z7dKd0ed1ed2ed3ed*e ed$e"f d4Z8d5ed$efd6Z9id7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXidYdZd[d\d]d^d_d<d`dadbdcdddedfdgdhdidjdgdkdldmdndodpdqdrdsdtdudvdwdxidydzd{d|d}d~dd~ddddddddddddddddddddddddddiddddddddddddddddddddddddddddddddddiddddddddddÓddddƓddȓddʓdd̓ddΓddΓddѓddӓddՓddדddٓiddddܓddޓddddddddddddddddddddddddddddiddddddddddddddd d d d d dddddddddddddddidddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d6d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdI Z:dJe:;DZr4Ds$<<->-@-@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_255r1s r z Color.as_hex..s:::a,q//:::r Nc3K|]}|dV dS)02xNr+r2vs r zColor.as_hex..s&44A444444r c3(K|] }|tvVdSr) repeat_colorsr1s rrgzColor.as_hex..s'22aqM!222222r c3(K|] }|V dSrr+)r2r3rWs rrgzColor.as_hex..s'II1VAYIIIIIIr rr-#)r:rappendr_joinallrangelen)rvaluesrWs @rrWz 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:rr_rrrround _alpha_floatrOs ras_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^r1s rrgz%Color.as_rgb_tuple..s(;;q<??;;;;;;r Nra)r:rrv)rrrrrs rrTzColor.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.NFrxzhsl(hz0.0frsz0.0%rtTr-)r:r as_hsl_tupleru)rhslias ras_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:rrrrrv)rrr~lrs rr}zColor.as_hsl_tuples"TZ\4:<FF1a =z'!Qw!Q 1 1 3 333  aD--/// /a7Nr c6|jjdn |jjS)Nr)r:rrOs rrvzColor._alpha_floatsJ$,qq$*2BBr sourcecZtj|jtjS)N) serialization)r "with_info_plain_validator_function _validateto_string_ser_schema)rKrrDs r__get_pydantic_core_schema__z"Color.__get_pydantic_core_schema__s.= M)I)K)K    r _Color__input_value_c||Srr+)rKrrs rrzColor._validatess=!!!r c.|dS)NTrQ)r[rOs r__str__z Color.__str__s}}d}+++r _repr.ReprArgscdd|dfgd|fgzS)NTrQrY)r[rTrOs r __repr_args__zColor.__repr_args__s7t}}d}3345%ARARATAT9U8VVVr otherct|to)||kSr)r>r8rT)rrs r__eq__z Color.__eq__s4%''WD,=,=,?,?5CUCUCWCW,WWr cDt|Sr)hashrTrOs r__hash__zColor.__hash__sD%%''(((r )r"r)%r%r&r'r(r) ColorTyper classmethodr r _GetJsonSchemaHandlerrrMrPboolrBr[rWrwr ColorTuplerTr HslColorTupler}r*rvrHrrrrrrrr0rr+r rr8r8Hs $IiD$%0;P [),1!!!D!S!!!!4$7;Xd^z4NNNNN7;Xd^}:CeCCCC #Y )13%2C)D     [ "c"c"g"""[",,,,,WWWWXCXDXXXX)#))))))r r8r;.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. rac34K|]}t|VdSrparse_color_valueres rrgzparse_tuple..s+77A$Q''777777r Nc34K|]}t|VdSrrres rrgzparse_tuple..s+;;A$Q'';;;;;;r r=z:value is not a valid color: tuples must have length 3 or 4)rprparse_float_alphar )r;rrrs rrArAs 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-r.Nr/res rrgzparse_str..7s.//a3q1ub>>//////r r-r.c36K|]}t|dVdS)r.Nr/res rrgzparse_str..As*++!3q"::++++++r r=zBvalue is not a valid color: string not recognised as a valid color)lowerCOLORS_BY_NAME ints_to_rgbarVre fullmatch r_hex_shortgroupsr0 r_hex_longr_rgbr_rgb_v4_styler_hslr_hsl_v4_style parse_hslr ) r; value_lowerrrrmrYrrs rrCrCs(++--K+ -1aAq!T***      [+..A,((**a//3///1a  %(Q^^c%9EEEAq!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 rrrSs= !!$$&7&:&:value is not a valid color: alpha values must be a valid floatrrzDvalue is not a valid color: alpha values must be in the range 0 to 1)r>rBendswithr*rXr mathisclose)r;rs rrr}s }ts eS ! ! !ennS&9&9 !%*%%+EE%LLE sss!-1qrrrs |E1yt eq !-1wxxxs AAA6r~h_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) r~rrrrs_valuel_valueh_valuerrrs rrrs)c224EeS4Q4QWGAhhG-C-#% E  D.4'A+'733GAq! 1a*511 2 22r r3c@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)r0ru)r3s rr_r_s 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)"r: floralwhite)rrr forestgreen)r:rr:fuchsia)rrr gainsboro)rrr ghostwhite)rrrgold)rrr goldenrod)r gray)rErEgreen)rrEr greenyellow)rrgreyhoneydew)rrrhotpink)rr indianred)r\rNindigo)Krivory)rrrkhaki)rrlavender)rTrTr lavenderblush)rrr lawngreen)|r lemonchiffon)rrr lightblue)rHrT lightcoral)rrErE lightcyan)rrlightgoldenrodyellow)rrr lightgray)r/r/r/ lightgreen)r7r7 lightgrey lightpink)r lightsalmon)rrr  lightseagreen)rCr9 lightskyblue)rr+rlightslategray)wrlightslategreylightsteelblue)rr lightyellow)rrr_lime)rrr limegreen)rrrlinen)rrrTmagentamaroon)rErrmediumaquamarine)frrj mediumblue)rrr mediumorchid)rr/ mediumpurple)r1pmediumseagreen)rqmediumslateblue){hrcmediumspringgreen)rrmediumturquoise)r%r,rmediumvioletred) midnightblue)rr~ mintcream)rrr mistyrose)rrmoccasin)rr navajowhite)rrrHnavy)rrrEoldlace)rrTolive)rErEr olivedrab)r#orange)rrr orangered)rErorchid)rBr~ palegoldenrod)rcrj palegreen)r paleturquoise)rcrc palevioletred)rr~r1 papayawhip)r peachpuff)rrBperu)rr?pink)rplum)rr powderblue)rqr_rTpurple)rErrEred)rrr rosybrown)r#r"r" royalblue)Arr saddlebrown)rrsalmon)rrEr sandybrown)`seagreen).rWseashell)rrrcsienna)rR-silver)rrrskyblue)rr+r slateblue)jZr slategray)r~rEr7 slategreysnow)rrr springgreen)rrr steelblue)FrQrL)rrLr)rrErE)r\r3r\)rcG)@r_)rcrQrc)rrr)rrr)rrr)rrr)rrr) tantealthistletomato turquoisevioletwheatwhite whitesmokeyellow yellowgreenci|]\}}|| Sr+r+)r2krfs r r\s;;;DAq1a;;;r r)r)=r(rrcolorsysrrtypingrrrrr pydantic_corer r r typing_extensionsr _internalr#_internal._schema_generation_sharedrr json_schemarwarningsrr?r0r*rrBrrr_r_255_r_comma_r_alpha_r_h_r_slrrrrrrripirRepresentationr8rArCrrrrr_ritemsrUr+r rrs    ++++++++77777777777777FFFFFFFFFF((((((^^^^^^((((((////// 5c3'sCe/C)DD E *c/ " eE5%/0%ueU8R2SST !!!!!!!!$   +2I T fff6f8fVfffRZfffbbxbbb%bbHbhbbb^&^^V^^^^(^^^Z$ZZ5ZZUZZhZZZ=<);<<< 47{ L & r)r)r)r)r)E r)r)  r)jouS#Xo4oooo,8sS8sT8s8s8s8sv l lE#s(O lc3h lE#s(O lT\]bTc los l l l l  U38_ s U    6yU4eS#89yhuoyyyy<333s33S3%3\`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