Enum LicenseSource 

#[non_exhaustive]
pub enum LicenseSource {
    RegistryDeclaredSpdx,
    FetchedDeclaredSpdx,
    DetectedSpdx,
    PomFreeText,
}

How this ecosystem’s license strings are sourced.

Drives three ecosystem-specific license behaviors that used to be re-derived independently at each consumer via a non-exhaustive matches!/== on EcosystemId instead of the sealed Ecosystem trait every other per-ecosystem capability goes through (issue #688): hover’s “(detected)” qualifier, which only applies to Self::DetectedSpdx; whether crate::licenses::resolve_license_entries must normalize free text to SPDX identifiers before hover displays it or a crate::licenses::LicensePolicy evaluates it, which only applies to Self::PomFreeText; and, via Self::requires_dedicated_fetch (issue #697), whether Ecosystem::fetch_license is a dedicated async fetch or a no-op because the license already arrived in the hot-path registry response.

Examples

use deps_core::LicenseSource;

assert_eq!(LicenseSource::default(), LicenseSource::RegistryDeclaredSpdx);
assert_ne!(LicenseSource::PomFreeText, LicenseSource::DetectedSpdx);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

RegistryDeclaredSpdx

Author-declared SPDX identifier(s) already present in the hot-path registry response — the default for every ecosystem that doesn’t override Ecosystem::license_source, and the only variant for which Self::requires_dedicated_fetch is false.

FetchedDeclaredSpdx

Author-declared SPDX identifier(s) that require a dedicated fetch separate from the hot-path registry response: JSR’s package-metadata endpoint (Deno).

DetectedSpdx

A detector’s best-effort guess, not an author declaration, that requires a dedicated fetch: pub.dev’s /score endpoint (Dart) and GitHub’s license.spdx_id (Swift) are both driven by a license-detection heuristic run against repository content, rather than metadata the package author explicitly declared to a registry.

PomFreeText

Maven POM <licenses><license><name> free text (Gradle), fetched via a dedicated request — never an SPDX identifier, so it must be normalized via crate::licenses::resolve_license_entries before display or policy evaluation.

Implementations

impl LicenseSource

pub const fn requires_dedicated_fetch(self) -> bool

Whether this source requires Ecosystem::fetch_license’s dedicated async fetch, as opposed to arriving for free in the hot-path registry response.

This is the single answer to “is this a tier-3 license ecosystem” (issue #697): capability and shape can no longer disagree, because both come from the same Ecosystem::license_source call.

Examples

use deps_core::LicenseSource;

assert!(!LicenseSource::RegistryDeclaredSpdx.requires_dedicated_fetch());
assert!(LicenseSource::FetchedDeclaredSpdx.requires_dedicated_fetch());
assert!(LicenseSource::DetectedSpdx.requires_dedicated_fetch());
assert!(LicenseSource::PomFreeText.requires_dedicated_fetch());

Trait Implementations

impl Clone for LicenseSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LicenseSource

impl Debug for LicenseSource

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

Formats the value using the given formatter.

impl Default for LicenseSource

fn default() -> Self

Returns the “default value” for a type.

impl Eq for LicenseSource

impl PartialEq for LicenseSource

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LicenseSource