cargo-pkg-info-struct-builder 0.1.0-alpha6

//------------------------------------------------------------------------------
// This file is automatically generated by `cargo-pkg-info-struct-builder`.
//
// DO NOT EDIT THIS FILE MANUALLY. ANY CHANGES WILL BE OVERWRITTEN.
//
// It contains a struct `CargoPkgInfo` that provides access to package metadata
// set by Cargo at compile time, including versioning, authors, license
// information, and build details. The values are obtained from environment
// variables defined in the Cargo.toml file and passed during the build process.
//
// For more information, see: <https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-crates>
//------------------------------------------------------------------------------

const NO_ENV_FALLBACK: &str = "N/A";

pub struct CargoPkgInfo {}

/// Unescapes all `\\n` sequences back to `\n`.
macro_rules! unescape_newlines {
    ($s:expr) => {
        Box::leak($s.replace("\\n", "\n").into_boxed_str())
    };
}

impl CargoPkgInfo {
    /// Returns the package name.
    #[allow(dead_code)]
    pub fn pkg_name() -> &'static str {
        option_env!("CARGO_PKG_NAME")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the crate name.
    #[allow(dead_code)]
    pub fn crate_name() -> &'static str {
        option_env!("CARGO_CRATE_NAME")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the package version.
    #[allow(dead_code)]
    pub fn pkg_version() -> &'static str {
        option_env!("CARGO_PKG_VERSION")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the major version of the package.
    #[allow(dead_code)]
    pub fn version_major() -> &'static str {
        option_env!("CARGO_PKG_VERSION_MAJOR")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the minor version of the package.
    #[allow(dead_code)]
    pub fn version_minor() -> &'static str {
        option_env!("CARGO_PKG_VERSION_MINOR")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the patch version of the pacakge.
    #[allow(dead_code)]
    pub fn version_patch() -> &'static str {
        option_env!("CARGO_PKG_VERSION_PATCH")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the pre-release version of the package.
    #[allow(dead_code)]
    pub fn version_pre() -> &'static str {
        option_env!("CARGO_PKG_VERSION_PRE")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the authors of the package.
    #[allow(dead_code)]
    pub fn authors() -> &'static str {
        option_env!("CARGO_PKG_AUTHORS")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the description of the package.
    #[allow(dead_code)]
    pub fn description() -> &'static str {
        option_env!("CARGO_PKG_DESCRIPTION")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the homepage URL of the package.
    #[allow(dead_code)]
    pub fn homepage() -> &'static str {
        option_env!("CARGO_PKG_HOMEPAGE")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the repository URL of the package.
    #[allow(dead_code)]
    pub fn repository() -> &'static str {
        option_env!("CARGO_PKG_REPOSITORY")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the license type of the package.
    #[allow(dead_code)]
    pub fn license() -> &'static str {
        option_env!("CARGO_PKG_LICENSE")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the contents of the license file (embedded at build time).
    #[allow(dead_code)]
    pub fn license_content() -> &'static str {
        let license = option_env!("LICENSE_CONTENT").unwrap_or(NO_ENV_FALLBACK);
        unescape_newlines!(license)
    }

    /// Returns the Rust version required by the package.
    #[allow(dead_code)]
    pub fn rust_version() -> &'static str {
        option_env!("CARGO_PKG_RUST_VERSION")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the path to the README file.
    #[allow(dead_code)]
    pub fn readme_path() -> &'static str {
        option_env!("CARGO_PKG_README")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the build target (architecture/platform).
    #[allow(dead_code)]
    pub fn build_target() -> &'static str {
        option_env!("BUILD_TARGET")
            .unwrap_or(NO_ENV_FALLBACK)
            .into()
    }

    /// Returns the UTC build time as an `Option<u64>`.
    #[allow(dead_code)]
    pub fn build_time_utc() -> Option<u64> {
        option_env!("BUILD_TIME_UTC").and_then(|s| s.parse::<u64>().ok())
    }
}