python-didl-lite 1.5.1__tar.gz → 1.5.2__tar.gz

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-didl-lite
-Version: 1.5.1
+Version: 1.5.2
 Summary: DIDL-Lite (Digital Item Declaration Language) tools for Python
 Author-email: Steven Looman <steven.looman@gmail.com>
 License-Expression: Apache-2.0
@@ -9,12 +9,12 @@ Keywords: DIDL,DIDL-lite
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.10
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 Requires-Dist: defusedxml>=0.6.0
 Provides-Extra: test

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/didl_lite/__init__.py

@@ -2,4 +2,4 @@
 
 from didl_lite import didl_lite  # noqa: F401
 
-__version__ = "1.5.1"
+__version__ = "1.5.2"

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/didl_lite/didl_lite.py

@@ -2,19 +2,8 @@
 # pylint: disable=too-many-lines
 
 import re
-from typing import (
-    Any,
-    Dict,
-    Iterable,
-    List,
-    Mapping,
-    Optional,
-    Sequence,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
+from collections.abc import Iterable, Mapping, Sequence
+from typing import Any, Self
 from xml.etree import ElementTree as ET
 
 import defusedxml.ElementTree
@@ -28,11 +17,6 @@ from .utils import (
     to_camel_case,
 )
 
-TDO = TypeVar("TDO", bound="DidlObject")  # pylint: disable=invalid-name
-TC = TypeVar("TC", bound="Container")  # pylint: disable=invalid-name
-TD = TypeVar("TD", bound="Descriptor")  # pylint: disable=invalid-name
-TR = TypeVar("TR", bound="Resource")  # pylint: disable=invalid-name
-
 
 class DidlLiteException(Exception):
     """DIDL Lite Exception."""
@@ -41,16 +25,16 @@ class DidlLiteException(Exception):
 # region: DidlObjects
 
 # upnp_class to python type mapping
-_upnp_class_map: Dict[str, Type["DidlObject"]] = {}
-_upnp_class_map_lowercase: Dict[str, Type["DidlObject"]] = {}
+_upnp_class_map: dict[str, type["DidlObject"]] = {}
+_upnp_class_map_lowercase: dict[str, type["DidlObject"]] = {}
 
 
 class DidlObject:
     """DIDL Object."""
 
-    tag: Optional[str] = None
+    tag: str | None = None
     upnp_class: str = "object"
-    didl_properties_defs: List[Tuple[str, str, str]] = [
+    didl_properties_defs: list[tuple[str, str, str]] = [
         ("didl_lite", "@id", "R"),
         ("didl_lite", "@parentID", "R"),
         ("didl_lite", "@restricted", "R"),
@@ -63,12 +47,12 @@ class DidlObject:
 
     id: str
     parent_id: str
-    res: List["Resource"]
-    xml_el: Optional[ET.Element]
+    res: list["Resource"]
+    xml_el: ET.Element | None
     descriptors: Sequence["Descriptor"]
 
     @classmethod
-    def __init_subclass__(cls: Type["DidlObject"], **kwargs: Any) -> None:
+    def __init_subclass__(cls: type["DidlObject"], **kwargs: Any) -> None:
         """Create mapping of upnp_class to Python type for fast lookup."""
         super().__init_subclass__(**kwargs)
         assert cls.upnp_class not in _upnp_class_map
@@ -80,8 +64,8 @@ class DidlObject:
         self,
         id: str = "",
         parent_id: str = "",
-        descriptors: Optional[Sequence["Descriptor"]] = None,
-        xml_el: Optional[ET.Element] = None,
+        descriptors: Sequence["Descriptor"] | None = None,
+        xml_el: ET.Element | None = None,
         strict: bool = True,
         **properties: Any,
     ) -> None:
@@ -124,14 +108,14 @@ class DidlObject:
             setattr(self, key, value)
 
     @classmethod
-    def from_xml(cls: Type[TDO], xml_el: ET.Element, strict: bool = True) -> TDO:
+    def from_xml(cls, xml_el: ET.Element, strict: bool = True) -> Self:
         """
         Initialize from an XML node.
 
         I.e., parse XML and return instance.
         """
         # pylint: disable=too-many-locals
-        properties = {}  # type: Dict[str, Any]
+        properties: dict[str, Any] = {}
 
         # attributes
         for attr_key, attr_value in xml_el.attrib.items():
@@ -613,8 +597,8 @@ class Container(DidlObject, list):
         self,
         id: str = "",
         parent_id: str = "",
-        descriptors: Optional[Sequence["Descriptor"]] = None,
-        xml_el: Optional[ET.Element] = None,
+        descriptors: Sequence["Descriptor"] | None = None,
+        xml_el: ET.Element | None = None,
         strict: bool = True,
         children: Iterable[DidlObject] = (),
         **properties: Any,
@@ -625,7 +609,7 @@ class Container(DidlObject, list):
         self.extend(children)
 
     @classmethod
-    def from_xml(cls: Type[TC], xml_el: ET.Element, strict: bool = True) -> TC:
+    def from_xml(cls, xml_el: ET.Element, strict: bool = True) -> Self:
         """
         Initialize from an XML node.
 
@@ -903,19 +887,19 @@ class Resource:
 
     def __init__(
         self,
-        uri: Optional[str],
-        protocol_info: Optional[str],
-        import_uri: Optional[str] = None,
-        size: Optional[str] = None,
-        duration: Optional[str] = None,
-        bitrate: Optional[str] = None,
-        sample_frequency: Optional[str] = None,
-        bits_per_sample: Optional[str] = None,
-        nr_audio_channels: Optional[str] = None,
-        resolution: Optional[str] = None,
-        color_depth: Optional[str] = None,
-        protection: Optional[str] = None,
-        xml_el: Optional[ET.Element] = None,
+        uri: str | None,
+        protocol_info: str | None,
+        import_uri: str | None = None,
+        size: str | None = None,
+        duration: str | None = None,
+        bitrate: str | None = None,
+        sample_frequency: str | None = None,
+        bits_per_sample: str | None = None,
+        nr_audio_channels: str | None = None,
+        resolution: str | None = None,
+        color_depth: str | None = None,
+        protection: str | None = None,
+        xml_el: ET.Element | None = None,
     ) -> None:
         """Initialize."""
         # pylint: disable=too-many-arguments,too-many-positional-arguments
@@ -934,7 +918,7 @@ class Resource:
         self.xml_el = xml_el
 
     @classmethod
-    def from_xml(cls: Type[TR], xml_el: ET.Element) -> TR:
+    def from_xml(cls, xml_el: ET.Element) -> Self:
         """Initialize from an XML node."""
         uri = xml_el.text
         protocol_info = xml_el.attrib.get("protocolInfo")
@@ -987,9 +971,9 @@ class Descriptor:
         self,
         id: str,
         name_space: str,
-        type: Optional[str] = None,
-        text: Optional[str] = None,
-        xml_el: Optional[ET.Element] = None,
+        type: str | None = None,
+        text: str | None = None,
+        xml_el: ET.Element | None = None,
     ) -> None:
         """Initialize."""
         # pylint: disable=invalid-name,redefined-builtin,too-many-arguments,too-many-positional-arguments
@@ -1000,7 +984,7 @@ class Descriptor:
         self.xml_el = xml_el
 
     @classmethod
-    def from_xml(cls: Type[TD], xml_el: ET.Element) -> TD:
+    def from_xml(cls, xml_el: ET.Element) -> Self:
         """Initialize from an XML node."""
         id_ = xml_el.attrib["id"]
         name_space = xml_el.attrib["nameSpace"]
@@ -1051,7 +1035,7 @@ def to_xml_string(*objects: DidlObject) -> bytes:
     return ET.tostring(root_el)
 
 
-def from_xml_string(xml_string: str, strict: bool = True) -> List[Union[DidlObject, Descriptor]]:
+def from_xml_string(xml_string: str, strict: bool = True) -> list[DidlObject | Descriptor]:
     """Parse DIDL-Lite XML string."""
     if not strict:
         # Find all prefixes used in tags, e.g., <prefix:tag ...>
@@ -1087,9 +1071,9 @@ def from_xml_string(xml_string: str, strict: bool = True) -> List[Union[DidlObje
     return from_xml_el(xml_el, strict)
 
 
-def from_xml_el(xml_el: ET.Element, strict: bool = True) -> List[Union[DidlObject, Descriptor]]:
+def from_xml_el(xml_el: ET.Element, strict: bool = True) -> list[DidlObject | Descriptor]:
     """Convert XML Element to DIDL Objects."""
-    didl_objects = []  # type: List[Union[DidlObject, Descriptor]]
+    didl_objects: list[DidlObject | Descriptor] = []
 
     # items and containers, in order
     for child_el in xml_el:
@@ -1125,7 +1109,7 @@ def from_xml_el(xml_el: ET.Element, strict: bool = True) -> List[Union[DidlObjec
 
 
 # upnp_class to python type mapping
-def type_by_upnp_class(upnp_class: str, strict: bool = True) -> Optional[Type[DidlObject]]:
+def type_by_upnp_class(upnp_class: str, strict: bool = True) -> type[DidlObject] | None:
     """Get DidlObject-type by upnp_class.
 
     When strict is False, the upnp_class lookup will be done ignoring string

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/didl_lite/utils.py

@@ -1,7 +1,7 @@
 """Utilities."""
 
+import functools
 import re
-from typing import Optional, Tuple
 
 NAMESPACES = {
     "didl_lite": "urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/",
@@ -27,7 +27,7 @@ def expand_namespace_tag(tag: str) -> str:
     return f"{{{namespace_uri}}}{tag}"
 
 
-def split_namespace_tag(namespaced_tag: str) -> Tuple[Optional[str], str]:
+def split_namespace_tag(namespaced_tag: str) -> tuple[str | None, str]:
     """
     Extract namespace and tag from namespaced-tag.
 
@@ -43,6 +43,10 @@ def split_namespace_tag(namespaced_tag: str) -> Tuple[Optional[str], str]:
     return namespace, tag
 
 
+# Cached: called for every attribute set on a DidlObject, with a small closed
+# set of property names. Bounded, as from_xml also passes names read from
+# documents received from other devices.
+@functools.lru_cache(maxsize=256)
 def to_camel_case(name: str) -> str:
     """Get camel case of name."""
     sub1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
@@ -61,7 +65,7 @@ def didl_property_key(didl_property_name: str) -> str:
     return to_camel_case(didl_property_name.replace("@", "_"))
 
 
-def didl_property_def_key(didl_property_def: Tuple[str, ...]) -> str:
+def didl_property_def_key(didl_property_def: tuple[str, ...]) -> str:
     """Get Python property key for didl_property_def."""
     if didl_property_def[1].startswith("@"):
         return to_camel_case(didl_property_def[1].replace("@", ""))

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/pyproject.toml

@@ -17,13 +17,13 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Programming Language :: Python",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "defusedxml>=0.6.0",
 ]
@@ -47,6 +47,7 @@ version = { attr = "didl_lite.__version__" }
 didl_lite = ["py.typed"]
 
 [tool.mypy]
+python_version = "3.11"
 check_untyped_defs = true
 disallow_untyped_calls = true
 disallow_untyped_defs = true

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/python_didl_lite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-didl-lite
-Version: 1.5.1
+Version: 1.5.2
 Summary: DIDL-Lite (Digital Item Declaration Language) tools for Python
 Author-email: Steven Looman <steven.looman@gmail.com>
 License-Expression: Apache-2.0
@@ -9,12 +9,12 @@ Keywords: DIDL,DIDL-lite
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.10
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 Requires-Dist: defusedxml>=0.6.0
 Provides-Extra: test

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.5.1
+current_version = 1.5.2
 commit = True
 tag = False
 tag_name = {new_version}

{python_didl_lite-1.5.1 → python_didl_lite-1.5.2}/tests/test_didl_lite.py

@@ -3,7 +3,7 @@
 import pytest
 from defusedxml import ElementTree as ET
 
-from didl_lite import didl_lite
+from didl_lite import didl_lite, utils
 
 NAMESPACES = {
     "didl_lite": "urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/",
@@ -793,3 +793,13 @@ class TestDidlLite:
 
         assert b"<upnp:artist>My Artist</upnp:artist>" in xml
         assert b"<upnp:genre>My Genre</upnp:genre>" in xml
+
+    def test_to_camel_case_is_cached(self) -> None:
+        """Test to_camel_case is cached, and used cached through didl_lite."""
+        assert hasattr(utils.to_camel_case, "cache_info")
+        # didl_lite imports the name; it must be the cached function too.
+        assert didl_lite.to_camel_case is utils.to_camel_case
+
+        hits_before = utils.to_camel_case.cache_info().hits
+        didl_lite.MusicTrack(id="0", parent_id="0", title="Title", restricted="1")
+        assert utils.to_camel_case.cache_info().hits > hits_before