Add debug goals to python

src/python/pants/backend/experimental/python/register.py

@@ -2,7 +2,7 @@
 # Licensed under the Apache License, Version 2.0 (see LICENSE).
 
 from pants.backend.codegen import export_codegen_goal
-from pants.backend.python.goals import publish
+from pants.backend.python.goals import debug_goals, publish
 from pants.backend.python.subsystems import setuptools_scm, twine
 from pants.backend.python.target_types import VCSVersion
 from pants.backend.python.util_rules import pex, vcs_versioning
@@ -16,6 +16,7 @@ def rules():
         *setuptools_scm.rules(),
         *export_codegen_goal.rules(),
         *twine.rules(),
+        *debug_goals.rules(),
     )
 
 

src/python/pants/backend/project_info/peek.py

@@ -15,6 +15,7 @@
 from pants.engine.target import (
     Dependencies,
     DependenciesRequest,
+    Field,
     HydratedSources,
     HydrateSourcesRequest,
     SourcesField,
@@ -89,12 +90,22 @@ class _PeekJsonEncoder(json.JSONEncoder):
 
     def default(self, o):
         """Return a serializable object for o."""
+        if isinstance(o, str):  # early exit prevents strings from being treated as sequences
+            return o
+        if o is None:
+            return o
         if is_dataclass(o):
             return asdict(o)
         if isinstance(o, collections.abc.Mapping):
             return dict(o)
-        if isinstance(o, collections.abc.Sequence):
+        if (
+            isinstance(o, collections.abc.Sequence)
+            or isinstance(o, set)
+            or isinstance(o, collections.abc.Set)
+        ):
             return list(o)
+        if isinstance(o, Field):
+            return self.default(o.value)
         try:
             return super().default(o)
         except TypeError:

src/python/pants/backend/python/dependency_inference/module_mapper.py

@@ -384,8 +384,10 @@ def add_modules(modules: Iterable[str], *, type_stub: bool = False) -> None:
 class PythonModuleOwners:
     """The target(s) that own a Python module.
 
-    If >1 targets own the same module, and they're implementations (vs .pyi type stubs), they will
-    be put into `ambiguous` instead of `unambiguous`. `unambiguous` should never be > 2.
+    Up to 2 targets can unambiguously own the same module, if one is an implementation and the other
+    is a .pyi type stub. It is ambiguous for >1 implementation target to own the same module, and
+    those targets will be put into `ambiguous` instead of `unambiguous`. Therefore, `unambiguous`
+    should never be >2; and only 1 of `unambiguous` and `ambiguous` should have targets.
     """
 
     unambiguous: tuple[Address, ...]

src/python/pants/backend/python/dependency_inference/parse_python_dependencies.py

@@ -1,6 +1,5 @@
 # Copyright 2020 Pants project contributors (see CONTRIBUTORS.md).
 # Licensed under the Apache License, Version 2.0 (see LICENSE).
-
 import json
 from dataclasses import dataclass