Struct NpmVersion 

pub struct NpmVersion {
    pub version: ConcreteVersion,
    pub deprecated: bool,
    pub deprecation: Option<Deprecation>,
    pub published_at: Option<PublishTime>,
}

Version information for an npm package.

Retrieved from the npm registry API at https://registry.npmjs.org/{package}. Contains version number and deprecation status.

Examples

use deps_npm::types::NpmVersion;

let version = NpmVersion {
    version: "4.18.2".into(),
    deprecated: false,
    deprecation: None,
    published_at: None,
};

assert!(!version.deprecated);

Fields

version: ConcreteVersion

deprecated: bool

deprecation: Option<Deprecation>

Package-level deprecation payload (issue #205), derived from the packument’s deprecated free-text field. None whenever deprecated is absent, null, or an all-whitespace string — npm’s own convention for “un-deprecating” a package is republishing with an empty deprecated string, so that case must not produce a dangling, information-free diagnostic (see deprecation_from_message). Carries no replacement: npm only ever names a successor in free text, and regex-extracting a package name from registry-controlled prose to rewrite a manifest is a typosquatting vector — see NpmFormatter::supports_package_rename.

published_at: Option<PublishTime>

Publish timestamp, populated only when Registry::get_versions_with is called with freshness enabled — derived from the full packument’s time map, never the abbreviated packument get_versions otherwise uses.

Trait Implementations

impl Clone for NpmVersion

fn clone(&self) -> NpmVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NpmVersion

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

Formats the value using the given formatter.

impl Version for NpmVersion

fn version_string(&self) -> &ConcreteVersion

Version string (e.g., “1.0.214”, “14.21.3”).

fn removal_status(&self) -> RemovalStatus

This version’s removal/deprecation status as reported by the registry.

fn published_at(&self) -> Option<PublishTime>

When this version was published, if the registry exposes it.

fn is_prerelease(&self) -> bool

Whether this version is a pre-release (alpha, beta, rc, etc.).

fn deprecation(&self) -> Option<&Deprecation>

Package-level deprecation payload, when this version’s registry data carries one.

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

Downcast to concrete version type

fn features(&self) -> Vec<String>

Available feature flags (empty if not supported by ecosystem).

fn is_stable(&self) -> bool

Whether this version is stable: not hard-yanked and not a pre-release.