feat: add features_human with raw-key fallback for unknown features

Author: Fivell

src/didww/resources/did_group.py

@@ -3,6 +3,17 @@
 
 
 class DidGroup(DidwwApiModel):
+    FEATURES = {
+        "voice_in": "Voice IN",
+        "voice_out": "Voice OUT",
+        "t38": "T.38 Fax",
+        "sms_in": "SMS IN",
+        "p2p": "P2P SMS",
+        "a2p": "A2P SMS",
+        "emergency": "Emergency",
+        "cnam_out": "CNAM OUT",
+    }
+
     prefix = SafeAttributeField("prefix")
     features = EnumListAttributeField("features", Feature)
     is_metered = SafeAttributeField("is_metered")
@@ -20,6 +31,12 @@ class DidGroup(DidwwApiModel):
     class Meta:
         type = "did_groups"
 
+    @property
+    def features_human(self):
+        """Map feature keys to human-readable labels, falling back to raw key for unknown features."""
+        raw_features = self.attributes.get("features") or []
+        return [self.FEATURES.get(f, f) for f in raw_features]
+
 
 class DidGroupRepository(ReadOnlyRepository):
     _resource_class = DidGroup

tests/resources/test_did_group.py

@@ -1,4 +1,5 @@
 from didww.enums import Feature, IdentityType, AreaLevel
+from didww.resources.did_group import DidGroup
 from tests.conftest import my_vcr
 from didww.query_params import QueryParams
 
@@ -11,6 +12,35 @@ def test_new_features_enum_values(self):
         assert Feature.CNAM_OUT.value == "cnam_out"
 
 
+class TestDidGroupFeaturesHuman:
+    def test_features_human_maps_known_features(self):
+        dg = DidGroup()
+        dg.attributes["features"] = ["t38", "voice_in"]
+        assert dg.features_human == ["T.38 Fax", "Voice IN"]
+
+    def test_features_human_falls_back_to_raw_key_for_unknown(self):
+        dg = DidGroup()
+        dg.attributes["features"] = ["voice_in", "future_unknown_feature"]
+        assert dg.features_human == ["Voice IN", "future_unknown_feature"]
+
+    def test_features_human_empty_list(self):
+        dg = DidGroup()
+        dg.attributes["features"] = []
+        assert dg.features_human == []
+
+    def test_features_human_none(self):
+        dg = DidGroup()
+        assert dg.features_human == []
+
+    def test_features_human_all_known_features(self):
+        dg = DidGroup()
+        dg.attributes["features"] = ["voice_in", "voice_out", "t38", "sms_in", "p2p", "a2p", "emergency", "cnam_out"]
+        assert dg.features_human == [
+            "Voice IN", "Voice OUT", "T.38 Fax", "SMS IN",
+            "P2P SMS", "A2P SMS", "Emergency", "CNAM OUT",
+        ]
+
+
 class TestDidGroup:
     @my_vcr.use_cassette("did_groups/list.yaml")
     def test_list_did_groups(self, client):