rust-ethernet-ip 1.2.0

/// Library version information
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
pub const NAME: &str = env!("CARGO_PKG_NAME");
pub const DESCRIPTION: &str = env!("CARGO_PKG_DESCRIPTION");

/// C FFI ABI version expected by downstream wrappers.
pub const ABI_VERSION: u32 = 2;

/// FFI supports ordered route-hop construction.
pub const CAP_ROUTE_PATH_ORDERED_HOPS: u64 = 0x0000_0000_0000_0001;

/// FFI supports the v1 native batch execution endpoint.
pub const CAP_BATCH_EXECUTE_V1: u64 = 0x0000_0000_0000_0002;

/// FFI supports diagnostics snapshot export as JSON.
pub const CAP_DIAGNOSTICS_JSON: u64 = 0x0000_0000_0000_0004;

/// FFI supports tag-group subscription endpoints.
pub const CAP_TAG_GROUP_SUBSCRIPTIONS: u64 = 0x0000_0000_0000_0008;

/// FFI exposes per-client last-error message retrieval (`eip_get_last_error`).
pub const CAP_LAST_ERROR: u64 = 0x0000_0000_0000_0010;

/// Capability bitmap for ABI v2.
pub const CAPABILITIES: u64 = CAP_ROUTE_PATH_ORDERED_HOPS
    | CAP_BATCH_EXECUTE_V1
    | CAP_DIAGNOSTICS_JSON
    | CAP_TAG_GROUP_SUBSCRIPTIONS
    | CAP_LAST_ERROR;

/// Major version number
pub const MAJOR_VERSION: u32 = 1;

/// Minor version number
pub const MINOR_VERSION: u32 = 2;

/// Patch version number
pub const PATCH_VERSION: u32 = 0;

/// Version string in format "v0.1.0"
pub const VERSION_STRING: &str = concat!("v", env!("CARGO_PKG_VERSION"));

// The VERGEN_* vars come from `build.rs`. They are absent when building without
// a git checkout (e.g. a crates.io tarball), so use `option_env!` with a literal
// fallback rather than `env!`, which would fail to compile when a var is unset.

/// Build date and time
pub const BUILD_DATE: &str = match option_env!("VERGEN_BUILD_TIMESTAMP") {
    Some(v) => v,
    None => "unknown",
};

/// Git commit hash
pub const GIT_HASH: &str = match option_env!("VERGEN_GIT_SHA") {
    Some(v) => v,
    None => "unknown",
};

/// Git commit date
pub const GIT_COMMIT_DATE: &str = match option_env!("VERGEN_GIT_COMMIT_TIMESTAMP") {
    Some(v) => v,
    None => "unknown",
};

/// Git branch
pub const GIT_BRANCH: &str = match option_env!("VERGEN_GIT_BRANCH") {
    Some(v) => v,
    None => "unknown",
};

/// Get the library version as a string
#[must_use]
pub fn get_version() -> &'static str {
    VERSION
}

/// Get the library name
#[must_use]
pub fn get_name() -> &'static str {
    NAME
}

/// Get the library description
#[must_use]
pub fn get_description() -> &'static str {
    DESCRIPTION
}