From 469e3dd4e072c3523e8272f164993234d0db2be3 Mon Sep 17 00:00:00 2001
From: Richard Knoll <riknoll@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:23:49 -0700
Subject: [PATCH] adding tutorial option for a python template (#10097)
 (#10182)

---
 localtypings/pxtarget.d.ts |  2 ++
 pxtlib/tutorial.ts         | 23 ++++++++++++++++++++++-
 webapp/src/app.tsx         |  6 ++++--
 3 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/localtypings/pxtarget.d.ts b/localtypings/pxtarget.d.ts
index f2f10b182932..4f6133682caa 100644
--- a/localtypings/pxtarget.d.ts
+++ b/localtypings/pxtarget.d.ts
@@ -1153,6 +1153,7 @@ declare namespace pxt.tutorial {
         code: string[]; // all code
         language?: string; // language of code snippet (ts or python)
         templateCode?: string;
+        templateLanguage?: string; // language of template code
         metadata?: TutorialMetadata;
         assetFiles?: pxt.Map<string>;
         jres?: string; // JRES to be used when generating hints; necessary for tilemaps
@@ -1258,6 +1259,7 @@ declare namespace pxt.tutorial {
         tutorialCode?: string[]; // all tutorial code bundled
         tutorialRecipe?: boolean; // micro tutorial running within the context of a script
         templateCode?: string;
+        templateLanguage?: string;
         mergeHeaderId?: string;
         mergeCarryoverCode?: boolean;
         autoexpandStep?: boolean; // autoexpand tutorial card if instruction text overflows
diff --git a/pxtlib/tutorial.ts b/pxtlib/tutorial.ts
index 115ab065a772..80a2832c60ba 100644
--- a/pxtlib/tutorial.ts
+++ b/pxtlib/tutorial.ts
@@ -13,6 +13,7 @@ namespace pxt.tutorial {
         const {
             code,
             templateCode,
+            templateLanguage,
             editor,
             language,
             jres,
@@ -51,6 +52,7 @@ namespace pxt.tutorial {
             activities,
             code,
             templateCode,
+            templateLanguage,
             metadata,
             language,
             jres,
@@ -63,7 +65,7 @@ namespace pxt.tutorial {
     }
 
     export function getMetadataRegex(): RegExp {
-        return /``` *(sim|block|blocks|filterblocks|spy|ghost|typescript|ts|js|javascript|template|python|jres|assetjson|customts|simtheme)\s*\n([\s\S]*?)\n```/gmi;
+        return /``` *(sim|block|blocks|filterblocks|spy|ghost|typescript|ts|js|javascript|template|python|jres|assetjson|customts|simtheme|python-template|ts-template|typescript-template|js-template|javascript-template)\s*\n([\s\S]*?)\n```/gmi;
     }
 
     function computeBodyMetadata(body: string) {
@@ -74,6 +76,7 @@ namespace pxt.tutorial {
         let jres: string;
         let code: string[] = [];
         let templateCode: string;
+        let templateLanguage: string;
         let language: string;
         let idx = 0;
         let assetJson: string;
@@ -109,6 +112,22 @@ namespace pxt.tutorial {
                     case "template":
                         templateCode = m2;
                         break;
+                    case "python-template":
+                        if (!checkTutorialEditor(pxt.PYTHON_PROJECT_NAME))
+                            return undefined;
+                        templateCode = m2;
+                        templateLanguage = "python";
+                        language = "python";
+                        break;
+                    case "ts-template":
+                    case "typescript-template":
+                    case "js-template":
+                    case "javascript-template":
+                        if (!checkTutorialEditor(pxt.JAVASCRIPT_PROJECT_NAME))
+                            return undefined;
+                        templateCode = m2;
+                        templateLanguage = "typescript";
+                        break;
                     case "jres":
                         jres = m2;
                         break;
@@ -132,6 +151,7 @@ namespace pxt.tutorial {
         return {
             code,
             templateCode,
+            templateLanguage,
             editor,
             language,
             jres,
@@ -443,6 +463,7 @@ ${code}
             tutorialCode: tutorialInfo.code,
             tutorialRecipe: !!recipe,
             templateCode: tutorialInfo.templateCode,
+            templateLanguage: tutorialInfo.templateLanguage,
             autoexpandStep: tutorialInfo.metadata?.autoexpandOff ? false : true,
             metadata: tutorialInfo.metadata,
             language: tutorialInfo.language,
diff --git a/webapp/src/app.tsx b/webapp/src/app.tsx
index 84199a032ff0..be33663f4a72 100644
--- a/webapp/src/app.tsx
+++ b/webapp/src/app.tsx
@@ -1974,8 +1974,10 @@ export class ProjectView
 
         const projectname = projectNameForEditor(preferredEditor || header.editor);
 
-
-        if (projectname === pxt.JAVASCRIPT_PROJECT_NAME) {
+        if (projectname === pxt.PYTHON_PROJECT_NAME && header.tutorial.templateLanguage === "python") {
+            currentText[pxt.MAIN_PY] = template;
+        }
+        else if (projectname === pxt.JAVASCRIPT_PROJECT_NAME) {
             currentText[pxt.MAIN_TS] = template;
         }
         else if (projectname === pxt.PYTHON_PROJECT_NAME) {