#1106 Add the class method to get an on_primary color setting from setting.

Author: simon-ritchie

apysc/_material_design/setting/material_settings_utils.py

@@ -162,3 +162,27 @@ def get_primary_color(cls, *, argument_color: Optional[Color]) -> Color:
             color_name="primary",
             argument_color=argument_color,
         )
+
+    @classmethod
+    def get_on_primary_color(cls, *, argument_color: Optional[Color]) -> Color:
+        """
+        Get an `on_primary` color setting from setting.
+
+        Parameters
+        ----------
+        argument_color : Optional[Color]
+            A specified argument color.
+
+        Returns
+        -------
+        target_color : Color
+            A target on-primary color.
+            This value becomes according to the following priorities:
+            1. If the `argument_color` is not the `None`
+            2. If a color scheme is set in the `MaterialSettings`
+            3. A fixed color value.
+        """
+        return cls._get_target_color_and_add_expressions_by_color_name(
+            color_name="on_primary",
+            argument_color=argument_color,
+        )

tests/_material_design/setting/test_material_settings_utils.py

@@ -62,3 +62,10 @@ def test_get_primary_color(self) -> None:
             argument_color=None
         )
         assert target_color == ap.MaterialSettingsUtils._fixed_color_scheme.primary
+
+    @apply_test_settings()
+    def test_get_on_primary_color(self) -> None:
+        target_color: ap.Color = ap.MaterialSettingsUtils.get_on_primary_color(
+            argument_color=None
+        )
+        assert target_color == ap.MaterialSettingsUtils._fixed_color_scheme.on_primary