Struct CargoProject 

pub struct CargoProject {
    pub name: String,
    pub version: String,
    pub manifest_path: PathBuf,
    pub package_dir: PathBuf,
    pub workspace_root: PathBuf,
    pub binaries: Vec<CargoBinary>,
    pub default_binary: String,
}

Cargo project metadata, discovered via cargo metadata --no-deps.

This is the primary domain entity for Rust project management. All fields are resolved by Cargo itself, ensuring accuracy even for workspace members with inherited fields.

Construction

Use CargoProject::discover() to create instances from real Cargo projects. Direct struct construction is available for testing but callers must ensure default_binary exists in binaries.

Examples

use propel_core::CargoProject;
use std::path::Path;

let project = CargoProject::discover(Path::new(".")).unwrap();
println!("Deploying {} v{}", project.name, project.version);
println!("Binary: {}", project.default_binary);

Fields

name: String

Package name from [package].name

version: String

Resolved version (handles version.workspace = true)

manifest_path: PathBuf

Absolute path to the package’s Cargo.toml

package_dir: PathBuf

Absolute path to the package directory (parent of manifest_path)

workspace_root: PathBuf

Absolute path to the workspace root directory

binaries: Vec<CargoBinary>

All binary targets in this package

default_binary: String

The binary selected for deployment.

Invariant: must match a name in binaries.

Implementations

impl CargoProject

pub fn discover(project_dir: &Path) -> Result<Self>

Discover the Cargo project at the given directory.

Runs cargo metadata --no-deps and locates the package whose manifest lives in project_dir. For single-package projects this is the only package; for workspaces the matching member is selected.

Errors

• crate::Error::CargoMetadata if cargo metadata fails (e.g. cargo not installed)
• crate::Error::NoPackageInDir if project_dir is a workspace root without [package]
• crate::Error::NoBinaryTarget if the package has no binary targets
• crate::Error::MultipleBinaries if multiple binaries exist and none is selected

Trait Implementations

impl Clone for CargoProject

fn clone(&self) -> CargoProject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CargoProject

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

Formats the value using the given formatter.