CodeSampleX

Ejemplo

tracing 0.1.41: tracing::span::Record

Muestra verificada para cargo tracing 0.1.41: tracing::span::Record. El contrato se ejecutó en rust 1 · linux alpine/x64 · docker y pasó.

sha256:cb9e5cfa3f3abb92e0d89ac9bc21810043da6caaf3fe72986d4d3b8a86c114ca

Esta red ofrece una sola cosa: una muestra que compila. La ejecutó en un sandbox y guardó el recibo firmado. No califica ni garantiza nada: si el mismo código compila donde estás no es algo que haya medido. Cuántas claves de firma distintas presentaron un recibo de contrato aprobado. Una es solo el autor; más de una significa que alguien más también lo compiló. Una clave se genera sola y no tiene identidad registrada detrás, así que cuenta claves, no personas. MIT-0

Evidencia de ejecución

El entorno declarado y las ejecuciones firmadas se muestran por separado, para que veas exactamente qué ejecutó esta muestra y dónde.

Base de evidencia
Contrato firmado aprobado
Recibos de verificación
1
Claves de firma que lo compilaron
1
Entorno declarado rust linux x64 rust rust cargo

Entornos de las ejecuciones de verificación

Entorno Contrato Etapas Ejecución
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-02

Caso

HOW
Objetivo
verify tracing::span::Record in pkg:cargo/tracing@0.1.41
Paquetes
Símbolos
  • tracing::span::Record
Entorno
rust
Creado
2026-11-02T18:52:02Z

Contrato

  1. assert Record::new over a single-field ValueSet reports len 1, !is_empty, contains the populated Field, and rejects unpopulated or foreign-callsite Fields
  2. assert Record::new over a sparse ValueSet with None slots reports len equal to the slice length while contains and record(Visit) only observe Some fields
  3. assert Record::new over an empty ValueSet reports len 0, is_empty, and visits zero fields
  4. assert Span::record dispatches a non-empty Record to Subscriber::record for declared fields while ignoring undeclared field names

Archivos

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

Descargar el artefacto de código fuente (tar.gz)

Código fuente

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

[[package]]
name = "once_cell"
version = "1.21.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"

[[package]]
name = "pin-project-lite"
version = "0.2.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"

[[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 = "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 = "tracing"
version = "0.1.41"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "784e0ac535deb450455cbfa28a6f0df145ea1bb7ae51b821cf5e7927fdcfbdd0"
dependencies = [
 "pin-project-lite",
 "tracing-attributes",
 "tracing-core",
]

[[package]]
name = "tracing-attributes"
version = "0.1.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "tracing-core"
version = "0.1.36"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
dependencies = [
 "once_cell",
]

[[package]]
name = "tracing-span-record-sample"
version = "0.1.0"
dependencies = [
 "tracing",
]

[[package]]
name = "unicode-ident"
version = "1.0.27"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
Cargo.toml
[package]
name = "tracing-span-record-sample"
version = "0.1.0"
edition = "2021"

[dependencies]
tracing = "=0.1.41"
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 tracing::span::Record in pkg:cargo/tracing@0.1.41
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/tracing@0.1.41
Demonstrate these symbols/APIs:
  - tracing::span::Record

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:c3e7d076bf947067ef9c10c6dba1f566e4888bba87e337b8a94fbf5d4370505c","contract":["assert Record::new over a single-field ValueSet reports len 1, !is_empty, contains the populated Field, and rejects unpopulated or foreign-callsite Fields","assert Record::new over a sparse ValueSet with None slots reports len equal to the slice length while contains and record(Visit) only observe Some fields","assert Record::new over an empty ValueSet reports len 0, is_empty, and visits zero fields","assert Span::record dispatches a non-empty Record to Subscriber::record for declared fields while ignoring undeclared field names"],"goal":"verify tracing::span::Record in pkg:cargo/tracing@0.1.41","kind":"HOW","packages":["pkg:cargo/tracing@0.1.41"],"schemaVersion":1,"symbols":["tracing::span::Record"]},"contractCommand":["cargo","test","--locked","--offline"],"environment":{"arch":"x64","ecosystem":"cargo","executionContext":"rust","language":"rust","os":"linux","packageManager":"cargo","runtime":"rust","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/tracing@0.1.41"],"schemaVersion":1,"subject":"pkg:cargo/tracing@0.1.41","symbols":["tracing::span::Record"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify tracing::span::Record in pkg:cargo/tracing@0.1.41",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/tracing@0.1.41"
  ],
  "symbols": [
    "tracing::span::Record"
  ]
}
src/main.rs
use std::collections::BTreeMap;
use std::fmt;
use std::sync::atomic::{AtomicU64, Ordering};
use std::sync::{Arc, Mutex};

use tracing::field::{Field, FieldSet, Visit};
use tracing::span::{Attributes, Id, Record};
use tracing::{Event, Level, Metadata, Subscriber};

#[derive(Debug, Clone, PartialEq, Eq)]
struct RecordedUpdate {
    len: usize,
    is_empty: bool,
    contains_status: bool,
    contains_latency: bool,
    contains_route: bool,
    visited: BTreeMap<String, String>,
}

#[derive(Debug, Default)]
struct SubscriberState {
    field_sets: BTreeMap<u64, &'static FieldSet>,
    initial_fields: BTreeMap<u64, BTreeMap<String, String>>,
    updates: BTreeMap<u64, Vec<RecordedUpdate>>,
}

struct MapVisitor<'a>(&'a mut BTreeMap<String, String>);

impl Visit for MapVisitor<'_> {
    fn record_str(&mut self, field: &Field, value: &str) {
        self.0.insert(field.name().to_string(), value.to_string());
    }

    fn record_u64(&mut self, field: &Field, value: u64) {
        self.0.insert(field.name().to_string(), value.to_string());
    }

    fn record_i64(&mut self, field: &Field, value: i64) {
        self.0.insert(field.name().to_string(), value.to_string());
    }

    fn record_bool(&mut self, field: &Field, value: bool) {
        self.0.insert(field.name().to_string(), value.to_string());
    }

    fn record_debug(&mut self, field: &Field, value: &dyn fmt::Debug) {
        self.0.insert(field.name().to_string(), format!("{value:?}"));
    }
}

struct RecordInspectingSubscriber {
    next_id: AtomicU64,
    state: Arc<Mutex<SubscriberState>>,
}

impl RecordInspectingSubscriber {
    fn new(state: Arc<Mutex<SubscriberState>>) -> Self {
        Self {
            next_id: AtomicU64::new(1),
            state,
        }
    }
}

impl Subscriber for RecordInspectingSubscriber {
    fn enabled(&self, _metadata: &Metadata<'_>) -> bool {
        true
    }

    fn new_span(&self, span: &Attributes<'_>) -> Id {
        let raw_id = self.next_id.fetch_add(1, Ordering::Relaxed);
        let mut initial = BTreeMap::new();
        span.record(&mut MapVisitor(&mut initial));

        let mut state = self.state.lock().unwrap();
        state.field_sets.insert(raw_id, span.metadata().fields());
        state.initial_fields.insert(raw_id, initial);
        Id::from_u64(raw_id)
    }

    fn record(&self, span: &Id, values: &Record<'_>) {
        let raw_id = span.into_u64();
        let mut visited = BTreeMap::new();
        values.record(&mut MapVisitor(&mut visited));

        let mut state = self.state.lock().unwrap();
        let field_set = state
            .field_sets
            .get(&raw_id)
            .copied()
            .expect("registered span field set");
        let route_field = field_set.field("route").expect("route field");
        let status_field = field_set.field("status").expect("status field");
        let latency_field = field_set.field("latency_ms").expect("latency_ms field");

        let update = RecordedUpdate {
            len: values.len(),
            is_empty: values.is_empty(),
            contains_status: values.contains(&status_field),
            contains_latency: values.contains(&latency_field),
            contains_route: values.contains(&route_field),
            visited,
        };
        state.updates.entry(raw_id).or_default().push(update);
    }

    fn record_follows_from(&self, _span: &Id, _follows: &Id) {}
    fn event(&self, _event: &Event<'_>) {}
    fn enter(&self, _span: &Id) {}
    fn exit(&self, _span: &Id) {}
}

fn verify_direct_record_from_metadata(
    metadata: &'static Metadata<'static>,
    other_metadata: &'static Metadata<'static>,
) {
    let fieldset = metadata.fields();
    let route_field = fieldset.field("route").expect("route field");
    let status_field = fieldset.field("status").expect("status field");
    let latency_field = fieldset.field("latency_ms").expect("latency_ms field");
    let foreign_field = other_metadata
        .fields()
        .field("status")
        .expect("foreign status field");

    let status_val = 204_u64;
    let single_pair: [(&Field, Option<&(dyn tracing::Value + '_)>); 1] =
        [(&status_field, Some(&status_val))];
    let value_set = fieldset.value_set(&single_pair);
    let record = Record::new(&value_set);

    assert_eq!(record.len(), 1);
    assert!(!record.is_empty());
    assert!(record.contains(&status_field));
    assert!(!record.contains(&route_field));
    assert!(!record.contains(&latency_field));
    // A field with the same name from a different callsite's FieldSet is not contained.
    assert!(!record.contains(&foreign_field));

    let mut visited = BTreeMap::new();
    record.record(&mut MapVisitor(&mut visited));
    assert_eq!(visited.len(), 1);
    assert_eq!(visited.get("status"), Some(&"204".to_string()));

    // When a ValueSet slice includes None slots alongside a Some value, Record::contains
    // and Record::record only observe the populated field, while len reflects the ValueSet entries.
    let sparse_pairs: [(&Field, Option<&(dyn tracing::Value + '_)>); 3] = [
        (&route_field, None),
        (&status_field, Some(&status_val)),
        (&latency_field, None),
    ];
    let sparse_value_set = fieldset.value_set(&sparse_pairs);
    let sparse_record = Record::new(&sparse_value_set);
    assert_eq!(sparse_record.len(), 3);
    assert!(!sparse_record.is_empty());
    assert!(sparse_record.contains(&status_field));
    assert!(!sparse_record.contains(&route_field));
    assert!(!sparse_record.contains(&latency_field));

    let mut sparse_visited = BTreeMap::new();
    sparse_record.record(&mut MapVisitor(&mut sparse_visited));
    assert_eq!(sparse_visited.len(), 1);
    assert_eq!(sparse_visited.get("status"), Some(&"204".to_string()));

    let empty_pairs: [(&Field, Option<&(dyn tracing::Value + '_)>); 0] = [];
    let empty_value_set = fieldset.value_set(&empty_pairs);
    let empty_record = Record::new(&empty_value_set);
    assert_eq!(empty_record.len(), 0);
    assert!(empty_record.is_empty());
    assert!(!empty_record.contains(&status_field));

    let mut empty_visited = BTreeMap::new();
    empty_record.record(&mut MapVisitor(&mut empty_visited));
    assert!(empty_visited.is_empty());
}

fn main() {
    let state = Arc::new(Mutex::new(SubscriberState::default()));
    let subscriber = RecordInspectingSubscriber::new(Arc::clone(&state));

    tracing::subscriber::with_default(subscriber, || {
        let span = tracing::span!(
            Level::INFO,
            "rpc_call",
            route = "/v1/items",
            status = tracing::field::Empty,
            latency_ms = tracing::field::Empty,
        );
        let other_span = tracing::span!(
            Level::INFO,
            "other_call",
            status = tracing::field::Empty,
        );
        let span_id = span.id().expect("span enabled").into_u64();
        let metadata = span.metadata().expect("span metadata enabled");
        let other_metadata = other_span.metadata().expect("other span metadata enabled");

        verify_direct_record_from_metadata(metadata, other_metadata);

        // Recording a single declared field produces a non-empty Record of len 1.
        span.record("status", 200_u64);
        // Recording an undeclared field name is a no-op and does not dispatch a Record to the Subscriber.
        span.record("undeclared_field", "ignored");
        // Recording another declared field produces a second Record update.
        span.record("latency_ms", 42_u64);

        let recorded = state.lock().unwrap();
        let initial = recorded.initial_fields.get(&span_id).expect("initial span fields");
        assert_eq!(initial.len(), 1);
        assert_eq!(initial.get("route"), Some(&"/v1/items".to_string()));
        assert!(!initial.contains_key("status"));

        let updates = recorded.updates.get(&span_id).expect("recorded updates");
        assert_eq!(updates.len(), 2);

        assert_eq!(updates[0].len, 1);
        assert!(!updates[0].is_empty);
        assert!(updates[0].contains_status);
        assert!(!updates[0].contains_latency);
        assert!(!updates[0].contains_route);
        assert_eq!(updates[0].visited.get("status"), Some(&"200".to_string()));
        assert_eq!(updates[0].visited.len(), 1);

        assert_eq!(updates[1].len, 1);
        assert!(!updates[1].is_empty);
        assert!(!updates[1].contains_status);
        assert!(updates[1].contains_latency);
        assert!(!updates[1].contains_route);
        assert_eq!(updates[1].visited.get("latency_ms"), Some(&"42".to_string()));
        assert_eq!(updates[1].visited.len(), 1);
    });
}
tests/contract.rs
#[test]
fn contract() {
    let status = std::process::Command::new(env!("CARGO_BIN_EXE_tracing-span-record-sample"))
        .status()
        .expect("run tracing-span-record-sample binary");
    assert!(status.success());
}

Seeder de origen

anónimo