smithy-test 0.1.0__tar.gz

smithy_test-0.1.0/.changes/0.1.0.json

@@ -0,0 +1,12 @@
+{
+  "changes": [
+    {
+      "type": "feature",
+      "description": "Added the `smithy-test` package providing `deep_equal`, a NaN-aware structural equality check for generated protocol tests."
+    },
+    {
+      "type": "feature",
+      "description": "Added `xml_equal` for comparing XML documents in protocol tests."
+    }
+  ]
+}

smithy_test-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Eclipse
+.classpath
+.project
+.settings/
+
+# Intellij
+.idea/
+*.iml
+*.iws
+
+# VS Code
+.vscode/
+
+# Mac
+.DS_Store
+
+# Maven
+target/
+**/dependency-reduced-pom.xml
+
+# Gradle
+**/.gradle
+build/
+*/out/
+**/*/out/
+
+# Python
+__pycache__
+*.swp
+.mypy_cache
+.coverage
+coverage.xml
+htmlcov
+*.egg-info
+dist
+.venv

smithy_test-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## v0.1.0
+
+### Features
+* Added the `smithy-test` package providing `deep_equal`, a NaN-aware structural equality check for generated protocol tests.
+* Added `xml_equal` for comparing XML documents in protocol tests.

smithy_test-0.1.0/NOTICE

@@ -0,0 +1 @@
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

smithy_test-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.5
+Name: smithy-test
+Version: 0.1.0
+Summary: Test-support helpers for generated Smithy clients.
+Project-URL: Changelog, https://github.com/smithy-lang/smithy-python/blob/develop/packages/smithy-test/CHANGELOG.md
+Project-URL: Code, https://github.com/smithy-lang/smithy-python/blob/develop/packages/smithy-test/
+Project-URL: Issue tracker, https://github.com/smithy-lang/smithy-python/issues
+Author: Amazon Web Services
+License: Apache License 2.0
+License-File: NOTICE
+Keywords: sdk,smithy,test
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# smithy-test
+
+Test-support helpers shared by generated Smithy clients, kept out of the runtime
+packages. Currently provides `deep_equal`, a structural equality check used by the
+generated protocol tests that treats `NaN == NaN`.

smithy_test-0.1.0/README.md

@@ -0,0 +1,5 @@
+# smithy-test
+
+Test-support helpers shared by generated Smithy clients, kept out of the runtime
+packages. Currently provides `deep_equal`, a structural equality check used by the
+generated protocol tests that treats `NaN == NaN`.

smithy_test-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "smithy-test"
+dynamic = ["version"]
+requires-python = ">=3.12"
+authors = [
+  {name = "Amazon Web Services"},
+]
+description = "Test-support helpers for generated Smithy clients."
+readme = "README.md"
+license = {text = "Apache License 2.0"}
+keywords = ["smithy", "sdk", "test"]
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: System Administrators",
+  "Natural Language :: English",
+  "License :: OSI Approved :: Apache Software License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Free Threading :: 2 - Beta",
+  "Topic :: Software Development :: Libraries"
+]
+dependencies = []
+
+[project.urls]
+"Changelog" = "https://github.com/smithy-lang/smithy-python/blob/develop/packages/smithy-test/CHANGELOG.md"
+"Code" = "https://github.com/smithy-lang/smithy-python/blob/develop/packages/smithy-test/"
+"Issue tracker" = "https://github.com/smithy-lang/smithy-python/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+path = "src/smithy_test/__init__.py"
+
+[tool.hatch.build]
+exclude = [
+  "tests",
+]
+
+[tool.ruff]
+src = ["src"]

smithy_test-0.1.0/src/smithy_test/__init__.py

@@ -0,0 +1,7 @@
+#  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#  SPDX-License-Identifier: Apache-2.0
+from ._private.equality import deep_equal as deep_equal
+from ._private.equality import xml_equal as xml_equal
+
+__version__ = "0.1.0"
+__all__ = ("deep_equal", "xml_equal")

smithy_test-0.1.0/src/smithy_test/_private/__init__.py

@@ -0,0 +1,2 @@
+#  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#  SPDX-License-Identifier: Apache-2.0

smithy_test-0.1.0/src/smithy_test/_private/equality.py

@@ -0,0 +1,67 @@
+#  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#  SPDX-License-Identifier: Apache-2.0
+import dataclasses
+import math
+from collections.abc import Mapping, Sequence
+from typing import cast
+from xml.dom.minidom import Element, Node, parseString
+
+
+def deep_equal(a: object, b: object) -> bool:
+    """Structural equality for deserialized shapes that treats ``NaN == NaN``."""
+    if isinstance(a, float) and isinstance(b, float):
+        return a == b or (math.isnan(a) and math.isnan(b))
+    if dataclasses.is_dataclass(a) and dataclasses.is_dataclass(b):
+        if type(a) is not type(b):
+            return False
+        return all(
+            deep_equal(getattr(a, f.name), getattr(b, f.name))
+            for f in dataclasses.fields(a)
+            if f.compare
+        )
+    if isinstance(a, (list, tuple)) and isinstance(b, (list, tuple)):
+        a_seq = cast(Sequence[object], a)
+        b_seq = cast(Sequence[object], b)
+        return len(a_seq) == len(b_seq) and all(
+            deep_equal(x, y) for x, y in zip(a_seq, b_seq)
+        )
+    if isinstance(a, dict) and isinstance(b, dict):
+        a_map = cast(Mapping[object, object], a)
+        b_map = cast(Mapping[object, object], b)
+        return a_map.keys() == b_map.keys() and all(
+            deep_equal(a_map[k], b_map[k]) for k in a_map
+        )
+    # bool subclasses int; the subclass check would admit 1 == True without this.
+    if isinstance(a, bool) != isinstance(b, bool):
+        return False
+    return (isinstance(a, type(b)) or isinstance(b, type(a))) and a == b  # pyright: ignore[reportUnknownArgumentType]
+
+
+def xml_equal(a: bytes, b: bytes) -> bool:
+    """Semantic equality for XML documents.
+
+    Only the order of same-named sibling elements (such as list items) is
+    significant; structure members, attributes, whitespace-only text, and
+    whitespace around text may differ. Namespace declarations are compared as
+    attributes.
+    """
+    return _canonical_xml(a) == _canonical_xml(b)
+
+
+def _canonical_xml(document: bytes) -> object:
+    root = parseString(document).documentElement  # noqa: S318
+    assert root is not None  # noqa: S101
+    return _canonical_element(root)
+
+
+def _canonical_element(element: Element) -> object:
+    text: str = ""
+    children: list[tuple[str, object]] = []
+    for node in element.childNodes:
+        if node.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
+            text += cast(str, node.data)  # type: ignore
+        elif node.nodeType == Node.ELEMENT_NODE:
+            children.append((node.tagName, _canonical_element(node)))
+    # A stable sort keeps same-named siblings in document order.
+    children.sort(key=lambda child: child[0])
+    return (element.tagName, dict(element.attributes.items()), text.strip(), children)

smithy_test-0.1.0/src/smithy_test/py.typed

@@ -0,0 +1 @@
+# PEP 561