molde 0.1.13__py3-none-any.whl → 0.1.14__py3-none-any.whl

molde/colors/color.py

@@ -1,8 +1,10 @@
 import typing
 from qtpy.QtGui import QColor
 import numpy as np
+from dataclasses import dataclass
 
 
+@dataclass(frozen=True, init=False)
 class Color:
     r: int
     g: int
@@ -10,19 +12,19 @@ class Color:
     a: int
 
     @typing.overload
-    def __init__(self, r: int, g: int, b: int, a: int = 255):
+    def __new__(self, r: int, g: int, b: int, a: int = 255):
         """
         Initialize Colors with RGB or RGBA integer values ranging from 0 to 255.
         """
 
     @typing.overload
-    def __init__(self, r: float, g: float, b: float, a: float = 1.0):
+    def __new__(self, r: float, g: float, b: float, a: float = 1.0):
         """
         Initialize Colors with RGB or RGBA floating values ranging from 0.0 to 1.0.
         """
 
     @typing.overload
-    def __init__(self, hexa: str):
+    def __new__(self, hexa: str):
         """
         Initialize colors from hex values.
         The valid formats incluce RGB (#FF0000 for example)
@@ -30,61 +32,79 @@ class Color:
         """
 
     @typing.overload
-    def __init__(self, qcolor: QColor):
+    def __new__(self, qcolor: QColor):
         """
         Initialize the color class with an instance of QColor
         """
 
     @typing.overload
-    def __init__(self, color: "Color"):
+    def __new__(self, color: "Color"):
         """
         Initialize the color class with an instance it's own class
         """
 
     @typing.overload
-    def __init__(self):
+    def __new__(self):
         """
         Initialize an empty black color
         """
 
-    def __init__(self, *args):
+    def __new__(cls, *args):
+        """
+        Calls the appropriate constructor for the class according to the
+        number of arguments and their types.
+        """
+
         all_int = all([isinstance(i, int) for i in args])
         all_float = all([isinstance(i, float) for i in args])
 
         if len(args) == 0:
-            self.from_rgba(0, 0, 0, 255)
+            return cls.from_rgba(0, 0, 0, 255)
 
         elif len(args) == 1 and isinstance(args[0], str):
-            self.from_hex(*args)
+            return cls.from_hex(*args)
 
         elif len(args) == 1 and isinstance(args[0], QColor):
-            self.from_qcolor(*args)
+            return cls.from_qcolor(*args)
 
         elif len(args) == 1 and isinstance(args[0], Color):
-            self.from_color(*args)
+            return cls.from_color(*args)
 
         elif len(args) in [3, 4] and all_int:
-            self.from_rgba(*args)
+            return cls.from_rgba(*args)
 
         elif len(args) in [3, 4] and all_float:
-            self.from_rgba_f(*args)
+            return cls.from_rgba_f(*args)
 
         else:
             raise ValueError("Invalid input values")
 
+    @classmethod
+    def from_rgba(cls, r: int, g: int, b: int, a: int = 255) -> "Color":
+        """
+        This is the default constructor for the class.
+        All other constructors call this one.
+
+        Since "Color" should be imutable, we use "object.__setattr__" to bypass
+        the imutability just in the constructor.
+        """
+
+        obj = super().__new__(cls)
+        object.__setattr__(obj, "r", round(np.clip(r, 0, 255)))
+        object.__setattr__(obj, "g", round(np.clip(g, 0, 255)))
+        object.__setattr__(obj, "b", round(np.clip(b, 0, 255)))
+        object.__setattr__(obj, "a", round(np.clip(a, 0, 255)))
+        return obj
+
+    @classmethod
     def from_rgb(self, r: int, g: int, b: int) -> "Color":
         return self.from_rgba(r, g, b)
 
-    def from_rgba(self, r: int, g: int, b: int, a: int = 255) -> "Color":
-        self.r = round(np.clip(r, 0, 255))
-        self.g = round(np.clip(g, 0, 255))
-        self.b = round(np.clip(b, 0, 255))
-        self.a = round(np.clip(a, 0, 255))
-        return self
-
+    @classmethod
     def from_rgb_f(self, r: float, g: float, b: float) -> "Color":
         return self.from_rgba_f(r, g, b)
 
+    @classmethod
     def from_rgba_f(self, r: float, g: float, b: float, a: float = 1) -> "Color":
         return self.from_rgba(
             round(r * 255),
@@ -93,6 +113,7 @@ class Color:
             round(a * 255),
         )
 
+    @classmethod
     def from_hex(self, color: str) -> "Color":
         color = color.lstrip("#")
         if len(color) == 6:
@@ -103,6 +124,7 @@ class Color:
             return self.from_rgba(r, g, b, a)
         raise ValueError("Invalid hex color format")
 
+    @classmethod
     def from_hsv(self, hue: float, saturation: float, value: float):
         v = value / 100
         s = saturation / 100
@@ -111,17 +133,17 @@ class Color:
         h = hue / 60
         x = c * (1 - abs(h % 2 - 1))
 
-        if 0 < h < 1:
+        if 0 <= h < 1:
             r, g, b = c, x, 0
-        elif 1 < h < 2:
+        elif 1 <= h < 2:
             r, g, b = x, c, 0
-        elif 2 < h < 3:
+        elif 2 <= h < 3:
             r, g, b = 0, c, x
-        elif 3 < h < 4:
+        elif 3 <= h < 4:
             r, g, b = 0, x, c
-        elif 4 < h < 5:
+        elif 4 <= h < 5:
             r, g, b = x, 0, c
-        elif 5 < h < 6:
+        elif 5 <= h < 6:
             r, g, b = c, 0, x
         else:
             r, g, b = 0, 0, 0
@@ -132,9 +154,11 @@ class Color:
             (b + v - c),
         )
 
+    @classmethod
     def from_qcolor(self, color: QColor) -> "Color":
         return self.from_rgba(color.red(), color.green(), color.blue(), color.alpha())
 
+    @classmethod
     def from_color(self, color: "Color"):
         self.r = color.r
         self.g = color.g
@@ -165,7 +189,9 @@ class Color:
         min_, mid_, max_ = sorted((r, g, b))
         delta = max_ - min_
 
-        if max_ == r:
+        if delta == 0:
+            hue = 0
+        elif max_ == r:
             hue = (g - b) / delta
         elif max_ == g:
             hue = (b - r) / delta + 2
@@ -198,13 +224,47 @@ class Color:
 
         return new_color
 
-    def set_brightness(self, brightness: int) -> "Color":
+    def with_brightness(self, brightness: int) -> "Color":
+        """
+        Percentage of brightness of the new color.
+        """
         h, s, _ = self.to_hsv()
-        return self.to_hsv(h, s, brightness)
+        return self.from_hsv(h, s, brightness)
 
-    def set_saturation(self, saturation: int) -> "Color":
+    def with_saturation(self, saturation: int) -> "Color":
+        """
+        Percentage of brightness of the new color.
+        """
         h, _, v = self.to_hsv()
-        return self.to_hsv(h, saturation, v)
+        return self.from_hsv(h, saturation, v)
+
+    def with_rgba(
+        self,
+        r: int | None = None,
+        g: int | None = None,
+        b: int | None = None,
+        a: int | None = None,
+    ) -> "Color":
+        return self.from_rgba(
+            r if (r is not None) else self.r,
+            g if (g is not None) else self.g,
+            b if (b is not None) else self.b,
+            a if (a is not None) else self.a,
+        )
+
+    def with_rgba_f(
+        self,
+        r: int | None = None,
+        g: int | None = None,
+        b: int | None = None,
+        a: int | None = None,
+    ) -> "Color":
+        return self.from_rgba_f(
+            r if (r is not None) else self.r,
+            g if (g is not None) else self.g,
+            b if (b is not None) else self.b,
+            a if (a is not None) else self.a,
+        )
 
     def __repr__(self):
         return f"Color(r={self.r}, g={self.g}, b={self.b}, a={self.a})"

{molde-0.1.13.dist-info → molde-0.1.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: molde
-Version: 0.1.13
+Version: 0.1.14
 Summary: 
 Author: André Fernandes
 Author-email: fpf.andre@gmail.com

{molde-0.1.13.dist-info → molde-0.1.14.dist-info}/RECORD

@@ -7,7 +7,7 @@ molde/actors/lines_actor.py,sha256=EI2jnaHMVIa7Ru6rDWRnei8_UlRbYz9rMbu4Z0pcjJk,1
 molde/actors/round_points_actor.py,sha256=z2-xAS70LAupK2ZNjgSDI7jtylGqljwp1RUQJv0Rn5U,222
 molde/actors/square_points_actor.py,sha256=FdtPWHPCd9Ll6M4xmEkfGpaj98JzsLS0ZUcIkY1f8jw,1147
 molde/colors/__init__.py,sha256=1btZnmV8oHnqK6n9vzB9rLrUAQg7YxnRALSXUtH2NlM,51
-molde/colors/color.py,sha256=AIYDSQYg4s7eB2K_hja8w6n_CLRR-hBvxUEluxUmCIg,6321
+molde/colors/color.py,sha256=k8vkngW6VQx6GCHyp2g5rU2HDqEF96xCMHWv-f-u_7g,8076
 molde/colors/color_names.py,sha256=e4kluhl8BRxiZKs1DE8nfmGtIbTeyli_yje1eb_Jxk0,2958
 molde/fonts/IBMPlexMono-Bold.ttf,sha256=ykA8VpMbrvMH0gumS2mstxq8rWH3XmZBRmHVdIS2kOw,157924
 molde/fonts/IBMPlexMono-Regular.ttf,sha256=_hEwSl_pVtV0TptqJGzIPZBCUkXnWmIjAESWbKlqf1A,155940
@@ -63,6 +63,6 @@ molde/utils/format_sequences.py,sha256=RHxWGpWBRi89jTk3F4sdlGsKqeheRD49PZMeM36Rs
 molde/utils/poly_data_utils.py,sha256=WoeW46ciuSZB4KO9oh0ksPoxARUbheQDROcjwlpjL4c,2125
 molde/utils/tree_info.py,sha256=FxgT_uKjtgi0-NVcH41LBoqRmAKt26NJmsjBk1WTqt8,1760
 molde/windows/loading_window.py,sha256=3U1VEujSKWWWIu1aSqSkYCupTpstI0xks6csJhdKh5Y,6288
-molde-0.1.13.dist-info/METADATA,sha256=FYU-9RbnBvEwa-9QoFLJ06uLGdfHDaoxRWPTrUkqkgU,2102
-molde-0.1.13.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-molde-0.1.13.dist-info/RECORD,,
+molde-0.1.14.dist-info/METADATA,sha256=o3bbxUxSLWe6TnOGGNW2a7mECUpKcnda0ermhbN7LEQ,2102
+molde-0.1.14.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+molde-0.1.14.dist-info/RECORD,,