new: Add Python tier 2 and 3 support.

CHANGELOG.md

@@ -23,6 +23,12 @@
 - Added 7 new token variables: `$arch`, `$os`, `$osFamily`, `$vcsBranch`, `$vcsRepository`,
   `$vcsRevision`, `$workingDir`
 - Added a `rust.binstallVersion` setting to `.moon/toolchain.yml`.
+- Added Python tier 3 support.
+  - Will download and install Python into the toolchain when a `version` is configured.
+  - Will parse the `requirements.txt` to resolve and install dependencies.
+  - Added a `python.version` setting to `.moon/toolchain.yml`.
+  - Added a `toolchain.python` setting to `moon.yml`.
+  - Updated `moon bin` commands to support Python.
 
 #### 🐞 Fixes
 

crates/app/Cargo.toml

@@ -89,6 +89,9 @@ moon_deno_platform = { path = "../../legacy/deno/platform" }
 moon_node_lang = { path = "../../legacy/node/lang" }
 moon_node_tool = { path = "../../legacy/node/tool" }
 moon_node_platform = { path = "../../legacy/node/platform" }
+moon_python_lang = { path = "../../legacy/python/lang" }
+moon_python_tool = { path = "../../legacy/python/tool" }
+moon_python_platform = { path = "../../legacy/python/platform" }
 moon_rust_lang = { path = "../../legacy/rust/lang" }
 moon_rust_tool = { path = "../../legacy/rust/tool" }
 moon_rust_platform = { path = "../../legacy/rust/platform" }

crates/app/src/systems/analyze.rs

@@ -8,6 +8,7 @@ use moon_console::{Checkpoint, Console};
 use moon_deno_platform::DenoPlatform;
 use moon_node_platform::NodePlatform;
 use moon_platform::PlatformManager;
+use moon_python_platform::PythonPlatform;
 use moon_rust_platform::RustPlatform;
 use moon_system_platform::SystemPlatform;
 use moon_toolchain_plugin::ToolchainRegistry;
@@ -172,6 +173,18 @@ pub async fn register_platforms(
         );
     }
 
+    if let Some(python_config) = &toolchain_config.python {
+        registry.register(
+            PlatformType::Python,
+            Box::new(PythonPlatform::new(
+                python_config,
+                workspace_root,
+                Arc::clone(proto_env),
+                Arc::clone(&console),
+            )),
+        );
+    }
+
     if let Some(rust_config) = &toolchain_config.rust {
         registry.register(
             PlatformType::Rust,

crates/cli/tests/run_python_test.rs

@@ -0,0 +1,65 @@
+use moon_config::{PartialPipConfig, PartialPythonConfig};
+use moon_test_utils::{
+    assert_snapshot, create_sandbox_with_config, get_python_fixture_configs, Sandbox,
+};
+use proto_core::UnresolvedVersionSpec;
+
+fn python_sandbox(config: PartialPythonConfig) -> Sandbox {
+    python_sandbox_with_config(|_| {}, config)
+}
+
+fn python_sandbox_with_config<C>(callback: C, config: PartialPythonConfig) -> Sandbox
+where
+    C: FnOnce(&mut PartialPythonConfig),
+{
+    let (workspace_config, mut toolchain_config, tasks_config) = get_python_fixture_configs();
+
+    toolchain_config.python = Some(config);
+
+    if let Some(python_config) = &mut toolchain_config.python {
+        callback(python_config);
+    }
+
+    let sandbox = create_sandbox_with_config(
+        "python",
+        Some(workspace_config),
+        Some(toolchain_config),
+        Some(tasks_config),
+    );
+
+    sandbox.enable_git();
+    sandbox
+}
+
+#[test]
+fn runs_standard_script() {
+    let sandbox = python_sandbox(PartialPythonConfig {
+        version: Some(UnresolvedVersionSpec::parse("3.11.10").unwrap()),
+        ..PartialPythonConfig::default()
+    });
+    let assert = sandbox.run_moon(|cmd| {
+        cmd.arg("run").arg("python:standard");
+    });
+
+    assert_snapshot!(assert.output());
+}
+
+#[test]
+fn runs_install_deps_via_args() {
+    let sandbox = python_sandbox(PartialPythonConfig {
+        version: Some(UnresolvedVersionSpec::parse("3.11.10").unwrap()),
+        pip: Some(PartialPipConfig {
+            install_args: Some(vec![
+                "--quiet".to_string(),
+                "--disable-pip-version-check".to_string(),
+                "poetry==1.8.4".to_string(),
+            ]),
+        }),
+        ..PartialPythonConfig::default()
+    });
+    let assert = sandbox.run_moon(|cmd| {
+        cmd.arg("run").arg("python:poetry");
+    });
+
+    assert_snapshot!(assert.output());
+}

crates/cli/tests/snapshots/run_python_test__runs_install_deps_via_args.snap

@@ -0,0 +1,14 @@
+---
+source: crates/cli/tests/run_python_test.rs
+assertion_line: 60
+expression: assert.output()
+snapshot_kind: text
+---
+▪▪▪▪ activate virtual environment
+▪▪▪▪ pip install
+▪▪▪▪ python:poetry
+Poetry (version 1.8.4)
+▪▪▪▪ python:poetry (100ms)
+
+Tasks: 1 completed
+ Time: 100ms

crates/cli/tests/snapshots/run_python_test__runs_standard_script.snap

@@ -0,0 +1,11 @@
+---
+source: crates/cli/tests/run_python_test.rs
+assertion_line: 38
+expression: assert.output()
+---
+▪▪▪▪ python:standard
+Python 3.11.10
+▪▪▪▪ python:standard (100ms)
+
+Tasks: 1 completed
+ Time: 100ms

crates/config/src/language_platform.rs

@@ -70,6 +70,7 @@ derive_enum!(
         Bun,
         Deno,
         Node,
+        Python,
         Rust,
         System,
         #[default]
@@ -103,6 +104,7 @@ mod tests {
         assert_eq!(LanguageType::Go.to_string(), "go");
         assert_eq!(LanguageType::JavaScript.to_string(), "javascript");
         assert_eq!(LanguageType::Ruby.to_string(), "ruby");
+        assert_eq!(LanguageType::Python.to_string(), "python");
         assert_eq!(LanguageType::Unknown.to_string(), "unknown");
         assert_eq!(LanguageType::Other(Id::raw("dotnet")).to_string(), "dotnet");
     }

crates/config/src/project/overrides_config.rs

@@ -49,6 +49,10 @@ cacheable!(
         #[setting(nested)]
         pub deno: Option<ProjectToolchainCommonToolConfig>,
 
+        /// Overrides `python` settings.
+        #[setting(nested)]
+        pub python: Option<ProjectToolchainCommonToolConfig>,
+
         /// Overrides `node` settings.
         #[setting(nested)]
         pub node: Option<ProjectToolchainCommonToolConfig>,

crates/config/src/toolchain/mod.rs

@@ -3,6 +3,7 @@ mod bun_config;
 mod deno_config;
 mod moon_config;
 mod node_config;
+mod python_config;
 mod rust_config;
 mod typescript_config;
 
@@ -11,6 +12,7 @@ pub use bun_config::*;
 pub use deno_config::*;
 pub use moon_config::*;
 pub use node_config::*;
+pub use python_config::*;
 pub use rust_config::*;
 pub use typescript_config::*;
 

crates/config/src/toolchain/python_config.rs

@@ -0,0 +1,35 @@
+// use super::bin_config::BinEntry;
+use schematic::Config;
+use serde::Serialize;
+use version_spec::UnresolvedVersionSpec;
+use warpgate_api::PluginLocator;
+
+#[derive(Clone, Config, Debug, PartialEq, Serialize)]
+pub struct PipConfig {
+    /// List of arguments to append to `pip install` commands.
+    pub install_args: Option<Vec<String>>,
+}
+
+#[derive(Clone, Config, Debug, PartialEq)]
+pub struct PythonConfig {
+    /// Location of the WASM plugin to use for Python support.
+    pub plugin: Option<PluginLocator>,
+
+    /// Options for pip, when used as a package manager.
+    #[setting(nested)]
+    pub pip: Option<PipConfig>,
+
+    /// Defines the virtual environment name which will be created on workspace root.
+    /// Project dependencies will be installed into this. Defaults to `.venv`
+    #[setting(default = ".venv")]
+    pub venv_name: String,
+
+    /// Assumes only the root `requirements.txt` is used for dependencies.
+    /// Can be used to support the "one version policy" pattern.
+    #[setting(default = true)]
+    pub root_requirements_only: bool,
+
+    /// The version of Python to download, install, and run `python` tasks with.
+    #[setting(env = "MOON_PYTHON_VERSION")]
+    pub version: Option<UnresolvedVersionSpec>,
+}