maxml 1.0.4__tar.gz → 1.0.5__tar.gz

{maxml-1.0.4 → maxml-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxml
-Version: 1.0.4
+Version: 1.0.5
 Summary: A streamlined pure Python XML serializer.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -19,9 +19,9 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: classicist==1.0.*
-Requires-Dist: enumerific==1.0.*
+Requires-Dist: enumerific==1.1.*
 Provides-Extra: development
-Requires-Dist: black==24.10.*; extra == "development"
+Requires-Dist: black==26.1.*; extra == "development"
 Requires-Dist: pytest==8.3.*; extra == "development"
 Requires-Dist: pytest-codeblocks==0.17.0; extra == "development"
 Provides-Extra: distribution
@@ -133,11 +133,15 @@ The `Element` class provides the following methods:
 	Each namespace consists of a prefix which can be used to prefix element names
 	and the URI associated with that namespace prefix.
 	
-	Optionally, a namespace can be marked as promoted during registration, which will
-	result in the namespace being serialized into the XML before any attributes on the
-	element. Namespaces that are not marked as promoted will appear after attributes.
-	Namespace promotion can be enabled for a given namespace during registration by
-	passing the optional `promoted` keyword argument with the value of `True`.
+	Optionally, a namespace can be marked as being promoted during registration, which
+	will result in the namespace being serialized into the XML before any attributes on
+	the element. Namespaces that are not marked as being promoted will appear after any
+	attributes on the element. Namespace promotion can be enabled for a given namespace
+	during registration by passing the optional `promoted` keyword argument with the
+	value of `True`. Whether a namespace is marked as promoted or not can be changed
+	after registration by changing a `Namespace` entity's `promoted` property value or
+	by using the `promote()` and `unpromote()` methods. See the **Namespace Class** for
+	more information.
 
 	For example, the 'rdf' prefix is associated with the following canonical URI:
 		"http://www.w3.org/1999/02/22-rdf-syntax-ns#"
@@ -284,6 +288,9 @@ The `Namespace` class constructor `Namespace(...)` takes the following arguments
 
  * `prefix` (`str`) – The required `prefix` argument sets the namespace prefix.
  * `uri` (`str`) – The required `uri` argument sets the namespace URI.
+ * `promoted` (`bool`) – The optional `promoted` argument sets whether the namespace is
+    marked as being promoted or not. Promoted namespaces result in the namespace being
+    serialized into the XML before any attributes on their associated element.
 
 The `Namespace` class provides the following methods:
 

{maxml-1.0.4 → maxml-1.0.5}/README.md

@@ -102,11 +102,15 @@ The `Element` class provides the following methods:
 	Each namespace consists of a prefix which can be used to prefix element names
 	and the URI associated with that namespace prefix.
 	
-	Optionally, a namespace can be marked as promoted during registration, which will
-	result in the namespace being serialized into the XML before any attributes on the
-	element. Namespaces that are not marked as promoted will appear after attributes.
-	Namespace promotion can be enabled for a given namespace during registration by
-	passing the optional `promoted` keyword argument with the value of `True`.
+	Optionally, a namespace can be marked as being promoted during registration, which
+	will result in the namespace being serialized into the XML before any attributes on
+	the element. Namespaces that are not marked as being promoted will appear after any
+	attributes on the element. Namespace promotion can be enabled for a given namespace
+	during registration by passing the optional `promoted` keyword argument with the
+	value of `True`. Whether a namespace is marked as promoted or not can be changed
+	after registration by changing a `Namespace` entity's `promoted` property value or
+	by using the `promote()` and `unpromote()` methods. See the **Namespace Class** for
+	more information.
 
 	For example, the 'rdf' prefix is associated with the following canonical URI:
 		"http://www.w3.org/1999/02/22-rdf-syntax-ns#"
@@ -253,6 +257,9 @@ The `Namespace` class constructor `Namespace(...)` takes the following arguments
 
  * `prefix` (`str`) – The required `prefix` argument sets the namespace prefix.
  * `uri` (`str`) – The required `uri` argument sets the namespace URI.
+ * `promoted` (`bool`) – The optional `promoted` argument sets whether the namespace is
+    marked as being promoted or not. Promoted namespaces result in the namespace being
+    serialized into the XML before any attributes on their associated element.
 
 The `Namespace` class provides the following methods:
 

{maxml-1.0.4 → maxml-1.0.5}/requirements.development.txt

@@ -1,4 +1,4 @@
 # MaXML Library: Development & Test Dependencies
-black==24.10.*
+black==26.1.*
 pytest==8.3.*
 pytest-codeblocks==0.17.0

{maxml-1.0.4 → maxml-1.0.5}/requirements.txt

@@ -1,3 +1,3 @@
 # MaXML Library: Runtime Dependencies
 classicist==1.0.*
-enumerific==1.0.*
+enumerific==1.1.*

{maxml-1.0.4 → maxml-1.0.5}/source/maxml/element/__init__.py

@@ -122,7 +122,7 @@ class Element(object):
         prefix: str = None
 
         if ":" in name:
-            (prefix, basename) = name.split(":", maxsplit=1)
+            prefix, basename = name.split(":", maxsplit=1)
 
         self._prefix: str = prefix
 

{maxml-1.0.4 → maxml-1.0.5}/source/maxml/namespace/__init__.py

@@ -94,7 +94,7 @@ class Namespace(object):
     def copy(self) -> Namespace:
         """Create an independent copy of the current Namespace instance."""
 
-        return Namespace(prefix=self.prefix, uri=self.uri)
+        return Namespace(prefix=self.prefix, uri=self.uri, promoted=self.promoted)
 
     @property
     def promoted(self) -> bool:

maxml-1.0.5/source/maxml/version.txt

@@ -0,0 +1 @@
+1.0.5

{maxml-1.0.4 → maxml-1.0.5}/source/maxml.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxml
-Version: 1.0.4
+Version: 1.0.5
 Summary: A streamlined pure Python XML serializer.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -19,9 +19,9 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: classicist==1.0.*
-Requires-Dist: enumerific==1.0.*
+Requires-Dist: enumerific==1.1.*
 Provides-Extra: development
-Requires-Dist: black==24.10.*; extra == "development"
+Requires-Dist: black==26.1.*; extra == "development"
 Requires-Dist: pytest==8.3.*; extra == "development"
 Requires-Dist: pytest-codeblocks==0.17.0; extra == "development"
 Provides-Extra: distribution
@@ -133,11 +133,15 @@ The `Element` class provides the following methods:
 	Each namespace consists of a prefix which can be used to prefix element names
 	and the URI associated with that namespace prefix.
 	
-	Optionally, a namespace can be marked as promoted during registration, which will
-	result in the namespace being serialized into the XML before any attributes on the
-	element. Namespaces that are not marked as promoted will appear after attributes.
-	Namespace promotion can be enabled for a given namespace during registration by
-	passing the optional `promoted` keyword argument with the value of `True`.
+	Optionally, a namespace can be marked as being promoted during registration, which
+	will result in the namespace being serialized into the XML before any attributes on
+	the element. Namespaces that are not marked as being promoted will appear after any
+	attributes on the element. Namespace promotion can be enabled for a given namespace
+	during registration by passing the optional `promoted` keyword argument with the
+	value of `True`. Whether a namespace is marked as promoted or not can be changed
+	after registration by changing a `Namespace` entity's `promoted` property value or
+	by using the `promote()` and `unpromote()` methods. See the **Namespace Class** for
+	more information.
 
 	For example, the 'rdf' prefix is associated with the following canonical URI:
 		"http://www.w3.org/1999/02/22-rdf-syntax-ns#"
@@ -284,6 +288,9 @@ The `Namespace` class constructor `Namespace(...)` takes the following arguments
 
  * `prefix` (`str`) – The required `prefix` argument sets the namespace prefix.
  * `uri` (`str`) – The required `uri` argument sets the namespace URI.
+ * `promoted` (`bool`) – The optional `promoted` argument sets whether the namespace is
+    marked as being promoted or not. Promoted namespaces result in the namespace being
+    serialized into the XML before any attributes on their associated element.
 
 The `Namespace` class provides the following methods:
 

{maxml-1.0.4 → maxml-1.0.5}/source/maxml.egg-info/requires.txt

@@ -1,8 +1,8 @@
 classicist==1.0.*
-enumerific==1.0.*
+enumerific==1.1.*
 
 [development]
-black==24.10.*
+black==26.1.*
 pytest==8.3.*
 pytest-codeblocks==0.17.0
 

{maxml-1.0.4 → maxml-1.0.5}/tests/test_element.py

@@ -463,6 +463,56 @@ def test_maxml_special_tostring(data: callable):
     assert string == compare
 
 
+def test_maxml_namespace_promotion(data: callable):
+    """Check promotion of registered namespaces works as expected"""
+
+    # Register a class level namespace
+    maxml.Element.register_namespace(
+        prefix="xy", uri="http://namespace.example.org/xy", promoted=True
+    )
+
+    # Create a new top-level element
+    element = maxml.Element(name="xy:test")
+
+    # Ensure that the Element object's type is as expected
+    assert isinstance(element, maxml.Element)
+
+    # Ensure that the Element object's namespace type is as expected
+    assert isinstance(element.namespace, maxml.Namespace)
+    assert element.namespace.prefix == "xy"
+    assert element.namespace.uri == "http://namespace.example.org/xy"
+    assert element.namespace.promoted is True
+
+    # Set an element attribute
+    element.set("xy:id", "1")
+
+    # Serialise the element to a string
+    string: str = element.tostring(pretty=True)
+
+    assert isinstance(string, str)
+
+    # Confirm that the promoted namespace was serialised before the attributes
+    compare: str = """<xy:test xmlns:xy="http://namespace.example.org/xy" xy:id="1"/>"""
+
+    assert string == compare
+
+    # Now mark the namespace as not being promoted to re-test the serialisation below
+    element.namespace.promoted = False
+
+    # Ensure that the promoted status has changed
+    assert element.namespace.promoted is False
+
+    # Serialise the element to a string
+    string: str = element.tostring(pretty=True)
+
+    assert isinstance(string, str)
+
+    # Confirm that the non-promoted namespace was serialised after the attributes
+    compare: str = """<xy:test xy:id="1" xmlns:xy="http://namespace.example.org/xy"/>"""
+
+    assert string == compare
+
+
 def test_maxml_namespace_promotion_non_promoted_namespace(data: callable):
     """Check promotion of registered namespaces works as expected"""
 

maxml-1.0.4/source/maxml/version.txt

@@ -1 +0,0 @@
-1.0.4