openrewrite-migrate-python 0.17.0.dev20261022193254__tar.gz → 0.17.0.dev20261022194832__tar.gz

{openrewrite_migrate_python-0.17.0.dev20261022193254 → openrewrite_migrate_python-0.17.0.dev20261022194832}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrewrite-migrate-python
-Version: 0.17.0.dev20261022193254
+Version: 0.17.0.dev20261022194832
 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.17.0.dev20261022193254 → openrewrite_migrate_python-0.17.0.dev20261022194832}/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.17.0.dev20261022193254"  # Updated dynamically during release
+version = "0.17.0.dev20261022194832"  # Updated dynamically during release
 authors = [{ name = "Moderne Inc.", email = "support@moderne.io" }]
 license = { text = "Moderne Proprietary" }
 readme = "README.md"

{openrewrite_migrate_python-0.17.0.dev20261022193254 → openrewrite_migrate_python-0.17.0.dev20261022194832}/src/openrewrite_migrate_python/migrate/__init__.py

@@ -20,7 +20,7 @@ from .aifc_migrations import (
     FindSndhdrModule,
     FindSunauModule,
 )
-from .array_deprecations import ReplaceArrayFromstring, ReplaceArrayTostring
+from .array_deprecations import FindArrayUnicodeTypecode, ReplaceArrayFromstring, ReplaceArrayTostring
 from .ast_deprecations import (
     ReplaceAstBytes,
     ReplaceAstEllipsis,
@@ -29,17 +29,22 @@ from .ast_deprecations import (
     ReplaceAstStr,
 )
 from .asyncio_coroutine_to_async import MigrateAsyncioCoroutine
-from .asyncio_deprecations import FindAsyncioCoroutineDecorator
+from .asyncio_deprecations import (
+    FindAsyncioCoroutineDecorator,
+    FindAsyncioEventLoopPolicy,
+    ReplaceAsyncioIscoroutinefunction,
+)
 from .avro_migrations import MigrateAvroPython3ToAvro
 from .backoff_to_tenacity import (
     FindBackoffDecoratorsNotMigrated,
     MigrateBackoffToTenacity,
     ReplaceBackoffDecoratorsWithTenacity,
 )
+from .builtins_deprecations import FindBitwiseInversionOnBool
 from .calendar_deprecations import ReplaceCalendarConstants
 from .cgi_migrations import FindCgiModule, FindCgitbModule
 from .cgi_parse_deprecations import ReplaceCgiParseQs, ReplaceCgiParseQsl
-from .collections_abc_migrations import ReplaceCollectionsAbcImports
+from .collections_abc_migrations import FindByteString, ReplaceCollectionsAbcImports
 from .configparser_deprecations import (
     ReplaceConfigparserReadfp,
     ReplaceConfigparserSafeConfigParser,
@@ -76,6 +81,7 @@ from .pep594_system_migrations import (
 )
 from .pipes_migrations import FindPipesModule
 from .pkgutil_deprecations import ReplacePkgutilFindLoader, ReplacePkgutilGetLoader
+from .profile_deprecations import FindProfileModule
 from .pydantic_deprecations import (
     FindDeprecatedJsonEncoders,
     FindDeprecatedSchemaGenerator,
@@ -148,6 +154,7 @@ from .upgrade_to_pydantic import (
 from .urllib_deprecations import FindUrllibParseSplitFunctions, FindUrllibParseToBytes
 from .uu_migrations import FindUuModule
 from .wave_deprecations import FindWaveMarkers
+from .webbrowser_deprecations import FindWebbrowserMacOSXOSAScript
 from .xdrlib_migrations import FindXdrlibModule
 from .xml_deprecations import ReplaceElementGetchildren, ReplaceElementGetiterator
 
@@ -279,6 +286,15 @@ __all__ = [
     "FindSreModules",
     "FindTypingNoTypeCheckDecorator",
     "FindWaveMarkers",
+    # Auto-fix: Python 3.16 and 3.17 removals
+    "ReplaceAsyncioIscoroutinefunction",
+    # Detection: Python 3.16 and 3.17 removals
+    "FindArrayUnicodeTypecode",
+    "FindAsyncioEventLoopPolicy",
+    "FindBitwiseInversionOnBool",
+    "FindByteString",
+    "FindProfileModule",
+    "FindWebbrowserMacOSXOSAScript",
     # Auto-fix: LangChain
     "ReplaceLangchainCommunityImports",
     "ReplaceLangchainProviderImports",

openrewrite_migrate_python-0.17.0.dev20261022194832/src/openrewrite_migrate_python/migrate/array_deprecations.py

@@ -0,0 +1,201 @@
+"""
+Recipes for migrating deprecated array module methods.
+
+The following methods were deprecated in Python 3.2 and removed in Python 3.9:
+- ``array.tostring()`` -> ``array.tobytes()``
+- ``array.fromstring()`` -> ``array.frombytes()``
+
+The ``'u'`` typecode was deprecated in Python 3.13 and is scheduled for
+removal in Python 3.16; ``FindArrayUnicodeTypecode`` reports it.
+
+See: https://docs.python.org/3/library/array.html
+"""
+
+from typing import Any, List, Optional
+
+from rewrite import ExecutionContext, Preconditions, Recipe, TreeVisitor
+from rewrite.category import CategoryDescriptor
+from rewrite.decorators import categorize
+from rewrite.java.tree import Empty, Identifier, J, Literal, MethodInvocation
+from rewrite.marketplace import Python
+from rewrite.python.method_matcher import MethodMatcher
+from rewrite.python.preconditions import uses_method
+from rewrite.python.tree import NamedArgument
+from rewrite.python.visitor import PythonVisitor
+
+from ._markers import mark_deprecated
+from ._method_renames import rename_methods
+
+# Define category path: Python > Migrate > Python 3.9
+_Python39 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.9"),
+]
+
+# Define category path: Python > Migrate > Python 3.13
+_Python313 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.13"),
+]
+
+
+@categorize(_Python39)
+class ReplaceArrayTostring(Recipe):
+    """
+    Replace ``array.tostring()`` with ``array.tobytes()``.
+
+    The ``tostring()`` method was deprecated in Python 3.2 and removed in
+    Python 3.9. ``tobytes()`` behaves identically.
+
+    Example:
+        Before:
+            import array
+            my_array = array.array("b", b"ab")
+            data = my_array.tostring()
+
+        After:
+            import array
+            my_array = array.array("b", b"ab")
+            data = my_array.tobytes()
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.ReplaceArrayTostring"
+
+    @property
+    def display_name(self) -> str:
+        return "Replace `array.tostring()` with `array.tobytes()`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Replace `tostring()` with `tobytes()` on array objects. "
+            "The `tostring()` method was deprecated in Python 3.2 and removed in 3.9. "
+            "Only fires where the receiver's type resolves to `array.array` or a subclass."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.9", "array"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        return rename_methods("array.array", {"tostring": "tobytes"})
+
+
+@categorize(_Python39)
+class ReplaceArrayFromstring(Recipe):
+    """
+    Replace ``array.fromstring()`` with ``array.frombytes()``.
+
+    The ``fromstring()`` method was deprecated in Python 3.2 and removed in
+    Python 3.9. ``frombytes()`` behaves identically.
+
+    Example:
+        Before:
+            import array
+            my_array = array.array("b")
+            my_array.fromstring(data)
+
+        After:
+            import array
+            my_array = array.array("b")
+            my_array.frombytes(data)
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.ReplaceArrayFromstring"
+
+    @property
+    def display_name(self) -> str:
+        return "Replace `array.fromstring()` with `array.frombytes()`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Replace `fromstring()` with `frombytes()` on array objects. "
+            "The `fromstring()` method was deprecated in Python 3.2 and removed in 3.9. "
+            "Only fires where the receiver's type resolves to `array.array` or a subclass."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.9", "array"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        return rename_methods("array.array", {"fromstring": "frombytes"})
+
+
+_ARRAY = "array.array <constructor>(..)"
+_ARRAY_MATCHER = MethodMatcher.create(_ARRAY)
+
+
+def _typecode(call: MethodInvocation) -> Optional[J]:
+    for arg in call.arguments:
+        if isinstance(arg, NamedArgument):
+            if isinstance(arg.name, Identifier) and arg.name.simple_name == "typecode":
+                return arg.value
+        elif not isinstance(arg, Empty):
+            return arg
+    return None
+
+
+@categorize(_Python313)
+class FindArrayUnicodeTypecode(Recipe):
+    """
+    Find arrays created with the `'u'` typecode, deprecated in Python 3.13
+    and scheduled for removal in Python 3.16.
+
+    `'u'` stores `wchar_t`, two bytes on Windows and four elsewhere. `'w'`
+    stores `Py_UCS4`, four bytes everywhere, so code reading the array's raw
+    bytes on Windows needs adjusting too.
+
+    Example:
+        Before:
+            import array
+            chars = array.array("u", "hello")
+
+        After:
+            import array
+            chars = array.array("w", "hello")
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.FindArrayUnicodeTypecode"
+
+    @property
+    def display_name(self) -> str:
+        return "Find `array` `'u'` typecode"
+
+    @property
+    def description(self) -> str:
+        return (
+            "The `'u'` typecode of `array.array` was deprecated in Python 3.13 and is scheduled for "
+            "removal in Python 3.16. Use `'w'`, which stores 4-byte `Py_UCS4` code points where `'u'` "
+            "stored the platform's `wchar_t`, 2 bytes on Windows."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.13", "3.16", "array"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        class Visitor(PythonVisitor[ExecutionContext]):
+            def visit_method_invocation(self, method: MethodInvocation, p: ExecutionContext) -> J:
+                m = super().visit_method_invocation(method, p)
+                if not isinstance(m, MethodInvocation) or not _ARRAY_MATCHER.matches(m, cursor=self.cursor):
+                    return m
+                typecode = _typecode(m)
+                if isinstance(typecode, Literal) and typecode.value == "u":
+                    return mark_deprecated(
+                        m,
+                        "The 'u' array typecode is deprecated and removed in Python 3.16. "
+                        "Use 'w' (4-byte Py_UCS4) instead.",
+                    )
+                return m
+
+        return Preconditions.check(uses_method(_ARRAY), Visitor())

{openrewrite_migrate_python-0.17.0.dev20261022193254 → openrewrite_migrate_python-0.17.0.dev20261022194832}/src/openrewrite_migrate_python/migrate/asyncio_deprecations.py

@@ -13,10 +13,14 @@ becomes:
     async def my_func():
         await something()
 
+``asyncio.iscoroutinefunction()`` and the event loop policy system were
+deprecated in Python 3.14 and are scheduled for removal in Python 3.16.
+
 See: https://docs.python.org/3/library/asyncio-task.html
+See: https://docs.python.org/3/deprecations/pending-removal-in-3.16.html
 """
 
-from typing import Any
+from typing import Any, List
 
 from rewrite import ExecutionContext, Preconditions, Recipe, TreeVisitor
 from rewrite.category import CategoryDescriptor
@@ -24,8 +28,10 @@ from rewrite.decorators import categorize
 from rewrite.marketplace import Python
 from rewrite.python.binding_utils import import_bindings
 from rewrite.python.preconditions import uses_import
+from rewrite.python.recipes import ChangeImport
 from rewrite.python.visitor import PythonVisitor
 from rewrite.java.tree import FieldAccess, Identifier, J
+from ._finders import find_member_references
 from ._markers import mark_deprecated
 
 # Define category path: Python > Migrate > Python 3.11
@@ -35,6 +41,13 @@ _Python311 = [
     CategoryDescriptor(display_name="Python 3.11"),
 ]
 
+# Define category path: Python > Migrate > Python 3.14
+_Python314 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.14"),
+]
+
 
 def _mark(tree: J) -> J:
     return mark_deprecated(
@@ -106,3 +119,104 @@ class FindAsyncioCoroutineDecorator(Recipe):
                 return _mark(i)
 
         return Preconditions.check(uses_import("asyncio"), Visitor())
+
+
+@categorize(_Python314)
+class ReplaceAsyncioIscoroutinefunction(Recipe):
+    """
+    Replace `asyncio.iscoroutinefunction()` with
+    `inspect.iscoroutinefunction()`.
+
+    Example:
+        Before:
+            import asyncio
+            asyncio.iscoroutinefunction(handler)
+
+        After:
+            import inspect
+            inspect.iscoroutinefunction(handler)
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.ReplaceAsyncioIscoroutinefunction"
+
+    @property
+    def display_name(self) -> str:
+        return "Replace `asyncio.iscoroutinefunction()` with `inspect.iscoroutinefunction()`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "`asyncio.iscoroutinefunction()` was deprecated in Python 3.14 and is scheduled for "
+            "removal in Python 3.16. Use `inspect.iscoroutinefunction()` instead."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.14", "3.16", "asyncio"]
+
+    def recipe_list(self) -> List[Recipe]:
+        return [
+            ChangeImport(
+                old_module="asyncio",
+                old_name="iscoroutinefunction",
+                new_module="inspect",
+                new_name="iscoroutinefunction",
+            )
+        ]
+
+
+_POLICY_MESSAGE = (
+    "The asyncio policy system is deprecated and removed in Python 3.16. "
+    "Pass loop_factory to asyncio.run() or asyncio.Runner instead."
+)
+_POLICY_MEMBERS = (
+    "AbstractEventLoopPolicy",
+    "DefaultEventLoopPolicy",
+    "WindowsSelectorEventLoopPolicy",
+    "WindowsProactorEventLoopPolicy",
+    "get_event_loop_policy",
+    "set_event_loop_policy",
+)
+
+
+@categorize(_Python314)
+class FindAsyncioEventLoopPolicy(Recipe):
+    """
+    Find uses of the asyncio policy system, deprecated in Python 3.14 and
+    scheduled for removal in Python 3.16.
+
+    Example:
+        Before:
+            import asyncio
+            asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+            asyncio.run(main())
+
+        After:
+            import asyncio
+            asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.FindAsyncioEventLoopPolicy"
+
+    @property
+    def display_name(self) -> str:
+        return "Find deprecated asyncio event loop policies"
+
+    @property
+    def description(self) -> str:
+        return (
+            "The asyncio policy system (`get_event_loop_policy()`, `set_event_loop_policy()` and the "
+            "`*EventLoopPolicy` classes) was deprecated in Python 3.14 and is scheduled for removal "
+            "in Python 3.16. Pass `loop_factory` to `asyncio.run()` or `asyncio.Runner` instead."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.14", "3.16", "asyncio"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        return find_member_references({f"asyncio.{member}": _POLICY_MESSAGE for member in _POLICY_MEMBERS})

openrewrite_migrate_python-0.17.0.dev20261022194832/src/openrewrite_migrate_python/migrate/builtins_deprecations.py

@@ -0,0 +1,89 @@
+"""
+Recipe for finding bitwise inversion of a `bool`.
+
+`~True` and `~False` were deprecated in Python 3.12 and are scheduled for
+removal in Python 3.16.
+
+See: https://docs.python.org/3/deprecations/pending-removal-in-3.16.html
+"""
+
+from typing import Any, List
+
+from rewrite import ExecutionContext, Recipe, TreeVisitor
+from rewrite.category import CategoryDescriptor
+from rewrite.decorators import categorize
+from rewrite.java.support_types import JavaType
+from rewrite.java.tree import J, Literal, Unary
+from rewrite.marketplace import Python
+from rewrite.python.visitor import PythonVisitor
+
+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 FindBitwiseInversionOnBool(Recipe):
+    """
+    Find `~` applied to a `bool`, deprecated in Python 3.12 and scheduled
+    for removal in Python 3.16.
+
+    `~True` is `-2` and `~False` is `-1`, both truthy, so `~flag` almost
+    always meant `not flag`.
+
+    Example:
+        Before:
+            def toggle(enabled: bool) -> bool:
+                return ~enabled
+
+        After:
+            def toggle(enabled: bool) -> bool:
+                return not enabled
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.FindBitwiseInversionOnBool"
+
+    @property
+    def display_name(self) -> str:
+        return "Find bitwise inversion `~` on a `bool`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Bitwise inversion of a `bool` (`~True` is `-2`) was deprecated in Python 3.12 and is "
+            "scheduled for removal in Python 3.16. Use `not x` for logical negation, or `~int(x)` "
+            "for the integer inversion. Only fires on a `bool` literal or where the operand's type "
+            "resolves to `bool`."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.12", "3.16"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        class Visitor(PythonVisitor[ExecutionContext]):
+            def visit_unary(self, unary: Unary, p: ExecutionContext) -> J:
+                u = super().visit_unary(unary, p)
+                if (
+                    isinstance(u, Unary)
+                    and u.operator == Unary.Type.Complement
+                    and (
+                        u.expression.type == JavaType.Primitive.Boolean
+                        or (isinstance(u.expression, Literal) and isinstance(u.expression.value, bool))
+                    )
+                ):
+                    return mark_deprecated(
+                        u,
+                        "Bitwise inversion of a bool is deprecated and removed in Python 3.16. "
+                        "Use `not x`, or `~int(x)` for the integer inversion.",
+                    )
+                return u
+
+        return Visitor()

{openrewrite_migrate_python-0.17.0.dev20261022193254 → openrewrite_migrate_python-0.17.0.dev20261022194832}/src/openrewrite_migrate_python/migrate/collections_abc_migrations.py

@@ -4,17 +4,22 @@ Recipes for migrating deprecated collections imports to collections.abc.
 The abstract base classes were moved from `collections` to `collections.abc`
 in Python 3.3 and the old import locations were removed in Python 3.10.
 
+``collections.abc.ByteString`` itself, and the ``typing.ByteString`` alias,
+are scheduled for removal in Python 3.17; ``FindByteString`` reports them.
+
 See: https://docs.python.org/3/library/collections.abc.html
 """
 
-from typing import List
+from typing import Any, List
 
-from rewrite import Recipe
+from rewrite import ExecutionContext, Recipe, TreeVisitor
 from rewrite.category import CategoryDescriptor
 from rewrite.decorators import categorize
 from rewrite.marketplace import Python
 from rewrite.python.recipes import ChangeImport
 
+from ._finders import find_member_references
+
 # Define category path: Python > Migrate > Python 3.10
 _Python310 = [
     *Python,
@@ -22,6 +27,13 @@ _Python310 = [
     CategoryDescriptor(display_name="Python 3.10"),
 ]
 
+# Define category path: Python > Migrate > Python 3.12
+_Python312 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.12"),
+]
+
 # All ABC aliases that `collections` re-exported until their removal in
 # Python 3.10 (`_collections_abc.__all__` as of Python 3.9).
 COLLECTIONS_ABC_CLASSES: tuple = (
@@ -98,3 +110,55 @@ class ReplaceCollectionsAbcImports(Recipe):
             )
             for abc_class in COLLECTIONS_ABC_CLASSES
         ]
+
+
+_BYTESTRING_MESSAGE = (
+    "ByteString is deprecated and removed in Python 3.17. Use collections.abc.Buffer, "
+    "or a union such as bytes | bytearray | memoryview."
+)
+
+
+@categorize(_Python312)
+class FindByteString(Recipe):
+    """
+    Find references to `collections.abc.ByteString` and
+    `typing.ByteString`, scheduled for removal in Python 3.17.
+
+    Example:
+        Before:
+            from collections.abc import ByteString
+
+            def checksum(data: ByteString) -> int: ...
+
+        After:
+            from collections.abc import Buffer
+
+            def checksum(data: Buffer) -> int: ...
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.FindByteString"
+
+    @property
+    def display_name(self) -> str:
+        return "Find deprecated `ByteString`"
+
+    @property
+    def description(self) -> str:
+        return (
+            "`collections.abc.ByteString` (deprecated in Python 3.12) and `typing.ByteString` "
+            "(deprecated in Python 3.9) are scheduled for removal in Python 3.17. Use "
+            "`collections.abc.Buffer` to accept any buffer, or a union of the types the code "
+            "supports, such as `bytes | bytearray | memoryview`."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.12", "3.17", "typing"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        return find_member_references({
+            "collections.abc.ByteString": _BYTESTRING_MESSAGE,
+            "typing.ByteString": _BYTESTRING_MESSAGE,
+        })

openrewrite_migrate_python-0.17.0.dev20261022194832/src/openrewrite_migrate_python/migrate/profile_deprecations.py

@@ -0,0 +1,68 @@
+"""
+Recipe for finding the deprecated `profile` module.
+
+The `profile` module was deprecated in Python 3.15 and is scheduled for
+removal in Python 3.17.
+
+See: https://docs.python.org/3/deprecations/pending-removal-in-3.17.html
+"""
+
+from typing import Any, List
+
+from rewrite import ExecutionContext, Recipe, TreeVisitor
+from rewrite.category import CategoryDescriptor
+from rewrite.decorators import categorize
+from rewrite.marketplace import Python
+
+from ._module_imports import find_module_imports
+
+# Define category path: Python > Migrate > Python 3.15
+_Python315 = [
+    *Python,
+    CategoryDescriptor(display_name="Migrate"),
+    CategoryDescriptor(display_name="Python 3.15"),
+]
+
+
+@categorize(_Python315)
+class FindProfileModule(Recipe):
+    """
+    Find imports of the `profile` module, deprecated in Python 3.15 and
+    scheduled for removal in Python 3.17.
+
+    Example:
+        Before:
+            import profile
+            profile.run("main()")
+
+        After:
+            import cProfile
+            cProfile.run("main()")
+    """
+
+    @property
+    def name(self) -> str:
+        return "org.openrewrite.python.migrate.FindProfileModule"
+
+    @property
+    def display_name(self) -> str:
+        return "Find deprecated `profile` module"
+
+    @property
+    def description(self) -> str:
+        return (
+            "The pure-Python `profile` module was deprecated in Python 3.15 and is scheduled for "
+            "removal in Python 3.17. Use `profiling.tracing` (new in 3.15) or `cProfile`, which "
+            "provide a compatible API but no custom timers or bias calibration."
+        )
+
+    @property
+    def tags(self) -> List[str]:
+        return ["python", "migration", "3.15", "3.17", "profile"]
+
+    def editor(self) -> TreeVisitor[Any, ExecutionContext]:
+        return find_module_imports(
+            "profile",
+            "The `profile` module is deprecated and removed in Python 3.17. "
+            "Use `profiling.tracing` or `cProfile` instead.",
+        )