@mgwilt/nx-uv 0.1.2 → 0.1.3-beta.1

package/README.md

@@ -1,24 +1,309 @@
 # @mgwilt/nx-uv
 
-Nx plugin for integrating [uv](https://docs.astral.sh/uv/) workflows into an Nx monorepo.
+[Nx](https://nx.dev/) plugin for running [uv](https://docs.astral.sh/uv/) workflows in [Nx](https://nx.dev/) monorepos.
 
-## Executors
+[![CI](https://github.com/mgwilt/nx-uv/actions/workflows/ci.yml/badge.svg)](https://github.com/mgwilt/nx-uv/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/mgwilt/nx-uv/badges/.github/badges/coverage.json)](https://github.com/mgwilt/nx-uv/blob/badges/.github/badges/coverage.json)
+[![npm beta](https://img.shields.io/npm/v/%40mgwilt%2Fnx-uv/beta?label=npm%20beta&cacheSeconds=300)](https://www.npmjs.com/package/@mgwilt/nx-uv?activeTab=versions)
 
-- `@mgwilt/nx-uv:sync` runs `uv sync`
-- `@mgwilt/nx-uv:run` runs `uv run`
-- `@mgwilt/nx-uv:add` runs `uv add`
+## When to use this plugin
 
-## Generator
+- Run [uv](https://docs.astral.sh/uv/) commands through [Nx](https://nx.dev/) targets instead of ad-hoc shell scripts.
+- Infer useful [uv](https://docs.astral.sh/uv/) targets from existing `pyproject.toml` files.
+- Scaffold [uv](https://docs.astral.sh/uv/)-ready [Python](https://www.python.org/) projects and workspace config.
+- Keep [Python](https://www.python.org/) work in the same task graph, caching, and CI flow as the rest of your monorepo.
 
-- `@mgwilt/nx-uv:python-package`
-  - Creates a Python package in `packages/py/<name>` by default.
-  - Generates `pyproject.toml`, `src/<module>/__init__.py`, and optional tests.
-  - Adds Nx targets: `sync`, `add`, `run`, `test`, `lint`.
+## Tools
 
-## Local Usage
+- Executors for [uv](https://docs.astral.sh/uv/) command families:
+  - `@mgwilt/nx-uv:project`
+  - `@mgwilt/nx-uv:uv`
+  - `@mgwilt/nx-uv:pip`
+  - `@mgwilt/nx-uv:tool`
+  - `@mgwilt/nx-uv:python`
+  - `@mgwilt/nx-uv:auth`
+  - `@mgwilt/nx-uv:cache`
+  - `@mgwilt/nx-uv:self`
+- Generators:
+  - `@mgwilt/nx-uv:workspace`
+  - `@mgwilt/nx-uv:project`
+  - `@mgwilt/nx-uv:integration`
+  - `@mgwilt/nx-uv:convert`
+- [Nx](https://nx.dev/) plugin inference (`createNodesV2`) for `pyproject.toml`.
+
+## Install
+
+Prerequisites:
+
+- [Nx](https://nx.dev/) workspace
+- [uv](https://docs.astral.sh/uv/) installed and available on `PATH`
+
+Install the plugin:
+
+```bash
+pnpm add -D @mgwilt/nx-uv
+```
+
+## Brand new monorepo example
+
+This walkthrough creates a new [Nx](https://nx.dev/) monorepo and uses this plugin to scaffold a working [uv](https://docs.astral.sh/uv/) + [Python](https://www.python.org/) example.
+
+1. Create a new workspace:
+
+```bash
+pnpm create nx-workspace@latest acme-monorepo --preset=ts --packageManager=pnpm --nxCloud=skip --interactive=false
+cd acme-monorepo
+```
+
+2. Install this plugin (beta channel) and initialize workspace-level [uv](https://docs.astral.sh/uv/) config:
+
+```bash
+pnpm add -D @mgwilt/nx-uv@beta
+pnpm nx g @mgwilt/nx-uv:workspace --name=acme --membersGlob='packages/py/*'
+```
+
+3. Generate a [Python](https://www.python.org/) app and scaffold integrations:
+
+```bash
+pnpm nx g @mgwilt/nx-uv:project api --projectType=app --directory=packages/py
+pnpm nx g @mgwilt/nx-uv:integration --template=fastapi --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=github
+```
+
+Expected file tree (key files) after step 3:
+
+```text
+acme-monorepo/
+├── nx.json
+├── package.json
+├── pyproject.toml
+├── .github/
+│   └── workflows/
+│       └── uv-ci.yml
+└── packages/
+    └── py/
+        └── api/
+            ├── README.md
+            ├── pyproject.toml
+            ├── main.py
+            ├── Dockerfile.fastapi
+            ├── src/
+            │   └── api/
+            │       ├── __init__.py
+            │       └── main.py
+            └── tests/
+                └── test_smoke.py
+```
+
+4. Add runtime and dev dependencies with [uv](https://docs.astral.sh/uv/):
+
+```bash
+cd packages/py/api
+uv add fastapi uvicorn
+uv add --dev pytest ruff
+cd ../../..
+```
+
+5. Run plugin-backed targets via [Nx](https://nx.dev/):
 
 ```bash
-pnpm nx g @mgwilt/nx-uv:python-package shared
-pnpm nx run shared:sync
-pnpm nx run shared:test
+pnpm nx run api:sync
+pnpm nx run api:uv
+pnpm nx run api:run
+pnpm nx run api:test
+pnpm nx run api:build
+```
+
+At this point you have a working monorepo with:
+
+- Root `pyproject.toml` and [uv](https://docs.astral.sh/uv/) workspace members
+- A generated `api` [Python](https://www.python.org/) project under `packages/py/api`
+- Generated [FastAPI](https://fastapi.tiangolo.com/) starter files and a [GitHub Actions](https://github.com/features/actions) Nx-first CI template
+- [Nx](https://nx.dev/) targets that run uv commands consistently in CI/local dev
+
+## Quick start (existing workspace)
+
+1. Add the plugin to `nx.json`:
+
+```json
+{
+  "plugins": [
+    {
+      "plugin": "@mgwilt/nx-uv",
+      "options": {
+        "targetPrefix": "uv:",
+        "inferencePreset": "standard",
+        "includeGlobalTargets": false
+      }
+    }
+  ]
+}
 ```
+
+2. (Optional, recommended for new repos) Initialize [uv](https://docs.astral.sh/uv/) workspace config:
+
+```bash
+pnpm nx g @mgwilt/nx-uv:workspace --name=acme
+```
+
+3. Generate a [Python](https://www.python.org/) project wired for [uv](https://docs.astral.sh/uv/) + [Nx](https://nx.dev/):
+
+```bash
+pnpm nx g @mgwilt/nx-uv:project services/api --projectType=app
+```
+
+4. Run [uv](https://docs.astral.sh/uv/)-backed targets:
+
+```bash
+pnpm nx run api:sync
+pnpm nx run api:test
+pnpm nx run api:build
+```
+
+## Existing [Python](https://www.python.org/) projects
+
+If your repo already has `pyproject.toml` files, the plugin can infer targets (for example `uv:sync`, `uv:run`, `uv:test`) based on your configured `targetPrefix` and inference preset.
+
+### Customizing inferred targets
+
+You can disable or override inferred targets in plugin options:
+
+```json
+{
+  "plugins": [
+    {
+      "plugin": "@mgwilt/nx-uv",
+      "options": {
+        "targetPrefix": "uv:",
+        "inferencePreset": "standard",
+        "inferredTargets": {
+          "test": false,
+          "lint": {
+            "command": "run",
+            "commandArgs": ["--", "ruff", "check", "src"]
+          }
+        }
+      }
+    }
+  ]
+}
+```
+
+Supported inferred target keys are: `sync`, `run`, `lock`, `test`, `lint`, `build`, `tree`, `export`, `format`, `venv`, `publish`.
+
+## Integration templates
+
+Use integration templates to scaffold common [uv](https://docs.astral.sh/uv/) ecosystem files for CI, containers, dependency automation, and notebook workflows.
+
+### How file output location works
+
+- `--project=<name>` sets `<baseDir>` to that [Nx](https://nx.dev/) project's root.
+- `--directory=<path>` sets `<baseDir>` to that directory relative to workspace root.
+- If neither is set, `<baseDir>` defaults to workspace root (`.`).
+- Workspace-level templates always write to repo root, even if `--project` or `--directory` is provided.
+- Workspace-level templates are:
+  - `github`
+  - `gitlab`
+  - `dependency-bots`
+  - `pre-commit`
+
+### Template matrix
+
+| Template              | Scope          | Files generated                                     | Best for                                                                                                                                                   |
+| --------------------- | -------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `alternative-indexes` | `baseDir`      | `<baseDir>/uv.indexes.toml.snippet`                 | Defining custom/internal [Python](https://www.python.org/) indexes                                                                                         |
+| `aws-lambda`          | `baseDir`      | `<baseDir>/Dockerfile.lambda`                       | Packaging [uv](https://docs.astral.sh/uv/)-based [AWS Lambda](https://aws.amazon.com/lambda/) workloads                                                    |
+| `coiled`              | `baseDir`      | `<baseDir>/scripts/coiled-example.py`               | Starting distributed [Python](https://www.python.org/) experiments with [Coiled](https://coiled.io/)                                                       |
+| `dependency-bots`     | workspace root | `renovate.json`, `.github/dependabot.yml`           | Automated dependency update workflows with [Renovate](https://docs.renovatebot.com/) and [Dependabot](https://docs.github.com/en/code-security/dependabot) |
+| `docker`              | `baseDir`      | `<baseDir>/Dockerfile`                              | Containerizing a [uv](https://docs.astral.sh/uv/) project with [Docker](https://www.docker.com/)                                                           |
+| `fastapi`             | `baseDir`      | `<baseDir>/main.py`, `<baseDir>/Dockerfile.fastapi` | Bootstrapping a [FastAPI](https://fastapi.tiangolo.com/) service with [uv](https://docs.astral.sh/uv/)                                                     |
+| `github`              | workspace root | `.github/workflows/uv-ci.yml`                       | [GitHub Actions](https://github.com/features/actions) Nx-first CI starter using `nx affected`                                                              |
+| `gitlab`              | workspace root | `.gitlab-ci.uv.yml`                                 | [GitLab CI/CD](https://docs.gitlab.com/ee/ci/) Nx-first CI starter using `nx run-many`                                                                     |
+| `jupyter`             | `baseDir`      | `<baseDir>/scripts/setup-jupyter-kernel.sh`         | Registering a [uv](https://docs.astral.sh/uv/)-managed [Jupyter](https://jupyter.org/) kernel                                                              |
+| `marimo`              | `baseDir`      | `<baseDir>/notebooks/example.marimo.py`             | Starting [marimo](https://marimo.io/) notebook workflows                                                                                                   |
+| `pre-commit`          | workspace root | `.pre-commit-config.yaml`                           | Local code quality hooks for [uv](https://docs.astral.sh/uv/) projects using [pre-commit](https://pre-commit.com/)                                         |
+| `pytorch`             | `baseDir`      | `<baseDir>/uv.pytorch.toml.snippet`                 | Configuring [PyTorch](https://pytorch.org/) index/source snippets                                                                                          |
+
+### Command examples for all templates
+
+```bash
+pnpm nx g @mgwilt/nx-uv:integration --template=alternative-indexes --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=aws-lambda --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=coiled --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=dependency-bots
+pnpm nx g @mgwilt/nx-uv:integration --template=docker --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=fastapi --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=github
+pnpm nx g @mgwilt/nx-uv:integration --template=gitlab
+pnpm nx g @mgwilt/nx-uv:integration --template=jupyter --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=marimo --project=api
+pnpm nx g @mgwilt/nx-uv:integration --template=pre-commit
+pnpm nx g @mgwilt/nx-uv:integration --template=pytorch --project=api
+```
+
+### Common options
+
+- `--overwrite=true` replaces existing files instead of skipping them.
+- `--directory=<path>` writes baseDir-aware templates into a non-project directory.
+- `--skipFormat=true` skips formatter execution after generation.
+- Prefer `--project` for app/lib scaffolds and no location flag for workspace-level templates.
+
+### Notes and pitfalls
+
+- Templates are starter scaffolds; you should review and harden generated files for production use.
+- Running the same template multiple times without `--overwrite=true` leaves existing files unchanged.
+- Workspace-level templates are intentionally global and may affect repository-wide automation.
+
+## Compatibility and versioning
+
+- Runtime [uv](https://docs.astral.sh/uv/) compatibility checks verify that `uv` is available and executable.
+- `uv 0.9.x` and `0.10.x` are currently the tested ranges. Other versions log a warning and continue.
+- This package is pre-v1 and published on the [npm](https://www.npmjs.com/) `beta` dist-tag.
+
+## Troubleshooting
+
+### Nx plugin bootstrap failures
+
+If `quality:ci` fails before running tasks with worker/bootstrap errors (for example `Failed to load ... Nx plugin(s)`), run:
+
+```bash
+pnpm nx report
+pnpm nx reset
+NX_DAEMON=false pnpm quality:ci
+```
+
+If bootstrap still fails, run direct checks to isolate whether the issue is Nx plugin startup or project logic:
+
+```bash
+pnpm exec eslint .
+pnpm exec tsc -p tsconfig.lib.json --noEmit
+pnpm exec tsc -p tsconfig.spec.json --noEmit
+pnpm exec vitest run -c vitest.unit.config.mts
+pnpm exec vitest run -c vitest.integration.config.mts
+pnpm exec vitest run -c vitest.e2e.config.mts
+pnpm exec vitest run -c vitest.coverage.config.mts
+```
+
+### E2E execution permissions
+
+The e2e suite executes a temporary shim binary from the local filesystem. In restricted environments (for example `noexec` mounts or sandboxed process policies), e2e tests may be skipped when executable spawning is not permitted.
+
+## LLM context files
+
+This repository publishes LLM-friendly docs artifacts:
+
+- `llms.txt`: concise index of high-signal project docs.
+- `llms-full.txt`: expanded inline content for the same curated sources.
+
+Regenerate and validate them with:
+
+```bash
+pnpm llms:generate
+pnpm llms:check
+```
+
+## Additional docs
+
+- [Documentation index](docs/index.md)
+- [Maintainer guide (quality gates, CI, release)](docs/maintainers.md)
+- [Sample scaffolding patterns](samples/README.md)

package/executors.json

@@ -1,19 +1,44 @@
 {
   "executors": {
-    "sync": {
-      "implementation": "./src/executors/sync/sync",
-      "schema": "./src/executors/sync/schema.json",
-      "description": "Run uv sync for a Python package."
+    "uv": {
+      "implementation": "./src/executors/uv/uv",
+      "schema": "./src/executors/uv/schema.json",
+      "description": "Run any uv command via argument passthrough."
     },
-    "run": {
-      "implementation": "./src/executors/run/run",
-      "schema": "./src/executors/run/schema.json",
-      "description": "Run arbitrary commands through uv run."
+    "project": {
+      "implementation": "./src/executors/project/project",
+      "schema": "./src/executors/project/schema.json",
+      "description": "Run uv project-oriented commands (run/init/add/remove/sync/lock/build/publish/etc)."
     },
-    "add": {
-      "implementation": "./src/executors/add/add",
-      "schema": "./src/executors/add/schema.json",
-      "description": "Add dependencies through uv add."
+    "pip": {
+      "implementation": "./src/executors/pip/pip",
+      "schema": "./src/executors/pip/schema.json",
+      "description": "Run uv pip subcommands."
+    },
+    "tool": {
+      "implementation": "./src/executors/tool/tool",
+      "schema": "./src/executors/tool/schema.json",
+      "description": "Run uv tool subcommands."
+    },
+    "python": {
+      "implementation": "./src/executors/python/python",
+      "schema": "./src/executors/python/schema.json",
+      "description": "Run uv python subcommands."
+    },
+    "auth": {
+      "implementation": "./src/executors/auth/auth",
+      "schema": "./src/executors/auth/schema.json",
+      "description": "Run uv auth subcommands."
+    },
+    "cache": {
+      "implementation": "./src/executors/cache/cache",
+      "schema": "./src/executors/cache/schema.json",
+      "description": "Run uv cache subcommands."
+    },
+    "self": {
+      "implementation": "./src/executors/self/self",
+      "schema": "./src/executors/self/schema.json",
+      "description": "Run uv self subcommands."
     }
   }
 }

package/generators.json

@@ -1,9 +1,24 @@
 {
   "generators": {
-    "python-package": {
-      "factory": "./src/generators/python-package/python-package",
-      "schema": "./src/generators/python-package/schema.json",
-      "description": "Generate a Python package with uv and Nx targets."
+    "workspace": {
+      "factory": "./src/generators/workspace/workspace",
+      "schema": "./src/generators/workspace/schema.json",
+      "description": "Configure a uv workspace root and Nx plugin inference settings."
+    },
+    "project": {
+      "factory": "./src/generators/project/project",
+      "schema": "./src/generators/project/schema.json",
+      "description": "Generate a Python app/lib/script project wired for uv and Nx."
+    },
+    "convert": {
+      "factory": "./src/generators/convert/convert",
+      "schema": "./src/generators/convert/schema.json",
+      "description": "Convert existing Python Nx projects to new uv targets and executors."
+    },
+    "integration": {
+      "factory": "./src/generators/integration/integration",
+      "schema": "./src/generators/integration/schema.json",
+      "description": "Scaffold uv integration templates (CI, Docker, FastAPI, Lambda, and more)."
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgwilt/nx-uv",
-  "version": "0.1.2",
+  "version": "0.1.3-beta.1",
   "description": "Nx plugin for uv workflows in Nx monorepos",
   "license": "MIT",
   "type": "commonjs",
@@ -18,11 +18,16 @@
     "python"
   ],
   "dependencies": {
+    "@iarna/toml": "^2.2.5",
     "@nx/devkit": "22.5.3",
     "@nx/vite": "22.5.3",
+    "minimatch": "^10.2.4",
     "tslib": "^2.3.0",
     "vitest": "^4.0.18"
   },
+  "peerDependencies": {
+    "nx": ">=22 <=23"
+  },
   "devDependencies": {
     "@commitlint/cli": "^20.4.2",
     "@commitlint/config-conventional": "^20.4.2",
@@ -39,6 +44,7 @@
     "eslint-config-prettier": "^10.1.8",
     "jsdom": "^27.1.0",
     "jsonc-eslint-parser": "^2.4.0",
+    "lefthook": "^2.1.2",
     "nx": "22.5.3",
     "prettier": "^3.6.2",
     "typescript": "~5.9.2",
@@ -49,10 +55,23 @@
   "generators": "./generators.json",
   "scripts": {
     "build": "nx run nx-uv:build",
+    "coverage:badge": "nx run nx-uv:coverage-badge",
+    "typecheck": "nx run nx-uv:typecheck",
+    "format:check": "nx run nx-uv:format-check",
     "lint": "nx run nx-uv:lint",
     "test": "nx run nx-uv:test",
-    "release:version": "nx release version",
-    "release:publish": "nx release publish",
+    "test:unit": "nx run nx-uv:test-unit",
+    "test:integration": "nx run nx-uv:test-integration",
+    "test:e2e": "nx run nx-uv:test-e2e",
+    "test:coverage": "nx run nx-uv:test-coverage",
+    "quality:local": "nx run nx-uv:quality-local",
+    "quality:ci": "nx run nx-uv:quality-ci",
+    "samples:generate": "node tools/generate-samples.cjs",
+    "llms:generate": "node tools/generate-llms.cjs",
+    "llms:check": "node tools/check-llms.cjs",
+    "hooks:install": "lefthook install",
+    "release:version": "nx release version --preid beta",
+    "release:publish": "nx release publish --tag beta",
     "commitlint": "commitlint --from=HEAD~1 --to=HEAD"
   }
 }

package/src/executors/auth/auth.d.ts

@@ -0,0 +1,4 @@
+import { PromiseExecutor } from "@nx/devkit";
+import { AuthExecutorSchema } from "./schema";
+declare const authExecutor: PromiseExecutor<AuthExecutorSchema>;
+export default authExecutor;

package/src/executors/auth/auth.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_uv_1 = require("../shared/run-uv");
+const authExecutor = async (options, context) => {
+    var _a;
+    const args = ["auth", options.command, ...((_a = options.commandArgs) !== null && _a !== void 0 ? _a : [])];
+    return (0, run_uv_1.runUvCommand)(args, options, context);
+};
+exports.default = authExecutor;
+//# sourceMappingURL=auth.js.map

package/src/executors/auth/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../src/executors/auth/auth.ts"],"names":[],"mappings":";;AACA,6CAAgD;AAGhD,MAAM,YAAY,GAAwC,KAAK,EAC7D,OAAO,EACP,OAAO,EACP,EAAE;;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,IAAA,qBAAY,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,kBAAe,YAAY,CAAC"}

package/src/executors/auth/schema.d.ts

@@ -0,0 +1,8 @@
+import { UvBaseExecutorSchema } from "../shared/options";
+
+export type UvAuthCommand = "login" | "logout" | "token" | "dir";
+
+export interface AuthExecutorSchema extends UvBaseExecutorSchema {
+  command: UvAuthCommand;
+  commandArgs?: string[];
+}

package/src/executors/auth/schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "version": 2,
+  "title": "uv auth executor",
+  "description": "Run uv auth subcommands.",
+  "type": "object",
+  "properties": {
+    "cwd": { "type": "string" },
+    "directory": { "type": "string" },
+    "project": { "type": "string" },
+    "configFile": { "type": "string" },
+    "noConfig": { "type": "boolean", "default": false },
+    "offline": { "type": "boolean", "default": false },
+    "noProgress": { "type": "boolean", "default": false },
+    "quiet": { "type": "boolean", "default": false },
+    "verbose": { "type": "boolean", "default": false },
+    "color": { "type": "string", "enum": ["auto", "always", "never"] },
+    "nativeTls": { "type": "boolean", "default": false },
+    "cacheDir": { "type": "string" },
+    "noCache": { "type": "boolean", "default": false },
+    "managedPython": { "type": "boolean", "default": false },
+    "noManagedPython": { "type": "boolean", "default": false },
+    "noPythonDownloads": { "type": "boolean", "default": false },
+    "allowInsecureHost": { "type": "array", "items": { "type": "string" } },
+    "env": { "type": "object", "additionalProperties": { "type": "string" } },
+    "extraArgs": { "type": "array", "items": { "type": "string" } },
+    "skipVersionCheck": { "type": "boolean", "default": false },
+    "command": {
+      "type": "string",
+      "enum": ["login", "logout", "token", "dir"]
+    },
+    "commandArgs": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["command"],
+  "additionalProperties": false
+}

package/src/executors/cache/cache.d.ts

@@ -0,0 +1,4 @@
+import { PromiseExecutor } from "@nx/devkit";
+import { CacheExecutorSchema } from "./schema";
+declare const cacheExecutor: PromiseExecutor<CacheExecutorSchema>;
+export default cacheExecutor;

package/src/executors/cache/cache.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_uv_1 = require("../shared/run-uv");
+const cacheExecutor = async (options, context) => {
+    var _a;
+    const args = ["cache", options.command, ...((_a = options.commandArgs) !== null && _a !== void 0 ? _a : [])];
+    return (0, run_uv_1.runUvCommand)(args, options, context);
+};
+exports.default = cacheExecutor;
+//# sourceMappingURL=cache.js.map

package/src/executors/cache/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/executors/cache/cache.ts"],"names":[],"mappings":";;AACA,6CAAgD;AAGhD,MAAM,aAAa,GAAyC,KAAK,EAC/D,OAAO,EACP,OAAO,EACP,EAAE;;IACF,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,IAAA,qBAAY,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,kBAAe,aAAa,CAAC"}

package/src/executors/cache/schema.d.ts

@@ -0,0 +1,8 @@
+import { UvBaseExecutorSchema } from "../shared/options";
+
+export type UvCacheCommand = "clean" | "prune" | "dir" | "size";
+
+export interface CacheExecutorSchema extends UvBaseExecutorSchema {
+  command: UvCacheCommand;
+  commandArgs?: string[];
+}

package/src/executors/cache/schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "version": 2,
+  "title": "uv cache executor",
+  "description": "Run uv cache subcommands.",
+  "type": "object",
+  "properties": {
+    "cwd": { "type": "string" },
+    "directory": { "type": "string" },
+    "project": { "type": "string" },
+    "configFile": { "type": "string" },
+    "noConfig": { "type": "boolean", "default": false },
+    "offline": { "type": "boolean", "default": false },
+    "noProgress": { "type": "boolean", "default": false },
+    "quiet": { "type": "boolean", "default": false },
+    "verbose": { "type": "boolean", "default": false },
+    "color": { "type": "string", "enum": ["auto", "always", "never"] },
+    "nativeTls": { "type": "boolean", "default": false },
+    "cacheDir": { "type": "string" },
+    "noCache": { "type": "boolean", "default": false },
+    "managedPython": { "type": "boolean", "default": false },
+    "noManagedPython": { "type": "boolean", "default": false },
+    "noPythonDownloads": { "type": "boolean", "default": false },
+    "allowInsecureHost": { "type": "array", "items": { "type": "string" } },
+    "env": { "type": "object", "additionalProperties": { "type": "string" } },
+    "extraArgs": { "type": "array", "items": { "type": "string" } },
+    "skipVersionCheck": { "type": "boolean", "default": false },
+    "command": { "type": "string", "enum": ["clean", "prune", "dir", "size"] },
+    "commandArgs": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["command"],
+  "additionalProperties": false
+}

package/src/executors/pip/pip.d.ts

@@ -0,0 +1,4 @@
+import { PromiseExecutor } from "@nx/devkit";
+import { PipExecutorSchema } from "./schema";
+declare const pipExecutor: PromiseExecutor<PipExecutorSchema>;
+export default pipExecutor;

package/src/executors/pip/pip.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_uv_1 = require("../shared/run-uv");
+const pipExecutor = async (options, context) => {
+    var _a;
+    const args = ["pip", options.command, ...((_a = options.commandArgs) !== null && _a !== void 0 ? _a : [])];
+    return (0, run_uv_1.runUvCommand)(args, options, context);
+};
+exports.default = pipExecutor;
+//# sourceMappingURL=pip.js.map

package/src/executors/pip/pip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pip.js","sourceRoot":"","sources":["../../../../src/executors/pip/pip.ts"],"names":[],"mappings":";;AACA,6CAAgD;AAGhD,MAAM,WAAW,GAAuC,KAAK,EAC3D,OAAO,EACP,OAAO,EACP,EAAE;;IACF,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,CAAC;IACtE,OAAO,IAAA,qBAAY,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,kBAAe,WAAW,CAAC"}

package/src/executors/pip/schema.d.ts

@@ -0,0 +1,17 @@
+import { UvBaseExecutorSchema } from "../shared/options";
+
+export type UvPipCommand =
+  | "compile"
+  | "sync"
+  | "install"
+  | "uninstall"
+  | "freeze"
+  | "list"
+  | "show"
+  | "tree"
+  | "check";
+
+export interface PipExecutorSchema extends UvBaseExecutorSchema {
+  command: UvPipCommand;
+  commandArgs?: string[];
+}