zerovec-derive 0.11.6: zerovec_derive::ULE

# 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-zerovec-derive-ule"
version = "1.0.0"
dependencies = [
 "zerovec",
 "zerovec-derive",
]

[[package]]
name = "serde"
version = "1.0.229"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
dependencies = [
 "serde_core",
 "serde_derive",
]

[[package]]
name = "serde_core"
version = "1.0.229"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
dependencies = [
 "serde_derive",
]

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

[[package]]
name = "syn"
version = "3.0.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8593e8e72159ed2257d083c7a454a85cbf854f37a0966d8d483aff8c8a3ebcee"
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 = "zerofrom"
version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"

[[package]]
name = "zerovec"
version = "0.11.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "90f911cbc359ab6af17377d242225f4d75119aec87ea711a880987b18cd7b239"
dependencies = [
 "serde",
 "zerofrom",
 "zerovec-derive",
]

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

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

[dependencies]
zerovec-derive = "=0.11.6"
zerovec = { version = "=0.11.6", features = ["alloc", "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 zerovec_derive::ULE in pkg:cargo/zerovec-derive@0.11.6
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/zerovec-derive@0.11.6
Demonstrate these symbols/APIs:
  - zerovec_derive::ULE

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:aa9c62ba67d65adef139ca226c6483a3318d8318bca26d9085d9f761745edb1b","contract":["derive(ULE) implements ULE for repr(C, packed) structs with ULE fields","derive(ULE) implements ULE for repr(transparent) single-field structs","derive(ULE) implements ULE for repr(C, packed) tuple structs","ULE::validate_bytes validates slice length alignment and field byte validity","ZeroVec parses and accesses slices of derived ULE structs"],"goal":"verify zerovec_derive::ULE in pkg:cargo/zerovec-derive@0.11.6","kind":"HOW","packages":["pkg:cargo/zerovec-derive@0.11.6"],"schemaVersion":1,"symbols":["zerovec_derive::ULE"]},"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/zerovec-derive@0.11.6"],"schemaVersion":1,"subject":"pkg:cargo/zerovec-derive@0.11.6","symbols":["zerovec_derive::ULE"],"verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify zerovec_derive::ULE in pkg:cargo/zerovec-derive@0.11.6",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/zerovec-derive@0.11.6"
  ],
  "symbols": [
    "zerovec_derive::ULE"
  ]
}

//! Clean-room verification sample for zerovec-derive::ULE.

pub use zerovec_derive::*;

use zerovec::ule::AsULE;
use zerovec::ZeroVec;
use zerovec_derive::ULE;

// 1. derive(ULE) implements ULE for repr(C, packed) structs with ULE fields
#[repr(C, packed)]
#[derive(Copy, Clone, Debug, PartialEq, Eq, ULE)]
struct PointULE {
    x: <u32 as AsULE>::ULE,
    y: <u32 as AsULE>::ULE,
}

impl AsULE for PointULE {
    type ULE = Self;
    #[inline]
    fn to_unaligned(self) -> Self {
        self
    }
    #[inline]
    fn from_unaligned(unaligned: Self) -> Self {
        unaligned
    }
}

// 2. derive(ULE) implements ULE for repr(transparent) single-field structs
#[repr(transparent)]
#[derive(Copy, Clone, Debug, PartialEq, Eq, ULE)]
struct WrappedULE {
    inner: <u32 as AsULE>::ULE,
}

// 3. derive(ULE) implements ULE for repr(C, packed) tuple structs
#[repr(C, packed)]
#[derive(Copy, Clone, Debug, PartialEq, Eq, ULE)]
struct PairULE(u8, <u16 as AsULE>::ULE);

fn main() {
    // 1. repr(C, packed) struct validation and slice parsing
    let pt1 = PointULE {
        x: <u32 as AsULE>::to_unaligned(10),
        y: <u32 as AsULE>::to_unaligned(20),
    };
    let pt2 = PointULE {
        x: <u32 as AsULE>::to_unaligned(30),
        y: <u32 as AsULE>::to_unaligned(40),
    };
    assert_eq!(core::mem::size_of::<PointULE>(), 8);
    assert_eq!(core::mem::align_of::<PointULE>(), 1);

    let mut bytes = Vec::new();
    bytes.extend_from_slice(zerovec::ule::ULE::slice_as_bytes(core::slice::from_ref(&pt1)));
    bytes.extend_from_slice(zerovec::ule::ULE::slice_as_bytes(core::slice::from_ref(&pt2)));
    assert_eq!(bytes.len(), 16);

    // validate_bytes succeeds on valid byte stream
    assert!(<PointULE as zerovec::ule::ULE>::validate_bytes(&bytes).is_ok());

    // validate_bytes fails on invalid length (not a multiple of size_of::<PointULE>())
    assert!(<PointULE as zerovec::ule::ULE>::validate_bytes(&bytes[..15]).is_err());
    assert!(<PointULE as zerovec::ule::ULE>::validate_bytes(&bytes[..7]).is_err());

    // parse_bytes_to_slice returns slice of ULE structs
    let slice = <PointULE as zerovec::ule::ULE>::parse_bytes_to_slice(&bytes).expect("valid PointULE slice");
    assert_eq!(slice.len(), 2);
    assert_eq!(<u32 as AsULE>::from_unaligned(slice[0].x), 10);
    assert_eq!(<u32 as AsULE>::from_unaligned(slice[0].y), 20);
    assert_eq!(<u32 as AsULE>::from_unaligned(slice[1].x), 30);
    assert_eq!(<u32 as AsULE>::from_unaligned(slice[1].y), 40);

    // 2. repr(transparent) struct validation
    let wrapped = WrappedULE {
        inner: <u32 as AsULE>::to_unaligned(999),
    };
    assert_eq!(core::mem::size_of::<WrappedULE>(), 4);
    assert_eq!(core::mem::align_of::<WrappedULE>(), 1);
    let wrapped_bytes = zerovec::ule::ULE::slice_as_bytes(core::slice::from_ref(&wrapped));
    assert!(<WrappedULE as zerovec::ule::ULE>::validate_bytes(wrapped_bytes).is_ok());
    assert!(<WrappedULE as zerovec::ule::ULE>::validate_bytes(&wrapped_bytes[..3]).is_err());
    let parsed_wrapped = <WrappedULE as zerovec::ule::ULE>::parse_bytes_to_slice(wrapped_bytes).expect("valid WrappedULE slice");
    assert_eq!(<u32 as AsULE>::from_unaligned(parsed_wrapped[0].inner), 999);

    // 3. repr(C, packed) tuple struct validation
    let pair = PairULE(42, <u16 as AsULE>::to_unaligned(1000));
    assert_eq!(core::mem::size_of::<PairULE>(), 3);
    assert_eq!(core::mem::align_of::<PairULE>(), 1);
    let pair_bytes = zerovec::ule::ULE::slice_as_bytes(core::slice::from_ref(&pair));
    assert!(<PairULE as zerovec::ule::ULE>::validate_bytes(pair_bytes).is_ok());
    assert!(<PairULE as zerovec::ule::ULE>::validate_bytes(&pair_bytes[..2]).is_err());
    let parsed_pair = <PairULE as zerovec::ule::ULE>::parse_bytes_to_slice(pair_bytes).expect("valid PairULE slice");
    assert_eq!(parsed_pair[0].0, 42);
    assert_eq!(<u16 as AsULE>::from_unaligned(parsed_pair[0].1), 1000);

    // 4. ZeroVec with derived ULE type
    let zv: ZeroVec<PointULE> = ZeroVec::parse_bytes(&bytes).expect("parse PointULE ZeroVec");
    assert_eq!(zv.len(), 2);
    assert_eq!(<u32 as AsULE>::from_unaligned(zv.get(0).unwrap().x), 10);
    assert_eq!(<u32 as AsULE>::from_unaligned(zv.get(1).unwrap().y), 40);

    println!("All zerovec_derive::ULE contract assertions passed successfully.");
}