Struct GithubActionsDependency 

pub struct GithubActionsDependency {
    pub name: PackageName,
    pub name_range: Range,
    pub version_req: Option<VersionReq>,
    pub version_range: Option<Range>,
    pub version_literal: Option<String>,
    pub pin: Option<PinStyle>,
    pub source: DependencySource,
    pub is_plain_scalar: bool,
}

Parsed uses: dependency from a GitHub Actions workflow file, with position tracking.

name is owner/repo — truncated at the second / for a subdirectory action (github/codeql-action/init@v3 -> github/codeql-action) or a reusable-workflow call (owner/repo/.github/workflows/x.yml@ref -> owner/repo).

Fields

name: PackageName

owner/repo identity.

name_range: Range

LSP range of the owner/repo text (truncated at the second /).

version_req: Option<VersionReq>

Normalized version requirement: the tag text for a [PinStyle::Tag] or a [PinStyle::Sha] with a comment_tag, the raw SHA for a commentless [PinStyle::Sha], the branch name for [PinStyle::Branch] — None for a non-resolvable source.

version_range: Option<Range>

LSP range of the ref text — for a [PinStyle::Sha] with a comment_tag, this extends through the comment token (<40hex> # v4.2.0). None for a non-resolvable source or a bare uses: owner/repo with no @ at all.

version_literal: Option<String>

The raw literal text version_range spans, when it differs from version_req — populated only for the SHA-with-comment form, where version_req is the comment-derived tag but version_range spans the full <sha> # <tag> text.

pin: Option<PinStyle>

How the ref is pinned; None for a non-resolvable source.

source: DependencySource

Dependency source: DependencySource::Registry for any @ref form (tag, SHA, or branch — all resolvable against the GitHub tags API by name alone), DependencySource::Path for ./local, DependencySource::Url for docker://image:tag and a reusable-workflow call.

is_plain_scalar: bool

Whether the whole uses: value was written as a plain (unquoted) YAML scalar, as opposed to single- or double-quoted (uses: "actions/checkout@v4").

For a quoted scalar, version_range spans text inside the quotes — writing {sha} # {tag} there would place a # inside the string rather than starting a YAML comment, producing a uses: value GitHub Actions rejects and that re-parses as [PinStyle::Branch] (issue #473, spec 031 FR-010). A SHA-pin code action must check this before writing any edit that assumes an unquoted YAML comment can follow the ref text — see crate::formatter::GithubActionsFormatter::sha_pin_replacement_for’s caller.

Trait Implementations

impl Clone for GithubActionsDependency

fn clone(&self) -> GithubActionsDependency

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GithubActionsDependency

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

Formats the value using the given formatter.

impl Dependency for GithubActionsDependency

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 version_literal(&self) -> Option<&str>

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

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

Downcast to concrete type

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

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

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

LSP range of the features array (ecosystem-specific, None 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).

impl Eq for GithubActionsDependency

impl PartialEq for GithubActionsDependency

fn eq(&self, other: &GithubActionsDependency) -> 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 GithubActionsDependency