xulbux 1.5.5__py3-none-any.whl → 1.5.7__py3-none-any.whl

xulbux/xx_color.py

@@ -31,14 +31,11 @@ The `Color` class, which contains all sorts of different color-related methods:
     - saturation
 """
 
-
 from .xx_regex import *
 
 import re as _re
 
 
-
-
 class rgba:
     """An RGB/RGBA color: is a tuple of 3 integers, representing the red (`0`-`255`), green (`0`-`255`), and blue (`0`-`255`).<br>
     Also includes an optional 4th param, which is a float, that represents the alpha channel (`0.0`-`1.0`).\n
@@ -62,14 +59,18 @@ class rgba:
     - `with_alpha(alpha)` to create a new color with different alpha
     - `complementary()` to get the complementary color"""
 
-    def __init__(self, r:int, g:int, b:int, a:float = None):
+    def __init__(self, r: int, g: int, b: int, a: float = None):
         if any(isinstance(x, rgba) for x in (r, g, b)):
-            raise ValueError('Color is already a rgba() color')
+            raise ValueError("Color is already a rgba() color")
         elif not all(isinstance(x, int) and 0 <= x <= 255 for x in (r, g, b)):
-            raise ValueError('RGBA color must have R G B as integers in [0, 255]: got', (r, g, b))
-        elif not a is None and not (isinstance(a, (int, float)) and 0 <= a <= 1):
-            raise ValueError('Alpha channel must be a float/int in [0.0, 1.0]: got', a)
-        self.r, self.g, self.b, self.a = r, g, b, (1.0 if a > 1.0 else float(a)) if a else None
+            raise ValueError(
+                "RGBA color must have R G B as integers in [0, 255]: got",
+                (r, g, b),
+            )
+        elif a is not None and not (isinstance(a, (int, float)) and 0 <= a <= 1):
+            raise ValueError("Alpha channel must be a float/int in [0.0, 1.0]: got", a)
+        self.r, self.g, self.b = r, g, b
+        self.a = (1.0 if a > 1.0 else float(a)) if a else None
 
     def __len__(self):
         return 4 if self.a else 3
@@ -77,6 +78,9 @@ class rgba:
     def __iter__(self):
         return iter((self.r, self.g, self.b) + ((self.a,) if self.a else ()))
 
+    def __dict__(self):
+        return self.dict()
+
     def __getitem__(self, index):
         return ((self.r, self.g, self.b) + ((self.a,) if self.a else ()))[index]
 
@@ -87,16 +91,14 @@ class rgba:
         return f'({self.r}, {self.g}, {self.b}{f", {self.a}" if self.a else ""})'
 
     def __eq__(self, other):
-        if not isinstance(other, rgba): return False
-        return (self.r, self.g, self.b, self.a) == (other[0], other[1], other[2], other[3])
-
-    def list(self) -> list:
-        """Returns the color components as a list `[r, g, b]` or `[r, g, b, a]` if alpha is present"""
-        return [self.r, self.g, self.b] + ([self.a] if self.a else [])
-
-    def tuple(self) -> tuple:
-        """Returns the color components as a tuple `(r, g, b)` or `(r, g, b, a)` if alpha is present"""
-        return tuple(self.list())
+        if not isinstance(other, rgba):
+            return False
+        return (self.r, self.g, self.b, self.a) == (
+            other[0],
+            other[1],
+            other[2],
+            other[3],
+        )
 
     def dict(self) -> dict:
         """Returns the color components as a dictionary with keys `'r'`, `'g'`, `'b'` and optionally `'a'`"""
@@ -106,59 +108,61 @@ class rgba:
         """Returns the color components as separate values `r, g, b, a`"""
         return self.r, self.g, self.b, self.a
 
-    def to_hsla(self) -> 'hsla':
+    def to_hsla(self) -> "hsla":
         """Returns the color as a `hsla()` color"""
         return hsla(*self._rgb_to_hsl(self.r, self.g, self.b), self.a)
 
-    def to_hexa(self) -> 'hexa':
+    def to_hexa(self) -> "hexa":
         """Returns the color as a `hexa()` color"""
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
     def has_alpha(self) -> bool:
         """Returns `True` if the color has an alpha channel and `False` otherwise"""
-        return self.a != None
+        return self.a is not None
 
-    def lighten(self, amount:float) -> 'rgba':
+    def lighten(self, amount: float) -> "rgba":
         """Increases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_hsla().lighten(amount).to_rgba().values()
         return rgba(self.r, self.g, self.b, self.a)
 
-    def darken(self, amount:float) -> 'rgba':
+    def darken(self, amount: float) -> "rgba":
         """Decreases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_hsla().darken(amount).to_rgba().values()
         return rgba(self.r, self.g, self.b, self.a)
 
-    def saturate(self, amount:float) -> 'rgba':
+    def saturate(self, amount: float) -> "rgba":
         """Increases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_hsla().saturate(amount).to_rgba().values()
         return rgba(self.r, self.g, self.b, self.a)
 
-    def desaturate(self, amount:float) -> 'rgba':
+    def desaturate(self, amount: float) -> "rgba":
         """Decreases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_hsla().desaturate(amount).to_rgba().values()
         return rgba(self.r, self.g, self.b, self.a)
 
-    def rotate(self, degrees:int) -> 'rgba':
+    def rotate(self, degrees: int) -> "rgba":
         """Rotates the colors hue by the specified number of degrees"""
         self.r, self.g, self.b, self.a = self.to_hsla().rotate(degrees).to_rgba().values()
         return rgba(self.r, self.g, self.b, self.a)
 
-    def invert(self, invert_alpha:bool = False) -> 'rgba':
+    def invert(self, invert_alpha: bool = False) -> "rgba":
         """Inverts the color by rotating hue by 180 degrees and inverting lightness"""
         self.r, self.g, self.b = 255 - self.r, 255 - self.g, 255 - self.b
-        if invert_alpha: self.a = 1 - self.a
+        if invert_alpha:
+            self.a = 1 - self.a
         return rgba(self.r, self.g, self.b, self.a)
 
-    def grayscale(self) -> 'rgba':
+    def grayscale(self) -> "rgba":
         """Converts the color to grayscale using the luminance formula"""
         self.r = self.g = self.b = Color.luminance(self.r, self.g, self.b)
         return rgba(self.r, self.g, self.b, self.a)
 
-    def blend(self, other:'rgba', ratio:float = 0.5, additive_alpha:bool = False) -> 'rgba':
+    def blend(self, other: "rgba", ratio: float = 0.5, additive_alpha: bool = False) -> "rgba":
         """Blends the current color with another color using the specified ratio (`0.0`-`1.0`):<br>
         If `ratio` is `0.0` it means 100% of the current color and 0% of the `other` color (1:0 mixture)<br>
         If `ratio` is `0.5` it means 50% of both colors (1:1 mixture)<br>
-        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)"""
+        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)
+        """
         if not (isinstance(ratio, (int, float)) and 0 <= ratio <= 1):
             raise ValueError("'ratio' must be a float/int in [0.0, 1.0]")
         elif not isinstance(other, rgba):
@@ -177,7 +181,13 @@ class rgba:
             if additive_alpha:
                 self.a = max(0, min(1, (self_a * (2 - ratio)) + (other_a * ratio)))
             else:
-                self.a = max(0, min(1, (self_a * (1 - (ratio / 2))) + (other_a * (ratio / 2))))
+                self.a = max(
+                    0,
+                    min(
+                        1,
+                        (self_a * (1 - (ratio / 2))) + (other_a * (ratio / 2)),
+                    ),
+                )
         else:
             self.a = None
         return rgba(self.r, self.g, self.b, None if none_alpha else self.a)
@@ -198,17 +208,17 @@ class rgba:
         """Returns `True` if the color has no transparency"""
         return self.a == 1 or self.a is None
 
-    def with_alpha(self, alpha:float) -> 'rgba':
+    def with_alpha(self, alpha: float) -> "rgba":
         """Returns a new color with the specified alpha value"""
         if not (isinstance(alpha, (int, float)) and 0 <= alpha <= 1):
             raise ValueError("'alpha' must be a float/int in [0.0, 1.0]")
         return rgba(self.r, self.g, self.b, alpha)
 
-    def complementary(self) -> 'rgba':
+    def complementary(self) -> "rgba":
         """Returns the complementary color (180 degrees on the color wheel)"""
         return self.to_hsla().complementary().to_rgba()
 
-    def _rgb_to_hsl(self, r:int, g:int, b:int) -> tuple:
+    def _rgb_to_hsl(self, r: int, g: int, b: int) -> tuple:
         r, g, b = r / 255.0, g / 255.0, b / 255.0
         max_c, min_c = max(r, g, b), min(r, g, b)
         l = (max_c + min_c) / 2
@@ -217,15 +227,16 @@ class rgba:
         else:
             delta = max_c - min_c
             s = delta / (1 - abs(2 * l - 1))
-            if max_c == r: h = ((g - b) / delta) % 6
-            elif max_c == g: h = ((b - r) / delta) + 2
-            else: h = ((r - g) / delta) + 4
+            if max_c == r:
+                h = ((g - b) / delta) % 6
+            elif max_c == g:
+                h = ((b - r) / delta) + 2
+            else:
+                h = ((r - g) / delta) + 4
             h /= 6
         return int(round(h * 360)), int(round(s * 100)), int(round(l * 100))
 
 
-
-
 class hsla:
     """A HSL/HSLA color: is a tuple of 3 integers, representing hue (`0`-`360`), saturation (`0`-`100`), and lightness (`0`-`100`).<br>
     Also includes an optional 4th param, which is a float, that represents the alpha channel (`0.0`-`1.0`).\n
@@ -249,14 +260,18 @@ class hsla:
     - `with_alpha(alpha)` to create a new color with different alpha
     - `complementary()` to get the complementary color"""
 
-    def __init__(self, h:int, s:int, l:int, a:float = None):
+    def __init__(self, h: int, s: int, l: int, a: float = None):
         if any(isinstance(x, hsla) for x in (h, s, l)):
-            raise ValueError('Color is already a hsla() color')
+            raise ValueError("Color is already a hsla() color")
         elif not (isinstance(h, int) and (0 <= h <= 360) and all(isinstance(x, int) and (0 <= x <= 100) for x in (s, l))):
-            raise ValueError('HSL color must have H as integer in [0, 360] and S L as integers in [0, 100]: got', (h, s, l))
-        elif not a is None and (not isinstance(a, (int, float)) or not 0 <= a <= 1):
-            raise ValueError('Alpha channel must be a float/int in [0.0, 1.0]: got', a)
-        self.h, self.s, self.l, self.a = h, s, l, (1.0 if a > 1.0 else float(a)) if a else None
+            raise ValueError(
+                "HSL color must have H as integer in [0, 360] and S L as integers in [0, 100]: got",
+                (h, s, l),
+            )
+        elif a is not None and (not isinstance(a, (int, float)) or not 0 <= a <= 1):
+            raise ValueError("Alpha channel must be a float/int in [0.0, 1.0]: got", a)
+        self.h, self.s, self.l = h, s, l
+        self.a = (1.0 if a > 1.0 else float(a)) if a else None
 
     def __len__(self):
         return 4 if self.a else 3
@@ -264,6 +279,9 @@ class hsla:
     def __iter__(self):
         return iter((self.h, self.s, self.l) + ((self.a,) if self.a else ()))
 
+    def __dict__(self):
+        return self.dict()
+
     def __getitem__(self, index):
         return ((self.h, self.s, self.l) + ((self.a,) if self.a else ()))[index]
 
@@ -276,15 +294,12 @@ class hsla:
     def __eq__(self, other):
         if not isinstance(other, hsla):
             return False
-        return (self.h, self.s, self.l, self.a) == (other[0], other[1], other[2], other[3])
-
-    def list(self) -> list:
-        """Returns the color components as a list `[h, s, l]` or `[h, s, l, a]` if alpha is present"""
-        return [self.h, self.s, self.l] + ([self.a] if self.a else [])
-
-    def tuple(self) -> tuple:
-        """Returns the color components as a tuple `(h, s, l)` or `(h, s, l, a)` if alpha is present"""
-        return tuple(self.list())
+        return (self.h, self.s, self.l, self.a) == (
+            other[0],
+            other[1],
+            other[2],
+            other[3],
+        )
 
     def dict(self) -> dict:
         """Returns the color components as a dictionary with keys `'h'`, `'s'`, `'l'` and optionally `'a'`"""
@@ -294,71 +309,73 @@ class hsla:
         """Returns the color components as separate values `h, s, l, a`"""
         return self.h, self.s, self.l, self.a
 
-    def to_rgba(self) -> 'rgba':
+    def to_rgba(self) -> "rgba":
         """Returns the color as a `rgba()` color"""
         return rgba(*self._hsl_to_rgb(self.h, self.s, self.l), self.a)
 
-    def to_hexa(self) -> 'hexa':
+    def to_hexa(self) -> "hexa":
         """Returns the color as a `hexa()` color"""
         r, g, b = self._hsl_to_rgb(self.h, self.s, self.l)
         return hexa(f'#{r:02X}{g:02X}{b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
     def has_alpha(self) -> bool:
         """Returns `True` if the color has an alpha channel and `False` otherwise"""
-        return self.a != None
+        return self.a is not None
 
-    def lighten(self, amount:float) -> 'hsla':
+    def lighten(self, amount: float) -> "hsla":
         """Increases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         if not (isinstance(amount, (int, float)) and 0 <= amount <= 1):
             raise ValueError("'amount' must be a float/int in [0.0, 1.0]")
         self.l = int(min(100, self.l + (100 - self.l) * amount))
         return hsla(self.h, self.s, self.l, self.a)
 
-    def darken(self, amount:float) -> 'hsla':
+    def darken(self, amount: float) -> "hsla":
         """Decreases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         if not (isinstance(amount, (int, float)) and 0 <= amount <= 1):
             raise ValueError("'amount' must be a float/int in [0.0, 1.0]")
         self.l = int(max(0, self.l * (1 - amount)))
         return hsla(self.h, self.s, self.l, self.a)
 
-    def saturate(self, amount:float) -> 'hsla':
+    def saturate(self, amount: float) -> "hsla":
         """Increases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         if not (isinstance(amount, (int, float)) and 0 <= amount <= 1):
             raise ValueError("'amount' must be a float/int in [0.0, 1.0]")
         self.s = int(min(100, self.s + (100 - self.s) * amount))
         return hsla(self.h, self.s, self.l, self.a)
 
-    def desaturate(self, amount:float) -> 'hsla':
+    def desaturate(self, amount: float) -> "hsla":
         """Decreases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         if not (isinstance(amount, (int, float)) and 0 <= amount <= 1):
             raise ValueError("'amount' must be a float/int in [0.0, 1.0]")
         self.s = int(max(0, self.s * (1 - amount)))
         return hsla(self.h, self.s, self.l, self.a)
 
-    def rotate(self, degrees:int) -> 'hsla':
+    def rotate(self, degrees: int) -> "hsla":
         """Rotates the colors hue by the specified number of degrees"""
         self.h = (self.h + degrees) % 360
         return hsla(self.h, self.s, self.l, self.a)
 
-    def invert(self, invert_alpha:bool = False) -> 'hsla':
+    def invert(self, invert_alpha: bool = False) -> "hsla":
         """Inverts the color by rotating hue by 180 degrees and inverting lightness"""
         self.h = (self.h + 180) % 360
         self.l = 100 - self.l
-        if invert_alpha: self.a = 1 - self.a
+        if invert_alpha:
+            self.a = 1 - self.a
         return hsla(self.h, self.s, self.l, self.a)
 
-    def grayscale(self) -> 'hsla':
+    def grayscale(self) -> "hsla":
         """Converts the color to grayscale using the luminance formula"""
         l = Color.luminance(*self._hsl_to_rgb(self.h, self.s, self.l))
         self.h, self.s, self.l, _ = rgba(l, l, l).to_hsla().values()
         return hsla(self.h, self.s, self.l, self.a)
 
-    def blend(self, other:'hsla', ratio:float = 0.5, additive_alpha:bool = False) -> 'rgba':
+    def blend(self, other: "hsla", ratio: float = 0.5, additive_alpha: bool = False) -> "rgba":
         """Blends the current color with another color using the specified ratio (`0.0`-`1.0`):<br>
         If `ratio` is `0.0` it means 100% of the current color and 0% of the `other` color (1:0 mixture)<br>
         If `ratio` is `0.5` it means 50% of both colors (1:1 mixture)<br>
-        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)"""
-        self.h, self.s, self.l, self.a = self.to_hsla().blend(Color.to_hsla(other), ratio, additive_alpha).values()
+        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)
+        """
+        self.h, self.s, self.l, self.a = self.to_rgba().blend(Color.to_rgba(other), ratio, additive_alpha).to_hsla().values()
         return hsla(self.h, self.s, self.l, self.a)
 
     def is_dark(self) -> bool:
@@ -377,38 +394,43 @@ class hsla:
         """Returns `True` if the color has no transparency"""
         return self.a == 1 or self.a is None
 
-    def with_alpha(self, alpha:float) -> 'hsla':
+    def with_alpha(self, alpha: float) -> "hsla":
         """Returns a new color with the specified alpha value"""
         if not (isinstance(alpha, (int, float)) and 0 <= alpha <= 1):
             raise ValueError("'alpha' must be a float/int in [0.0, 1.0]")
         return hsla(self.h, self.s, self.l, alpha)
 
-    def complementary(self) -> 'hsla':
+    def complementary(self) -> "hsla":
         """Returns the complementary color (180 degrees on the color wheel)"""
         return hsla((self.h + 180) % 360, self.s, self.l, self.a)
 
-    def _hsl_to_rgb(self, h:int, s:int, l:int) -> tuple:
+    def _hsl_to_rgb(self, h: int, s: int, l: int) -> tuple:
         h, s, l = h / 360, s / 100, l / 100
         if s == 0:
             r = g = b = int(l * 255)
         else:
+
             def hue_to_rgb(p, q, t):
-                if t < 0: t += 1
-                if t > 1: t -= 1
-                if t < 1/6: return p + (q - p) * 6 * t
-                if t < 1/2: return q
-                if t < 2/3: return p + (q - p) * (2/3 - t) * 6
+                if t < 0:
+                    t += 1
+                if t > 1:
+                    t -= 1
+                if t < 1 / 6:
+                    return p + (q - p) * 6 * t
+                if t < 1 / 2:
+                    return q
+                if t < 2 / 3:
+                    return p + (q - p) * (2 / 3 - t) * 6
                 return p
+
             q = l * (1 + s) if l < 0.5 else l + s - l * s
             p = 2 * l - q
-            r = int(round(hue_to_rgb(p, q, h + 1/3) * 255))
+            r = int(round(hue_to_rgb(p, q, h + 1 / 3) * 255))
             g = int(round(hue_to_rgb(p, q, h) * 255))
-            b = int(round(hue_to_rgb(p, q, h - 1/3) * 255))
+            b = int(round(hue_to_rgb(p, q, h - 1 / 3) * 255))
         return r, g, b
 
 
-
-
 class hexa:
     """A HEX color: is a string representing a hexadecimal color code with optional alpha channel.\n
     -------------------------------------------------------------------------------------------------
@@ -432,26 +454,46 @@ class hexa:
     - `with_alpha(alpha)` to create a new color with different alpha
     - `complementary()` to get the complementary color"""
 
-    def __init__(self, color:str|int):
+    def __init__(self, color: str | int):
         if isinstance(color, hexa):
-            raise ValueError('Color is already a hexa() color')
+            raise ValueError("Color is already a hexa() color")
         if isinstance(color, str):
-            if color.startswith('#'):
+            if color.startswith("#"):
                 color = color[1:].upper()
-            elif color.startswith('0x'):
+            elif color.startswith("0x"):
                 color = color[2:].upper()
             if len(color) == 3:  # RGB
-                self.r, self.g, self.b, self.a = int(color[0] * 2, 16), int(color[1] * 2, 16), int(color[2] * 2, 16), None
+                self.r, self.g, self.b, self.a = (
+                    int(color[0] * 2, 16),
+                    int(color[1] * 2, 16),
+                    int(color[2] * 2, 16),
+                    None,
+                )
             elif len(color) == 4:  # RGBA
-                self.r, self.g, self.b, self.a = int(color[0] * 2, 16), int(color[1] * 2, 16), int(color[2] * 2, 16), int(color[3] * 2, 16) / 255.0
+                self.r, self.g, self.b, self.a = (
+                    int(color[0] * 2, 16),
+                    int(color[1] * 2, 16),
+                    int(color[2] * 2, 16),
+                    int(color[3] * 2, 16) / 255.0,
+                )
             elif len(color) == 6:  # RRGGBB
-                self.r, self.g, self.b, self.a = int(color[0:2], 16), int(color[2:4], 16), int(color[4:6], 16), None
+                self.r, self.g, self.b, self.a = (
+                    int(color[0:2], 16),
+                    int(color[2:4], 16),
+                    int(color[4:6], 16),
+                    None,
+                )
             elif len(color) == 8:  # RRGGBBAA
-                self.r, self.g, self.b, self.a = int(color[0:2], 16), int(color[2:4], 16), int(color[4:6], 16), int(color[6:8], 16) / 255.0
+                self.r, self.g, self.b, self.a = (
+                    int(color[0:2], 16),
+                    int(color[2:4], 16),
+                    int(color[4:6], 16),
+                    int(color[6:8], 16) / 255.0,
+                )
             else:
                 raise ValueError(f"Invalid HEX format '{color}'")
         elif isinstance(color, int):
-            self.r, self.g, self.b, self.a = Color.hex_to_rgba(color)
+            self.r, self.g, self.b, self.a = Color.hex_int_to_rgba(color)
         else:
             raise TypeError("HEX color must be of type 'str' or 'int': got", type(color))
 
@@ -459,10 +501,13 @@ class hexa:
         return 4 if self.a else 3
 
     def __iter__(self):
-        return iter((f'{self.r:02X}', f'{self.g:02X}', f'{self.b:02X}') + ((f'{int(self.a * 255):02X}',) if self.a else ()))
+        return iter((f"{self.r:02X}", f"{self.g:02X}", f"{self.b:02X}") + ((f"{int(self.a * 255):02X}",) if self.a else ()))
+
+    def __dict__(self):
+        return self.dict()
 
     def __getitem__(self, index):
-        return ((f'{self.r:02X}', f'{self.g:02X}', f'{self.b:02X}') + ((f'{int(self.a * 255):02X}',) if self.a else ()))[index]
+        return ((f"{self.r:02X}", f"{self.g:02X}", f"{self.b:02X}") + ((f"{int(self.a * 255):02X}",) if self.a else ()))[index]
 
     def __repr__(self):
         return f'hexa(#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""})'
@@ -471,30 +516,42 @@ class hexa:
         return f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}'
 
     def __eq__(self, other):
-        if not isinstance(other, hexa): return False
-        return (self.r, self.g, self.b, self.a) == (other[0], other[1], other[2], other[3])
-
-    def list(self) -> list:
-        """Returns the color components as a list of hex strings `[RR, GG, BB]` or `[RR, GG, BB, AA]` if alpha is present"""
-        return [f'{self.r:02X}', f'{self.g:02X}', f'{self.b:02X}'] + ([f'{int(self.a * 255):02X}'] if self.a else [])
-
-    def tuple(self) -> tuple:
-        """Returns the color components as a tuple of hex strings `(RR, GG, BB)` or `(RR, GG, BB, AA)` if alpha is present"""
-        return tuple(self.list())
+        if not isinstance(other, hexa):
+            return False
+        return (self.r, self.g, self.b, self.a) == (
+            other[0],
+            other[1],
+            other[2],
+            other[3],
+        )
 
     def dict(self) -> dict:
         """Returns the color components as a dictionary with hex string values for keys `'r'`, `'g'`, `'b'` and optionally `'a'`"""
-        return dict(r=f'{self.r:02X}', g=f'{self.g:02X}', b=f'{self.b:02X}', a=f'{int(self.a * 255):02X}') if self.a else dict(r=f'{self.r:02X}', g=f'{self.g:02X}', b=f'{self.b:02X}')
+        return (
+            dict(
+                r=f"{self.r:02X}",
+                g=f"{self.g:02X}",
+                b=f"{self.b:02X}",
+                a=f"{int(self.a * 255):02X}",
+            )
+            if self.a
+            else dict(r=f"{self.r:02X}", g=f"{self.g:02X}", b=f"{self.b:02X}")
+        )
 
     def values(self) -> tuple:
         """Returns the color components as separate values `r, g, b, a`"""
         return self.r, self.g, self.b, self.a
 
-    def to_rgba(self, round_alpha:bool = True) -> 'rgba':
+    def to_rgba(self, round_alpha: bool = True) -> "rgba":
         """Returns the color as a `rgba()` color"""
-        return rgba(self.r, self.g, self.b, (round(self.a, 2) if round_alpha else self.a) if self.a else None)
-
-    def to_hsla(self, round_alpha:bool = True) -> 'hsla':
+        return rgba(
+            self.r,
+            self.g,
+            self.b,
+            (round(self.a, 2) if round_alpha else self.a) if self.a else None,
+        )
+
+    def to_hsla(self, round_alpha: bool = True) -> "hsla":
         """Returns the color as a `hsla()` color"""
         return self.to_rgba(round_alpha).to_hsla()
 
@@ -502,47 +559,49 @@ class hexa:
         """Returns `True` if the color has an alpha channel and `False` otherwise"""
         return self.a is not None
 
-    def lighten(self, amount:float) -> 'hexa':
+    def lighten(self, amount: float) -> "hexa":
         """Increases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).lighten(amount).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def darken(self, amount:float) -> 'hexa':
+    def darken(self, amount: float) -> "hexa":
         """Decreases the colors lightness by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).darken(amount).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def saturate(self, amount:float) -> 'hexa':
+    def saturate(self, amount: float) -> "hexa":
         """Increases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).saturate(amount).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def desaturate(self, amount:float) -> 'hexa':
+    def desaturate(self, amount: float) -> "hexa":
         """Decreases the colors saturation by the specified amount (`0.0`-`1.0`)"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).desaturate(amount).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def rotate(self, degrees:int) -> 'hexa':
+    def rotate(self, degrees: int) -> "hexa":
         """Rotates the colors hue by the specified number of degrees"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).rotate(degrees).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def invert(self, invert_alpha:bool = False) -> 'hexa':
+    def invert(self, invert_alpha: bool = False) -> "hexa":
         """Inverts the color by rotating hue by 180 degrees and inverting lightness"""
         self.r, self.g, self.b, self.a = self.to_rgba(False).invert().values()
-        if invert_alpha: self.a = 1 - self.a
+        if invert_alpha:
+            self.a = 1 - self.a
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def grayscale(self) -> 'hexa':
+    def grayscale(self) -> "hexa":
         """Converts the color to grayscale using the luminance formula"""
         self.r = self.g = self.b = Color.luminance(self.r, self.g, self.b)
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
-    def blend(self, other:'hexa', ratio:float = 0.5, additive_alpha:bool = False) -> 'rgba':
+    def blend(self, other: "hexa", ratio: float = 0.5, additive_alpha: bool = False) -> "rgba":
         """Blends the current color with another color using the specified ratio (`0.0`-`1.0`):<br>
         If `ratio` is `0.0` it means 100% of the current color and 0% of the `other` color (1:0 mixture)<br>
         If `ratio` is `0.5` it means 50% of both colors (1:1 mixture)<br>
-        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)"""
+        If `ratio` is `1.0` it means 0% of the current color and 100% of the `other` color (0:1 mixture)
+        """
         self.r, self.g, self.b, self.a = self.to_rgba(False).blend(Color.to_rgba(other), ratio, additive_alpha).values()
         return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
 
@@ -562,105 +621,133 @@ class hexa:
         """Returns `True` if the color has no transparency (`alpha == 1.0`)"""
         return self.to_hsla(False).is_opaque()
 
-    def with_alpha(self, alpha:float) -> 'hexa':
+    def with_alpha(self, alpha: float) -> "hexa":
         """Returns a new color with the specified alpha value"""
         if not (isinstance(alpha, (int, float)) and 0 <= alpha <= 1):
             raise ValueError("'alpha' must be in [0.0, 1.0]")
-        return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(self.a * 255):02X}" if self.a else ""}')
+        return hexa(f'#{self.r:02X}{self.g:02X}{self.b:02X}{f"{int(alpha * 255):02X}" if alpha else ""}')
 
-    def complementary(self) -> 'hexa':
+    def complementary(self) -> "hexa":
         """Returns the complementary color (180 degrees on the color wheel)"""
         return self.to_hsla(False).complementary().to_hexa()
 
 
-
-
 class Color:
 
     @staticmethod
-    def is_valid_rgba(color:str|list|tuple|dict, allow_alpha:bool = True) -> bool:
+    def is_valid_rgba(color: str | list | tuple | dict, allow_alpha: bool = True) -> bool:
         try:
             if isinstance(color, rgba):
                 return True
             elif isinstance(color, (list, tuple)):
                 if allow_alpha and Color.has_alpha(color):
-                    return 0 <= color[0] <= 255 and 0 <= color[1] <= 255 and 0 <= color[2] <= 255 and (0 <= color[3] <= 1 or color[3] is None)
+                    return (
+                        0 <= color[0] <= 255
+                        and 0 <= color[1] <= 255
+                        and 0 <= color[2] <= 255
+                        and (0 <= color[3] <= 1 or color[3] is None)
+                    )
                 return 0 <= color[0] <= 255 and 0 <= color[1] <= 255 and 0 <= color[2] <= 255
             elif isinstance(color, dict):
                 if allow_alpha and Color.has_alpha(color):
-                    return 0 <= color['r'] <= 255 and 0 <= color['g'] <= 255 and 0 <= color['b'] <= 255 and (0 <= color['a'] <= 1 or color['a'] is None)
-                return 0 <= color['r'] <= 255 and 0 <= color['g'] <= 255 and 0 <= color['b'] <= 255
+                    return (
+                        0 <= color["r"] <= 255
+                        and 0 <= color["g"] <= 255
+                        and 0 <= color["b"] <= 255
+                        and (0 <= color["a"] <= 1 or color["a"] is None)
+                    )
+                return 0 <= color["r"] <= 255 and 0 <= color["g"] <= 255 and 0 <= color["b"] <= 255
             elif isinstance(color, str):
                 return bool(_re.fullmatch(Regex.rgba_str(), color))
             return False
-        except: return False
+        except Exception:
+            return False
 
     @staticmethod
-    def is_valid_hsla(color:str|list|tuple|dict, allow_alpha:bool = True) -> bool:
+    def is_valid_hsla(color: str | list | tuple | dict, allow_alpha: bool = True) -> bool:
         try:
             if isinstance(color, hsla):
                 return True
             elif isinstance(color, (list, tuple)):
                 if allow_alpha and Color.has_alpha(color):
-                    return 0 <= color[0] <= 360 and 0 <= color[1] <= 100 and 0 <= color[2] <= 100 and (0 <= color[3] <= 1 or color[3] is None)
+                    return (
+                        0 <= color[0] <= 360
+                        and 0 <= color[1] <= 100
+                        and 0 <= color[2] <= 100
+                        and (0 <= color[3] <= 1 or color[3] is None)
+                    )
                 else:
                     return 0 <= color[0] <= 360 and 0 <= color[1] <= 100 and 0 <= color[2] <= 100
             elif isinstance(color, dict):
                 if allow_alpha and Color.has_alpha(color):
-                    return 0 <= color['h'] <= 360 and 0 <= color['s'] <= 100 and 0 <= color['l'] <= 100 and (0 <= color['a'] <= 1 or color['a'] is None)
+                    return (
+                        0 <= color["h"] <= 360
+                        and 0 <= color["s"] <= 100
+                        and 0 <= color["l"] <= 100
+                        and (0 <= color["a"] <= 1 or color["a"] is None)
+                    )
                 else:
-                    return 0 <= color['h'] <= 360 and 0 <= color['s'] <= 100 and 0 <= color['l'] <= 100
+                    return 0 <= color["h"] <= 360 and 0 <= color["s"] <= 100 and 0 <= color["l"] <= 100
             elif isinstance(color, str):
                 return bool(_re.fullmatch(Regex.hsla_str(), color))
-        except:
+        except Exception:
             return False
 
     @staticmethod
-    def is_valid_hexa(color:str, allow_alpha:bool = True, get_prefix:bool = False) -> bool|tuple[bool,str]:
+    def is_valid_hexa(color: str, allow_alpha: bool = True, get_prefix: bool = False) -> bool | tuple[bool, str]:
         try:
             if isinstance(color, hexa):
-                return (True, '#')
+                return (True, "#")
             elif isinstance(color, int):
                 is_valid = 0 <= color <= (0xFFFFFFFF if allow_alpha else 0xFFFFFF)
-                return (is_valid, '0x') if get_prefix else is_valid
+                return (is_valid, "0x") if get_prefix else is_valid
             else:
-                if color.startswith('#'):
-                    color, prefix = color[1:], '#'
-                elif color.startswith('0x'):
-                    color, prefix = color[2:], '0x'
-                pattern = r'(?i)^[0-9A-F]{8}|[0-9A-F]{6}|[0-9A-F]{4}|[0-9A-F]{3}$' if allow_alpha else r'(?i)^[0-9A-F]{6}|[0-9A-F]{3}$'
+                if color.startswith("#"):
+                    color, prefix = color[1:], "#"
+                elif color.startswith("0x"):
+                    color, prefix = color[2:], "0x"
+                pattern = (
+                    r"(?i)^[0-9A-F]{8}|[0-9A-F]{6}|[0-9A-F]{4}|[0-9A-F]{3}$"
+                    if allow_alpha
+                    else r"(?i)^[0-9A-F]{6}|[0-9A-F]{3}$"
+                )
                 return (bool(_re.fullmatch(pattern, color)), prefix) if get_prefix else bool(_re.fullmatch(pattern, color))
-        except:
+        except Exception:
             return (False, None) if get_prefix else False
 
     @staticmethod
-    def is_valid(color:str|list|tuple|dict, allow_alpha:bool = True) -> bool:
-        return Color.is_valid_hexa(color, allow_alpha) or Color.is_valid_rgba(color, allow_alpha) or Color.is_valid_hsla(color, allow_alpha)
+    def is_valid(color: str | list | tuple | dict, allow_alpha: bool = True) -> bool:
+        return (
+            Color.is_valid_rgba(color, allow_alpha)
+            or Color.is_valid_hsla(color, allow_alpha)
+            or Color.is_valid_hexa(color, allow_alpha)
+        )
 
     @staticmethod
-    def has_alpha(color:rgba|hsla|hexa) -> bool:
+    def has_alpha(color: rgba | hsla | hexa) -> bool:
         """Check if the given color has an alpha channel.\n
         --------------------------------------------------------------------------------
         Input a RGBA, HSLA or HEXA color as `color`.<br>
-        Returns `True` if the color has an alpha channel and `False` otherwise."""
+        Returns `True` if the color has an alpha channel and `False` otherwise.
+        """
         if isinstance(color, (rgba, hsla, hexa)):
             return color.has_alpha()
         if Color.is_valid_hexa(color):
             if isinstance(color, str):
-                if color.startswith('#'):
+                if color.startswith("#"):
                     color = color[1:]
                 return len(color) == 4 or len(color) == 8
             if isinstance(color, int):
-                hex_length = len(f'{color:X}')
+                hex_length = len(f"{color:X}")
                 return hex_length == 4 or hex_length == 8
         elif isinstance(color, (list, tuple)) and len(color) == 4 and color[3] is not None:
             return True
-        elif isinstance(color, dict) and len(color) == 4 and color['a'] is not None:
+        elif isinstance(color, dict) and len(color) == 4 and color["a"] is not None:
             return True
         return False
 
     @staticmethod
-    def to_rgba(color:hsla|hexa) -> rgba:
+    def to_rgba(color: hsla | hexa) -> rgba:
         """Will try to convert any color type to a color of type RGBA."""
         if isinstance(color, (hsla, hexa)):
             return color.to_rgba()
@@ -669,11 +756,15 @@ class Color:
         elif Color.is_valid_hexa(color):
             return hexa(color).to_rgba()
         elif Color.is_valid_rgba(color):
-            return color if isinstance(color, rgba) else rgba(*color) if Color.has_alpha(color) else rgba(color[0], color[1], color[2])
+            return (
+                color
+                if isinstance(color, rgba)
+                else (rgba(*color) if Color.has_alpha(color) else rgba(color[0], color[1], color[2]))
+            )
         raise ValueError(f"Invalid color format '{color}'")
 
     @staticmethod
-    def to_hsla(color:rgba|hexa) -> hsla:
+    def to_hsla(color: rgba | hexa) -> hsla:
         """Will try to convert any color type to a color of type HSLA."""
         if isinstance(color, (rgba, hexa)):
             return color.to_hsla()
@@ -682,11 +773,15 @@ class Color:
         elif Color.is_valid_hexa(color):
             return hexa(color).to_hsla()
         elif Color.is_valid_hsla(color):
-            return color if isinstance(color, hsla) else hsla(*color) if Color.has_alpha(color) else hsla(color[0], color[1], color[2])
+            return (
+                color
+                if isinstance(color, hsla)
+                else (hsla(*color) if Color.has_alpha(color) else hsla(color[0], color[1], color[2]))
+            )
         raise ValueError(f"Invalid color format '{color}'")
 
     @staticmethod
-    def to_hexa(color:rgba|hsla) -> hexa:
+    def to_hexa(color: rgba | hsla) -> hexa:
         """Will try to convert any color type to a color of type HEXA."""
         if isinstance(color, (rgba, hsla)):
             return color.to_hexa()
@@ -695,26 +790,43 @@ class Color:
         elif Color.is_valid_hsla(color):
             return hsla(*color).to_hexa() if Color.has_alpha(color) else hsla(color[0], color[1], color[2]).to_hexa()
         elif Color.is_valid_hexa(color):
-            return color if isinstance(color, hexa) else hexa(f'#{color}')
+            return color if isinstance(color, hexa) else hexa(f"#{color}")
         raise ValueError(f"Invalid color format '{color}'")
 
     @staticmethod
-    def str_to_rgba(string:str, only_first:bool = False) -> rgba|list[rgba]|None:
+    def str_to_rgba(string: str, only_first: bool = False) -> rgba | list[rgba] | None:
         """Will try to recognize RGBA colors inside a string and output the found ones as RGBA objects.<br>
-        If `only_first` is `True` only the first found color will be returned (not as a list)."""
+        If `only_first` is `True` only the first found color will be returned (not as a list).
+        """
         matches = _re.findall(Regex.rgb_str(allow_alpha=True), string)
-        if not matches: return None
-        result = [rgba(int(m[0]), int(m[1]), int(m[2]), ((int(m[3]) if '.' not in m[3] else float(m[3])) if m[3] else None)) for m in matches]
+        if not matches:
+            return None
+        result = [
+            rgba(
+                int(m[0]),
+                int(m[1]),
+                int(m[2]),
+                ((int(m[3]) if "." not in m[3] else float(m[3])) if m[3] else None),
+            )
+            for m in matches
+        ]
         return result[0] if len(result) == 1 or only_first else result
 
     @staticmethod
-    def rgba_to_hex(r:int, g:int, b:int, a:float = None, _preserve_original:bool = False) -> int:
+    def rgba_to_hex_int(
+        r: int,
+        g: int,
+        b: int,
+        a: float = None,
+        _preserve_original: bool = False,
+    ) -> int:
         """Convert RGBA channels to a HEXA integer (alpha is optional).\n
         -------------------------------------------------------------------------------------------------------------------------
         To preserve leading zeros, the function will add a `1` at the beginning, if the HEX value would start with a `0`.<br>
         This could affect the color a little bit, but will make sure, that it won't be interpreted as a completely different<br>
         color, when initializing it as a `hexa()` color or changing it back to RGBA using `Color.hex_to_rgba()`.\n
-        ⇾ **You can disable this behavior by setting `_preserve_original` to `True`**"""
+        ⇾ **You can disable this behavior by setting `_preserve_original` to `True`**
+        """
         r = max(0, min(255, int(r)))
         g = max(0, min(255, int(g)))
         b = max(0, min(255, int(b)))
@@ -732,21 +844,31 @@ class Color:
         return hex_int
 
     @staticmethod
-    def hex_to_rgba(hex_int:int) -> tuple[int,int,int,float|int|None]:
+    def hex_int_to_rgba(hex_int: int) -> tuple[int, int, int, float | int | None]:
         if not isinstance(hex_int, int):
-            raise ValueError('Input must be an integer (hex value)')
-        hex_str = f'{hex_int:x}'
+            raise ValueError("Input must be an integer (hex value)")
+        hex_str = f"{hex_int:x}"
         if len(hex_str) <= 6:
             hex_str = hex_str.zfill(6)
-            return int(hex_str[0:2], 16), int(hex_str[2:4], 16), int(hex_str[4:6], 16), None
+            return (
+                int(hex_str[0:2], 16),
+                int(hex_str[2:4], 16),
+                int(hex_str[4:6], 16),
+                None,
+            )
         elif len(hex_str) <= 8:
             hex_str = hex_str.zfill(8)
-            return int(hex_str[0:2], 16), int(hex_str[2:4], 16), int(hex_str[4:6], 16), int(hex_str[6:8], 16) / 255.0
+            return (
+                int(hex_str[0:2], 16),
+                int(hex_str[2:4], 16),
+                int(hex_str[4:6], 16),
+                int(hex_str[6:8], 16) / 255.0,
+            )
         else:
             raise ValueError(f"Invalid HEX integer '0x{hex_str}': expected in range [0x000000, 0xFFFFFF]")
 
     @staticmethod
-    def luminance(r:int, g:int, b:int, output_type:type = None) -> int|float:
+    def luminance(r: int, g: int, b: int, output_type: type = None) -> int | float:
         """Gets the colors luminance using the luminance formula.\n
         ------------------------------------------------------------
         The param `output_type` can be set to:<br>
@@ -754,46 +876,72 @@ class Color:
         *`float`* =⠀float in [0.0, 1.0]<br>
         `None`    =⠀integer in [0, 255]"""
         r, g, b = r / 255.0, g / 255.0, b / 255.0
-        if r < 0.03928: r = r / 12.92
-        else: r = ((r + 0.055) / 1.055) ** 2.4
-        if g < 0.03928: g = g / 12.92
-        else: g = ((g + 0.055) / 1.055) ** 2.4
-        if b < 0.03928: b = b / 12.92
-        else: b = ((b + 0.055) / 1.055) ** 2.4
+        if r < 0.03928:
+            r = r / 12.92
+        else:
+            r = ((r + 0.055) / 1.055) ** 2.4
+        if g < 0.03928:
+            g = g / 12.92
+        else:
+            g = ((g + 0.055) / 1.055) ** 2.4
+        if b < 0.03928:
+            b = b / 12.92
+        else:
+            b = ((b + 0.055) / 1.055) ** 2.4
         l = 0.2126 * r + 0.7152 * g + 0.0722 * b
         return round(l * 100) if isinstance(output_type, int) else round(l * 255) if output_type is None else l
 
     @staticmethod
-    def text_color_for_on_bg(title_bg_color:rgba|hexa = 0xFFF) -> rgba|hexa:
-        (was_hexa, hexa_prefix), was_int = Color.is_valid_hexa(title_bg_color, get_prefix=True), isinstance(title_bg_color, int)
+    def text_color_for_on_bg(
+        title_bg_color: rgba | hexa = 0xFFF,
+    ) -> rgba | hexa:
+        (was_hexa, hexa_prefix), was_int = Color.is_valid_hexa(title_bg_color, get_prefix=True), isinstance(
+            title_bg_color, int
+        )
         title_bg_color = Color.to_rgba(title_bg_color)
         brightness = 0.2126 * title_bg_color[0] + 0.7152 * title_bg_color[1] + 0.0722 * title_bg_color[2]
-        return (hexa(f'{hexa_prefix}FFF') if was_hexa else rgba(255, 255, 255)) if brightness < 128 else ((0x000 if was_int else hexa(f'{hexa_prefix}000')) if was_hexa else rgba(0, 0, 0))
+        return (
+            (hexa(f"{hexa_prefix}FFF") if was_hexa else rgba(255, 255, 255))
+            if brightness < 128
+            else ((0x000 if was_int else hexa(f"{hexa_prefix}000")) if was_hexa else rgba(0, 0, 0))
+        )
 
     @staticmethod
-    def adjust_lightness(color:rgba|hexa, brightness_change:float) -> rgba|hexa:
+    def adjust_lightness(color: rgba | hexa, brightness_change: float) -> rgba | hexa:
         """In- or decrease the lightness of the input color.\n
         ----------------------------------------------------------------------------------------------------
         **color** (rgba|hexa): HEX or RGBA color<br>
         **brightness_change** (float): float between -1.0 (darken by `100%`) and 1.0 (lighten by `100%`)\n
         ----------------------------------------------------------------------------------------------------
-        **returns** (rgba|hexa): the adjusted color in the format of the input color"""
+        **returns** (rgba|hexa): the adjusted color in the format of the input color
+        """
         was_hexa = Color.is_valid_hexa(color)
         color = Color.to_hsla(color)
-        h, s, l, a = color[0], color[1], color[2], color[3] if Color.has_alpha(color) else None
+        h, s, l, a = (
+            color[0],
+            color[1],
+            color[2],
+            color[3] if Color.has_alpha(color) else None,
+        )
         l = int(max(0, min(100, l + brightness_change * 100)))
         return Color.to_hexa((h, s, l, a)) if was_hexa else Color.to_rgba((h, s, l, a))
 
     @staticmethod
-    def adjust_saturation(color:rgba|hexa, saturation_change:float) -> rgba|hexa:
+    def adjust_saturation(color: rgba | hexa, saturation_change: float) -> rgba | hexa:
         """In- or decrease the saturation of the input color.\n
         ---------------------------------------------------------------------------------------------------------
         **color** (rgba|hexa): HEX or RGBA color<br>
         **saturation_change** (float): float between -1.0 (saturate by `100%`) and 1.0 (desaturate by `100%`)\n
         ---------------------------------------------------------------------------------------------------------
-        **returns** (rgba|hexa): the adjusted color in the format of the input color"""
+        **returns** (rgba|hexa): the adjusted color in the format of the input color
+        """
         was_hexa = Color.is_valid_hexa(color)
         color = Color.to_hsla(color)
-        h, s, l, a = color[0], color[1], color[2], color[3] if Color.has_alpha(color) else None
+        h, s, l, a = (
+            color[0],
+            color[1],
+            color[2],
+            color[3] if Color.has_alpha(color) else None,
+        )
         s = int(max(0, min(100, s + saturation_change * 100)))
         return Color.to_hexa((h, s, l, a)) if was_hexa else Color.to_rgba((h, s, l, a))