Implement upgrading built-in Python from 3.9 to 3.11

Author: ivankravets

src/installer/stages/platformio-core.js

@@ -48,8 +48,21 @@ export default class PlatformIOCoreStage extends BaseStage {
         throw new Error('PlatformIO Core has not been installed yet!');
       }
     }
-    // check that PIO Core is installed and load its state an patch OS environ
+    // check that PIO Core is installed
     await this.loadCoreState();
+
+    // check if outdated built-in Python
+    if (await this.isBuiltinPythonOutdated()) {
+      return false;
+    }
+
+    // Setup `platformio` CLI globally for a Node.JS process
+    if (this.params.useBuiltinPIOCore) {
+      proc.extendOSEnvironPath('PLATFORMIO_PATH', [
+        core.getEnvBinDir(),
+        core.getEnvDir(),
+      ]);
+    }
     this.status = BaseStage.STATUS_SUCCESSED;
     return true;
   }
@@ -86,16 +99,6 @@ export default class PlatformIOCoreStage extends BaseStage {
     console.info('PIO Core State', coreState);
     core.setCoreState(coreState);
     await fs.unlink(stateJSONPath); // cleanup
-
-    // Add PIO Core virtualenv to global PATH
-    // Setup `platformio` CLI globally for a Node.JS process
-    if (this.params.useBuiltinPIOCore) {
-      proc.extendOSEnvironPath('PLATFORMIO_PATH', [
-        core.getEnvBinDir(),
-        core.getEnvDir(),
-      ]);
-    }
-
     return true;
   }
 
@@ -106,6 +109,37 @@ export default class PlatformIOCoreStage extends BaseStage {
     );
   }
 
+  async isBuiltinPythonOutdated() {
+    if (!this.params.useBuiltinPython) {
+      return false;
+    }
+    const builtInPythonDir = PlatformIOCoreStage.getBuiltInPythonDir();
+    const coreState = core.getCoreState();
+    try {
+      await fs.access(builtInPythonDir);
+      if (!coreState.python_version.startsWith('3.9.')) {
+        throw new Error('Not 3.9 Python in penv');
+      }
+      const pkgVersion = (
+        await misc.loadJSON(path.join(builtInPythonDir, 'package.json'))
+      ).version;
+      if (!pkgVersion.startsWith('1.309')) {
+        throw new Error('Not 3.9 Python package');
+      }
+    } catch (err) {
+      return false;
+    }
+    if ((coreState.system || '').startsWith('windows')) {
+      try {
+        await fs.unlink(path.join(builtInPythonDir, 'python.exe'));
+      } catch (err) {
+        return false;
+      }
+    }
+    console.info('Upgrading built-in Python...');
+    return true;
+  }
+
   async whereIsPython({ prompt = false } = {}) {
     let status = this.params.pythonPrompt.STATUS_TRY_AGAIN;
     this.configureBuiltInPython();