fix(parser): preserve lazy export introspection

Author: leandrodamascena

aws_lambda_powertools/utilities/parser/__init__.py

@@ -27,6 +27,10 @@ def __getattr__(name: str) -> object:
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
 
 
+def __dir__() -> list[str]:
+    return sorted(set(globals()) | set(__all__))
+
+
 __all__ = [
     "event_parser",
     "parse",

tests/functional/parser/test_parser.py

@@ -386,3 +386,26 @@ def test_parser_import_does_not_eagerly_load_envelopes():
         check=False,
     )
     assert result.returncode == 0, f"import * test failed:\n{result.stderr}\n{result.stdout}"
+
+
+def test_parser_lazy_exports_are_discoverable():
+    """Lazy exports must remain discoverable through standard module introspection."""
+    import subprocess
+    import sys
+
+    script = """
+import inspect
+import sys
+import aws_lambda_powertools.utilities.parser as parser
+
+assert "envelopes" in dir(parser)
+assert "BaseEnvelope" in dir(parser)
+assert "aws_lambda_powertools.utilities.parser.envelopes" not in sys.modules
+
+members = dict(inspect.getmembers(parser))
+assert members["envelopes"] is parser.envelopes
+assert members["BaseEnvelope"] is parser.BaseEnvelope
+"""
+
+    result = subprocess.run([sys.executable, "-c", script], capture_output=True, text=True, check=False)
+    assert result.returncode == 0, f"parser introspection test failed:\n{result.stderr}\n{result.stdout}"