From f71ecb1a847f866ed8070104c42dc556a17edd3f Mon Sep 17 00:00:00 2001
From: Vitaly Legchilkin <vitaly.legchilkin@jetbrains.com>
Date: Tue, 3 Mar 2026 12:50:28 +0100
Subject: [PATCH] PY-88108 Make PythonPackageManager listing and dependency
 methods Experimental API

Promote five methods from @ApiStatus.Internal to @ApiStatus.Experimental:
- listInstalledPackages()
- listInstalledPackagesSnapshot()
- listOutdatedPackages()
- listOutdatedPackagesSnapshot()
- extractDependenciesCached()

Update pycharm_api.txt allowlist accordingly.

IJ-MR-194281

GitOrigin-RevId: 61c645dddd790316255318245eeee53e917132b6
---
 .../packaging/management/PythonPackageManager.kt       | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/python/src/com/jetbrains/python/packaging/management/PythonPackageManager.kt b/python/src/com/jetbrains/python/packaging/management/PythonPackageManager.kt
index 92f8b40c197c..01e972a4ec44 100644
--- a/python/src/com/jetbrains/python/packaging/management/PythonPackageManager.kt
+++ b/python/src/com/jetbrains/python/packaging/management/PythonPackageManager.kt
@@ -187,25 +187,25 @@ abstract class PythonPackageManager(val project: Project, val sdk: Sdk) : Dispos
   }
 
 
-  @ApiStatus.Internal
+  @ApiStatus.Experimental
   suspend fun listInstalledPackages(): List<PythonPackage> {
     waitForInit()
     return listInstalledPackagesSnapshot()
   }
 
-  @ApiStatus.Internal
+  @ApiStatus.Experimental
   fun listInstalledPackagesSnapshot(): List<PythonPackage> {
     return installedPackages
   }
 
-  @ApiStatus.Internal
+  @ApiStatus.Experimental
   suspend fun listOutdatedPackages(): Map<String, PythonOutdatedPackage> {
     waitForInit()
     return listOutdatedPackagesSnapshot()
   }
 
 
-  @ApiStatus.Internal
+  @ApiStatus.Experimental
   fun listOutdatedPackagesSnapshot(): Map<String, PythonOutdatedPackage> {
     return outdatedPackages
   }
@@ -283,7 +283,7 @@ abstract class PythonPackageManager(val project: Project, val sdk: Sdk) : Dispos
    *         PyResult.Failure if extraction is supported but failed (e.g., parsing error),
    *         PyResult.Success with the list of dependencies if extraction succeeded.
    */
-  @ApiStatus.Internal
+  @ApiStatus.Experimental
   suspend fun extractDependenciesCached(): PyResult<List<PythonPackage>>? {
     val dependencyFile = getDependencyFile() ?: return null
     return createCachedDependencies(dependencyFile).await()