Add common types for natively Json objects

server/entertainment_decider/common/__init__.py

@@ -20,9 +20,23 @@ from ._string import (
 from ._subprocess import (
     call,
 )
+from ._types import (
+    JsonContainer,
+    JsonLeaf,
+    JsonList,
+    JsonMapping,
+    JsonMappingKey,
+    JsonRepr,
+)
 
 
 __all__ = [
+    "JsonContainer",
+    "JsonLeaf",
+    "JsonList",
+    "JsonMapping",
+    "JsonMappingKey",
+    "JsonRepr",
     "all_same",
     "call",
     "date_to_datetime",

server/entertainment_decider/common/_types.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from collections.abc import (
+    Sequence,
+    Mapping,
+)
+from typing import (
+    TypeAlias,
+)
+
+
+JsonMappingKey: TypeAlias = str | int | float
+"""type for use in JSON mappings as key"""
+JsonLeaf: TypeAlias = JsonMappingKey | bool | None
+"""object natively mapping to JSON as values excluding containers"""
+
+JsonMapping: TypeAlias = Mapping[JsonMappingKey, "JsonRepr"]
+"""mapping natively mapping to JSON"""
+JsonList: TypeAlias = Sequence["JsonRepr"]
+"""list natively mapping to JSON"""
+JsonContainer: TypeAlias = JsonList | JsonMapping
+"""container natively mapping to JSON"""
+
+JsonRepr: TypeAlias = JsonContainer | JsonLeaf
+"""object natively mapping to JSON"""