o TjS @sdZddlZddlZddlmZmZddlmZmZm Z m Z m Z ddl m Z mZmZddlmZddlmZdd lmZdd lmZdd lmZe eeeefeeeeeffZe eefZ e eeeefeeeeeffZ!Gd d 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-dddDZ.dej/Z0eded Gd!d"d"ej1Z2d#eed$fd%e"fd&d'Z3d#ed%e"fd(d)Z4dTd*e eefd+e eefd,e eefd-e ed%e"f d.d/Z5dUd#e eefd1ed%efd2d3Z6d#e deeefd%e efd4d5Z7dTd6ed7ed8ed9ed-e ed%e"f d:d;Z8dZ9id?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`idadbdcdddedfdgdDdhdidjdkdldmdndodpdqdrdodsdtdudvdwdxdydzd{d|d}d~ddiddddddddddddddddddddddddddddddddddiddddddddddddddddddddddddddddddddddiddÓddœddǓddɓdd˓ddɓddΓddГddғddԓdd֓dd֓ddٓddۓddݓddߓddiddddddddddddddddddddddddddddddddddiddddddd d d d d ddddddddddddddddddd d!d"d#d$id%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d>d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQ Z:dRdSe:;DZDsr.0123456789abcdefr'zThe `Color` class is deprecated, use `pydantic_extra_types` instead. See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.)categoryc@sTeZdZdZdZdeddfddZedej d e de fd d Z defd d Z dddedefddZdefddZdefddZdddeedefddZdefddZdddeedefddZdefdd Zed!eed eege fdej fd"d#Zed$ed%eddfd&d'Zdefd(d)Z d2d+d,Z!d-edefd.d/Z"de#fd0d1Z$dS)3ColorzRepresents a color.) _original_rgbavaluerNcCsf||t|ttfrt||_nt|trt||_nt|tr)|j|_|j}nt dd||_dS)N color_errorzAvalue is not a valid color: value must be a tuple, list or string) isinstancetuplelist parse_tupler3str parse_strr1r2r )rr4rrrrRs     zColor.__init__r handlercCsi}|jddd|S)Nstringcolor)typeformat)update)clsr r< field_schemarrr__get_pydantic_json_schema__dsz"Color.__get_pydantic_json_schema__cCs|jS)z!Original value passed to `Color`.)r2rrrroriginallszColor.originalFfallbackrHc Csr|jjdur5tttttf|}zt|WSty4}z|r+|WYd}~St d|d}~ww|S)a<Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary, otherwise returns the hexadecimal representation of the color or raises `ValueError`. Args: fallback: If True, falls back to returning the hexadecimal representation of the color instead of raising a ValueError when no named color is found. Returns: The name of the color, or the hexadecimal representation of the color. Raises: ValueError: When no named color is found and fallback is `False`. Nz=no named color found, use fallback=True, as_hex() or as_rgb()) r3rrr7r* as_rgb_tupleCOLORS_BY_VALUEKeyErroras_hex ValueError)rrHrgberrras_namedps   zColor.as_namedcsdd|jddD}|jjdur|t|jjddd|Dtdd|Dr@dfd dtd td Dd S) 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. cSsg|]}t|qSr float_to_255r+rrr sz Color.as_hex..Ncss|]}|dVqdS)02xNrr,vrrr zColor.as_hex..css|]}|tvVqdSr) repeat_colorsr+rrrrYrZc3s|]}|VqdSrrr+rLrrrYrZrr'#)r3rappendrRjoinallrangelen)rvaluesrr\rrLs $z Color.as_hexc Cs||jjdurdt|jjdt|jjdt|jjdSdt|jjdt|jjdt|jjdt|dd S)zFColor as an `rgb(, , )` or `rgba(, , , )` string.Nzrgb(, )zrgba(r')r3rrRrrrround _alpha_floatrErrras_rgbs 0, z Color.as_rgbrrcCsjdd|jddD\}}}|dur&|jjdur|||fS||||fS|r0||||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. cs|]}t|VqdSrrQr+rrrrYrZz%Color.as_rgb_tuple..NrT)r3rrg)rrrrrrrrrIs   zColor.as_rgb_tuplec Cs|jjdur |jdd\}}}d|ddd|dd|dd S|jd d\}}}}d|ddd|dd|ddt|d d S) zEColor as an `hsl(, , )` or `hsl(, , , )` string.NFrizhsl(hz0.0frdz0.0%reTr')r3r as_hsl_tuplerf)rhsliarrras_hsls ".z Color.as_hslcCsjt|jj|jj|jj\}}}|dur&|jjdur|||fS||||fS|r0||||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`. N)rr3rrrrrg)rrrmlrnrrrrls   zColor.as_hsl_tuplecCs|jjdurdS|jjS)Nr )r3rrErrrrgszColor._alpha_floatsourcecCstj|jtdS)N) serialization)r "with_info_plain_validator_function _validateto_string_ser_schema)rBrsr<rrr__get_pydantic_core_schema__s z"Color.__get_pydantic_core_schema___Color__input_value_cCs||Srr)rBryrzrrrrvszColor._validatecCs |jddS)NTrG)rPrErrr__str__ z Color.__str___repr.ReprArgscCs d|jddfgd|fgS)NTrGrN)rPrIrErrr __repr_args__s zColor.__repr_args__othercCst|to ||kSr)r6r1rI)rrrrr__eq__sz Color.__eq__cCs t|Sr)hashrIrErrr__hash__r|zColor.__hash__)rr})%r!r"r#r$r% ColorTyper classmethodr r _GetJsonSchemaHandlerrrDrFboolr:rPrLrhr ColorTuplerIrq HslColorTuplerlr&rgr?rrrxrvr{r~rr*rrrrrr1HsD      r1r4.rcCsvt|dkrdd|D\}}}t|||dSt|dkr6dd|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. rTcsrjrparse_color_valuerWrrrrYrZzparse_tuple..NcsrjrrrWrrrrYrZr5z:value is not a valid color: tuples must have length 3 or 4)rbrparse_float_alphar )r4rrrrrrr9s   r9c CsJ|}z t|\}}}Wn tyYnwt|||dStt|}|rL|^}}dd|D\}}}|rCt|ddd}nd}t||||Stt |}|rx|^}}dd|D\}}}|rot|dd}nd}t||||Stt |ptt |}|rt|Stt |ptt |}|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. Ncss|] }t|ddVqdS)r'r(Nr)rWrrrrY7szparse_str..r'r(css|]}t|dVqdS)r(Nr)rWrrrrYAsr5zBvalue is not a valid color: string not recognised as a valid color)lowerCOLORS_BY_NAMErK ints_to_rgbare fullmatch r_hex_shortgroupsr* r_hex_longr_rgbr_rgb_v4_styler_hslr_hsl_v4_style parse_hslr ) r4 value_lowerrrrmrNrprrrrr;s<      r;rrrrcCstt|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)rrrrrrrrSs rrmax_valcCsRzt|}Wn tytddwd|kr |kr!||Stddd|i)a8Parse the color value provided and return a number between 0 and 1. Args: value: An integer or string color value. max_val: Maximum range value. Defaults to 255. Raises: PydanticCustomError: If the value is not a valid color. Returns: A number between 0 and 1. r5z?value is not a valid color: color values must be a valid numberrzLvalue is not a valid color: color values must be in the range 0 to {max_val}r)r&rMr )r4rr>rrrrbs   rcCs|durdSzt|tr|drt|ddd}nt|}Wn ty-tddwt|dr6dSd|krAdkrB|Stdd ) aZParse an alpha value checking it's a valid float in the range 0 to 1. Args: value: The input value to parse. Returns: The parsed value as a float, or `None` if the value was None or equal 1. Raises: PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range. N%dr5z>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)r6r:endswithr&rMr mathisclose)r4rrrrr}s      rrmh_unitssatlightc Csvt|dt|d}}t|}|dvr|dd}n|dkr%|tt}n|d}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>Ndegrkradr )rr&radsrrr) rmrrrrs_valuel_valueh_valuerrrrrrrs rr-cCstt|dS)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)r*rf)r-rrrrRs rR 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)rr 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)rrrfuchsia)rrr gainsboro)rrr ghostwhite)rrrgold)rrr goldenrod)r gray)r"r"green)rr"r greenyellow)rrgreyhoneydew)rrrhotpink)rr indianred)r\r+indigo)Krivory)rrrkhaki)rrlavender)r1r1r lavenderblush)rrr lawngreen)|r lemonchiffon)rrr lightblue)r%r1 lightcoral)rr"r" lightcyan)rrlightgoldenrodyellow)rrr lightgray)r r r  lightgreen)rr lightgrey lightpink)r lightsalmon)rrr lightseagreen)r r lightskyblue)rrrlightslategray)wrlightslategreylightsteelblue)rr lightyellow)rrr<lime)rrr limegreen)rrrlinen)rrr1magentamaroon)r"rrmediumaquamarine)frrG mediumblue)rrr mediumorchid)rr  mediumpurple)rpmediumseagreen)rqmediumslateblue){hr@mediumspringgreen)rrmediumturquoise)rr rmediumvioletred) midnightblue)rkr[ mintcream)rrr mistyrose)rrmoccasin)rr navajowhite)rrr%navy)rrr"oldlace)rr1olive)r"r"r olivedrab)r#orange)rrr orangered)rErorchid)rr[ palegoldenrod)r@rG palegreen)r paleturquoise)r@r@ palevioletred)r\r[r papayawhip)r peachpuff)rrperu)rri?pink)rplum)rr powderblue)rNr<r1purple)r"rr"red)rrr rosybrown)rrr royalblue)Arrn saddlebrown)rr{salmon)rr"r sandybrown)`seagreen).rWseashell)rrr@sienna)rR-silver)rrrskyblue)rrr slateblue)jZr slategray)r[r"r slategreysnow)rrr springgreen)rrr steelblue)Fr.r))rr)r)rr"r")r9rr9)rcG)@r<)r@r.r@)rrr^)rrr)rrr)rrr)rdrr) tantealthistletomato turquoisevioletwheatwhite whitesmokeyellow yellowgreencCsi|]\}}||qSrr)r,krXrrr \srr)r)=r$rrcolorsysrrtypingrrrrr pydantic_corer r r typing_extensionsr _internalr#_internal._schema_generation_sharedrr json_schemarwarningsrr7r*r&rr:rrr_r_255_r_comma_r_alpha_r_h_r_slrrrrrrr[pirRepresentationr1r9r;rrrrrRritemsrJrrrrs     " "&& 6>;""*      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~