openrewrite-migrate-python 0.6.0.dev20260420171522__tar.gz → 0.7.0__tar.gz

{openrewrite_migrate_python-0.6.0.dev20260420171522 → openrewrite_migrate_python-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrewrite-migrate-python
-Version: 0.6.0.dev20260420171522
+Version: 0.7.0
 Summary: OpenRewrite recipes for migrating Python codebases to newer Python versions.
 Author-email: "Moderne Inc." <support@moderne.io>
 License: Moderne Proprietary

{openrewrite_migrate_python-0.6.0.dev20260420171522 → openrewrite_migrate_python-0.7.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "openrewrite-migrate-python"
 description = "OpenRewrite recipes for migrating Python codebases to newer Python versions."
-version = "0.6.0.dev20260420171522"  # Updated dynamically during release
+version = "0.7.0"  # Updated dynamically during release
 authors = [{ name = "Moderne Inc.", email = "support@moderne.io" }]
 license = { text = "Moderne Proprietary" }
 readme = "README.md"

openrewrite_migrate_python-0.7.0/src/openrewrite_migrate_python/migrate/sys_last_deprecations.py

@@ -0,0 +1,99 @@
+"""
+Recipe for replacing deprecated sys.last_type/last_value/last_traceback
+with sys.last_exc equivalents.
+
+sys.last_type, sys.last_value, and sys.last_traceback were deprecated in
+Python 3.12 in favor of sys.last_exc:
+
+- sys.last_value     -> sys.last_exc
+- sys.last_type      -> type(sys.last_exc)
+- sys.last_traceback -> sys.last_exc.__traceback__
+
+See: https://docs.python.org/3/whatsnew/3.12.html#deprecated
+"""
+
+from typing import Any, List, Optional, cast
+
+from rewrite import ExecutionContext, Recipe, TreeVisitor
+from rewrite.category import CategoryDescriptor
+from rewrite.decorators import categorize
+from rewrite.marketplace import Python
+from rewrite.python.visitor import PythonVisitor
+from rewrite.python.template import pattern, template
+from rewrite.java.tree import FieldAccess, J
+
+# Define category path: Python > Migrate > Python 3.12
+_Python312 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.12"),
+]
+
+_last_value_pattern = pattern("sys.last_value")
+_last_type_pattern = pattern("sys.last_type")
+_last_traceback_pattern = pattern("sys.last_traceback")
+
+_last_exc_template = template("sys.last_exc")
+_type_last_exc_template = template("type(sys.last_exc)")
+_last_exc_traceback_template = template("sys.last_exc.__traceback__")
+
+
+@categorize(_Python312)
+class ReplaceSysLastExcInfo(Recipe):
+    """
+    Replace `sys.last_type`, `sys.last_value`, and `sys.last_traceback` with
+    their `sys.last_exc`-based equivalents.
+
+    These attributes were deprecated in Python 3.12 in favor of `sys.last_exc`
+    which provides the exception object directly.
+
+    Example:
+        Before:
+            import sys
+            exc_type = sys.last_type
+            exc_value = sys.last_value
+            exc_tb = sys.last_traceback
+
+        After:
+            import sys
+            exc_type = type(sys.last_exc)
+            exc_value = sys.last_exc
+            exc_tb = sys.last_exc.__traceback__
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.ReplaceSysLastExcInfo"
+
+    @property
+    def display_name(self) -> str:
+        return "Replace `sys.last_type` / `sys.last_value` / `sys.last_traceback` with `sys.last_exc`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "`sys.last_type`, `sys.last_value`, and `sys.last_traceback` were "
+            "deprecated in Python 3.12. Replace them with their `sys.last_exc`-"
+            "based equivalents: `type(sys.last_exc)`, `sys.last_exc`, and "
+            "`sys.last_exc.__traceback__` respectively."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.12", "sys"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        class Visitor(PythonVisitor[ExecutionContext]):
+            def visit_field_access(  # type: ignore[override]
+                self, field_access: FieldAccess, p: ExecutionContext
+            ) -> Optional[J]:
+                fa = cast(FieldAccess, super().visit_field_access(field_access, p))
+                if _last_value_pattern.matches(fa, self.cursor):
+                    return _last_exc_template.apply(self.cursor)
+                if _last_type_pattern.matches(fa, self.cursor):
+                    return _type_last_exc_template.apply(self.cursor)
+                if _last_traceback_pattern.matches(fa, self.cursor):
+                    return _last_exc_traceback_template.apply(self.cursor)
+                return fa
+
+        return Visitor()

{openrewrite_migrate_python-0.6.0.dev20260420171522 → openrewrite_migrate_python-0.7.0}/src/openrewrite_migrate_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrewrite-migrate-python
-Version: 0.6.0.dev20260420171522
+Version: 0.7.0
 Summary: OpenRewrite recipes for migrating Python codebases to newer Python versions.
 Author-email: "Moderne Inc." <support@moderne.io>
 License: Moderne Proprietary

{openrewrite_migrate_python-0.6.0.dev20260420171522 → openrewrite_migrate_python-0.7.0}/tests/test_sys_last_deprecations.py

@@ -25,8 +25,8 @@ class TestReplaceSysLastExcInfo:
             )
         )
 
-    def test_flags_sys_last_type(self):
-        """last_type needs type(sys.last_exc) — flagged for manual review."""
+    def test_replaces_sys_last_type(self):
+        """last_type is rewritten to type(sys.last_exc)."""
         spec = RecipeSpec(recipe=ReplaceSysLastExcInfo())
         spec.rewrite_run(
             python(
@@ -36,13 +36,13 @@ class TestReplaceSysLastExcInfo:
                 """,
                 """
                 import sys
-                t = /*~~(sys.last_type is deprecated in Python 3.12. Use type(sys.last_exc) instead.)~~>*/sys.last_type
+                t = type(sys.last_exc)
                 """,
             )
         )
 
-    def test_flags_sys_last_traceback(self):
-        """last_traceback needs sys.last_exc.__traceback__ — flagged for manual review."""
+    def test_replaces_sys_last_traceback(self):
+        """last_traceback is rewritten to sys.last_exc.__traceback__."""
         spec = RecipeSpec(recipe=ReplaceSysLastExcInfo())
         spec.rewrite_run(
             python(
@@ -52,7 +52,7 @@ class TestReplaceSysLastExcInfo:
                 """,
                 """
                 import sys
-                tb = /*~~(sys.last_traceback is deprecated in Python 3.12. Use sys.last_exc.__traceback__ instead.)~~>*/sys.last_traceback
+                tb = sys.last_exc.__traceback__
                 """,
             )
         )

openrewrite_migrate_python-0.6.0.dev20260420171522/src/openrewrite_migrate_python/migrate/sys_last_deprecations.py

@@ -1,121 +0,0 @@
-"""
-Recipe for replacing deprecated sys.last_type/last_value/last_traceback
-with sys.last_exc.
-
-sys.last_type, sys.last_value, and sys.last_traceback were deprecated in
-Python 3.12 in favor of sys.last_exc.
-
-- sys.last_value is semantically equivalent to sys.last_exc (auto-replaced)
-- sys.last_type and sys.last_traceback are not direct equivalents
-  (would need type(sys.last_exc) and sys.last_exc.__traceback__) and are
-  flagged for manual review.
-
-See: https://docs.python.org/3/whatsnew/3.12.html#deprecated
-"""
-
-from typing import Any, List, Optional
-
-from rewrite import ExecutionContext, Recipe, TreeVisitor
-from rewrite.category import CategoryDescriptor
-from rewrite.decorators import categorize
-from rewrite.marketplace import Python
-from rewrite.python.visitor import PythonVisitor
-from rewrite.java.tree import FieldAccess, Identifier
-from ._markers import mark_deprecated
-
-# Define category path: Python > Migrate > Python 3.12
-_Python312 = [
-    *Python,
-    CategoryDescriptor(display_name="Migrate"),
-    CategoryDescriptor(display_name="Python 3.12"),
-]
-
-
-@categorize(_Python312)
-class ReplaceSysLastExcInfo(Recipe):
-    """
-    Replace `sys.last_value` with `sys.last_exc` and flag `sys.last_type`
-    and `sys.last_traceback` for manual review.
-
-    These attributes were deprecated in Python 3.12 in favor of
-    `sys.last_exc` which provides the exception object directly.
-
-    Only `sys.last_value` is semantically equivalent to `sys.last_exc`.
-    `sys.last_type` would need `type(sys.last_exc)` and
-    `sys.last_traceback` would need `sys.last_exc.__traceback__`,
-    which require structural changes beyond a simple rename.
-
-    Example:
-        Before:
-            import sys
-            exc_value = sys.last_value
-
-        After:
-            import sys
-            exc_value = sys.last_exc
-    """
-
-    @property
-    def name(self) -> str:
-        return "org.openrewrite.python.migrate.ReplaceSysLastExcInfo"
-
-    @property
-    def display_name(self) -> str:
-        return "Replace `sys.last_value` with `sys.last_exc` and flag `sys.last_type` / `sys.last_traceback`"
-
-    @property
-    def description(self) -> str:
-        return (
-            "`sys.last_type`, `sys.last_value`, and `sys.last_traceback` were "
-            "deprecated in Python 3.12. `sys.last_value` is auto-replaced with "
-            "`sys.last_exc`; `sys.last_type` and `sys.last_traceback` are flagged "
-            "for manual review."
-        )
-
-    @property
-    def tags(self) -> List[str]:
-        return ["python", "migration", "3.12", "sys"]
-
-    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
-        class Visitor(PythonVisitor[ExecutionContext]):
-            def visit_field_access(
-                self, field_access: FieldAccess, p: ExecutionContext
-            ) -> Optional[FieldAccess]:
-                field_access = super().visit_field_access(field_access, p)
-
-                if not isinstance(field_access.name, Identifier):
-                    return field_access
-
-                attr_name = field_access.name.simple_name
-                if attr_name not in ("last_type", "last_value", "last_traceback"):
-                    return field_access
-
-                target = field_access.target
-                if not isinstance(target, Identifier):
-                    return field_access
-                if target.simple_name != "sys":
-                    return field_access
-
-                # Only last_value is a direct semantic equivalent of last_exc
-                if attr_name == "last_value":
-                    new_identifier = field_access.name.replace(_simple_name="last_exc")
-                    old_padded = field_access.padding.name
-                    new_padded = old_padded.replace(_element=new_identifier)
-                    return field_access.padding.replace(_name=new_padded)
-
-                # last_type and last_traceback need structural changes
-                # (type(sys.last_exc) and sys.last_exc.__traceback__)
-                if attr_name == "last_type":
-                    return mark_deprecated(
-                        field_access,
-                        "sys.last_type is deprecated in Python 3.12. "
-                        "Use type(sys.last_exc) instead."
-                    )
-                else:  # last_traceback
-                    return mark_deprecated(
-                        field_access,
-                        "sys.last_traceback is deprecated in Python 3.12. "
-                        "Use sys.last_exc.__traceback__ instead."
-                    )
-
-        return Visitor()