From 14a7d76b6dd8e13e3b0925d4eed5f99a2949d6bd Mon Sep 17 00:00:00 2001 From: "QUALISYSTEMS\\nahum-t" Date: Sun, 6 Sep 2026 09:40:02 +0300 Subject: [PATCH] Dev guide: modernize Python install guidance for shell developers The dev-env page told developers to install Python 3.9.x (EOL Oct 2025) and carried pip-version guidance from the 2.7 era; the getting-started page used a Python27 path example. Now: install a current 64-bit Python 3 (shellfoundry supports 3.9-3.13; 3.13 needs shellfoundry 1.2.29+), with an explicit note that shells still EXECUTE on the Python bundled with CloudShell (3.9.9 / 2.7.18), so driver code must stay compatible with that. Co-Authored-By: Claude Fable 5 --- docs/devguide/developing-shells/getting-started.md | 2 +- docs/devguide/setting-up-dev-env.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/devguide/developing-shells/getting-started.md b/docs/devguide/developing-shells/getting-started.md index 5e6466e33d..cb291ea857 100644 --- a/docs/devguide/developing-shells/getting-started.md +++ b/docs/devguide/developing-shells/getting-started.md @@ -56,7 +56,7 @@ Run the following in your local Command Line: python -m pip install shellfoundry ``` -For windows users, it is recommended to add the path (to the shellfoundry installation folder) to your local environment variables. For example, C:\\Python27\\Scripts. This will enable us to run the Shellfoundry commands from any folder of the Shell project. +For windows users, it is recommended to add the path (to the shellfoundry installation folder) to your local environment variables. For example, C:\\Python313\\Scripts. This will enable us to run the Shellfoundry commands from any folder of the Shell project. **To update Shellfoundry:** diff --git a/docs/devguide/setting-up-dev-env.md b/docs/devguide/setting-up-dev-env.md index add2e0dc78..0299cad8a6 100644 --- a/docs/devguide/setting-up-dev-env.md +++ b/docs/devguide/setting-up-dev-env.md @@ -6,11 +6,13 @@ sidebar_position: 1 In this section we’ll go over the recommended steps for setting up a development environment for developing CloudShell Shells and orchestration scripts. -## Get the latest Python 3.9.x +## Install Python ![Python](/Images/Devguide-intro/Intro-Setting-up-the-Development.png) -Download and install the latest version of Python 3.9.x from the [official website](https://www.python.org/downloads/). We also recommend installing pip (even though technically its included in the latest versions of Python): pip 21.2.4 and up for Python 3.7 and pip 19.2.3 for Python 2.7.18. Python 2.7.x is supported for older shells. Follow the instructions on this website: [https://pip.pypa.io/en/stable/installing/](https://pip.pypa.io/en/stable/installing/) +Download and install a current 64-bit version of Python 3 from the [official website](https://www.python.org/downloads/). Shellfoundry, CloudShell's shell development CLI, supports Python 3.9–3.13 (Python 3.13 requires shellfoundry 1.2.29 or later). + +Note that shells and scripts *execute* on the Python versions bundled with CloudShell itself — currently Python 3.9.9 (and Python 2.7.18 for legacy shells). Your driver code and its requirements.txt must stay compatible with the bundled version your CloudShell deployment runs, even if your dev machine uses a newer Python. :::tip CloudShell components such as Quali Server and the execution servers come with their own Python installation folders. Making changes to these folders may cause unexpected behavior in CloudShell. Therefore, if you plan on doing dev work on a machine that has CloudShell components installed, we recommend doing one of the following: