+ vi>csRt^RIt^RIt^RIHt^RIHtHtHt^RI H t ^RI H t ^RI t^RIHt]P"!]4t^t]!RR]44t!R R 4t!R R ]4t!R R]]R7tR"RltRtR#RltR"RltR"RltRtR$RltRt Rt!RRRR/Rlt"R#Rlt#R%RRllt$] !RR 7R!4t%R#)&zAssorted utilities used by drivers and the CLI. Copyright Jonas Malaco and contributors SPDX-License-Identifier: GPL-3.0-or-later N) literal_eval)EnumEnumMetaunique)Optional) lru_cache)UnsafeFeaturesNotEnabledcsa]tRt^toRtRtR tR tR tR t R t Rt Rt Rt RtRtRtRtRtRtRtRtRt]R4tRtRtRtVtR#) Hue2AccessoryaMapping of HUE 2 accessory IDs and names. >>> Hue2Accessory(4) >>> str(Hue2Accessory(4)) 'HUE 2 LED Strip 300 mm' Unknown IDs are automatically translated to equivalent pseudo-names. >>> Hue2Accessory(59) >>> Hue2Accessory(59).value == Hue2Accessory(59).value True >>> Hue2Accessory(59) != Hue2Accessory(58) True csH\PV4pW#nWnV#N)object__new__ pretty_name_value_)clsvaluer Zmember&&& 3/usr/lib/python3.14/site-packages/liquidctl/util.pyr ZHue2Accessory.__new__=s $( cs^\PV4pRVnRV 2VnWnV#)ZUnknownZUNKNOWN_)r r r Z_name_r )r rZdummys&& r _missing_ZHue2Accessory._missing_Cs0s#%!%)   rcsVP#r)r )self&r__str__ZHue2Accessory.__str__Ksrcs4VPVP8H#r)r)rZother&&r__eq__ZHue2Accessory.__eq__NszzU[[((rN)zHUE+ LED Strip)z AER RGB 1)izHUE 2 LED Strip 300 mm)izHUE 2 LED Strip 250 mm)izHUE 2 LED Strip 200 mm)izHUE 2 Cable Comb)i zHUE 2 Underglow 300 mm)i zHUE 2 Underglow 200 mm)i zAER RGB 2 120 mm)i zAER RGB 2 140 mm)iz$Kraken X (X53, X63 or X73) Pump Ring)iz$Kraken X (X53, X63 or X73) Pump Logo)izF120 RGB)izF140 RGB)iz F140 RGB Core)iz F240 RGB Core)iz F360 RGB Core)__name__ __module__ __qualname____firstlineno____doc__ZHUE_PLUS_LED_STRIPZ AER_RGB1_FANZHUE2_LED_STRIP_300ZHUE2_LED_STRIP_250ZHUE2_LED_STRIP_200ZHUE2_CABLE_COMBZHUE2_UNDERGLOW_300ZHUE2_UNDERGLOW_200Z AER_RGB2_120Z AER_RGB2_140ZKRAKENX_GEN4_RINGZKRAKENX_GEN4_LOGOZF120_RGBZF140_RGBZ F140_RGB_COREZ F240_RGB_COREZ F360_RGB_COREr Z classmethodrrr__static_attributes____classdictcell__ __classdict__@rrrs"2&L9990O99-L-LFF!H!H+M+M+M  ))rrcs4a]tRt^RtoRtRRltRtRtVtR#) LazyHexReprahWrap an indexed collection of bytes with a lazy hex __repr__. This is useful for logging, which uses `%` string formatting to lazily generate the messages, only when needed. >>> '%r' % LazyHexRepr(b'abc') '61:62:63' Start and end indices may also be specified. >>> '%r' % LazyHexRepr(b'abc', start=1) '62:63' >>> '%r' % LazyHexRepr(b'abc', end=-1) '61:62' Ncs6WnW nW0nW@nR#r)datastartendsep)rr&r'r(r)s&&&&&r__init__ZLazyHexRepr.__init__bs  rcs\RVPVPVP4pVPP V4#)cs VR #)Z02xr)xrrZ&LazyHexRepr.__repr__..is 1S' r)mapr&r'r(r)Zjoin)rZhexvalss& r__repr__ZLazyHexRepr.__repr__hs5*DIIdjj$((,KLxx}}W%%r)r&r(r)r')NN:) rrrrrr*r.r r!r"r$rr%r%Rs &&rr%cs2aa]tRt^mtoV3RltRtVtV;t#)_RelaxedNamesEnumcs><\SV`VP44#r)Zsuper __getitem__upper)r Zname __class__s&&rr1Z_RelaxedNamesEnum.__getitem__nsw"4::<00rr)rrrrr1r r!Z __classcell__)r3r#s@@rr0r0ms11rr0cs]tRt^rtRtRtR#)RelaxedNamesEnumz1Enum class where name lookup is case insensitive.rN)rrrrrr rrrr4r4rs;rr4)Z metaclasscs\V\V4, pVPV.V,4V#)zPad `list` with `fillitem` to `width`. >>> rpadlist([1, 2, 3], 5) [1, 2, 3, 0, 0] >>> rpadlist([1, 2, 3], 5, fillitem=None) [1, 2, 3, None, None] )lenZextend)listZwidthZfillitemZ pad_widthrrrpadlistr7ws*D !IKK Y&' Krcsj\V\W 44pW08wd\PRWV4V#)z;Clamp numeric `value` to interval [`clampmin`, `clampmax`].zclamped %s to interval [%s, %s])ZmaxZmin_LOGGERZdebug)rZclampminZclampmaxZclampedrrclampr9s/(C01G 7(S NrcsVe V^d, pVe,V^8gV^8d \R4h\V^,4#\R4h)zReturn `ratio` xor `percentage` expressed as a fraction of 255. >>> fraction_of_byte(ratio=.8) 204 >>> fraction_of_byte(percentage=20) 51 z'cannot express ratios outside of [0, 1]z+either ratio or percentage must not be None) ValueErrorround)ZratioZ percentagerrfraction_of_byter<sNS   19 FG GUS[!! B CCrcB\PWV^,RR7#)zRead an unsigned 16-bit little-endian integer from `buffer`. >>> u16le_from(b'E') 1349 >>> u16le_from(b'E', offset=1) 773 ZlittleZ byteorderintZ from_bytesZbufferZoffsetrr u16le_fromrBs  >>&!4> IIrcr=)z~Read an unsigned 16-bit big-endian integer from `buffer`. >>> u16be_from(b'E') 17669 >>> u16be_from(b'E', offset=1) 1283 Zbigr>r?rArr u16be_fromrCs  >>&!4> FFrcs\VR,VRR4UUu.uF3wrV^,V^,, V^,V^,, 3NK5 upp#uuppi)u Compute a profile's Δx and Δy.rNNN)zip)profileZcurZprevs& rdeltarHsY!gcrl; =; VDG^SVDG^ ,; == =s9Acs\\V4W3.,RR7pVR,p\VR,VRR4F5wwrEwrgWF8XdKWW8dTpVPWE34WR8XgK4V# V#)aNormalize a [(x:int, y:int), ...] profile. The normalized profile will ensure that: - the profile is a monotonically increasing function (i.e. for every i, i > 1, x[i] - x[i-1] > 0 and y[i] - y[i-1] >= 0) - the profile is sorted - a (critx, 100) failsafe is enforced - only the first point that sets y := 100 is kept >>> normalize_profile([(30, 40), (25, 25), (35, 30), (40, 35), (40, 80)], 60) [(25, 25), (30, 40), (35, 40), (40, 80), (60, 100)] >>> normalize_profile([(30, 40), (25, 25), (35, 30), (40, 100)], 60) [(25, 25), (30, 40), (35, 40), (40, 100)] >>> normalize_profile([(30, 40), (25, 25), (35, 100), (40, 100)], 60) [(25, 25), (30, 40), (35, 100)] >>> normalize_profile([], 60) [(60, 100)] >>> normalize_profile([], 60, 300) [(60, 300)] cs(V^,V^,)3#r)prrr,Z#normalize_profile..s!A$QRSTQUPUrkey:rJrNrDNrE)sortedr6rFZappend)rGZcritxZ max_valueZmonor+ZyZxbZybs&&& rnormalize_profilerOs.T']u&8%99?VWG 3  K; KrcsrV^,VR,r2VF%pV^,V8:dTpV^,V8gK#TpM V^,V^,8Xd V^,#\V^,W^,, V^,V^,, , V^,V^,, ,,4#)aInterpolate y given x and a [(x: int, y: int), ...] profile. Requires the profile to be sorted by x, with no duplicate x values (see normalize_profile). Expects profiles with integer x and y values, and returns duty rounded to the nearest integer. >>> interpolate_profile([(20, 50), (50, 70), (60, 100)], 33) 59 >>> interpolate_profile([(20, 50), (50, 70)], 19) 50 >>> interpolate_profile([(20, 50), (50, 70)], 51) 70 >>> interpolate_profile([(20, 50)], 20) 50 rEr;)rGr+lowerr2Zsteps&& rinterpolate_profilerRs 1:wr{5 7a<E 7a<E    Qx58Qx qQq\E!HuQx,?@%(USTXBUVV WWrc saV3RlpSP4pVPR4'dV!SR,R4wr4pW4V.#VPR4'dUV!SR,R4wrgp\\R\P !VR, V^d, V^d, 444#VPR4'dUV!SR,R4wrgp \\R\P !VR, V ^d, V^d, 444#\S4^8Xd\\PS44#\S4^8Xd=SPR 4'd&\\PSR ,44#\S4^8Xd=VPR 4'd&\\PSR ,44#\R S 24h)uParse a color, and, if necessary, translate it into the RGB model. The input string can be encoded in several formats: - ffffff: hexadecimal RGB implicit tuple (with or without the prefix '0x') - rgb(255, 255, 255): explicit RGB, R,G,B ∊ [0, 255] - hsv(360, 100, 100): explicit HSV, H ∊ [0, 360], SV ∊ [0, 100] - hsl(360, 100, 100): explicit HSL, H ∊ [0, 360], SV ∊ [0, 100] >>> color_from_str('fF7f3f') [255, 127, 63] >>> color_from_str('0xfF7f3f') [255, 127, 63] >>> color_from_str('0XfF7f3f') [255, 127, 63] >>> color_from_str('#fF7f3f') [255, 127, 63] >>> color_from_str('Rgb(255, 127, 63)') [255, 127, 63] >>> color_from_str('Hsv(20, 75, 100)') [255, 128, 64] >>> color_from_str('Hsl(20, 100, 62)') [255, 126, 61] >>> color_from_str('fF7f3f1f') Traceback (most recent call last): ... ValueError: cannot parse color: fF7f3f1f >>> color_from_str('0bff00ff') Traceback (most recent call last): ... ValueError: cannot parse color: 0bff00ff >>> color_from_str('rgb()') Traceback (most recent call last): ... ValueError: expected 3-element triple: rgb() >>> color_from_str('rgb(255)') Traceback (most recent call last): ... ValueError: expected 3-element triple: rgb(255) >>> color_from_str('rgb(300, 255, 255)') Traceback (most recent call last): ... ValueError: expected value in range [0, 255]: 300 in rgb(300, 255, 255) >>> color_from_str('hsv(360, 150, 100)') Traceback (most recent call last): ... ValueError: expected value in range [0, 100]: 150 in hsv(360, 150, 100) >>> color_from_str('hsl(360, 100, 150)') Traceback (most recent call last): ... ValueError: expected value in range [0, 100]: 150 in hsl(360, 100, 150) c sj<\V4p\V\4'd\V4^8wd\ RS 24h\ W!4Fcwr4\V\ 4'g(\V\4'g\ RV RS 24hV^8g W48gKQ\ RV RV RS 24h V#)zexpected 3-element triple: zexpected float or int: z in zexpected value in range [0, z]: )rZ isinstancetupler5r:rFr@Zfloat)ZsubZ maxvaluesZliteralrZmaxvaluer+s&& r parse_tripleZ$color_from_str..parse_triple0ss#'5))S\Q->:1#>? ?"76OEeS))*UE2J2J #:5'aS!IJJqyE, #?zUGSWXYWZ![\\ 7 rzrgb(:rSNNzhsv(hc&\V^,4#rPbrrr, color_from_str..B %#,rzhsl(crWrXrPrZrrr,r\Er]rZ#rDZ0x:rNNzcannot parse color: )rYrYrY)rVdr^) rQ startswithr6r-colorsysZ hsv_to_rgbZ hls_to_rgbr5ZbytesZfromhexr:) r+rUZxlZrZgr[ZhZsZvZls f rcolor_from_strrasn  B }}Vquo6aay v  quo6aC.0C0CAcE1S5RSTWRW0XYZZ v  quo6aC.0C0CAcE1S5RSTWRW0XYZZ Q1EMM!$%% Q1c**EMM!B%()) Q1t,,EMM!B%())/s344runsafeerrorFcsaS'd\\V3RlV44pV'gR#V'd \V4hR#)afCheck if unsafe feature requirements are met. Unstable. Checks if the requirements in the positional arguments (`*reqs`) are all met by the `unsafe` string list of enabled features. >>> check_unsafe('foo', unsafe='foo,bar') True >>> check_unsafe('foo', 'bar', unsafe='foo,bar') True >>> check_unsafe('foo', unsafe=None) False >>> check_unsafe('foo', 'baz', unsafe='foo,bar') False If `error=True` and some requirements have not been met, raises `liquidctl.error.UnsafeFeaturesNotEnabled`. In the default `error=False` mode, a boolean is return indicating whether all requirements were met. >>> check_unsafe('foo', 'baz', unsafe='foo,bar', error=True) Traceback (most recent call last): ... liquidctl.error.UnsafeFeaturesNotEnabled: required unsafe features have not been enabled: baz In driver code, `unsafe` is normally passed in `**kwargs`. >>> kwargs = {'unsafe': 'foo,bar'} >>> check_unsafe('foo', 'bar', **kwargs) True >>> check_unsafe('foo', 'baz', error=True, **kwargs) Traceback (most recent call last): ... liquidctl.error.UnsafeFeaturesNotEnabled: required unsafe features have not been enabled: baz cs<VS9#rr)r+rbs&rr,Zcheck_unsafe..vs avorTF)rTZfilterr)rbrcZreqsZkwargssd$*,r check_unsaferdPs2JV5t<=  &t,, rcsRPV4'dV#RPV4'dV#\RV: 24h)aCheck a `direction` option and run the appropriate closure. Unstable. Accepts both US and UK spellings. Raises a `ValueError` if the option value is neither forward[s] nor backward[s]. >>> map_direction('forward', 3, 42) 3 >>> map_direction('forwards', 3, 42) 3 >>> map_direction('backward', 3, 42) 42 >>> map_direction('backwards', 3, 42) 42 >>> map_direction('fooowwd', 3, 42) Traceback (most recent call last): ... ValueError: invalid direction: 'fooowwd' ZforwardsZ backwardszinvalid direction: )r_r:)Z directionZforwardZbackwards&&&r map_directionresC,Y''    * *.ym<==rcshV^8dQhR\\,R\\,R\/#)rrmax_fansZreturn)rZstrr@dict)Zformats"r __annotate__rhs3l@l@8C=l@HSMl@Tl@rcsZV'g/#VPR4p/pVFpVPR4p\V4^8wd \R4hVUu.uFqfP4NK upwrx\ V^ 4p T ^8:g TeY8d\RT R24hTP 4R 9d\RT R24hTP YxP 4/4K \\VP4RR74#uupi \d\RT R24hi;i) axConvert the --fan-mode=:[,...] options into a {key: value, ....} dictionary. The default is an empty dictionary. Unstable. >>> fan_mode_parser(None, 5) {} >>> fan_mode_parser('', 5) {} >>> fan_mode_parser('1:dc', 5) {'1': 'dc'} >>> fan_mode_parser('2:auto', 5) {'2': 'auto'} >>> fan_mode_parser('3:off', 5) {'3': 'off'} >>> fan_mode_parser('1:DC', 5) {'1': 'dc'} >>> fan_mode_parser('2:AUTO', 5) {'2': 'auto'} >>> fan_mode_parser('3:OFF', 5) {'3': 'off'} >>> fan_mode_parser('5:OFF', 5) {'5': 'off'} >>> fan_mode_parser('5:OFF') {'5': 'off'} >>> fan_mode_parser('1:dc,2:auto,3:off,4:pwm', 5) {'1': 'dc', '2': 'auto', '3': 'off', '4': 'pwm'} >>> fan_mode_parser('1:dc, 2:auto, 3:off', 5) {'1': 'dc', '2': 'auto', '3': 'off'} >>> fan_mode_parser('4:dc, 3:auto, 2:off', 5) {'2': 'off', '3': 'auto', '4': 'dc'} >>> fan_mode_parser('1 :dc, 2: auto, 3 : off, 4 : auto ', 5) {'1': 'dc', '2': 'auto', '3': 'off', '4': 'auto'} >>> fan_mode_parser('1:dc:dc', 5) Traceback (most recent call last): ... ValueError: invalid format, should be ':' >>> fan_mode_parser('-1:dc', 5) Traceback (most recent call last): ... ValueError: invalid fan number: '-1' >>> fan_mode_parser('0:pwm', 5) Traceback (most recent call last): ... ValueError: invalid fan number: '0' >>> fan_mode_parser('5:dc', 4) Traceback (most recent call last): ... ValueError: invalid fan number: '5' >>> fan_mode_parser('a:dc', 5) Traceback (most recent call last): ... ValueError: invalid fan number: 'a' >>> fan_mode_parser('1:PMW', 5) Traceback (most recent call last): ... ValueError: invalid fan mode: 'PMW' Z,r/z,invalid format, should be ':'zinvalid fan number: 'Z'zinvalid fan mode: 'csV^,#rIr)Zitemrrr,Z!fan_mode_parser.. sd1grrL)ZoffZautoZdcZpwm) Zsplitr5r:Zstripr@rQZupdatergrNZitems) rrfZpartsZoptsrKZp2ZirMZvalZkey_vals && rfan_mode_parserrisb  KK E D  WWS\ r7a<KL L)+,Aggi,  =#rlG a ??!- =4SE;< < =sD 1 DD*)Zmaxsizecs@\PPV4#)aEfficiently construct a predefined CRC function. Unstable. For the available algorithms, see . This function implements memoization, only constructing each requested CRC algorithm implementation once. )crcmodZ predefinedmkCrcFun)Zcrc_namerrrkrk s    % %h //rrI)NN)r^r)&rr`ZloggingZastrZenumrrrZtypingrZ functoolsrZcrcmod.predefinedrjZliquidctl.errorrZ getLoggerrr8ZHUE2_MAX_ACCESSORIES_IN_CHANNELrr%r0r4r7r9r<rBrCrHrOrRrardrerirkrrrrls ''4   H %"#6)D6)6)r&&611  t'8 D"JG= !HX8T5n-t-5-`>