Struct PypiDependency 

pub struct PypiDependency {
    pub name: PackageName,
    pub name_range: Range,
    pub version_req: Option<VersionReq>,
    pub version_range: Option<Range>,
    pub extras: Vec<String>,
    pub extras_range: Option<Range>,
    pub markers: Option<String>,
    pub markers_range: Option<Range>,
    pub section: PypiDependencySection,
    pub source: DependencySource,
}

Parsed dependency from pyproject.toml with position tracking.

Stores all information about a Python dependency declaration, including its name, version requirement, extras, environment markers, and source positions for LSP operations. Positions are critical for features like hover, completion, and inlay hints.

Examples

use deps_pypi::types::{PypiDependency, PypiDependencySection, PypiDependencySource};
use tower_lsp_server::ls_types::{Position, Range};

let dep = PypiDependency {
    name: "requests".into(),
    name_range: Range::new(Position::new(5, 4), Position::new(5, 12)),
    version_req: Some(">=2.28.0,<3.0".into()),
    version_range: Some(Range::new(Position::new(5, 13), Position::new(5, 27))),
    extras: vec!["security".into()],
    extras_range: None,
    markers: Some("python_full_version >= '3.8'".into()),
    markers_range: None,
    section: PypiDependencySection::Dependencies,
    source: PypiDependencySource::Registry,
};

assert_eq!(dep.name, "requests");
assert!(matches!(dep.section, PypiDependencySection::Dependencies));

Fields

name: PackageName

The package name as produced by the parse path that created this dependency — normalization is non-uniform, not a property callers can rely on directly:

• PEP 508 string paths (PEP 621 [project] dependencies, PEP 735 dependency groups, requirements.txt) — already PEP 503-normalized, because pep508_rs::PackageName normalizes at construction.
• Poetry table-key paths ([tool.poetry.dependencies], [tool.poetry.group.*.dependencies]) — the verbatim TOML key, unnormalized.

Callers must therefore never assume a normalized name. Apply crate::name::normalize (via EcosystemFormatter::normalize_package_name) at lookup time.

name_range: Range

LSP range of the package name

version_req: Option<VersionReq>

PEP 440 version specifier (e.g., “>=2.28.0,<3.0”)

version_range: Option<Range>

LSP range of the version specifier

extras: Vec<String>

PEP 508 extras (e.g., [“security”, “socks”])

extras_range: Option<Range>

LSP range of the extras specification

markers: Option<String>

PEP 508 environment markers (e.g., “python_full_version >= ‘3.8’”; pep508_rs canonicalizes python_version comparisons to python_full_version on serialization)

markers_range: Option<Range>

LSP range of the markers specification

section: PypiDependencySection

Section where this dependency is declared

source: DependencySource

Source of the dependency (PyPI, Git, Path, URL)

Trait Implementations

impl Clone for PypiDependency

fn clone(&self) -> PypiDependency

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PypiDependency

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Dependency for PypiDependency

fn name(&self) -> &PackageName

Package name

fn name_range(&self) -> Range

LSP range of the dependency name

fn version_requirement(&self) -> Option<&VersionReq>

Version requirement string (e.g., “^1.0”, “>=2.0”)

fn version_range(&self) -> Option<Range>

LSP range of the version string

fn source(&self) -> DependencySource

Dependency source (registry, git, path)

fn features(&self) -> &[String]

Feature flags (ecosystem-specific, empty if not supported)

fn markers(&self) -> Option<&str>

Environment marker expression gating this dependency (e.g. PEP 508’s python_version >= '3.8'). Ecosystem-specific, None if not supported or not present on this dependency.

fn markers_range(&self) -> Option<Range>

LSP range of the environment marker expression (ecosystem-specific, None if not supported or not present).

fn as_any(&self) -> &(dyn Any + 'static)

Downcast to concrete type

fn features_range(&self) -> Option<Range>

LSP range of the features array (ecosystem-specific, None if not supported)

fn version_literal(&self) -> Option<&str>

The raw manifest text spanned by version_range, when it differs from version_requirement.

impl PartialEq for PypiDependency

fn eq(&self, other: &PypiDependency) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PypiDependency