GeneralManager 0.4.4__py3-none-any.whl → 0.4.5__py3-none-any.whl

general_manager/measurement/measurement.py

@@ -56,7 +56,22 @@ class Measurement:
 
     @classmethod
     def from_string(cls, value: str) -> Measurement:
-        value, unit = value.split(" ")
+        """
+        Creates a Measurement instance from a string in the format 'value unit'.
+        
+        Args:
+            value: A string containing a numeric value and a unit separated by a space (e.g., '10.5 kg').
+        
+        Returns:
+            A Measurement instance representing the parsed value and unit.
+        
+        Raises:
+            ValueError: If the input string does not contain exactly two parts separated by a space.
+        """
+        splitted = value.split(" ")
+        if len(splitted) != 2:
+            raise ValueError("String must be in the format 'value unit'.")
+        value, unit = splitted
         return cls(value, unit)
 
     @staticmethod
@@ -202,12 +217,31 @@ class Measurement:
         return f"Measurement({self.quantity.magnitude}, '{self.quantity.units}')"
 
     def _compare(self, other: Any, operation: Callable[..., bool]) -> bool:
+        """
+        Compares this Measurement with another using the specified comparison operation.
+        
+        If `other` is a string, it is parsed into a Measurement. Raises a TypeError if
+        `other` is not a Measurement instance. Converts `other` to this instance's unit
+        before applying the comparison. Raises a ValueError if the measurements have
+        incompatible dimensions.
+        
+        Args:
+            other: The object to compare with, either a Measurement or a string in the format "value unit".
+            operation: A callable that takes two magnitudes and returns a boolean result.
+        
+        Returns:
+            The result of the comparison operation.
+        
+        Raises:
+            TypeError: If `other` is not a Measurement instance or a valid string representation.
+            ValueError: If the measurements have different dimensions and cannot be compared.
+        """
         if isinstance(other, str):
             other = Measurement.from_string(other)
 
         # Überprüfen, ob `other` ein Measurement-Objekt ist
         if not isinstance(other, Measurement):
-            return NotImplemented
+            raise TypeError("Comparison is only allowed between Measurement instances.")
         try:
             # Convert `other` to the same units as `self`
             other_converted: pint.Quantity = other.quantity.to(self.quantity.units)  # type: ignore
@@ -238,4 +272,17 @@ class Measurement:
         return self._compare(other, gt)
 
     def __ge__(self, other: Any) -> bool:
+        """
+        Returns True if this measurement is greater than or equal to another measurement.
+        
+        Comparison is performed after converting the other operand to the same unit. Raises a TypeError if the other object is not a Measurement instance or a compatible string, or a ValueError if the units are not compatible.
+        """
         return self._compare(other, ge)
+
+    def __hash__(self) -> int:
+        """
+        Returns a hash value based on the magnitude and unit of the measurement.
+        
+        This enables Measurement instances to be used in hash-based collections such as sets and dictionaries.
+        """
+        return hash((self.quantity.magnitude, str(self.quantity.units)))

{generalmanager-0.4.4.dist-info → generalmanager-0.4.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.4.4
+Version: 0.4.5
 Summary: Kurzbeschreibung deines Pakets
 Author-email: Tim Kleindick <tkleindick@yahoo.de>
 License-Expression: MIT

{generalmanager-0.4.4.dist-info → generalmanager-0.4.5.dist-info}/RECORD

@@ -28,7 +28,7 @@ general_manager/manager/groupManager.py,sha256=O4FABqbm7KlZw6t36Ot3HU1FsBYN0h6Zh
 general_manager/manager/input.py,sha256=iKawV3P1QICz-0AQUF00OvH7LZYxussg3svpvCUl8hE,2977
 general_manager/manager/meta.py,sha256=5wHrCVnua5c38vpVZSCesrNvgydQDH8h6pxW6_QgCDg,3107
 general_manager/measurement/__init__.py,sha256=X97meFujBldE5v0WMF7SmKeGpC5R0JTczfLo_Lq1Xek,84
-general_manager/measurement/measurement.py,sha256=IMUY8vmoEIrclMW9FWLgL2Wi61rH1J0NMSmjYdMkMHM,9516
+general_manager/measurement/measurement.py,sha256=e_FjHieeJbBtjXGCO9J7vRPw6KCkMrOxwWjaD0m8ee4,11777
 general_manager/measurement/measurementField.py,sha256=iq9Hqe6ZGX8CxXm4nIqTAWTRkQVptzpqE9ExX-jFyNs,5928
 general_manager/permission/__init__.py,sha256=5UlDERN60Vn8obGVkT-cOM8kHjzmoxgK5w5FgTCDhGE,59
 general_manager/permission/basePermission.py,sha256=PsJiX-UNeSh6xUlcUwuQNCLYvHZipWUJ0kAoMkdxXJc,6113
@@ -39,8 +39,8 @@ general_manager/permission/permissionDataManager.py,sha256=Ji7fsnuaKTa6M8yzCGyzr
 general_manager/rule/__init__.py,sha256=4Har5cfPD1fmOsilTDod-ZUz3Com-tkl58jz7yY4fD0,23
 general_manager/rule/handler.py,sha256=z8SFHTIZ0LbLh3fV56Mud0V4_OvWkqJjlHvFqau7Qfk,7334
 general_manager/rule/rule.py,sha256=3FVCKGL7BTVoStdgOTdWQwuoVRIxAIAilV4VOzouDpc,10759
-generalmanager-0.4.4.dist-info/licenses/LICENSE,sha256=YGFm0ieb4KpkMRRt2qnWue6uFh0cUMtobwEBkHwajhc,1450
-generalmanager-0.4.4.dist-info/METADATA,sha256=UKE3ErZAUTQn1MAwFom9YVQP-uNDPDvkXKRL-X9fRuU,6528
-generalmanager-0.4.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-generalmanager-0.4.4.dist-info/top_level.txt,sha256=sTDtExP9ga-YP3h3h42yivUY-A2Q23C2nw6LNKOho4I,16
-generalmanager-0.4.4.dist-info/RECORD,,
+generalmanager-0.4.5.dist-info/licenses/LICENSE,sha256=YGFm0ieb4KpkMRRt2qnWue6uFh0cUMtobwEBkHwajhc,1450
+generalmanager-0.4.5.dist-info/METADATA,sha256=XtO9PCJmtFWR-pPXbRZ_EaV4b0SwgbVSWsHhusr9FKQ,6528
+generalmanager-0.4.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+generalmanager-0.4.5.dist-info/top_level.txt,sha256=sTDtExP9ga-YP3h3h42yivUY-A2Q23C2nw6LNKOho4I,16
+generalmanager-0.4.5.dist-info/RECORD,,