o iS @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.Z0123456789abcdefr'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_tupler2str parse_strr0r1r )rr3rrrrRs     zColor.__init__r handlercCsi}|jddd|S)Nstringcolor)typeformat)update)clsr r;Z field_schemarrr__get_pydantic_json_schema__dsz"Color.__get_pydantic_json_schema__cCs|jS)z!Original value passed to `Color`.)r1rrrroriginallszColor.originalFfallbackrFc 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()) r2rrr6r* as_rgb_tupleCOLORS_BY_VALUEKeyErroras_hex ValueError)rrFrgberrras_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+rrrrWrXc3s|]}|VqdSrrr+rJrrrWrXrr'#)r2rappendrPjoinallrangelen)rvaluesrrZrrJs $z Color.as_hexc Cs||jjdurdt|jjdt|jjdt|jjdSdt|jjdt|jjdt|jjdt|dd S)zFColor as an `rgb(, , )` or `rgba(, , , )` string.Nzrgb(, )zrgba(r')r2rrPrrrround _alpha_floatrCrrras_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|VqdSrrOr+rrrrWrXz%Color.as_rgb_tuple..NrR)r2rre)rrrrrrrrrGs   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.NFrgzhsl(hz0.0frbz0.0%rcTr')r2r as_hsl_tuplerd)rhsZliarrras_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)rr2rrrrre)rrrklrlrrrrjs   zColor.as_hsl_tuplecCs|jjdurdS|jjS)Nr )r2rrCrrrreszColor._alpha_floatsourcecCstj|jtdS)N)Z serialization)r Z"with_info_plain_validator_function _validateZto_string_ser_schema)rArpr;rrr__get_pydantic_core_schema__s z"Color.__get_pydantic_core_schema___Color__input_value_cCs||Srr)rArsrtrrrrqszColor._validatecCs |jddS)NTrE)rNrCrrr__str__ z Color.__str___repr.ReprArgscCs d|jddfgd|fgS)NTrErL)rNrGrCrrr __repr_args__s zColor.__repr_args__othercCst|to ||kSr)r5r0rG)rryrrr__eq__sz Color.__eq__cCs t|Sr)hashrGrCrrr__hash__rvzColor.__hash__)rrw)%r!r"r#r$r% ColorTyper classmethodr r _GetJsonSchemaHandlerrrBrDboolr9rNrJrfr ColorTuplerGrn HslColorTuplerjr&rer>rrrrrqrurxrzr*r|rrrrr0HsD      r0r3.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. rRcsrhrparse_color_valuerUrrrrWrXzparse_tuple..NcsrhrrrUrrrrWrXr4z:value is not a valid color: tuples must have length 3 or 4)r`rparse_float_alphar )r3rrrrrrr8s   r8c 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)rUrrrrW7szparse_str..r'r(css|]}t|dVqdS)r(Nr)rUrrrrWAsr4zBvalue is not a valid color: string not recognised as a valid color)lowerCOLORS_BY_NAMErI ints_to_rgbare fullmatch r_hex_shortgroupsr* r_hex_longr_rgbr_rgb_v4_styler_hslr_hsl_v4_style parse_hslr ) r3Z value_lowerrrrmrLrmrrrrr: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. r4z?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&rKr )r3rr=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%dr4z>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)r5r9endswithr&rKr mathisclose)r3rrrrr}s      rrkh_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>degNriZradr )rr&radsrrr) rkrrrrZs_valueZl_valueZh_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*rd)r-rrrrPs rPZ aliceblue)rZ antiquewhite)Zaqua)rrrZ aquamarine)rZazure)rrrZbeige)rZbisque)rblack)rrrZblanchedalmond)rrblue)rrrZ blueviolet)+Zbrown)*rZ burlywood)Z cadetblue)_Z chartreuse)rrrZ chocolate)iZcoral)rrPZcornflowerblue)rZcornsilk)rrrZcrimson)r<cyanZdarkblue)rrZdarkcyan)rrrZ darkgoldenrod)r Zdarkgray)rrZ darkgreen)rrrZdarkgreyZ darkkhaki)kZ darkmagenta)rrrZdarkolivegreen)Ur/Z darkorange)rrZ darkorchid)2Zdarkred)rrrZ darksalmon)zZ darkseagreen)rZ darkslateblue)H=rZ darkslategray)rOrZ darkslategreyZ darkturquoise)rZ darkviolet)rZdeeppink)rrZ deepskyblue)rrZdimgray)rrrZdimgreyZ dodgerblue)rrZ firebrick)"rZ floralwhite)rrrZ forestgreen)rrrZfuchsia)rrrZ gainsboro)rrrZ ghostwhite)rrrZgold)rrrZ goldenrod)r gray)rrgreen)rrrZ greenyellow)rrZgreyZhoneydew)rrrZhotpink)rrZ indianred)r\rZindigo)KrZivory)rrrZkhaki)rrZlavender)rrrZ lavenderblush)rrrZ lawngreen)|rZ lemonchiffon)rrrZ lightblue)rrZ lightcoral)rrrZ lightcyan)rrZlightgoldenrodyellow)rrrZ lightgray)rrrZ lightgreen)rrZ lightgreyZ lightpink)rZ lightsalmon)rrrZ lightseagreen)rrZ lightskyblue)rrrZlightslategray)wrZlightslategreyZlightsteelblue)rrZ lightyellow)rrrZlime)rrrZ limegreen)rrrZlinen)rrrmagentaZmaroon)rrrZmediumaquamarine)frrZ mediumblue)rrrZ mediumorchid)rrZ mediumpurple)rpZmediumseagreen)rqZmediumslateblue){hrZmediumspringgreen)rrZmediumturquoise)rrrZmediumvioletred)Z midnightblue)rrZ mintcream)rrrZ mistyrose)rrZmoccasin)rrZ navajowhite)rrrZnavy)rrrZoldlace)rrZolive)rrrZ olivedrab)r#Zorange)rrrZ orangered)rErorchid)rrZ palegoldenrod)rrZ palegreen)rZ paleturquoise)rrZ palevioletred)rrrZ papayawhip)rZ peachpuff)rrperu)rr?Zpink)rZplum)rrZ powderblue)rrrpurple)rrrred)rrrZ rosybrown)rrrZ royalblue)ArrZ saddlebrown)rr Zsalmon)rrrZ sandybrown)`Zseagreen).rWZseashell)rrrZsienna)rR-silver)rrrZskyblue)rrrZ slateblue)jZrZ slategray)rrrZ slategreyZsnow)rrrZ springgreen)rrrZ steelblue)Frr)rrr)rrr)rrr)rcG)@r)rrr)rrr)rrr)rrr)rrr)rrr) tantealZthistletomatoZ turquoisevioletZwheatwhiteZ whitesmokeyellowZ yellowgreencCsi|]\}}||qSrr)r,krVrrr \sr5r)r)=r$rrcolorsysrrtypingrrrrrZ pydantic_corer r r Ztyping_extensionsr _internalrZ#_internal._schema_generation_sharedrrZ json_schemarwarningsrr6r*r&rr9r}rrZ_r_255Z_r_commaZ_r_alphaZ_r_hZ_r_slrrrrrrrYpirZRepresentationr0r8r:rrrrrPritemsrHrrrrs     " "&& 6>;""*      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~