uv
Installation
Entrypoint
Entrypoint
Entrypoint
Types
Uv
Audit
WorkspaceSource

uv

No long description provided.

Installation

dagger install github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10

Entrypoint

Return Type

Uv !

Arguments

Name	Type	Default Value	Description
source	Directory	-	Source directory.

Example

dagger -m github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10 call \

func (m *MyModule) Example() *dagger.Uv  {
	return dag.
			Uv()
}

@function
def example() -> dagger.Uv:
	return (
		dag.uv()
	)

@func()
example(): Uv {
	return dag
		.uv()
}

Entrypoint

Return Type

Audit !

Arguments

Name	Type	Default Value	Description
uvLock	File !	-	The workspace's uv.lock file.
pyproject	File !	-	The workspace's pyproject.toml file.
image	String !	-	uv image reference to run the audit in (must provide a `uv` binary).
uvToml	File	null	The workspace's uv.toml configuration file, if present.

Example

Function Audit.Constructor is not accessible from the uv module

Function Audit.Constructor is not accessible from the uv module

Function Audit.Constructor is not accessible from the uv module

Function Audit.Constructor is not accessible from the uv module

Entrypoint

Return Type

WorkspaceSource !

Arguments

Name	Type	Default Value	Description
uvLock	File !	-	The workspace's `uv.lock` file.
pyproject	File !	-	The workspace's `pyproject.toml` file (required by `uv audit`).
uvToml	File	null	The workspace's `uv.toml` configuration file, if present.

Example

Function WorkspaceSource.Constructor is not accessible from the uv module

Function WorkspaceSource.Constructor is not accessible from the uv module

Function WorkspaceSource.Constructor is not accessible from the uv module

Function WorkspaceSource.Constructor is not accessible from the uv module

Types

Uv 🔗

Tooling for uv-managed Python projects.

source() 🔗

Source directory.

Return Type

Directory !

Example

dagger -m github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10 call \
 source

func (m *MyModule) Example() *dagger.Directory  {
	return dag.
			Uv().
			Source()
}

@function
def example() -> dagger.Directory:
	return (
		dag.uv()
		.source()
	)

@func()
example(): Directory {
	return dag
		.uv()
		.source()
}

workspaces() 🔗

Every uv workspace in the source tree (one per uv.lock).

Return Type

[WorkspaceSource ! ] !

Example

dagger -m github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10 call \
 workspaces

func (m *MyModule) Example() []*dagger.UvWorkspaceSource  {
	return dag.
			Uv().
			Workspaces()
}

@function
def example() -> List[dagger.UvWorkspaceSource]:
	return (
		dag.uv()
		.workspaces()
	)

@func()
example(): UvWorkspaceSource[] {
	return dag
		.uv()
		.workspaces()
}

auditWorkspace() 🔗

Run uv audit for a single workspace.

Return Type

Void !

Arguments

Name	Type	Default Value	Description
uvLock	File !	-	The workspace's uv.lock file.
pyproject	File !	-	The workspace's pyproject.toml file.
uvToml	File	null	The workspace's uv.toml configuration file, if present.
uvVersion	String	null	uv version (image tag) to run with. Defaults to the version detected from the workspace; ignored when `image` is set.
image	String	null	Full uv image reference to run with. Overrides `uv_version`.

Example

dagger -m github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10 call \
 audit-workspace --uv-lock file:path --pyproject file:path

func (m *MyModule) Example(ctx context.Context, uvLock *dagger.File, pyproject *dagger.File)   {
	return dag.
			Uv().
			AuditWorkspace(ctx, uvLock, pyproject)
}

@function
async def example(uv_lock: dagger.File, pyproject: dagger.File) -> None:
	return await (
		dag.uv()
		.audit_workspace(uv_lock, pyproject)
	)

@func()
async example(uvLock: File, pyproject: File): Promise<void> {
	return dag
		.uv()
		.auditWorkspace(uvLock, pyproject)
}

audit() 🔗

Run uv audit for every workspace in parallel.

Exits non-zero when any (non-excluded) workspace fails its audit.

Return Type

Void !

Arguments

Name	Type	Default Value	Description
exclude	[String ! ]	null	Glob patterns (source-relative) of workspace paths to skip, e.g. `/tests/_packages/`.
uvVersion	String	null	uv version (image tag) to run with. Defaults to the version detected per workspace; ignored when `image` is set.
image	String	null	Full uv image reference to run with. Overrides `uv_version`.

Example

dagger -m github.com/typesafe-ai/daggerverse/uv@374f287ed5f2e918e4bba106a453af6dfdd21e10 call \
 audit

func (m *MyModule) Example(ctx context.Context)   {
	return dag.
			Uv().
			Audit(ctx)
}

@function
async def example() -> None:
	return await (
		dag.uv()
		.audit()
	)

@func()
async example(): Promise<void> {
	return dag
		.uv()
		.audit()
}

Audit 🔗

Runs ``uv audit`` for a single workspace in a given uv image.

uvLock() 🔗

The workspace’s uv.lock file.

Return Type

File !

Example

Function UvAudit.uvLock is not accessible from the uv module

Function UvAudit.uvLock is not accessible from the uv module

Function UvAudit.uvLock is not accessible from the uv module

Function UvAudit.uvLock is not accessible from the uv module

pyproject() 🔗

The workspace’s pyproject.toml file.

Return Type

File !

Example

Function UvAudit.pyproject is not accessible from the uv module

Function UvAudit.pyproject is not accessible from the uv module

Function UvAudit.pyproject is not accessible from the uv module

Function UvAudit.pyproject is not accessible from the uv module

image() 🔗

uv image reference to run the audit in (must provide a uv binary).

Return Type

String !

Example

Function UvAudit.image is not accessible from the uv module

Function UvAudit.image is not accessible from the uv module

Function UvAudit.image is not accessible from the uv module

Function UvAudit.image is not accessible from the uv module

uvToml() 🔗

The workspace’s uv.toml configuration file, if present.

Return Type

File

Example

Function UvAudit.uvToml is not accessible from the uv module

Function UvAudit.uvToml is not accessible from the uv module

Function UvAudit.uvToml is not accessible from the uv module

Function UvAudit.uvToml is not accessible from the uv module

run() 🔗

Run uv audit --frozen for this workspace.

Audits straight from the committed uv.lock without re-resolving against package indexes (--frozen); vulnerability data comes from the public OSV service, so no index credentials are required. A failing audit (non-zero exit, e.g. vulnerabilities found) fails the exec itself, so Dagger surfaces the output in the UI and does not cache the failure.

Return Type

Void !

Example

Function UvAudit.run is not accessible from the uv module

Function UvAudit.run is not accessible from the uv module

Function UvAudit.run is not accessible from the uv module

Function UvAudit.run is not accessible from the uv module

WorkspaceSource 🔗

A self-contained uv workspace: the source files rooted at a ``uv.lock``. Currently carries the lockfile and the ``pyproject.toml`` that ``uv audit`` requires alongside it; it will carry more of the workspace in the future. Named ``UvWorkspaceSource`` (not ``UvWorkspace``) to avoid colliding with the sibling ``uv-workspace`` module's main ``UvWorkspace`` object when both are composed in a parent module.

uvLock() 🔗

The workspace’s uv.lock file.

Return Type

File !

Example

Function UvWorkspaceSource.uvLock is not accessible from the uv module

Function UvWorkspaceSource.uvLock is not accessible from the uv module

Function UvWorkspaceSource.uvLock is not accessible from the uv module

Function UvWorkspaceSource.uvLock is not accessible from the uv module

pyproject() 🔗

The workspace’s pyproject.toml file (required by uv audit).

Return Type

File !

Example

Function UvWorkspaceSource.pyproject is not accessible from the uv module

Function UvWorkspaceSource.pyproject is not accessible from the uv module

Function UvWorkspaceSource.pyproject is not accessible from the uv module

Function UvWorkspaceSource.pyproject is not accessible from the uv module

uvToml() 🔗

The workspace’s uv.toml configuration file, if present.

Return Type

File

Example

Function UvWorkspaceSource.uvToml is not accessible from the uv module

Function UvWorkspaceSource.uvToml is not accessible from the uv module

Function UvWorkspaceSource.uvToml is not accessible from the uv module

Function UvWorkspaceSource.uvToml is not accessible from the uv module

uvVersion() 🔗

The uv version this workspace requires, as a concrete image tag.

Reads required-version (a PEP 440 specifier) from uv.toml or the [tool.uv] table of pyproject.toml, resolving ranges against PyPI. Falls back to the default version hardcoded in this module when unspecified.

Return Type

String !

Example

Function UvWorkspaceSource.uvVersion is not accessible from the uv module

Function UvWorkspaceSource.uvVersion is not accessible from the uv module

Function UvWorkspaceSource.uvVersion is not accessible from the uv module

Function UvWorkspaceSource.uvVersion is not accessible from the uv module

audit() 🔗

Audit this workspace’s locked dependencies using the given uv image.

The image is supplied by the caller so this type stays container-free (the runner owns image/version selection).

Return Type

Audit !

Arguments

Name	Type	Default Value	Description
image	String !	-	uv image reference to run the audit in.

Example

Function UvWorkspaceSource.audit is not accessible from the uv module

Function UvWorkspaceSource.audit is not accessible from the uv module

Function UvWorkspaceSource.audit is not accessible from the uv module

Function UvWorkspaceSource.audit is not accessible from the uv module