CodeSampleX

Beispiel

block-buffer 0.12.1: block_buffer::ReadBuffer

Verifiziertes Beispiel für cargo block-buffer 0.12.1: block_buffer::ReadBuffer. Der Vertrag lief auf rust 1 · linux alpine/x64 · docker und bestand.

sha256:49e3f9b6fa62334cbf2dda2c4bec4d7e03b9c04dc3c13baa42769c738631456d

Dieses Netzwerk bietet eine Sache: ein Sample, das baut. Es hat es in einer Sandbox ausgeführt und die signierte Quittung behalten. Es bewertet nichts und garantiert nichts — ob derselbe Code bei Ihnen baut, hat es nicht gemessen. Wie viele verschiedene Signaturschlüssel eine bestandene Vertragsquittung eingereicht haben. Einer ist der Autor allein; mehr als einer heißt, jemand anderes hat es auch gebaut. Ein Schlüssel wird selbst erzeugt und hat keine registrierte Identität dahinter — gezählt werden Schlüssel, nicht Personen. MIT-0

Ausführungsbelege

Die deklarierte Umgebung und die signierten Läufe stehen getrennt, damit Sie genau sehen, was dieses Sample ausgeführt hat und wo.

Beleggrundlage
Signierter Vertrag bestanden
Verifizierungsbelege
1
Signaturschlüssel, die es gebaut haben
1
Deklarierte Umgebung linux x64 cargo

Umgebungen der Verifizierungsläufe

Umgebung Contract Stufen Lauf
rust 1 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · cargo@1rust:1-alpine@sha256:a10e64dd139b…
2026-11-08

Fall

HOW
Ziel
verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1
Pakete
Symbole
  • block_buffer::ReadBuffer
Erstellt
2026-11-08T15:53:09Z

Contract

  1. ReadBuffer::<U4>::default initializes with size() == 4, get_pos() == 4, and remaining() == 0
  2. ReadBuffer::<U4>::read generates 4-byte blocks on demand to fill arbitrary output slices and caches unread tail bytes in get_pos()..4
  3. ReadBuffer::<U4>::read_cached consumes n bytes directly from the cached tail and advances get_pos() by n without invoking block generation
  4. ReadBuffer::<U4>::serialize writes get_pos() at byte 0, zeroizes consumed prefix indices 1..get_pos(), and preserves unread cached bytes at get_pos()..4; deserialize restores that state and rejects non-zero consumed prefix bytes or out-of-range pos with Error
  5. ReadBuffer::<U4>::reset discards cached bytes and restores get_pos() == 4 and remaining() == 0

Dateien

  • Cargo.lock
  • Cargo.toml
  • PROMPT.md
  • csx.json
  • spec.json
  • src/main.rs
  • tests/contract.rs

Quellartefakt herunterladen (tar.gz)

Quelltext

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

[[package]]
name = "block-buffer"
version = "0.12.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d2f6c7dbe95a6ed67ad9f18e57daf93a2f034c524b99fd2b76d18fdfeb6660aa"
dependencies = [
 "hybrid-array",
]

[[package]]
name = "hybrid-array"
version = "0.4.15"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "27f864f10dfb56725ce5ce5472bc52252c8f93a4ab86327122cebf62c5f59a17"
dependencies = [
 "typenum",
]

[[package]]
name = "sample-read-buffer"
version = "0.1.0"
dependencies = [
 "block-buffer",
]

[[package]]
name = "typenum"
version = "1.20.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
Cargo.toml
[package]
name = "sample-read-buffer"
version = "0.1.0"
edition = "2021"

[dependencies]
block-buffer = "=0.12.1"
PROMPT.md
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 block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/block-buffer@0.12.1
Demonstrate these symbols/APIs:
  - block_buffer::ReadBuffer

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.
csx.json
{"case":{"caseId":"case:sha256:efe4ac338e7690a331e206a34bc81d32122819e4bc225c3c6dd28acd79eb7bd7","contract":["ReadBuffer::\u003cU4\u003e::default initializes with size() == 4, get_pos() == 4, and remaining() == 0","ReadBuffer::\u003cU4\u003e::read generates 4-byte blocks on demand to fill arbitrary output slices and caches unread tail bytes in get_pos()..4","ReadBuffer::\u003cU4\u003e::read_cached consumes n bytes directly from the cached tail and advances get_pos() by n without invoking block generation","ReadBuffer::\u003cU4\u003e::serialize writes get_pos() at byte 0, zeroizes consumed prefix indices 1..get_pos(), and preserves unread cached bytes at get_pos()..4; deserialize restores that state and rejects non-zero consumed prefix bytes or out-of-range pos with Error","ReadBuffer::\u003cU4\u003e::reset discards cached bytes and restores get_pos() == 4 and remaining() == 0"],"goal":"verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1","kind":"HOW","packages":["pkg:cargo/block-buffer@0.12.1"],"schemaVersion":1,"symbols":["block_buffer::ReadBuffer"]},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","ecosystem":"cargo","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/block-buffer@0.12.1"],"schemaVersion":1,"subject":"pkg:cargo/block-buffer@0.12.1","symbols":["block_buffer::ReadBuffer"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/block-buffer@0.12.1"
  ],
  "symbols": [
    "block_buffer::ReadBuffer"
  ]
}
src/main.rs
use block_buffer::array::typenum::U4;
use block_buffer::{Error, ReadBuffer};

fn verify_read_buffer() {
    // 1. Default initialization: pos starts at block size (4) with 0 cached bytes remaining
    let mut rb = ReadBuffer::<U4>::default();
    assert_eq!(rb.size(), 4);
    assert_eq!(rb.get_pos(), 4);
    assert_eq!(rb.remaining(), 0);

    // 2. Reading across block boundaries generates blocks on demand and caches unread tail bytes
    let mut seq = 0u8;
    let mut next_block = |block: &mut block_buffer::array::Array<u8, U4>| {
        for byte in block.iter_mut() {
            seq += 1;
            *byte = seq;
        }
    };

    // Read 2 bytes: generates block [1, 2, 3, 4], consumes [1, 2], caches [3, 4]
    let mut first = [0u8; 2];
    rb.read(&mut first, &mut next_block);
    assert_eq!(first, [1, 2]);
    assert_eq!(rb.get_pos(), 2);
    assert_eq!(rb.remaining(), 2);

    // read_cached consumes directly from the cached tail without generating a new block
    let cached_one = rb.read_cached(1);
    assert_eq!(cached_one, &[3]);
    assert_eq!(rb.get_pos(), 3);
    assert_eq!(rb.remaining(), 1);

    // Reading 6 more bytes drains cached [4], generates full block [5, 6, 7, 8],
    // and generates block [9, 10, 11, 12] to supply [9] while caching [10, 11, 12]
    let mut span = [0u8; 6];
    rb.read(&mut span, &mut next_block);
    assert_eq!(span, [4, 5, 6, 7, 8, 9]);
    assert_eq!(rb.get_pos(), 1);
    assert_eq!(rb.remaining(), 3);

    // After reading 1 more cached byte, pos == 2 and unread tail is [11, 12]
    assert_eq!(rb.read_cached(1), &[10]);
    assert_eq!(rb.get_pos(), 2);
    assert_eq!(rb.remaining(), 2);

    // 3. Serialization stores pos at index 0, zeroizes consumed prefix indices 1..pos,
    // and preserves unread cached bytes in pos..block_size
    let serialized = rb.serialize();
    assert_eq!(serialized.as_slice(), &[2, 0, 11, 12]);

    let mut restored = ReadBuffer::<U4>::deserialize(&serialized).expect("valid ReadBuffer state");
    assert_eq!(restored.get_pos(), 2);
    assert_eq!(restored.remaining(), 2);
    assert_eq!(restored.read_cached(2), &[11, 12]);
    assert_eq!(restored.get_pos(), 4);
    assert_eq!(restored.remaining(), 0);

    // Invalid serialized states: non-zero byte in consumed prefix (1..pos) or out-of-range pos
    let mut bad_prefix = serialized;
    bad_prefix[1] = 0xFF;
    assert_eq!(ReadBuffer::<U4>::deserialize(&bad_prefix).unwrap_err(), Error);

    let mut bad_pos = serialized;
    bad_pos[0] = 0; // pos == 0 is invalid for ReadBuffer
    assert_eq!(ReadBuffer::<U4>::deserialize(&bad_pos).unwrap_err(), Error);

    let mut bad_pos_over = serialized;
    bad_pos_over[0] = 5; // pos > 4 is invalid for ReadBuffer::<U4>
    assert_eq!(ReadBuffer::<U4>::deserialize(&bad_pos_over).unwrap_err(), Error);

    // 4. reset discards cached bytes and restores pos to block_size (remaining == 0)
    rb.reset();
    assert_eq!(rb.get_pos(), 4);
    assert_eq!(rb.remaining(), 0);
}

fn main() {
    verify_read_buffer();
}
tests/contract.rs
use block_buffer::array::typenum::U4;
use block_buffer::{Error, ReadBuffer};

#[test]
fn contract_read_buffer() {
    let mut rb = ReadBuffer::<U4>::default();
    assert_eq!(rb.size(), 4);
    assert_eq!(rb.get_pos(), 4);
    assert_eq!(rb.remaining(), 0);

    let mut seq = 0u8;
    let mut gen_block = |block: &mut block_buffer::array::Array<u8, U4>| {
        for b in block.iter_mut() {
            seq += 1;
            *b = seq * 10;
        }
    };

    let mut out = [0u8; 6];
    rb.read(&mut out, &mut gen_block);
    assert_eq!(out, [10, 20, 30, 40, 50, 60]);
    assert_eq!(rb.get_pos(), 2);
    assert_eq!(rb.remaining(), 2);

    let ser = rb.serialize();
    assert_eq!(ser.as_slice(), &[2, 0, 70, 80]);

    let mut restored = ReadBuffer::<U4>::deserialize(&ser).unwrap();
    assert_eq!(restored.read_cached(2), &[70, 80]);
    assert_eq!(restored.remaining(), 0);

    let mut invalid = ser;
    invalid[1] = 1;
    assert_eq!(ReadBuffer::<U4>::deserialize(&invalid).unwrap_err(), Error);

    rb.reset();
    assert_eq!(rb.get_pos(), 4);
    assert_eq!(rb.remaining(), 0);
}

Ursprungs-Seeder

anonym