Struct Target 

pub struct Target { /* private fields */ }

A resolved metadata target consisting of a type and an optional value.

Implementations

impl Target

pub fn from_parts(target_type: TargetType, value: Option<String>) -> Self

Create a target from raw parts.

This is a low-level constructor used when the target type and value are already known (e.g., when reconstructing targets from database rows or parsed tree entries). For user-facing construction, prefer the named constructors (commit(), project(), etc.) or parse().

Parameters

• target_type: the kind of target
• value: the target value, or None for project targets

pub fn commit(sha: &str) -> Result<Self>

Create a commit target from a SHA (full or partial).

Parameters

• sha: a commit SHA string, must be at least 3 characters.

Errors

Returns an error if the SHA is shorter than 3 characters.

pub fn project() -> Self

Create a project-scoped target (no value needed).

pub fn path(path: &str) -> Self

Create a path target.

Parameters

• path: the file or directory path this metadata attaches to.

pub fn branch(name: &str) -> Self

Create a branch target.

Parameters

• name: the branch name this metadata attaches to.

pub fn change_id(id: &str) -> Self

Create a change-id target.

Parameters

• id: the change identifier this metadata attaches to.

pub fn parse(s: &str) -> Result<Self>

Parse a target from a string in type:value format (e.g. "commit:abc123").

This is the CLI-oriented constructor. For programmatic use, prefer the named constructors: commit(), project(), path(), branch(), change_id().

Parameters

• s: the target string in type:value format, or "project" for project targets.

Errors

Returns an error if the format is invalid, the target type is unknown, or the value is shorter than 3 characters.

pub fn target_type(&self) -> &TargetType

The type of this target (commit, branch, path, etc.).

pub fn value(&self) -> Option<&str>

The target’s value, if any.

Returns None for project targets, Some(sha) for commit targets, etc.

pub fn resolve(&self, repo: &Repository) -> Result<Target>

If this is a commit target with a partial SHA, expand it to 40 chars using the given Git repository. Returns a new target with the expanded SHA, or a clone of this target if no resolution is needed.

Trait Implementations

impl Clone for Target

fn clone(&self) -> Target

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Display for Target

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

Formats the value using the given formatter.

impl Hash for Target

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Target

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

impl StructuralPartialEq for Target