#cargo-manifest #package #manifest #cargo #fields

build package_info

Crate for exposing Cargo Package Information to Rust code

1 unstable release

0.1.0 Sep 11, 2021

#412 in Build Utils

Download history 85/week @ 2024-07-26 140/week @ 2024-08-02 53/week @ 2024-08-09 48/week @ 2024-08-16 152/week @ 2024-08-23 165/week @ 2024-08-30 186/week @ 2024-09-06 179/week @ 2024-09-13 150/week @ 2024-09-20 40/week @ 2024-09-27 327/week @ 2024-10-04 470/week @ 2024-10-11 262/week @ 2024-10-18 367/week @ 2024-10-25 325/week @ 2024-11-01 181/week @ 2024-11-08

1,172 downloads per month
Used in 2 crates

MIT license

6KB

Package Info

Package Info offers access to Cargo manifest information from within your Rust code. Actually, Cargo offers that by exposing it via environment variables. However, if you are running your application from binary (as opposed to via cargo run), those environment variables are no longer present.

Package Info works around this issue by capturing the environment variable values during compile and embedding them in your code via the derived trait PackageInfo. You must add both package_info and package_info_derive as dependencies to your project.

Usage

use package_info::PackageInfo;        // the trait
use package_info_derive::PackageInfo; // the derive macro

#[derive(PackageInfo)]
struct CargoPackageInfo {}

fn main() {
    println!("{}", CargoPackageInfo::name().unwrap());
}

The PackageInfo trait provides the following functions, all of which return a Option<String>:

/// Accessor functions to common Cargo package information as specified in Cargo.toml
pub trait PackageInfo {
    /// Colon separated list of authors from the manifest of the package
    fn authors() -> Option<String>;
    /// The description from the manifest of the package
    fn description() -> Option<String>;
    /// The home page from the manifest of the package
    fn homepage() -> Option<String>;
    /// The license from the manifest of the package
    fn license() -> Option<String>;
    /// The license file from the manifest of the package
    fn license_file() -> Option<String>;
    /// The name of the package
    fn name() -> Option<String>;
    /// The repository from the manifest of the package
    fn repository() -> Option<String>;
    /// The full version of the package
    fn version() -> Option<String>;
    /// The major version of the package
    fn version_major() -> Option<String>;
    /// The minor version of the package
    fn version_minor() -> Option<String>;
    /// The patch version of the package
    fn version_patch() -> Option<String>;
    /// The pre-release version of the package
    fn version_pre() -> Option<String>;
}

No runtime deps