Enum VersionCompatibility 

pub enum VersionCompatibility {
    Full,
    Degraded,
    Incompatible,
}

Result of snapshot version compatibility analysis.

Returned by check_version to indicate whether a snapshot with a given format version can be read by this build of Hexz. This enum enables graceful handling of version mismatches with appropriate error messages.

Variants

• Full: Version is within MIN_SUPPORTED_VERSION..=MAX_SUPPORTED_VERSION and all features are supported. Proceed with normal operations.

• Degraded: Version is newer than MAX_SUPPORTED_VERSION but forward compatibility rules allow partial reads with warnings. Unsupported features are ignored or substituted with defaults. (Not yet implemented; currently treated as Incompatible.)

• Incompatible: Version is outside the supported range and cannot be read. The user must upgrade Hexz (for newer snapshots) or migrate the snapshot (for older snapshots).

Examples

use hexz_core::format::version::{check_version, VersionCompatibility};

let result = check_version(1);
assert_eq!(result, VersionCompatibility::Full);

let result = check_version(999);
assert_eq!(result, VersionCompatibility::Incompatible);
assert!(!result.is_compatible());

Variants

Full

Fully supported version with all features available.

Degraded

Newer version with partial support (warnings emitted, some features unavailable).

This variant is reserved for future forward compatibility modes. Currently, all versions outside the supported range are marked as Incompatible.

Incompatible

Incompatible version that cannot be read (too old or too new).

Implementations

impl VersionCompatibility

pub fn is_compatible(&self) -> bool

Tests whether the snapshot can be read with this compatibility status.

Returns true for Full and Degraded compatibility, indicating that read operations can proceed (possibly with warnings). Returns false for Incompatible, indicating that the snapshot must be rejected.

Returns

• true: Snapshot can be opened (possibly with limited functionality)
• false: Snapshot cannot be opened (hard error)

Examples

use hexz_core::format::version::{check_version, VersionCompatibility};

let compat = check_version(1);
if compat.is_compatible() {
    println!("Snapshot can be read");
} else {
    eprintln!("Snapshot is incompatible");
}

Trait Implementations

impl Clone for VersionCompatibility

fn clone(&self) -> VersionCompatibility

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionCompatibility

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

Formats the value using the given formatter.

impl Display for VersionCompatibility

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

Formats the value using the given formatter.

impl PartialEq for VersionCompatibility

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

impl Eq for VersionCompatibility

impl StructuralPartialEq for VersionCompatibility