Clear disabled python environments

ST lists older python environments' lib paths in `sys.path` which may likely
cause import errors in case order is mixed up by plugins. To avoid any conflicts
remove libraries and caches of all disabled/absent python environments.

Note: This might hit people switching between ST revisions with py38 and py313.

Author: deathaxe

Package Control.sublime-settings

@@ -89,6 +89,9 @@
 	// the Package Control.sublime-settings file was synced to this machine.
 	"remove_orphaned": true,
 
+	// Remove libraries of disabled or absent plugin_hosts at startup.
+	"remove_orphaned_enviornments": true,
+
 	// If incompatible packages should be automatically upgraded when ST starts.
 	// If ST is upgraded or moved to other computers, installed packages may
 	// become incompatible with either ST, OS or CPU architecture.

package_control/clear_directory.py

@@ -40,6 +40,9 @@ def clear_directory(directory, ignored_files=None, ignore_errors=True):
         If all of the files and folders were successfully deleted
     """
 
+    if not os.path.isdir(directory):
+        return True
+
     # make sure not to lock directory by current working directory
     if sys_path.longpath(os.path.normcase(os.getcwd())).startswith(os.path.normcase(directory)):
         os.chdir(os.path.dirname(directory))

package_control/package_cleanup.py

@@ -65,6 +65,9 @@ def run(self):
         # Clear trash
         clear_directory(sys_path.trash_path())
 
+        # Cleanup disabled python environments
+        self.cleanup_python_environments()
+
         # Scan through packages and complete pending operations
         found_packages = self.cleanup_pending_packages()
 
@@ -141,6 +144,36 @@ def run(self):
         if message:
             show_message('Sublime Text needs to be restarted %s.' % message)
 
+    def cleanup_python_environments(self):
+        """
+        Remove library and cache folders of disabled or absent plugin_hosts.
+        """
+        if not self.manager.settings.get('remove_orphaned_enviornments'):
+            return
+
+        # actual library dir
+        libdir = os.path.join(sys_path.data_path(), "Lib", "python")
+        # portable cache dir
+        cache1 = os.path.join(sys_path.cache_path(), "__pycache__", "install", "Data", "Lib", "python")
+        # normal setup's cache dir
+        cache2 = os.path.join(sys_path.cache_path(), "__pycache__", "data", "Lib", "python")
+
+        supported_versions = sys_path.python_versions()
+        if "3.3" not in supported_versions:
+            # Python folder is re-created at each startup, hence just clear it for now.
+            clear_directory(libdir + "33")
+            # Python 3.3 itself doesn't support nor create compiled cache modules,
+            # ST's fallback mechanism might however have created some py38 or py313 cache files
+            # in those directories, which need to be cleared out.
+            delete_directory(cache1 + "33")
+            delete_directory(cache2 + "33")
+
+        if "3.8" not in supported_versions:
+            # if 3.8 is not supported it is not present, delete all folders
+            delete_directory(libdir + "38")
+            delete_directory(cache1 + "38")
+            delete_directory(cache2 + "38")
+
     def cleanup_pending_packages(self):
         """
         Scan through packages and complete pending operations

package_control/package_manager.py

@@ -120,6 +120,7 @@ def __init__(self):
             'proxy_password',
             'proxy_username',
             'remove_orphaned',
+            'remove_orphaned_enviornments',
             'renamed_packages',
             'repositories',
             'submit_url',