Enum VersionConstraint 

pub enum VersionConstraint {
    Tag(String),
    Branch(String),
    Commit(String),
}

Represents different types of version constraints in AGPM.

VersionConstraint is a simple enum that categorizes version references into three main types: Git tags (including semantic versions), Git branches, and Git commit hashes. This classification helps AGPM route version resolution to the appropriate handling logic.

Variants

• Tag: Semantic versions, version requirements, and Git tags
• Branch: Git branch names and references
• Commit: Git commit hashes (full or abbreviated)

Serialization

This enum implements Serialize and Deserialize for use in configuration files and lockfiles, allowing version constraints to be persisted and restored.

Examples

use agpm_cli::version::VersionConstraint;

// Create different constraint types
let version = VersionConstraint::Tag("1.0.0".to_string());
let branch = VersionConstraint::Branch("main".to_string());
let commit = VersionConstraint::Commit("abc123def".to_string());

// Access the string value
assert_eq!(version.as_str(), "1.0.0");
assert_eq!(branch.as_str(), "main");
assert_eq!(commit.as_str(), "abc123def");

Variants

Tag(String)

A semantic version tag (e.g., “v1.2.0”, “1.0.0”)

Branch(String)

A git branch reference (e.g., “main”, “develop”, “feature/new”)

Commit(String)

A specific git commit hash (full or abbreviated)

Implementations

impl VersionConstraint

pub fn as_str(&self) -> &str

Get the string representation of this constraint.

This method extracts the underlying string value from any constraint variant, providing a uniform way to access the constraint specification regardless of its type classification.

Returns

Returns &str containing the original constraint string.

Examples

use agpm_cli::version::VersionConstraint;

let tag = VersionConstraint::Tag("^1.0.0".to_string());
assert_eq!(tag.as_str(), "^1.0.0");

let branch = VersionConstraint::Branch("feature/auth".to_string());
assert_eq!(branch.as_str(), "feature/auth");

let commit = VersionConstraint::Commit("abc123def456".to_string());
assert_eq!(commit.as_str(), "abc123def456");

Use Cases

This method is useful for:

• Displaying constraints in user interfaces
• Logging and debugging version resolution
• Passing constraint strings to external tools
• Serializing constraints to text formats

Trait Implementations

impl Clone for VersionConstraint

fn clone(&self) -> VersionConstraint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionConstraint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VersionConstraint

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for VersionConstraint

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for VersionConstraint

impl StructuralPartialEq for VersionConstraint