literalenum 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

{literalenum-0.3.0.dist-info → literalenum-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: literalenum
-Version: 0.3.0
+Version: 0.4.0
 Summary: A Python typing construct that provides namespaced literal constants with advanced typing features.
 Project-URL: Homepage, https://github.com/modularizer/literalenum
 Project-URL: Repository, https://github.com/modularizer/literalenum

{literalenum-0.3.0.dist-info → literalenum-0.4.0.dist-info}/RECORD

@@ -18,10 +18,10 @@ literalenum/compatibility_extensions/regex.py,sha256=4XDtC8VlehMlcZkcE5L9nXbKkR4
 literalenum/compatibility_extensions/sqlalchemy_enum.py,sha256=DF_ce3Q7YNp98mTFXPsyWagQVzTTaczI-dRklOPh_LY,237
 literalenum/compatibility_extensions/str_enum.py,sha256=y-VWFyaEDXmNicgyqzdEpsx-ImUdnydbF_YWhzvEVq0,329
 literalenum/compatibility_extensions/strawberry_enum.py,sha256=mjg3Pyy0w_AggRRB_UtuWQiOguiG66eTN5E_rpwd7cg,526
-typing_literalenum.py,sha256=eIhM_dGUR9Eu1PqQr78wKk0CH_IUUIS6cy1_pPEkPss,26653
+typing_literalenum.py,sha256=CKU4EBfMDZisrK8d9exWwp6sJhznJYp998oaRM5Igjs,27936
 literalenum/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-literalenum-0.3.0.dist-info/METADATA,sha256=r6KARro6c4xHELgYgAkQighvv6Qv3E54aHtG5xmuOj4,4819
-literalenum-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-literalenum-0.3.0.dist-info/entry_points.txt,sha256=AK8je10LoLMOXuWLjXSqHV2rsTxPW9HlG7YTJGfwkCY,46
-literalenum-0.3.0.dist-info/licenses/LICENSE,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
-literalenum-0.3.0.dist-info/RECORD,,
+literalenum-0.4.0.dist-info/METADATA,sha256=JA3sd54K2v5bhuOxtfnVroNnsGVajcRQeNMJ9fFzpVI,4819
+literalenum-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+literalenum-0.4.0.dist-info/entry_points.txt,sha256=AK8je10LoLMOXuWLjXSqHV2rsTxPW9HlG7YTJGfwkCY,46
+literalenum-0.4.0.dist-info/licenses/LICENSE,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
+literalenum-0.4.0.dist-info/RECORD,,

typing_literalenum.py

@@ -370,6 +370,48 @@ class LiteralEnumMeta(type):
             for names in cls._value_names_.values()
         })
 
+    @property
+    def name_mapping(cls) -> Mapping[Any, str]:
+        """A read-only ``{value: canonical_name}`` inverse mapping.
+
+        Each unique value maps to its first-declared (canonical) name::
+
+            class Method(LiteralEnum):
+                GET = "GET"
+                get = "GET"       # alias
+
+            Method.name_mapping   # {"GET": "GET"}
+
+        See also :attr:`names_mapping` for all names including aliases.
+        """
+        return MappingProxyType({
+            v: names[0]
+            for v, names in zip(cls._ordered_values_, cls._value_names_.values())
+        })
+
+    @property
+    def names_by_value(cls) -> Mapping[Any, str]:
+        return cls.name_mapping
+
+
+    @property
+    def names_mapping(cls) -> Mapping[Any, tuple[str, ...]]:
+        """A read-only ``{value: (name, ...)}`` inverse mapping.
+
+        Each unique value maps to a tuple of all its declared names
+        (canonical first, then aliases)::
+
+            class Method(LiteralEnum):
+                GET = "GET"
+                get = "GET"       # alias
+
+            Method.names_mapping  # {"GET": ("GET", "get")}
+        """
+        return MappingProxyType({
+            v: names
+            for v, names in zip(cls._ordered_values_, cls._value_names_.values())
+        })
+
     def keys(cls) -> tuple[str, ...]:
         """Return canonical member names in definition order (aliases excluded)."""
         return tuple(