zerocopy 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"
version = "1.0.0"
dependencies = [
 "zerocopy",
]

[[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"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
zerocopy = { version = "=0.8.56", features = ["derive"] }

[[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@0.8.56
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/zerocopy@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:44bc05a92ffb9024ee268d677e2c69364a970dc30e770cc94d1ddc9d165545b1","contract":["FromBytes and IntoBytes convert plain-old-data structs to and from byte slices","transmute unconditionally converts between types of the same size with zero cost","try_transmute conditionally converts between types validating bit validity","Ref safely wraps a typed reference over a backing byte slice","byteorder types read and write multi-byte integers with explicit endianness"],"goal":"verify pkg:cargo/zerocopy@0.8.56","kind":"HOW","packages":["pkg:cargo/zerocopy@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@0.8.56"],"schemaVersion":1,"subject":"pkg:cargo/zerocopy@0.8.56","verifierAdapter":"cargo@1"}

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

//! Clean-room verification sample for zerocopy.

pub use zerocopy::*;

use zerocopy::{
    byteorder::little_endian::U16 as LeU16,
    byteorder::little_endian::U32 as LeU32,
    byteorder::big_endian::U32 as BeU32,
    transmute, try_transmute, FromBytes, Immutable, IntoBytes, KnownLayout, Ref, Unaligned,
};

#[derive(FromBytes, IntoBytes, KnownLayout, Immutable, Unaligned, Debug, PartialEq, Eq, Clone, Copy)]
#[repr(C)]
struct PacketHeader {
    magic: [u8; 4],
    version: LeU16,
    flags: LeU16,
}

fn main() {
    // 1. FromBytes and IntoBytes convert plain-old-data structs to and from byte slices
    let header = PacketHeader {
        magic: *b"CSX1",
        version: LeU16::new(1),
        flags: LeU16::new(0x0042),
    };
    let bytes = header.as_bytes();
    assert_eq!(bytes.len(), 8);
    let parsed = PacketHeader::read_from_bytes(bytes).expect("deserialization should succeed");
    assert_eq!(parsed, header);

    // 2. transmute unconditionally converts between types of the same size with zero cost
    let raw_bytes: [u8; 4] = [0x01, 0x02, 0x03, 0x04];
    let arr2x2: [[u8; 2]; 2] = transmute!(raw_bytes);
    assert_eq!(arr2x2, [[0x01, 0x02], [0x03, 0x04]]);

    // 3. try_transmute conditionally converts between types validating bit validity
    let valid_bool: Result<bool, _> = try_transmute!(1u8);
    assert_eq!(valid_bool, Ok(true));
    let invalid_bool: Result<bool, _> = try_transmute!(2u8);
    assert!(invalid_bool.is_err());

    // 4. Ref safely wraps a typed reference over a backing byte slice
    let packet_bytes = [b'C', b'S', b'X', b'1', 1, 0, 0x42, 0, 0xFF];
    let (ref_header, remainder) =
        Ref::<&[u8], PacketHeader>::from_prefix(&packet_bytes[..]).expect("prefix parse should succeed");
    assert_eq!(ref_header.version.get(), 1);
    assert_eq!(ref_header.flags.get(), 0x0042);
    assert_eq!(remainder, &[0xFF]);

    // 5. byteorder types read and write multi-byte integers with explicit endianness
    let le_val = LeU32::new(0x12345678);
    let be_val = BeU32::new(0x12345678);
    assert_eq!(le_val.as_bytes(), &[0x78, 0x56, 0x34, 0x12]);
    assert_eq!(be_val.as_bytes(), &[0x12, 0x34, 0x56, 0x78]);
    assert_eq!(le_val.get(), 0x12345678);
    assert_eq!(be_val.get(), 0x12345678);

    println!("All zerocopy contract checks passed.");
}