@anvil-works/anvil-cli 0.7.0-canary.17 → 0.7.0-canary.18

package/README.md

@@ -170,17 +170,18 @@ Useful options:
 
 ### `anvil validate`
 
-Check an Anvil app file before syncing, or when the CLI reports a validation error.
+Check an Anvil app file or directory before syncing, or when the CLI reports a validation error.
 
 ```bash
-anvil validate <file>
+anvil validate <path>
 ```
 
-The command chooses the validator from the file path. It supports:
+When given a file, the command chooses the validator from the file path. When given a directory, it recursively validates supported files under that directory. It supports:
 
 - `anvil.yaml`
 - `.yaml` files under `client_code/`, including `client_code/**/form_template.yaml`
 - `.html` files under `client_code/`, including `client_code/**/form_template.html` and module-form `client_code/<Form>.html`
+- `.py` files under `client_code/` and `server_code/`
 
 Common examples:
 
@@ -190,10 +191,15 @@ anvil validate client_code/Form1/form_template.yaml
 anvil validate client_code/Form1.yaml
 anvil validate client_code/Form1/form_template.html
 anvil validate client_code/Form1.html
+anvil validate client_code/Helpers.py
+anvil validate server_code/ServerModule.py
+anvil validate .
 ```
 
 HTML validation parses the template with `@anvil-works/form-template-parser`, checks optional YAML frontmatter, and reports semantic issues such as duplicate explicit component names or invalid component types.
 
+Python validation checks syntax using a local Python interpreter (`ANVIL_PYTHON`, `python3`, or `python`). Form Python under `client_code/` also checks for the matching designer-template import and form class inheritance when a sibling form template exists.
+
 When the file is valid, the command prints a success message and exits with status `0`. When the file is invalid, it prints path-specific validation issues and exits with a non-zero status.
 
 Use `--json` with `anvil validate` to emit structured NDJSON output for scripts or LLM tooling.

package/dist/cli.js

@@ -16288,6 +16288,167 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             ok: true
         };
     }
+    const PYTHON_VALIDATOR_SCRIPT = String.raw`
+import ast
+import json
+import sys
+
+
+def issue_path(error):
+    if getattr(error, "lineno", None) is None:
+        return "root"
+    if getattr(error, "offset", None) is None:
+        return f"line {error.lineno}"
+    return f"line {error.lineno}, column {error.offset}"
+
+
+def base_name(node):
+    if isinstance(node, ast.Name):
+        return node.id
+    if isinstance(node, ast.Attribute):
+        return node.attr
+    return None
+
+
+def imports_template_from_anvil_designer(node, template_name):
+    if node.level < 1:
+        return False
+    if node.module not in ("_anvil_designer", None):
+        return False
+    return any(alias.name == template_name for alias in node.names)
+
+
+file_path = sys.argv[1]
+class_name = sys.argv[2]
+template_name = f"{class_name}Template" if class_name else ""
+source = sys.stdin.read()
+issues = []
+
+try:
+    compile(source, file_path, "exec")
+except SyntaxError as error:
+    issues.append({"path": issue_path(error), "message": error.msg})
+    print(json.dumps({"issues": issues}))
+    sys.exit(0)
+
+if class_name:
+    tree = ast.parse(source, filename=file_path)
+    has_template_import = False
+    has_form_class = False
+
+    for node in ast.walk(tree):
+        if isinstance(node, ast.ImportFrom) and imports_template_from_anvil_designer(node, template_name):
+            has_template_import = True
+        elif isinstance(node, ast.ClassDef) and node.name == class_name:
+            if any(base_name(base) == template_name for base in node.bases):
+                has_form_class = True
+
+    if not has_template_import:
+        issues.append({
+            "path": "root",
+            "message": f"missing {chr(96)}from ._anvil_designer import {template_name}{chr(96)}",
+        })
+    if not has_form_class:
+        issues.append({
+            "path": "root",
+            "message": f"missing class {chr(96)}{class_name}{chr(96)} inheriting from {chr(96)}{template_name}{chr(96)}",
+        })
+
+print(json.dumps({"issues": issues}))
+`;
+    function findPythonInterpreter() {
+        const candidates = [
+            process.env.ANVIL_PYTHON,
+            "python3",
+            "python"
+        ].filter((candidate)=>"string" == typeof candidate && candidate.length > 0);
+        for (const candidate of candidates){
+            const result = (0, external_child_process_namespaceObject.spawnSync)(candidate, [
+                "--version"
+            ], {
+                encoding: "utf8"
+            });
+            if (!result.error && 0 === result.status) return candidate;
+        }
+        return null;
+    }
+    function isClientFormPython(filePath) {
+        if ("__init__.py" === external_path_default().basename(filePath)) {
+            const formDir = external_path_default().dirname(filePath);
+            return external_fs_.existsSync(external_path_default().join(formDir, "form_template.html")) || external_fs_.existsSync(external_path_default().join(formDir, "form_template.yaml"));
+        }
+        const parsed = external_path_default().parse(filePath);
+        return external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.html`)) || external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.yaml`));
+    }
+    function expectedFormClassName(filePath) {
+        if (!isClientFormPython(filePath)) return null;
+        if ("__init__.py" === external_path_default().basename(filePath)) return external_path_default().basename(external_path_default().dirname(filePath));
+        return external_path_default().basename(filePath, ".py");
+    }
+    function isUnderDirectory(filePath, directoryPath) {
+        const relativePath = external_path_default().relative(directoryPath, filePath);
+        return relativePath.length > 0 && !relativePath.startsWith("..") && !external_path_default().isAbsolute(relativePath);
+    }
+    function validatePython(filePath, fileContent, appRoot) {
+        const interpreter = findPythonInterpreter();
+        if (!interpreter) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: "Python validation requires python3 or python on PATH, or ANVIL_PYTHON to be set"
+                }
+            ]
+        };
+        const absolutePath = external_path_default().resolve(filePath);
+        const clientCodeRoot = appRoot ? external_path_default().join(appRoot, "client_code") : null;
+        const formClassName = clientCodeRoot && isUnderDirectory(absolutePath, clientCodeRoot) ? expectedFormClassName(absolutePath) : null;
+        const result = (0, external_child_process_namespaceObject.spawnSync)(interpreter, [
+            "-c",
+            PYTHON_VALIDATOR_SCRIPT,
+            filePath,
+            formClassName ?? ""
+        ], {
+            encoding: "utf8",
+            input: fileContent,
+            maxBuffer: 1048576
+        });
+        if (result.error || 0 !== result.status) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: result.error?.message ?? (result.stderr.trim() || "Python validator failed")
+                }
+            ]
+        };
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        } catch (error) {
+            return {
+                ok: false,
+                message: "Python file could not be validated",
+                issues: [
+                    {
+                        path: "root",
+                        message: error instanceof Error ? error.message : String(error)
+                    }
+                ]
+            };
+        }
+        const issues = parsed.issues ?? [];
+        if (issues.length > 0) return {
+            ok: false,
+            message: "Python file is invalid for Anvil",
+            issues
+        };
+        return {
+            ok: true
+        };
+    }
     const validators_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
     const DB_ACCESS_LEVELS = new Set([
         "none",
@@ -16685,6 +16846,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const relativeToClientCode = normalizedPath.slice(startIndex + clientCodePrefix.length);
             if (relativeToClientCode.endsWith(".yaml")) return "form_template.yaml";
             if (relativeToClientCode.endsWith(".html")) return "form_template.html";
+            if (relativeToClientCode.endsWith(".py")) return "python";
+        }
+        const serverCodePrefix = "server_code/";
+        if (normalizedPath.startsWith(serverCodePrefix) || normalizedPath.includes(`/${serverCodePrefix}`)) {
+            const startIndex = normalizedPath.lastIndexOf(serverCodePrefix);
+            const relativeToServerCode = normalizedPath.slice(startIndex + serverCodePrefix.length);
+            if (relativeToServerCode.endsWith(".py")) return "python";
         }
         return null;
     }
@@ -16792,6 +16960,35 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 target
             };
         }
+        if ("python" === target) {
+            if (existingPath && appRoot) {
+                const clientCodeRoot = external_path_default().join(appRoot, "client_code");
+                const serverCodeRoot = external_path_default().join(appRoot, "server_code");
+                const relativeToClientCode = external_path_default().relative(clientCodeRoot, existingPath);
+                const relativeToServerCode = external_path_default().relative(serverCodeRoot, existingPath);
+                const isInsideClientCode = relativeToClientCode.length > 0 && !relativeToClientCode.startsWith("..") && !external_path_default().isAbsolute(relativeToClientCode);
+                const isInsideServerCode = relativeToServerCode.length > 0 && !relativeToServerCode.startsWith("..") && !external_path_default().isAbsolute(relativeToServerCode);
+                if (!isInsideClientCode && !isInsideServerCode || !existingPath.endsWith(".py")) return {
+                    ok: false,
+                    target,
+                    message: "File is not an Anvil app Python file",
+                    issues: [
+                        {
+                            path: "",
+                            message: `expected a .py file under ${clientCodeRoot} or ${serverCodeRoot}`
+                        }
+                    ]
+                };
+            }
+            const result = validatePython(filePath, fileContent, appRoot);
+            return result.ok ? {
+                ok: true,
+                target
+            } : {
+                ...result,
+                target
+            };
+        }
         return {
             ok: false,
             target: "unknown",
@@ -16799,7 +16996,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             issues: [
                 {
                     path: "",
-                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, client_code/**/*.yaml, and client_code/**/*.html"
+                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, client_code/**/*.yaml, client_code/**/*.html, client_code/**/*.py, and server_code/**/*.py"
                 }
             ]
         };
@@ -22921,6 +23118,123 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         }).catch(()=>{});
     }
+    function collectValidationFiles(dir) {
+        const files = [];
+        const ignoredDirectories = new Set([
+            ".anvil",
+            ".git",
+            "node_modules",
+            "__pycache__"
+        ]);
+        function walk(currentDir) {
+            for (const entry of (0, external_fs_.readdirSync)(currentDir, {
+                withFileTypes: true
+            })){
+                const entryPath = (0, external_path_namespaceObject.join)(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!ignoredDirectories.has(entry.name)) walk(entryPath);
+                    continue;
+                }
+                if (entry.isFile() && inferValidationTarget(entryPath)) files.push(entryPath);
+            }
+        }
+        walk(dir);
+        return files.sort();
+    }
+    function validateSingleFile(file) {
+        let fileContent;
+        try {
+            fileContent = (0, external_fs_.readFileSync)(file, "utf8");
+        } catch (error) {
+            return {
+                file,
+                type: "unknown",
+                valid: false,
+                error: `Failed to read ${file}: ${error.message}`,
+                issues: [
+                    {
+                        path: "",
+                        message: error.message
+                    }
+                ]
+            };
+        }
+        const result = validatePath(file, fileContent);
+        if (result.ok) return {
+            file,
+            type: result.target,
+            valid: true
+        };
+        return {
+            file,
+            type: result.target,
+            valid: false,
+            error: result.message,
+            issues: result.issues
+        };
+    }
+    function logValidationFailure(fileResult) {
+        logger_logger.error(`${fileResult.file} failed validation: ${fileResult.error ?? "Validation failed"}`);
+        for (const issue of fileResult.issues ?? []){
+            const issuePath = issue.path.length > 0 ? issue.path : "root";
+            logger_logger.error(`  - ${issuePath}: ${issue.message}`);
+        }
+    }
+    function handleValidateFile(file) {
+        const fileResult = validateSingleFile(file);
+        if (fileResult.valid) {
+            if (getGlobalOutputConfig().jsonMode) logJsonResult(true, {
+                data: {
+                    file: fileResult.file,
+                    type: fileResult.type,
+                    valid: true
+                }
+            });
+            else logger_logger.success(`${fileResult.file} is valid (${fileResult.type})`);
+            return;
+        }
+        if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+            error: fileResult.error,
+            data: {
+                file: fileResult.file,
+                type: fileResult.type,
+                issues: fileResult.issues ?? []
+            }
+        });
+        else logValidationFailure(fileResult);
+        process.exitCode = 1;
+    }
+    function handleValidateDirectory(dir) {
+        const files = collectValidationFiles(dir);
+        if (0 === files.length) {
+            const error = `No supported files found under ${dir}`;
+            if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+                error,
+                data: {
+                    file: dir,
+                    valid: false,
+                    files: []
+                }
+            });
+            else logger_logger.error(error);
+            process.exitCode = 1;
+            return;
+        }
+        const fileResults = files.map(validateSingleFile);
+        const failedResults = fileResults.filter((result)=>!result.valid);
+        if (getGlobalOutputConfig().jsonMode) logJsonResult(0 === failedResults.length, {
+            error: failedResults.length > 0 ? "Validation failed" : void 0,
+            data: {
+                file: dir,
+                valid: 0 === failedResults.length,
+                count: fileResults.length,
+                files: fileResults
+            }
+        });
+        else for (const fileResult of fileResults)if (fileResult.valid) logger_logger.success(`${fileResult.file} is valid (${fileResult.type})`);
+        else logValidationFailure(fileResult);
+        if (failedResults.length > 0) process.exitCode = 1;
+    }
     function getUpdateInstructions(platform) {
         if ("win32" === platform) return [
             "try { irm https://anvil.works/install-cli.ps1 | iex } catch { npm install -g @anvil-works/anvil-cli@latest }",
@@ -23034,43 +23348,17 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         program.command("update").description("Update anvil to the latest version").alias("u").action(async ()=>{
             await handleUpdateCommand();
         });
-        program.command("validate").description("Validate an Anvil app file by path (anvil.yaml, client_code/**/*.yaml, or client_code/**/*.html)").argument("<file>", "Path to file").action((file)=>{
-            let fileContent;
+        program.command("validate").description("Validate Anvil app files by path or directory (anvil.yaml, client_code/**/*.yaml, client_code/**/*.html, client_code/**/*.py, or server_code/**/*.py)").argument("<path>", "Path to file or directory").action((file)=>{
+            let pathStat;
             try {
-                fileContent = (0, external_fs_.readFileSync)(file, "utf8");
+                pathStat = (0, external_fs_.statSync)(file);
             } catch (error) {
-                logger_logger.error(`Failed to read ${file}: ${error.message}`);
+                logger_logger.error(`Failed to access ${file}: ${error.message}`);
                 process.exitCode = 1;
                 return;
             }
-            const result = validatePath(file, fileContent);
-            if (result.ok) {
-                if (getGlobalOutputConfig().jsonMode) logJsonResult(true, {
-                    data: {
-                        file,
-                        type: result.target,
-                        valid: true
-                    }
-                });
-                else logger_logger.success(`${file} is valid (${result.target})`);
-                return;
-            }
-            if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
-                error: result.message,
-                data: {
-                    file,
-                    type: result.target,
-                    issues: result.issues
-                }
-            });
-            else {
-                logger_logger.error(`${file} failed validation: ${result.message}`);
-                for (const issue of result.issues){
-                    const issuePath = issue.path.length > 0 ? issue.path : "root";
-                    logger_logger.error(`  - ${issuePath}: ${issue.message}`);
-                }
-            }
-            process.exitCode = 1;
+            if (pathStat.isDirectory()) return void handleValidateDirectory(file);
+            handleValidateFile(file);
         });
         if (watchCommand) {
             const watchOptions = watchCommand.options.map((opt)=>{

package/dist/index.js

@@ -16317,6 +16317,167 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             ok: true
         };
     }
+    const PYTHON_VALIDATOR_SCRIPT = String.raw`
+import ast
+import json
+import sys
+
+
+def issue_path(error):
+    if getattr(error, "lineno", None) is None:
+        return "root"
+    if getattr(error, "offset", None) is None:
+        return f"line {error.lineno}"
+    return f"line {error.lineno}, column {error.offset}"
+
+
+def base_name(node):
+    if isinstance(node, ast.Name):
+        return node.id
+    if isinstance(node, ast.Attribute):
+        return node.attr
+    return None
+
+
+def imports_template_from_anvil_designer(node, template_name):
+    if node.level < 1:
+        return False
+    if node.module not in ("_anvil_designer", None):
+        return False
+    return any(alias.name == template_name for alias in node.names)
+
+
+file_path = sys.argv[1]
+class_name = sys.argv[2]
+template_name = f"{class_name}Template" if class_name else ""
+source = sys.stdin.read()
+issues = []
+
+try:
+    compile(source, file_path, "exec")
+except SyntaxError as error:
+    issues.append({"path": issue_path(error), "message": error.msg})
+    print(json.dumps({"issues": issues}))
+    sys.exit(0)
+
+if class_name:
+    tree = ast.parse(source, filename=file_path)
+    has_template_import = False
+    has_form_class = False
+
+    for node in ast.walk(tree):
+        if isinstance(node, ast.ImportFrom) and imports_template_from_anvil_designer(node, template_name):
+            has_template_import = True
+        elif isinstance(node, ast.ClassDef) and node.name == class_name:
+            if any(base_name(base) == template_name for base in node.bases):
+                has_form_class = True
+
+    if not has_template_import:
+        issues.append({
+            "path": "root",
+            "message": f"missing {chr(96)}from ._anvil_designer import {template_name}{chr(96)}",
+        })
+    if not has_form_class:
+        issues.append({
+            "path": "root",
+            "message": f"missing class {chr(96)}{class_name}{chr(96)} inheriting from {chr(96)}{template_name}{chr(96)}",
+        })
+
+print(json.dumps({"issues": issues}))
+`;
+    function findPythonInterpreter() {
+        const candidates = [
+            process.env.ANVIL_PYTHON,
+            "python3",
+            "python"
+        ].filter((candidate)=>"string" == typeof candidate && candidate.length > 0);
+        for (const candidate of candidates){
+            const result = (0, external_child_process_namespaceObject.spawnSync)(candidate, [
+                "--version"
+            ], {
+                encoding: "utf8"
+            });
+            if (!result.error && 0 === result.status) return candidate;
+        }
+        return null;
+    }
+    function isClientFormPython(filePath) {
+        if ("__init__.py" === external_path_default().basename(filePath)) {
+            const formDir = external_path_default().dirname(filePath);
+            return external_fs_.existsSync(external_path_default().join(formDir, "form_template.html")) || external_fs_.existsSync(external_path_default().join(formDir, "form_template.yaml"));
+        }
+        const parsed = external_path_default().parse(filePath);
+        return external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.html`)) || external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.yaml`));
+    }
+    function expectedFormClassName(filePath) {
+        if (!isClientFormPython(filePath)) return null;
+        if ("__init__.py" === external_path_default().basename(filePath)) return external_path_default().basename(external_path_default().dirname(filePath));
+        return external_path_default().basename(filePath, ".py");
+    }
+    function isUnderDirectory(filePath, directoryPath) {
+        const relativePath = external_path_default().relative(directoryPath, filePath);
+        return relativePath.length > 0 && !relativePath.startsWith("..") && !external_path_default().isAbsolute(relativePath);
+    }
+    function validatePython(filePath, fileContent, appRoot) {
+        const interpreter = findPythonInterpreter();
+        if (!interpreter) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: "Python validation requires python3 or python on PATH, or ANVIL_PYTHON to be set"
+                }
+            ]
+        };
+        const absolutePath = external_path_default().resolve(filePath);
+        const clientCodeRoot = appRoot ? external_path_default().join(appRoot, "client_code") : null;
+        const formClassName = clientCodeRoot && isUnderDirectory(absolutePath, clientCodeRoot) ? expectedFormClassName(absolutePath) : null;
+        const result = (0, external_child_process_namespaceObject.spawnSync)(interpreter, [
+            "-c",
+            PYTHON_VALIDATOR_SCRIPT,
+            filePath,
+            formClassName ?? ""
+        ], {
+            encoding: "utf8",
+            input: fileContent,
+            maxBuffer: 1048576
+        });
+        if (result.error || 0 !== result.status) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: result.error?.message ?? (result.stderr.trim() || "Python validator failed")
+                }
+            ]
+        };
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        } catch (error) {
+            return {
+                ok: false,
+                message: "Python file could not be validated",
+                issues: [
+                    {
+                        path: "root",
+                        message: error instanceof Error ? error.message : String(error)
+                    }
+                ]
+            };
+        }
+        const issues = parsed.issues ?? [];
+        if (issues.length > 0) return {
+            ok: false,
+            message: "Python file is invalid for Anvil",
+            issues
+        };
+        return {
+            ok: true
+        };
+    }
     const validators_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
     const DB_ACCESS_LEVELS = new Set([
         "none",
@@ -16714,6 +16875,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const relativeToClientCode = normalizedPath.slice(startIndex + clientCodePrefix.length);
             if (relativeToClientCode.endsWith(".yaml")) return "form_template.yaml";
             if (relativeToClientCode.endsWith(".html")) return "form_template.html";
+            if (relativeToClientCode.endsWith(".py")) return "python";
+        }
+        const serverCodePrefix = "server_code/";
+        if (normalizedPath.startsWith(serverCodePrefix) || normalizedPath.includes(`/${serverCodePrefix}`)) {
+            const startIndex = normalizedPath.lastIndexOf(serverCodePrefix);
+            const relativeToServerCode = normalizedPath.slice(startIndex + serverCodePrefix.length);
+            if (relativeToServerCode.endsWith(".py")) return "python";
         }
         return null;
     }
@@ -16821,6 +16989,35 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 target
             };
         }
+        if ("python" === target) {
+            if (existingPath && appRoot) {
+                const clientCodeRoot = external_path_default().join(appRoot, "client_code");
+                const serverCodeRoot = external_path_default().join(appRoot, "server_code");
+                const relativeToClientCode = external_path_default().relative(clientCodeRoot, existingPath);
+                const relativeToServerCode = external_path_default().relative(serverCodeRoot, existingPath);
+                const isInsideClientCode = relativeToClientCode.length > 0 && !relativeToClientCode.startsWith("..") && !external_path_default().isAbsolute(relativeToClientCode);
+                const isInsideServerCode = relativeToServerCode.length > 0 && !relativeToServerCode.startsWith("..") && !external_path_default().isAbsolute(relativeToServerCode);
+                if (!isInsideClientCode && !isInsideServerCode || !existingPath.endsWith(".py")) return {
+                    ok: false,
+                    target,
+                    message: "File is not an Anvil app Python file",
+                    issues: [
+                        {
+                            path: "",
+                            message: `expected a .py file under ${clientCodeRoot} or ${serverCodeRoot}`
+                        }
+                    ]
+                };
+            }
+            const result = validatePython(filePath, fileContent, appRoot);
+            return result.ok ? {
+                ok: true,
+                target
+            } : {
+                ...result,
+                target
+            };
+        }
         return {
             ok: false,
             target: "unknown",
@@ -16828,7 +17025,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             issues: [
                 {
                     path: "",
-                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, client_code/**/*.yaml, and client_code/**/*.html"
+                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, client_code/**/*.yaml, client_code/**/*.html, client_code/**/*.py, and server_code/**/*.py"
                 }
             ]
         };

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuDpC,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,CAezE;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwFzD;AAiBD,wBAAgB,YAAY,IAAI,OAAO,CAmHtC"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2LpC,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,CAezE;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwFzD;AAiBD,wBAAgB,YAAY,IAAI,OAAO,CAkGtC"}

package/dist/validatePython.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationIssue } from "./validators";
+export type PythonValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    issues: ValidationIssue[];
+};
+export declare function validatePython(filePath: string, fileContent: string, appRoot: string | null): PythonValidationResult;
+//# sourceMappingURL=validatePython.d.ts.map

package/dist/validatePython.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePython.d.ts","sourceRoot":"","sources":["../src/validatePython.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACI,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAqHR,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,sBAAsB,CAiEpH"}

package/dist/validators.d.ts

@@ -16,7 +16,7 @@ export type AnvilYamlValidationResult = {
     message: string;
     issues: ValidationIssue[];
 };
-export type ValidationTarget = "anvil.yaml" | "form_template.yaml" | "form_template.html";
+export type ValidationTarget = "anvil.yaml" | "form_template.yaml" | "form_template.html" | "python";
 export type ValidatePathResult = {
     ok: true;
     target: ValidationTarget;
@@ -43,6 +43,7 @@ export declare function findAnvilAppRoot(filePath: string): string | null;
  * - `anvil.yaml`
  * - any form YAML under `client_code/` with a `.yaml` suffix
  * - any form HTML under `client_code/` with a `.html` suffix
+ * - any Python file under `client_code/` or `server_code/`
  */
 export declare function validatePath(filePath: string, fileContent: string): ValidatePathResult;
 //# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACI,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAER,MAAM,MAAM,yBAAyB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACI,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAER,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE1F,MAAM,MAAM,kBAAkB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACtC;IACI,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAoER,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,UAEhD;AAgBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,4BAA4B,CA0BtF;AAuZD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB,CAkFhF;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAiBxE;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAOjC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAoGtF"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACI,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAER,MAAM,MAAM,yBAAyB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACI,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAER,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,QAAQ,CAAC;AAErG,MAAM,MAAM,kBAAkB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACtC;IACI,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAoER,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,UAEhD;AAgBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,4BAA4B,CA0BtF;AAuZD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB,CAkFhF;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA4BxE;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAOjC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAoItF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvil-works/anvil-cli",
-  "version": "0.7.0-canary.17",
+  "version": "0.7.0-canary.18",
   "description": "CLI tool for developing Anvil apps locally",
   "main": "dist/index.js",
   "types": "dist/api.d.ts",