@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

package/src/py/project/generator.js

@@ -1,83 +1,173 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pyProjectGenerator = exports.getPyProjectDetails = exports.PY_PROJECT_GENERATOR_INFO = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const config_1 = require("../../license/config");
-const git_1 = require("../../utils/git");
-const metrics_1 = require("../../utils/metrics");
-const names_1 = require("../../utils/names");
-const npm_scope_1 = require("../../utils/npm-scope");
-const nx_1 = require("../../utils/nx");
-const nxlv_python_1 = require("../../utils/nxlv-python");
-const object_1 = require("../../utils/object");
-const py_1 = require("../../utils/py");
-const toml_1 = require("../../utils/toml");
-const versions_1 = require("../../utils/versions");
-exports.PY_PROJECT_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
+ */ import { ensurePackage, joinPathFragments, readNxJson, readProjectConfiguration, updateNxJson, updateProjectConfiguration } from "@nx/devkit";
+import { addLicenseCheckToLintTarget, ensurePythonLicenseCollector } from "../../license/config.js";
+import { addPyDependencies, addTsDependencies } from "../../utils/add-dependencies.js";
+import { declareDependencies } from "../../utils/declared-dependencies.js";
+import { updateGitIgnore } from "../../utils/git.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { normalizeDistributionName, toSnakeCase } from "../../utils/names.js";
+import { getNpmScope } from "../../utils/npm-scope.js";
+import { addDependencyToTargetIfNotPresent, addGeneratorMetadata, getGeneratorInfo, projectExists } from "../../utils/nx.js";
+import { migrateToSharedVenvGenerator, uvProjectGenerator } from "../../utils/nxlv-python.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { updateToml } from "../../utils/toml.js";
+import { pyenvPythonVersion, pyprojectPythonDependency, withVersions } from "../../utils/versions.js";
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: '@nxlv/python',
+            dev: true,
+            root: true
+        }
+    ],
+    py: [
+        // The linting and type checking tools live in the workspace root pyproject.
+        // Pinned to the version generation-time formatting uses, so generated files
+        // stay `ruff format --check`-clean across ruff releases.
+        {
+            name: 'ruff',
+            group: 'dev',
+            root: true
+        },
+        {
+            name: 'ty',
+            group: 'dev',
+            root: true
+        }
+    ]
+});
+export const PY_PROJECT_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+// Transient artifacts that pytest, coverage and ruff create and remove while
+// the test, typecheck and compile targets run concurrently. `.coverage.*` are
+// the per-process data files pytest-cov writes (`.coverage.<host>.<pid>.<rand>`)
+// before combining them. Both `ty` (which respects .gitignore) and the
+// `@nxlv/python:build` copy (which respects `ignorePaths`) would otherwise fail
+// when they read one of these mid-deletion.
+const PYTHON_TRANSIENT_ARTIFACTS = [
+    '__pycache__',
+    '.coverage',
+    '.coverage.*',
+    '.pytest_cache',
+    'pytest-cache-files-*',
+    '.ruff_cache'
+];
+// Python test files, excluded from the `production` named input so that editing
+// a test does not invalidate targets whose output cannot contain it.
+//
+// Anchored to the `tests` directory, which is where the generated project puts
+// them and the only path the build excludes (`ignorePaths` is matched against
+// the project root's top-level entries). An unanchored `**/test_*.py` would also
+// match a production module inside the packaged source directory — a
+// `test_data_loader.py` helper ships in the wheel, so excluding it would leave
+// the wheel stale after a fix to it.
+export const PYTHON_TEST_FILE_EXCLUSIONS = [
+    '!{projectRoot}/tests/**/*'
+];
+/**
+ * Excludes Python test files from the `production` named input, preserving any
+ * entries already present (including user additions).
+ *
+ * The input is created when absent: the Python targets reference `production`,
+ * and Nx fails hard on a named input that is not defined.
+ */ export const addPythonTestExclusionsToProductionInput = (tree)=>{
+    const nxJson = readNxJson(tree);
+    if (!nxJson) {
+        return;
+    }
+    const production = nxJson.namedInputs?.production ?? [
+        'default'
+    ];
+    const missing = PYTHON_TEST_FILE_EXCLUSIONS.filter((exclusion)=>!production.includes(exclusion));
+    if (missing.length === 0 && nxJson.namedInputs?.production) {
+        return;
+    }
+    updateNxJson(tree, {
+        ...nxJson,
+        namedInputs: {
+            ...nxJson.namedInputs,
+            production: [
+                ...production,
+                ...missing
+            ]
+        }
+    });
+};
 /**
  * Returns details about the Python project to be created
- */
-const getPyProjectDetails = (tree, schema) => {
-    const scope = (0, names_1.toSnakeCase)((0, npm_scope_1.getNpmScope)(tree));
-    const normalizedName = (0, names_1.toSnakeCase)(schema.name);
-    const normalizedModuleName = (0, names_1.toSnakeCase)(schema.moduleName ?? `${scope}_${normalizedName}`);
+ */ export const getPyProjectDetails = (tree, schema)=>{
+    const scope = toSnakeCase(getNpmScope(tree));
+    const normalizedName = toSnakeCase(schema.name);
+    const normalizedModuleName = toSnakeCase(schema.moduleName ?? `${scope}_${normalizedName}`);
     const fullyQualifiedName = `${scope}.${normalizedName}`;
+    // The Python distribution name is the PEP 503 normalised form of the
+    // fully qualified name: hyphenated, never dotted. See PyProjectDetails.
+    const distributionName = normalizeDistributionName(fullyQualifiedName);
     // NB: interactive nx generator cli can pass empty string
-    const dir = (0, devkit_1.joinPathFragments)(schema.directory || '.', schema.subDirectory || normalizedName);
-    return { dir, fullyQualifiedName, normalizedModuleName };
+    const dir = joinPathFragments(schema.directory || '.', schema.subDirectory || normalizedName);
+    return {
+        dir,
+        fullyQualifiedName,
+        distributionName,
+        normalizedModuleName
+    };
 };
-exports.getPyProjectDetails = getPyProjectDetails;
 /**
  * Generates a Python project
- */
-const pyProjectGenerator = async (tree, schema) => {
-    const { dir, normalizedModuleName, fullyQualifiedName } = (0, exports.getPyProjectDetails)(tree, schema);
-    const pythonPlugin = (0, versions_1.withVersions)(['@nxlv/python']);
-    (0, devkit_1.addDependenciesToPackageJson)(tree, {}, pythonPlugin);
-    Object.entries(pythonPlugin).forEach(([name, version]) => (0, devkit_1.ensurePackage)(name, version));
-    const nxJson = (0, devkit_1.readNxJson)(tree);
+ */ export const pyProjectGenerator = async (tree, schema)=>{
+    const { dir, normalizedModuleName, fullyQualifiedName, distributionName } = getPyProjectDetails(tree, schema);
+    addTsDependencies(tree, DEPENDENCIES);
+    addPythonTestExclusionsToProductionInput(tree);
+    const pythonPlugin = withVersions(DEPENDENCIES, [
+        '@nxlv/python'
+    ]);
+    Object.entries(pythonPlugin).forEach(([name, version])=>ensurePackage(name, version));
+    const nxJson = readNxJson(tree);
     // Only rewrite nx.json when the plugin needs adding, so re-running does not
     // reserialize (and reformat) the file when nothing has changed.
-    if (!nxJson.plugins?.find((p) => typeof p === 'string'
-        ? p === '@nxlv/python'
-        : p.plugin === '@nxlv/python')) {
+    if (!nxJson.plugins?.find((p)=>typeof p === 'string' ? p === '@nxlv/python' : p.plugin === '@nxlv/python')) {
         nxJson.plugins = [
-            ...(nxJson.plugins ?? []),
+            ...nxJson.plugins ?? [],
             {
                 plugin: '@nxlv/python',
                 options: {
-                    packageManager: 'uv',
-                },
-            },
+                    packageManager: 'uv'
+                }
+            }
         ];
-        (0, devkit_1.updateNxJson)(tree, nxJson);
+        updateNxJson(tree, nxJson);
     }
     // Only scaffold the project when it does not already exist so re-running with
     // the same name does not throw. The rest of the generator still runs to apply
     // any changed options to the existing project.
-    if (!(0, nx_1.projectExists)(tree, fullyQualifiedName)) {
+    if (!projectExists(tree, fullyQualifiedName)) {
         if (!tree.exists('uv.lock')) {
-            await (0, nxlv_python_1.migrateToSharedVenvGenerator)(tree, {
+            await migrateToSharedVenvGenerator(tree, {
                 autoActivate: true,
                 packageManager: 'uv',
                 moveDevDependencies: false,
-                pyenvPythonVersion: '3.14.0',
-                pyprojectPythonDependency: '>=3.14',
+                pyenvPythonVersion: pyenvPythonVersion(),
+                pyprojectPythonDependency: pyprojectPythonDependency()
             });
         }
-        await (0, nxlv_python_1.uvProjectGenerator)(tree, {
+        await uvProjectGenerator(tree, {
+            // The Nx project id (and `uv.workspace.members` etc.) keys off `name`, so
+            // keep it dotted. `packageName` is the separate PEP 503 distribution name
+            // written to `[project].name` and the root `[tool.uv.sources]` key; it is
+            // hyphenated so `@nxlv/python` infers the workspace dependency edge (it
+            // splits a dotted name on `.` and would otherwise drop it). This split is
+            // the whole fix (see PyProjectDetails.distributionName).
             name: fullyQualifiedName,
+            packageName: distributionName,
             publishable: false,
             buildLockedVersions: true,
             buildBundleLocalDependencies: true,
             linter: 'ruff',
             rootPyprojectDependencyGroup: 'main',
-            pyenvPythonVersion: '3.14.0',
-            pyprojectPythonDependency: '>=3.14',
+            pyenvPythonVersion: pyenvPythonVersion(),
+            pyprojectPythonDependency: pyprojectPythonDependency(),
             projectType: schema.type,
             projectNameAndRootFormat: 'as-provided',
             moduleName: normalizedModuleName,
@@ -89,19 +179,19 @@ const pyProjectGenerator = async (tree, schema) => {
             unitTestHtmlReport: true,
             unitTestJUnitReport: true,
             buildSystem: 'hatch',
-            srcDir: false,
+            srcDir: false
         });
         // Remove generated hello.py and test_hello.py as they are not needed
         [
-            (0, devkit_1.joinPathFragments)(dir, normalizedModuleName, 'hello.py'),
-            (0, devkit_1.joinPathFragments)(dir, 'tests', 'test_hello.py'),
-        ].forEach((f) => tree.delete(f));
+            joinPathFragments(dir, normalizedModuleName, 'hello.py'),
+            joinPathFragments(dir, 'tests', 'test_hello.py')
+        ].forEach((f)=>tree.delete(f));
         // Add a placeholder test so pytest doesn't fail with "no tests collected"
-        tree.write((0, devkit_1.joinPathFragments)(dir, 'tests', 'test_noop.py'), 'def test_noop():\n    pass\n');
+        tree.write(joinPathFragments(dir, 'tests', 'test_noop.py'), 'def test_noop():\n    pass\n');
     }
     const outputPath = '{workspaceRoot}/dist/{projectRoot}';
-    const buildOutputPath = (0, devkit_1.joinPathFragments)(outputPath, 'build');
-    const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, fullyQualifiedName);
+    const buildOutputPath = joinPathFragments(outputPath, 'build');
+    const projectConfiguration = readProjectConfiguration(tree, fullyQualifiedName);
     projectConfiguration.name = fullyQualifiedName;
     // Derive the compile target from the uv build target, and rewrite build to
     // orchestrate the other targets. This only runs on first creation: on re-run
@@ -111,86 +201,152 @@ const pyProjectGenerator = async (tree, schema) => {
         const buildTarget = projectConfiguration.targets.build;
         projectConfiguration.targets.compile = {
             ...buildTarget,
-            inputs: ['default', '^production'],
-            outputs: [buildOutputPath],
+            // `tests` is in `ignorePaths` below, so test files cannot reach the built
+            // distribution and must not invalidate it.
+            inputs: [
+                'production',
+                '^production'
+            ],
+            outputs: [
+                buildOutputPath
+            ],
             options: {
                 ...buildTarget.options,
                 outputPath: buildOutputPath,
-            },
+                // The build executor copies the project to a temp folder; exclude the
+                // executor defaults plus transient artifacts so the copy does not race
+                // a concurrent test/typecheck target deleting a file mid-copy.
+                ignorePaths: [
+                    '.venv',
+                    '.tox',
+                    'tests',
+                    ...PYTHON_TRANSIENT_ARTIFACTS
+                ]
+            }
         };
         projectConfiguration.targets.build = {
-            inputs: ['default', '^production'],
+            inputs: [
+                'default',
+                '^production'
+            ],
             dependsOn: [
                 'lint',
                 'compile',
                 'test',
                 'typecheck',
-                ...(buildTarget.dependsOn ?? []),
+                ...buildTarget.dependsOn ?? []
             ],
             options: {
-                outputPath,
-            },
+                outputPath
+            }
+        };
+        // The artifact-only sibling of build, which the deploy targets depend on.
+        projectConfiguration.targets.assemble = {
+            dependsOn: [
+                'compile'
+            ]
         };
     }
     projectConfiguration.targets.typecheck = {
         cache: true,
-        inputs: ['default', '^production'],
+        inputs: [
+            'default',
+            '^production'
+        ],
         executor: '@nxlv/python:run-commands',
         options: {
             command: 'uv run ty check',
-            cwd: '{projectRoot}',
-        },
+            cwd: '{projectRoot}'
+        }
     };
     // Set the default line length to 120, as 88 is a little too strict
-    (0, toml_1.updateToml)(tree, (0, devkit_1.joinPathFragments)(dir, 'pyproject.toml'), (pyProjectToml) => {
+    updateToml(tree, joinPathFragments(dir, 'pyproject.toml'), (pyProjectToml)=>{
         if (pyProjectToml.tool?.ruff) {
             pyProjectToml.tool.ruff['line-length'] = 120;
         }
         return pyProjectToml;
     });
-    (0, py_1.addDependenciesToDependencyGroupInPyProjectToml)(tree, '.', 'dev', ['ty']);
+    addPyDependencies(tree, DEPENDENCIES);
+    // Base format target checks rather than writes (so build/lint don't rewrite
+    // source); `fix` writes, and `skip-lint` writes without failing so it stays
+    // a no-op when propagated through the lint -> format dependency.
+    projectConfiguration.targets.format = {
+        ...projectConfiguration.targets.format,
+        cache: true,
+        inputs: [
+            'default',
+            '^production'
+        ],
+        options: {
+            ...projectConfiguration.targets.format?.options,
+            check: true
+        },
+        configurations: {
+            ...projectConfiguration.targets.format?.configurations,
+            fix: {
+                check: false
+            },
+            'skip-lint': {
+                check: false
+            }
+        }
+    };
     // Add a dependency on the format target for lint in order to reduce the number of
     // fixable lint errors (eg line too long)
     projectConfiguration.targets.lint = {
         ...projectConfiguration.targets.lint,
         cache: true,
-        inputs: ['default', '^production'],
+        inputs: [
+            'default',
+            '^production'
+        ],
         configurations: {
             ...projectConfiguration.targets.lint?.configurations,
             fix: {
-                fix: true,
+                fix: true
             },
             'skip-lint': {
-                exitZero: true,
-            },
-        },
+                exitZero: true
+            }
+        }
     };
     // Append `format` without moving an existing entry, so re-running does not
     // reorder lint dependencies (e.g. relative to a later-added license-check).
-    (0, nx_1.addDependencyToTargetIfNotPresent)(projectConfiguration, 'lint', 'format');
-    projectConfiguration.targets = (0, object_1.sortObjectKeys)(projectConfiguration.targets);
-    (0, devkit_1.updateProjectConfiguration)(tree, fullyQualifiedName, projectConfiguration);
-    (0, nx_1.addGeneratorMetadata)(tree, fullyQualifiedName, exports.PY_PROJECT_GENERATOR_INFO);
+    addDependencyToTargetIfNotPresent(projectConfiguration, 'lint', 'format');
+    projectConfiguration.targets = sortObjectKeys(projectConfiguration.targets);
+    updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);
+    addGeneratorMetadata(tree, fullyQualifiedName, PY_PROJECT_GENERATOR_INFO);
     // Update root .gitignore
-    (0, git_1.updateGitIgnore)(tree, '.', (patterns) => [...patterns, '/reports']);
-    // Update project level .gitignore
-    (0, git_1.updateGitIgnore)(tree, dir, (patterns) => [
-        ...patterns,
-        '**/__pycache__',
-        '.coverage',
+    updateGitIgnore(tree, '.', (patterns)=>[
+            ...patterns,
+            '/reports'
+        ]);
+    // Update project level .gitignore. The cache directories are also kept out
+    // of type checking: `ty` respects .gitignore, and pytest creates and removes
+    // transient `pytest-cache-files-*` directories while the test and typecheck
+    // targets run concurrently, which would otherwise make `ty` fail with an I/O
+    // error when it scans one mid-deletion.
+    updateGitIgnore(tree, dir, (patterns)=>[
+            ...patterns,
+            '**/__pycache__',
+            ...PYTHON_TRANSIENT_ARTIFACTS.filter((p)=>p !== '__pycache__')
+        ]);
+    await addGeneratorMetricsIfApplicable(tree, [
+        PY_PROJECT_GENERATOR_INFO
     ]);
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.PY_PROJECT_GENERATOR_INFO]);
-    await (0, config_1.ensurePythonLicenseCollector)(tree);
+    await ensurePythonLicenseCollector(tree);
     // If license checking is configured, make this project's lint target depend
     // on the root license-check target. No-op if license checking isn't set up;
     // the license generator wires up existing projects itself, so the dependency
     // is added regardless of which generator runs first.
-    (0, config_1.addLicenseCheckToLintTarget)(tree, fullyQualifiedName);
-    return async () => {
-        (0, devkit_1.installPackagesTask)(tree);
-        await new nxlv_python_1.UVProvider(tree.root, new nxlv_python_1.Logger(), tree).install();
-    };
+    addLicenseCheckToLintTarget(tree, fullyQualifiedName);
+    return ()=>installDependencies(tree, schema.preferInstallDependencies, {
+            languages: [
+                'typescript',
+                'python'
+            ]
+        });
 };
-exports.pyProjectGenerator = pyProjectGenerator;
-exports.default = exports.pyProjectGenerator;
+export default pyProjectGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/py/project/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/py/project/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/py/project/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  ensurePackage,\n  type GeneratorCallback,\n  joinPathFragments,\n  readNxJson,\n  readProjectConfiguration,\n  type Tree,\n  updateNxJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport {\n  addLicenseCheckToLintTarget,\n  ensurePythonLicenseCollector,\n} from '../../license/config.js';\nimport {\n  addPyDependencies,\n  addTsDependencies,\n} from '../../utils/add-dependencies.js';\nimport { declareDependencies } from '../../utils/declared-dependencies.js';\nimport { updateGitIgnore } from '../../utils/git.js';\nimport { installDependencies } from '../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics.js';\nimport { normalizeDistributionName, toSnakeCase } from '../../utils/names.js';\nimport { getNpmScope } from '../../utils/npm-scope.js';\nimport {\n  addDependencyToTargetIfNotPresent,\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n} from '../../utils/nx.js';\nimport type { UVPyprojectToml } from '../../utils/nxlv-python.js';\nimport {\n  migrateToSharedVenvGenerator,\n  uvProjectGenerator,\n} from '../../utils/nxlv-python.js';\nimport { sortObjectKeys } from '../../utils/object.js';\nimport { updateToml } from '../../utils/toml.js';\nimport {\n  pyenvPythonVersion,\n  pyprojectPythonDependency,\n  withVersions,\n} from '../../utils/versions.js';\nimport type { PyProjectGeneratorSchema } from './schema';\n\nexport const DEPENDENCIES = declareDependencies()({\n  ts: [{ name: '@nxlv/python', dev: true, root: true }],\n  py: [\n    // The linting and type checking tools live in the workspace root pyproject.\n    // Pinned to the version generation-time formatting uses, so generated files\n    // stay `ruff format --check`-clean across ruff releases.\n    { name: 'ruff', group: 'dev', root: true },\n    { name: 'ty', group: 'dev', root: true },\n  ],\n});\n\nexport const PY_PROJECT_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\n// Transient artifacts that pytest, coverage and ruff create and remove while\n// the test, typecheck and compile targets run concurrently. `.coverage.*` are\n// the per-process data files pytest-cov writes (`.coverage.<host>.<pid>.<rand>`)\n// before combining them. Both `ty` (which respects .gitignore) and the\n// `@nxlv/python:build` copy (which respects `ignorePaths`) would otherwise fail\n// when they read one of these mid-deletion.\nconst PYTHON_TRANSIENT_ARTIFACTS = [\n  '__pycache__',\n  '.coverage',\n  '.coverage.*',\n  '.pytest_cache',\n  'pytest-cache-files-*',\n  '.ruff_cache',\n];\n\n// Python test files, excluded from the `production` named input so that editing\n// a test does not invalidate targets whose output cannot contain it.\n//\n// Anchored to the `tests` directory, which is where the generated project puts\n// them and the only path the build excludes (`ignorePaths` is matched against\n// the project root's top-level entries). An unanchored `**/test_*.py` would also\n// match a production module inside the packaged source directory — a\n// `test_data_loader.py` helper ships in the wheel, so excluding it would leave\n// the wheel stale after a fix to it.\nexport const PYTHON_TEST_FILE_EXCLUSIONS = ['!{projectRoot}/tests/**/*'];\n\n/**\n * Excludes Python test files from the `production` named input, preserving any\n * entries already present (including user additions).\n *\n * The input is created when absent: the Python targets reference `production`,\n * and Nx fails hard on a named input that is not defined.\n */\nexport const addPythonTestExclusionsToProductionInput = (tree: Tree) => {\n  const nxJson = readNxJson(tree);\n  if (!nxJson) {\n    return;\n  }\n  const production = nxJson.namedInputs?.production ?? ['default'];\n  const missing = PYTHON_TEST_FILE_EXCLUSIONS.filter(\n    (exclusion) => !production.includes(exclusion),\n  );\n  if (missing.length === 0 && nxJson.namedInputs?.production) {\n    return;\n  }\n  updateNxJson(tree, {\n    ...nxJson,\n    namedInputs: {\n      ...nxJson.namedInputs,\n      production: [...production, ...missing],\n    },\n  });\n};\n\nexport interface PyProjectDetails {\n  /**\n   * Fully qualified Nx project id including scope, in dot notation (eg foo.bar).\n   * This is the identifier Nx uses (readProjectConfiguration, the project\n   * graph, target references) and is intentionally kept dotted.\n   */\n  readonly fullyQualifiedName: string;\n  /**\n   * PEP 503 normalised Python distribution name (eg foo-bar). This is the name\n   * written to the project's `[project].name`, the root `[tool.uv.sources]`\n   * key, and any inter-project dependency string. It is hyphenated (not dotted)\n   * so `uv` and `@nxlv/python` can match it: uv writes `uv.lock` keyed by the\n   * PEP 503 hyphenated name, and `@nxlv/python`'s dependency inference splits a\n   * dotted name on `.` and so would otherwise drop the edge entirely. Keeping\n   * the distribution name decoupled from `fullyQualifiedName` is what lets the\n   * workspace dependency edge appear in the Nx project graph.\n   */\n  readonly distributionName: string;\n  /**\n   * Directory of the library relative to the root\n   */\n  readonly dir: string;\n  /**\n   * Module name for the project\n   */\n  readonly normalizedModuleName: string;\n}\n\n/**\n * Returns details about the Python project to be created\n */\nexport const getPyProjectDetails = (\n  tree: Tree,\n  schema: {\n    name: string;\n    directory?: string;\n    subDirectory?: string;\n    moduleName?: string;\n  },\n): PyProjectDetails => {\n  const scope = toSnakeCase(getNpmScope(tree));\n  const normalizedName = toSnakeCase(schema.name);\n  const normalizedModuleName = toSnakeCase(\n    schema.moduleName ?? `${scope}_${normalizedName}`,\n  );\n  const fullyQualifiedName = `${scope}.${normalizedName}`;\n  // The Python distribution name is the PEP 503 normalised form of the\n  // fully qualified name: hyphenated, never dotted. See PyProjectDetails.\n  const distributionName = normalizeDistributionName(fullyQualifiedName);\n  // NB: interactive nx generator cli can pass empty string\n  const dir = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || normalizedName,\n  );\n  return { dir, fullyQualifiedName, distributionName, normalizedModuleName };\n};\n\n/**\n * Generates a Python project\n */\nexport const pyProjectGenerator = async (\n  tree: Tree,\n  schema: PyProjectGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const { dir, normalizedModuleName, fullyQualifiedName, distributionName } =\n    getPyProjectDetails(tree, schema);\n\n  addTsDependencies(tree, DEPENDENCIES);\n\n  addPythonTestExclusionsToProductionInput(tree);\n\n  const pythonPlugin = withVersions(DEPENDENCIES, ['@nxlv/python']);\n  Object.entries(pythonPlugin).forEach(([name, version]) =>\n    ensurePackage(name, version),\n  );\n\n  const nxJson = readNxJson(tree);\n\n  // Only rewrite nx.json when the plugin needs adding, so re-running does not\n  // reserialize (and reformat) the file when nothing has changed.\n  if (\n    !nxJson.plugins?.find((p) =>\n      typeof p === 'string'\n        ? p === '@nxlv/python'\n        : p.plugin === '@nxlv/python',\n    )\n  ) {\n    nxJson.plugins = [\n      ...(nxJson.plugins ?? []),\n      {\n        plugin: '@nxlv/python',\n        options: {\n          packageManager: 'uv',\n        },\n      },\n    ];\n    updateNxJson(tree, nxJson);\n  }\n\n  // Only scaffold the project when it does not already exist so re-running with\n  // the same name does not throw. The rest of the generator still runs to apply\n  // any changed options to the existing project.\n  if (!projectExists(tree, fullyQualifiedName)) {\n    if (!tree.exists('uv.lock')) {\n      await migrateToSharedVenvGenerator(tree, {\n        autoActivate: true,\n        packageManager: 'uv',\n        moveDevDependencies: false,\n        pyenvPythonVersion: pyenvPythonVersion(),\n        pyprojectPythonDependency: pyprojectPythonDependency(),\n      });\n    }\n\n    await uvProjectGenerator(tree, {\n      // The Nx project id (and `uv.workspace.members` etc.) keys off `name`, so\n      // keep it dotted. `packageName` is the separate PEP 503 distribution name\n      // written to `[project].name` and the root `[tool.uv.sources]` key; it is\n      // hyphenated so `@nxlv/python` infers the workspace dependency edge (it\n      // splits a dotted name on `.` and would otherwise drop it). This split is\n      // the whole fix (see PyProjectDetails.distributionName).\n      name: fullyQualifiedName,\n      packageName: distributionName,\n      publishable: false,\n      buildLockedVersions: true,\n      buildBundleLocalDependencies: true,\n      linter: 'ruff',\n      rootPyprojectDependencyGroup: 'main',\n      pyenvPythonVersion: pyenvPythonVersion(),\n      pyprojectPythonDependency: pyprojectPythonDependency(),\n      projectType: schema.type,\n      projectNameAndRootFormat: 'as-provided',\n      moduleName: normalizedModuleName,\n      directory: dir,\n      unitTestRunner: 'pytest',\n      codeCoverage: true,\n      codeCoverageHtmlReport: true,\n      codeCoverageXmlReport: true,\n      unitTestHtmlReport: true,\n      unitTestJUnitReport: true,\n      buildSystem: 'hatch',\n      srcDir: false,\n    });\n\n    // Remove generated hello.py and test_hello.py as they are not needed\n    [\n      joinPathFragments(dir, normalizedModuleName, 'hello.py'),\n      joinPathFragments(dir, 'tests', 'test_hello.py'),\n    ].forEach((f) => tree.delete(f));\n\n    // Add a placeholder test so pytest doesn't fail with \"no tests collected\"\n    tree.write(\n      joinPathFragments(dir, 'tests', 'test_noop.py'),\n      'def test_noop():\\n    pass\\n',\n    );\n  }\n\n  const outputPath = '{workspaceRoot}/dist/{projectRoot}';\n  const buildOutputPath = joinPathFragments(outputPath, 'build');\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n  projectConfiguration.name = fullyQualifiedName;\n  // Derive the compile target from the uv build target, and rewrite build to\n  // orchestrate the other targets. This only runs on first creation: on re-run\n  // build has already been transformed, so re-deriving would corrupt compile\n  // and duplicate the build dependencies.\n  if (!projectConfiguration.targets.compile) {\n    const buildTarget = projectConfiguration.targets.build;\n    projectConfiguration.targets.compile = {\n      ...buildTarget,\n      // `tests` is in `ignorePaths` below, so test files cannot reach the built\n      // distribution and must not invalidate it.\n      inputs: ['production', '^production'],\n      outputs: [buildOutputPath],\n      options: {\n        ...buildTarget.options,\n        outputPath: buildOutputPath,\n        // The build executor copies the project to a temp folder; exclude the\n        // executor defaults plus transient artifacts so the copy does not race\n        // a concurrent test/typecheck target deleting a file mid-copy.\n        ignorePaths: ['.venv', '.tox', 'tests', ...PYTHON_TRANSIENT_ARTIFACTS],\n      },\n    };\n    projectConfiguration.targets.build = {\n      inputs: ['default', '^production'],\n      dependsOn: [\n        'lint',\n        'compile',\n        'test',\n        'typecheck',\n        ...(buildTarget.dependsOn ?? []),\n      ],\n      options: {\n        outputPath,\n      },\n    };\n    // The artifact-only sibling of build, which the deploy targets depend on.\n    projectConfiguration.targets.assemble = {\n      dependsOn: ['compile'],\n    };\n  }\n  projectConfiguration.targets.typecheck = {\n    cache: true,\n    inputs: ['default', '^production'],\n    executor: '@nxlv/python:run-commands',\n    options: {\n      command: 'uv run ty check',\n      cwd: '{projectRoot}',\n    },\n  };\n\n  // Set the default line length to 120, as 88 is a little too strict\n  updateToml(\n    tree,\n    joinPathFragments(dir, 'pyproject.toml'),\n    (pyProjectToml: UVPyprojectToml) => {\n      if ((pyProjectToml.tool as any)?.ruff) {\n        (pyProjectToml.tool as any).ruff['line-length'] = 120;\n      }\n      return pyProjectToml;\n    },\n  );\n\n  addPyDependencies(tree, DEPENDENCIES);\n\n  // Base format target checks rather than writes (so build/lint don't rewrite\n  // source); `fix` writes, and `skip-lint` writes without failing so it stays\n  // a no-op when propagated through the lint -> format dependency.\n  projectConfiguration.targets.format = {\n    ...projectConfiguration.targets.format,\n    cache: true,\n    inputs: ['default', '^production'],\n    options: {\n      ...projectConfiguration.targets.format?.options,\n      check: true,\n    },\n    configurations: {\n      ...projectConfiguration.targets.format?.configurations,\n      fix: {\n        check: false,\n      },\n      'skip-lint': {\n        check: false,\n      },\n    },\n  };\n\n  // Add a dependency on the format target for lint in order to reduce the number of\n  // fixable lint errors (eg line too long)\n  projectConfiguration.targets.lint = {\n    ...projectConfiguration.targets.lint,\n    cache: true,\n    inputs: ['default', '^production'],\n    configurations: {\n      ...projectConfiguration.targets.lint?.configurations,\n      fix: {\n        fix: true,\n      },\n      'skip-lint': {\n        exitZero: true,\n      },\n    },\n  };\n  // Append `format` without moving an existing entry, so re-running does not\n  // reorder lint dependencies (e.g. relative to a later-added license-check).\n  addDependencyToTargetIfNotPresent(projectConfiguration, 'lint', 'format');\n\n  projectConfiguration.targets = sortObjectKeys(projectConfiguration.targets);\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  addGeneratorMetadata(tree, fullyQualifiedName, PY_PROJECT_GENERATOR_INFO);\n\n  // Update root .gitignore\n  updateGitIgnore(tree, '.', (patterns) => [...patterns, '/reports']);\n\n  // Update project level .gitignore. The cache directories are also kept out\n  // of type checking: `ty` respects .gitignore, and pytest creates and removes\n  // transient `pytest-cache-files-*` directories while the test and typecheck\n  // targets run concurrently, which would otherwise make `ty` fail with an I/O\n  // error when it scans one mid-deletion.\n  updateGitIgnore(tree, dir, (patterns) => [\n    ...patterns,\n    '**/__pycache__',\n    ...PYTHON_TRANSIENT_ARTIFACTS.filter((p) => p !== '__pycache__'),\n  ]);\n\n  await addGeneratorMetricsIfApplicable(tree, [PY_PROJECT_GENERATOR_INFO]);\n\n  await ensurePythonLicenseCollector(tree);\n\n  // If license checking is configured, make this project's lint target depend\n  // on the root license-check target. No-op if license checking isn't set up;\n  // the license generator wires up existing projects itself, so the dependency\n  // is added regardless of which generator runs first.\n  addLicenseCheckToLintTarget(tree, fullyQualifiedName);\n\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript', 'python'],\n    });\n};\nexport default pyProjectGenerator;\n"],"names":["ensurePackage","joinPathFragments","readNxJson","readProjectConfiguration","updateNxJson","updateProjectConfiguration","addLicenseCheckToLintTarget","ensurePythonLicenseCollector","addPyDependencies","addTsDependencies","declareDependencies","updateGitIgnore","installDependencies","addGeneratorMetricsIfApplicable","normalizeDistributionName","toSnakeCase","getNpmScope","addDependencyToTargetIfNotPresent","addGeneratorMetadata","getGeneratorInfo","projectExists","migrateToSharedVenvGenerator","uvProjectGenerator","sortObjectKeys","updateToml","pyenvPythonVersion","pyprojectPythonDependency","withVersions","DEPENDENCIES","ts","name","dev","root","py","group","PY_PROJECT_GENERATOR_INFO","filename","PYTHON_TRANSIENT_ARTIFACTS","PYTHON_TEST_FILE_EXCLUSIONS","addPythonTestExclusionsToProductionInput","tree","nxJson","production","namedInputs","missing","filter","exclusion","includes","length","getPyProjectDetails","schema","scope","normalizedName","normalizedModuleName","moduleName","fullyQualifiedName","distributionName","dir","directory","subDirectory","pyProjectGenerator","pythonPlugin","Object","entries","forEach","version","plugins","find","p","plugin","options","packageManager","exists","autoActivate","moveDevDependencies","packageName","publishable","buildLockedVersions","buildBundleLocalDependencies","linter","rootPyprojectDependencyGroup","projectType","type","projectNameAndRootFormat","unitTestRunner","codeCoverage","codeCoverageHtmlReport","codeCoverageXmlReport","unitTestHtmlReport","unitTestJUnitReport","buildSystem","srcDir","f","delete","write","outputPath","buildOutputPath","projectConfiguration","targets","compile","buildTarget","build","inputs","outputs","ignorePaths","dependsOn","assemble","typecheck","cache","executor","command","cwd","pyProjectToml","tool","ruff","format","check","configurations","fix","lint","exitZero","patterns","preferInstallDependencies","languages"],"mappings":"AAAA;;;CAGC,GACD,SACEA,aAAa,EAEbC,iBAAiB,EACjBC,UAAU,EACVC,wBAAwB,EAExBC,YAAY,EACZC,0BAA0B,QACrB,aAAa;AACpB,SACEC,2BAA2B,EAC3BC,4BAA4B,QACvB,0BAA0B;AACjC,SACEC,iBAAiB,EACjBC,iBAAiB,QACZ,kCAAkC;AACzC,SAASC,mBAAmB,QAAQ,uCAAuC;AAC3E,SAASC,eAAe,QAAQ,qBAAqB;AACrD,SAASC,mBAAmB,QAAQ,yBAAyB;AAC7D,SAASC,+BAA+B,QAAQ,yBAAyB;AACzE,SAASC,yBAAyB,EAAEC,WAAW,QAAQ,uBAAuB;AAC9E,SAASC,WAAW,QAAQ,2BAA2B;AACvD,SACEC,iCAAiC,EACjCC,oBAAoB,EACpBC,gBAAgB,EAEhBC,aAAa,QACR,oBAAoB;AAE3B,SACEC,4BAA4B,EAC5BC,kBAAkB,QACb,6BAA6B;AACpC,SAASC,cAAc,QAAQ,wBAAwB;AACvD,SAASC,UAAU,QAAQ,sBAAsB;AACjD,SACEC,kBAAkB,EAClBC,yBAAyB,EACzBC,YAAY,QACP,0BAA0B;AAGjC,OAAO,MAAMC,eAAelB,sBAAsB;IAChDmB,IAAI;QAAC;YAAEC,MAAM;YAAgBC,KAAK;YAAMC,MAAM;QAAK;KAAE;IACrDC,IAAI;QACF,4EAA4E;QAC5E,4EAA4E;QAC5E,yDAAyD;QACzD;YAAEH,MAAM;YAAQI,OAAO;YAAOF,MAAM;QAAK;QACzC;YAAEF,MAAM;YAAMI,OAAO;YAAOF,MAAM;QAAK;KACxC;AACH,GAAG;AAEH,OAAO,MAAMG,4BAA6ChB,iBACxD,YAAYiB,QAAQ,EACpB;AAEF,6EAA6E;AAC7E,8EAA8E;AAC9E,iFAAiF;AACjF,uEAAuE;AACvE,gFAAgF;AAChF,4CAA4C;AAC5C,MAAMC,6BAA6B;IACjC;IACA;IACA;IACA;IACA;IACA;CACD;AAED,gFAAgF;AAChF,qEAAqE;AACrE,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,qEAAqE;AACrE,+EAA+E;AAC/E,qCAAqC;AACrC,OAAO,MAAMC,8BAA8B;IAAC;CAA4B,CAAC;AAEzE;;;;;;CAMC,GACD,OAAO,MAAMC,2CAA2C,CAACC;IACvD,MAAMC,SAASvC,WAAWsC;IAC1B,IAAI,CAACC,QAAQ;QACX;IACF;IACA,MAAMC,aAAaD,OAAOE,WAAW,EAAED,cAAc;QAAC;KAAU;IAChE,MAAME,UAAUN,4BAA4BO,MAAM,CAChD,CAACC,YAAc,CAACJ,WAAWK,QAAQ,CAACD;IAEtC,IAAIF,QAAQI,MAAM,KAAK,KAAKP,OAAOE,WAAW,EAAED,YAAY;QAC1D;IACF;IACAtC,aAAaoC,MAAM;QACjB,GAAGC,MAAM;QACTE,aAAa;YACX,GAAGF,OAAOE,WAAW;YACrBD,YAAY;mBAAIA;mBAAeE;aAAQ;QACzC;IACF;AACF,EAAE;AA8BF;;CAEC,GACD,OAAO,MAAMK,sBAAsB,CACjCT,MACAU;IAOA,MAAMC,QAAQpC,YAAYC,YAAYwB;IACtC,MAAMY,iBAAiBrC,YAAYmC,OAAOpB,IAAI;IAC9C,MAAMuB,uBAAuBtC,YAC3BmC,OAAOI,UAAU,IAAI,GAAGH,MAAM,CAAC,EAAEC,gBAAgB;IAEnD,MAAMG,qBAAqB,GAAGJ,MAAM,CAAC,EAAEC,gBAAgB;IACvD,qEAAqE;IACrE,wEAAwE;IACxE,MAAMI,mBAAmB1C,0BAA0ByC;IACnD,yDAAyD;IACzD,MAAME,MAAMxD,kBACViD,OAAOQ,SAAS,IAAI,KACpBR,OAAOS,YAAY,IAAIP;IAEzB,OAAO;QAAEK;QAAKF;QAAoBC;QAAkBH;IAAqB;AAC3E,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMO,qBAAqB,OAChCpB,MACAU;IAEA,MAAM,EAAEO,GAAG,EAAEJ,oBAAoB,EAAEE,kBAAkB,EAAEC,gBAAgB,EAAE,GACvEP,oBAAoBT,MAAMU;IAE5BzC,kBAAkB+B,MAAMZ;IAExBW,yCAAyCC;IAEzC,MAAMqB,eAAelC,aAAaC,cAAc;QAAC;KAAe;IAChEkC,OAAOC,OAAO,CAACF,cAAcG,OAAO,CAAC,CAAC,CAAClC,MAAMmC,QAAQ,GACnDjE,cAAc8B,MAAMmC;IAGtB,MAAMxB,SAASvC,WAAWsC;IAE1B,4EAA4E;IAC5E,gEAAgE;IAChE,IACE,CAACC,OAAOyB,OAAO,EAAEC,KAAK,CAACC,IACrB,OAAOA,MAAM,WACTA,MAAM,iBACNA,EAAEC,MAAM,KAAK,iBAEnB;QACA5B,OAAOyB,OAAO,GAAG;eACXzB,OAAOyB,OAAO,IAAI,EAAE;YACxB;gBACEG,QAAQ;gBACRC,SAAS;oBACPC,gBAAgB;gBAClB;YACF;SACD;QACDnE,aAAaoC,MAAMC;IACrB;IAEA,8EAA8E;IAC9E,8EAA8E;IAC9E,+CAA+C;IAC/C,IAAI,CAACrB,cAAcoB,MAAMe,qBAAqB;QAC5C,IAAI,CAACf,KAAKgC,MAAM,CAAC,YAAY;YAC3B,MAAMnD,6BAA6BmB,MAAM;gBACvCiC,cAAc;gBACdF,gBAAgB;gBAChBG,qBAAqB;gBACrBjD,oBAAoBA;gBACpBC,2BAA2BA;YAC7B;QACF;QAEA,MAAMJ,mBAAmBkB,MAAM;YAC7B,0EAA0E;YAC1E,0EAA0E;YAC1E,0EAA0E;YAC1E,wEAAwE;YACxE,0EAA0E;YAC1E,yDAAyD;YACzDV,MAAMyB;YACNoB,aAAanB;YACboB,aAAa;YACbC,qBAAqB;YACrBC,8BAA8B;YAC9BC,QAAQ;YACRC,8BAA8B;YAC9BvD,oBAAoBA;YACpBC,2BAA2BA;YAC3BuD,aAAa/B,OAAOgC,IAAI;YACxBC,0BAA0B;YAC1B7B,YAAYD;YACZK,WAAWD;YACX2B,gBAAgB;YAChBC,cAAc;YACdC,wBAAwB;YACxBC,uBAAuB;YACvBC,oBAAoB;YACpBC,qBAAqB;YACrBC,aAAa;YACbC,QAAQ;QACV;QAEA,qEAAqE;QACrE;YACE1F,kBAAkBwD,KAAKJ,sBAAsB;YAC7CpD,kBAAkBwD,KAAK,SAAS;SACjC,CAACO,OAAO,CAAC,CAAC4B,IAAMpD,KAAKqD,MAAM,CAACD;QAE7B,0EAA0E;QAC1EpD,KAAKsD,KAAK,CACR7F,kBAAkBwD,KAAK,SAAS,iBAChC;IAEJ;IAEA,MAAMsC,aAAa;IACnB,MAAMC,kBAAkB/F,kBAAkB8F,YAAY;IACtD,MAAME,uBAAuB9F,yBAC3BqC,MACAe;IAEF0C,qBAAqBnE,IAAI,GAAGyB;IAC5B,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,wCAAwC;IACxC,IAAI,CAAC0C,qBAAqBC,OAAO,CAACC,OAAO,EAAE;QACzC,MAAMC,cAAcH,qBAAqBC,OAAO,CAACG,KAAK;QACtDJ,qBAAqBC,OAAO,CAACC,OAAO,GAAG;YACrC,GAAGC,WAAW;YACd,0EAA0E;YAC1E,2CAA2C;YAC3CE,QAAQ;gBAAC;gBAAc;aAAc;YACrCC,SAAS;gBAACP;aAAgB;YAC1B1B,SAAS;gBACP,GAAG8B,YAAY9B,OAAO;gBACtByB,YAAYC;gBACZ,sEAAsE;gBACtE,uEAAuE;gBACvE,+DAA+D;gBAC/DQ,aAAa;oBAAC;oBAAS;oBAAQ;uBAAYnE;iBAA2B;YACxE;QACF;QACA4D,qBAAqBC,OAAO,CAACG,KAAK,GAAG;YACnCC,QAAQ;gBAAC;gBAAW;aAAc;YAClCG,WAAW;gBACT;gBACA;gBACA;gBACA;mBACIL,YAAYK,SAAS,IAAI,EAAE;aAChC;YACDnC,SAAS;gBACPyB;YACF;QACF;QACA,0EAA0E;QAC1EE,qBAAqBC,OAAO,CAACQ,QAAQ,GAAG;YACtCD,WAAW;gBAAC;aAAU;QACxB;IACF;IACAR,qBAAqBC,OAAO,CAACS,SAAS,GAAG;QACvCC,OAAO;QACPN,QAAQ;YAAC;YAAW;SAAc;QAClCO,UAAU;QACVvC,SAAS;YACPwC,SAAS;YACTC,KAAK;QACP;IACF;IAEA,mEAAmE;IACnEvF,WACEgB,MACAvC,kBAAkBwD,KAAK,mBACvB,CAACuD;QACC,IAAKA,cAAcC,IAAI,EAAUC,MAAM;YACpCF,cAAcC,IAAI,CAASC,IAAI,CAAC,cAAc,GAAG;QACpD;QACA,OAAOF;IACT;IAGFxG,kBAAkBgC,MAAMZ;IAExB,4EAA4E;IAC5E,4EAA4E;IAC5E,iEAAiE;IACjEqE,qBAAqBC,OAAO,CAACiB,MAAM,GAAG;QACpC,GAAGlB,qBAAqBC,OAAO,CAACiB,MAAM;QACtCP,OAAO;QACPN,QAAQ;YAAC;YAAW;SAAc;QAClChC,SAAS;YACP,GAAG2B,qBAAqBC,OAAO,CAACiB,MAAM,EAAE7C,OAAO;YAC/C8C,OAAO;QACT;QACAC,gBAAgB;YACd,GAAGpB,qBAAqBC,OAAO,CAACiB,MAAM,EAAEE,cAAc;YACtDC,KAAK;gBACHF,OAAO;YACT;YACA,aAAa;gBACXA,OAAO;YACT;QACF;IACF;IAEA,kFAAkF;IAClF,yCAAyC;IACzCnB,qBAAqBC,OAAO,CAACqB,IAAI,GAAG;QAClC,GAAGtB,qBAAqBC,OAAO,CAACqB,IAAI;QACpCX,OAAO;QACPN,QAAQ;YAAC;YAAW;SAAc;QAClCe,gBAAgB;YACd,GAAGpB,qBAAqBC,OAAO,CAACqB,IAAI,EAAEF,cAAc;YACpDC,KAAK;gBACHA,KAAK;YACP;YACA,aAAa;gBACXE,UAAU;YACZ;QACF;IACF;IACA,2EAA2E;IAC3E,4EAA4E;IAC5EvG,kCAAkCgF,sBAAsB,QAAQ;IAEhEA,qBAAqBC,OAAO,GAAG3E,eAAe0E,qBAAqBC,OAAO;IAC1E7F,2BAA2BmC,MAAMe,oBAAoB0C;IAErD/E,qBAAqBsB,MAAMe,oBAAoBpB;IAE/C,yBAAyB;IACzBxB,gBAAgB6B,MAAM,KAAK,CAACiF,WAAa;eAAIA;YAAU;SAAW;IAElE,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,wCAAwC;IACxC9G,gBAAgB6B,MAAMiB,KAAK,CAACgE,WAAa;eACpCA;YACH;eACGpF,2BAA2BQ,MAAM,CAAC,CAACuB,IAAMA,MAAM;SACnD;IAED,MAAMvD,gCAAgC2B,MAAM;QAACL;KAA0B;IAEvE,MAAM5B,6BAA6BiC;IAEnC,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,qDAAqD;IACrDlC,4BAA4BkC,MAAMe;IAElC,OAAO,IACL3C,oBAAoB4B,MAAMU,OAAOwE,yBAAyB,EAAE;YAC1DC,WAAW;gBAAC;gBAAc;aAAS;QACrC;AACJ,EAAE;AACF,eAAe/D,mBAAmB"}

package/src/py/project/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/py/project/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/py/project/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface PyProjectGeneratorSchema {\n  readonly name: string;\n  readonly type: 'application' | 'library';\n  readonly directory?: string;\n  readonly subDirectory?: string;\n  readonly moduleName?: string;\n  readonly preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAOC"}

package/src/py/project/schema.d.ts

@@ -9,4 +9,5 @@ export interface PyProjectGeneratorSchema {
   readonly directory?: string;
   readonly subDirectory?: string;
   readonly moduleName?: string;
+  readonly preferInstallDependencies?: boolean;
 }

package/src/py/project/schema.json

@@ -8,6 +8,7 @@
     "name": {
       "type": "string",
       "description": "The name of the Python project",
+      "pattern": "^[a-zA-Z0-9][^:/\\\\]*$",
       "$default": {
         "$source": "argv",
         "index": 0
@@ -36,6 +37,11 @@
     "moduleName": {
       "type": "string",
       "description": "Python module name"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["name", "type"]