GitHub
Main Docs

Deep Agents

LangChain

LangGraph

Integrations

LangSmith

Deep Agents Code

⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

DistributionVersion

Copy

DistributionVersion(
  self,
  name: str,
  source_version: str | None,
  metadata_version: str

Constructors

Attributes

View source on GitHub

None

editable

bool

source_path

str

None

status

DistributionMetadataStatus

)

constructor

__init__

Name	Type
name	str
source_version	str \| None
metadata_version	str \| None
editable	bool
source_path	str \| None
status	DistributionMetadataStatus

attribute

name: str

Distribution name, such as deepagents or deepagents-code.

attribute

source_version: str | None

Version read from the imported/source _version.py, when available.

attribute

metadata_version: str | None

Version from importlib.metadata, when the distribution is installed.

attribute

editable: bool

Whether the distribution is installed in editable mode.

attribute

source_path: str | None

~-contracted editable source root, when known.

Available for callers that want to display the editable root; the --version//version surfaces render the CLI path from config instead, so this is not rendered on every surface today.

attribute

status: DistributionMetadataStatus

Outcome of the metadata lookup.

attribute

primary_version: str | None

Version to report as authoritative.

Editable installs prefer the live source version because their metadata can lag the working tree after a local version change; every other install uses the metadata version, falling back to the source version when metadata is absent. This keeps the "a resolved lookup yields a non-None version" contract intact even when a source version is the only fact available.

attribute

has_drift: bool

Whether the source and metadata versions are both known and differ.

Structured version facts for a single installed distribution.

Separates three facts that are easily conflated: the live version read from the running source, whether imported or parsed (source_version), the version recorded in the installed distribution metadata (metadata_version), and whether the install is editable (with its source_path). status records whether the metadata lookup succeeded so diagnostic callers can distinguish a genuinely absent package from an unexpected lookup failure.

Menu

DistributionVersion

Constructors

Attributes