zerocopy-derive 0.8.56

# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "proc-macro2"
version = "1.0.107"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
dependencies = [
 "unicode-ident",
]

[[package]]
name = "quote"
version = "1.0.47"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
dependencies = [
 "proc-macro2",
]

[[package]]
name = "sample-zerocopy-derive"
version = "1.0.0"
dependencies = [
 "zerocopy",
 "zerocopy-derive",
]

[[package]]
name = "syn"
version = "2.0.119"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
dependencies = [
 "proc-macro2",
 "quote",
 "unicode-ident",
]

[[package]]
name = "unicode-ident"
version = "1.0.26"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"

[[package]]
name = "zerocopy"
version = "0.8.56"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "556764e583adb45a9f8d413c2a147fa7e8d821e48e12b14fd560b607998b75eb"
dependencies = [
 "zerocopy-derive",
]

[[package]]
name = "zerocopy-derive"
version = "0.8.56"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f2ab42fc20575779bd240faa45f94a74256f755c0fa9e89f0ede20d91d0cdfc1"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[package]
name = "sample-zerocopy-derive"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
zerocopy-derive = "=0.8.56"
zerocopy = "=0.8.56"

[[bin]]
name = "contract"
path = "test/contract.rs"

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:cargo/zerocopy-derive@0.8.56
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/zerocopy-derive@0.8.56

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:1e2eb838cda4251a465fa462c399c8014a167688a6f94793d4a37c656095f36b","contract":["#[derive(FromBytes, IntoBytes, KnownLayout)] serializes and deserializes C-repr structs safely","#[derive(FromZeros)] allows zero-initialization of structs","#[derive(TryFromBytes, KnownLayout, Immutable, IntoBytes)] validates enum discriminants at runtime","#[derive(ByteEq)] provides PartialEq and Eq based on raw byte equality","#[derive(ByteHash)] provides Hash implementation based on raw byte hashing","#[derive(Unaligned, FromBytes, IntoBytes)] allows unaligned byte casting without alignment requirements","#[zerocopy(crate = \"...\")] custom crate path attribute resolves correctly"],"goal":"verify pkg:cargo/zerocopy-derive@0.8.56","kind":"HOW","packages":["pkg:cargo/zerocopy-derive@0.8.56"],"schemaVersion":1},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","distro":"alpine","ecosystem":"cargo","libc":"musl","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/zerocopy-derive@0.8.56"],"schemaVersion":1,"subject":"pkg:cargo/zerocopy-derive@0.8.56","verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify pkg:cargo/zerocopy-derive@0.8.56",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/zerocopy-derive@0.8.56"
  ]
}

//! Clean-room verification sample for zerocopy-derive.

pub use zerocopy_derive::*;

use std::collections::hash_map::DefaultHasher;
use std::hash::{Hash, Hasher};
use zerocopy::{FromBytes, FromZeros, IntoBytes, TryFromBytes};
use zerocopy_derive::{
    ByteEq, ByteHash, FromBytes, FromZeros, Immutable, IntoBytes, KnownLayout, TryFromBytes,
    Unaligned,
};

// 1. Struct deriving FromBytes, IntoBytes, and marker traits with multi-byte fields
#[derive(FromBytes, Immutable, IntoBytes, KnownLayout, Debug, PartialEq, Eq)]
#[repr(C)]
struct AlignedHeader {
    magic: u32,
    version: u16,
    flags: u16,
}

// 2. Struct deriving FromZeros independently for zero-initialization
#[derive(FromZeros, Immutable, IntoBytes, KnownLayout, Debug, PartialEq, Eq)]
#[repr(C)]
struct ZeroableConfig {
    timeout_ms: u32,
    retries: u32,
}

// 3. Enum deriving TryFromBytes for fallible discriminant parsing
#[derive(
    TryFromBytes, KnownLayout, Immutable, IntoBytes, Debug, PartialEq, Eq, Clone, Copy,
)]
#[repr(u8)]
#[allow(dead_code)]
enum StatusCode {
    Success = 0,
    NotFound = 1,
    ServerError = 2,
}

// 4. Struct deriving ByteEq for byte-level equality comparison
#[derive(Immutable, IntoBytes, ByteEq, Debug)]
#[repr(C)]
struct DeviceId {
    vendor: u16,
    product: u16,
}

// 5. Struct deriving ByteHash for byte-level hashing
#[derive(Immutable, IntoBytes, ByteHash, Debug)]
#[repr(C)]
struct Point {
    x: i32,
    y: i32,
}

// 6. Struct deriving Unaligned along with FromBytes and IntoBytes
#[derive(FromBytes, Immutable, IntoBytes, KnownLayout, Unaligned, Debug, PartialEq, Eq)]
#[repr(C)]
struct UnalignedPayload {
    tag: u8,
    data: [u8; 4],
    crc: u8,
}

// 7. Struct testing custom crate path attribute
#[derive(FromBytes, Immutable, IntoBytes, KnownLayout, Debug, PartialEq, Eq)]
#[zerocopy(crate = "zerocopy")]
#[repr(C)]
struct CustomPathStruct {
    value: u64,
}

fn compute_hash(val: impl Hash) -> u64 {
    let mut hasher = DefaultHasher::new();
    val.hash(&mut hasher);
    hasher.finish()
}

fn main() {
    // 1. #[derive(FromBytes, IntoBytes, KnownLayout)] serializes and deserializes C-repr structs safely
    let header = AlignedHeader {
        magic: 0x12345678,
        version: 1,
        flags: 0x8000,
    };
    let bytes = header.as_bytes();
    assert_eq!(bytes.len(), 8);
    let parsed = AlignedHeader::read_from_bytes(bytes).expect("read AlignedHeader from bytes");
    assert_eq!(parsed, header);

    // 2. #[derive(FromZeros)] allows zero-initialization of structs
    let zeroed = ZeroableConfig::new_zeroed();
    assert_eq!(
        zeroed,
        ZeroableConfig {
            timeout_ms: 0,
            retries: 0
        }
    );

    // 3. #[derive(TryFromBytes, KnownLayout, Immutable, IntoBytes)] validates enum discriminants at runtime
    let valid_de = StatusCode::try_read_from_bytes(&[1u8]).expect("parse valid StatusCode");
    assert_eq!(valid_de, StatusCode::NotFound);
    let invalid_de = StatusCode::try_read_from_bytes(&[99u8]);
    assert!(invalid_de.is_err(), "invalid discriminant must fail validation");

    // 4. #[derive(ByteEq)] provides PartialEq and Eq based on raw byte equality
    let dev1 = DeviceId {
        vendor: 0x8086,
        product: 0x1234,
    };
    let dev2 = DeviceId {
        vendor: 0x8086,
        product: 0x1234,
    };
    let dev3 = DeviceId {
        vendor: 0x8086,
        product: 0x5678,
    };
    assert_eq!(dev1, dev2);
    assert_ne!(dev1, dev3);

    // 5. #[derive(ByteHash)] provides Hash implementation based on raw byte hashing
    let p1 = Point { x: 10, y: 20 };
    let p2 = Point { x: 10, y: 20 };
    let p3 = Point { x: 20, y: 10 };
    assert_eq!(compute_hash(&p1), compute_hash(&p2));
    assert_ne!(compute_hash(&p1), compute_hash(&p3));

    // 6. #[derive(Unaligned, FromBytes, IntoBytes)] allows unaligned byte casting without alignment requirements
    let raw_unaligned = [0xFE, 0x01, 0x02, 0x03, 0x04, 0xFF];
    let payload =
        UnalignedPayload::read_from_bytes(&raw_unaligned).expect("read UnalignedPayload");
    assert_eq!(payload.tag, 0xFE);
    assert_eq!(payload.data, [0x01, 0x02, 0x03, 0x04]);
    assert_eq!(payload.crc, 0xFF);
    assert_eq!(payload.as_bytes(), &raw_unaligned);

    // 7. #[zerocopy(crate = "...")] custom crate path attribute resolves correctly
    let custom = CustomPathStruct {
        value: 0x1122334455667788,
    };
    let custom_bytes = custom.as_bytes();
    let custom_parsed =
        CustomPathStruct::read_from_bytes(custom_bytes).expect("read CustomPathStruct");
    assert_eq!(custom_parsed, custom);

    println!("All zerocopy-derive contract assertions passed successfully.");
}