Defines has_no_units methods for composite dimensions

Author: Maxcode123

src/property_utils/tests/units/test_descriptors.py

@@ -2006,6 +2006,14 @@ def test_with_aliased_denominator_composite_dimension(self):
     def test_with_fully_aliased_composite_dimension(self):
         self.assertResultTrue()
 
+@add_to(GenericCompositeDimension_test_suite)
+class TestGenericCompositeDimensionHasNoUnits(TestDescriptor):
+    def test_with_measurement_units(self):
+        self.assertFalse(generic_composite_dimension().has_no_units())
+
+    def test_with_no_measurement_units(self):
+        self.assertTrue(GenericCompositeDimension().has_no_units())
+
 
 @add_to(CompositeDimension_test_suite)
 class TestCompositeDimensionFromDescriptor(TestDescriptor):
@@ -2568,6 +2576,19 @@ def test_objects_are_not_persisted(self):
         self.assertNotEqual(ids(composite.numerator), ids(inverse.denominator))
         self.assertNotEqual(ids(composite.denominator), ids(inverse.numerator))
 
+@add_to(CompositeDimension_test_suite)
+class TestCompositeDimensionHasNoUnits(TestDescriptor):
+    def test_with_units(self):
+        self.assertFalse(composite_dimension().has_no_units())
+
+    def test_with_no_units(self):
+        self.assertTrue(CompositeDimension().has_no_units())
+
+    def test_with_same_unit_type(self):
+        self.assertFalse(CompositeDimension([Unit1.A],[Unit1.a]).has_no_units())
+
+    def test_with_same_unit(self):
+        self.assertFalse(CompositeDimension([Unit1.A],[Unit1.A]).has_no_units())
 
 @add_to(CompositeDimension_test_suite)
 class TestCompositeDimensionMultiplication(TestDescriptorBinaryOperation):

src/property_utils/units/descriptors.py

@@ -1314,6 +1314,21 @@ def is_equivalent(self, other: GenericUnitDescriptor) -> bool:
 
         return False
 
+    def has_no_units(self) -> bool:
+        """
+        Returns True if the generic composite dimension does not have any units, False
+        otherwise.
+
+        Examples:
+            >>> class LengthUnit(MeasurementUnit): ...
+
+            >>> GenericCompositeDimension().has_no_units()
+            True
+            >>> GenericCompositeDimension([LengthUnit]).has_no_units()
+            False
+        """
+        return len(self.denominator) == 0 and len(self.numerator) == 0
+
     def _numerator_copy(self) -> List[GenericDimension]:
         return [replace(n) for n in self.numerator]
 
@@ -1743,6 +1758,21 @@ def inverse(self) -> "CompositeDimension":
         """
         return CompositeDimension(self._denominator_copy(), self._numerator_copy())
 
+    def has_no_units(self) -> bool:
+        """
+        Returns True if the composite dimension does not have any units, False otherwise.
+
+        Examples:
+            >>> class LengthUnit(MeasurementUnit):
+            ...     METER = "m"
+
+            >>> CompositeDimension().has_no_units()
+            True
+            >>> CompositeDimension([LengthUnit.METER]).has_no_units()
+            False
+        """
+        return len(self.denominator) == 0 and len(self.numerator) == 0
+
     def _numerator_copy(self) -> List[Dimension]:
         return [replace(n) for n in self.numerator]