backtrace 0.3.76: backtrace::BacktraceSymbol

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

[[package]]
name = "addr2line"
version = "0.25.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1b5d307320b3181d6d7954e663bd7c774a838b8220fe0593c86d9fb09f498b4b"
dependencies = [
 "gimli",
]

[[package]]
name = "adler2"
version = "2.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"

[[package]]
name = "backtrace"
version = "0.3.76"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bb531853791a215d7c62a30daf0dde835f381ab5de4589cfe7c649d2cbe92bd6"
dependencies = [
 "addr2line",
 "cfg-if",
 "libc",
 "miniz_oxide",
 "object",
 "rustc-demangle",
 "windows-link",
]

[[package]]
name = "cfg-if"
version = "1.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"

[[package]]
name = "gimli"
version = "0.32.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e629b9b98ef3dd8afe6ca2bd0f89306cec16d43d907889945bc5d6687f2f13c7"

[[package]]
name = "libc"
version = "0.2.189"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"

[[package]]
name = "memchr"
version = "2.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"

[[package]]
name = "miniz_oxide"
version = "0.8.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
dependencies = [
 "adler2",
]

[[package]]
name = "object"
version = "0.37.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ff76201f031d8863c38aa7f905eca4f53abbfa15f609db4277d44cd8938f33fe"
dependencies = [
 "memchr",
]

[[package]]
name = "rustc-demangle"
version = "0.1.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b74b56ffa8bb2830709a538c2cbcae9aa062db0d2a42563bfb09bdaae44020eb"

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

[[package]]
name = "windows-link"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

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

[dependencies]
backtrace = "=0.3.76"

[[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 backtrace::BacktraceSymbol in pkg:cargo/backtrace@0.3.76
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/backtrace@0.3.76
Demonstrate these symbols/APIs:
  - backtrace::BacktraceSymbol

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:18ed3cc004a613786879c84c57cb0edf0a40969eb5b7d010556e7e48c3e54f59","contract":["Backtrace::new captures frames containing resolved BacktraceSymbol entries with accessible name and address","BacktraceSymbol implements Clone and provides a valid Debug representation","Backtrace::new_unresolved frames have empty symbols until resolve populates BacktraceSymbol entries"],"goal":"verify backtrace::BacktraceSymbol in pkg:cargo/backtrace@0.3.76","kind":"HOW","packages":["pkg:cargo/backtrace@0.3.76"],"schemaVersion":1,"symbols":["backtrace::BacktraceSymbol"]},"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/backtrace@0.3.76"],"schemaVersion":1,"subject":"pkg:cargo/backtrace@0.3.76","symbols":["backtrace::BacktraceSymbol"],"verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify backtrace::BacktraceSymbol in pkg:cargo/backtrace@0.3.76",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/backtrace@0.3.76"
  ],
  "symbols": [
    "backtrace::BacktraceSymbol"
  ]
}

//! Clean-room verification sample for backtrace.

pub use backtrace::*;

use backtrace::{Backtrace, BacktraceSymbol};

#[inline(never)]
fn test_inner() -> Backtrace {
    Backtrace::new()
}

#[inline(never)]
fn test_unresolved() -> Backtrace {
    Backtrace::new_unresolved()
}

fn main() {
    // 1. Backtrace::new captures frames containing resolved BacktraceSymbol entries with accessible name and address
    let bt = test_inner();
    let frames = bt.frames();
    assert!(!frames.is_empty(), "backtrace should contain at least one frame");

    let mut found_symbol = false;
    for frame in frames {
        let symbols: &[BacktraceSymbol] = frame.symbols();
        for symbol in symbols {
            found_symbol = true;
            let _addr = symbol.addr();
            if let Some(name) = symbol.name() {
                let name_str = format!("{name}");
                assert!(!name_str.is_empty());
            }
            let _filename = symbol.filename();
            let _lineno = symbol.lineno();
            let _colno = symbol.colno();
        }
    }
    assert!(found_symbol, "at least one BacktraceSymbol must be present in resolved backtrace");

    // 2. BacktraceSymbol implements Clone and provides a valid Debug representation
    let symbol_ref: &BacktraceSymbol = frames
        .iter()
        .flat_map(|f| f.symbols())
        .next()
        .expect("must have at least one BacktraceSymbol");
    let cloned_symbol: BacktraceSymbol = symbol_ref.clone();
    let debug_str = format!("{cloned_symbol:?}");
    assert!(debug_str.starts_with("BacktraceSymbol"));

    // 3. Backtrace::new_unresolved frames have empty symbols until resolve populates BacktraceSymbol entries
    let mut bt_unresolved = test_unresolved();
    let unresolved_frames = bt_unresolved.frames();
    assert!(!unresolved_frames.is_empty());
    for frame in unresolved_frames {
        assert!(frame.symbols().is_empty(), "unresolved frame should have no symbols");
    }

    bt_unresolved.resolve();
    let resolved_frames = bt_unresolved.frames();
    let has_resolved_symbols = resolved_frames.iter().any(|f| !f.symbols().is_empty());
    assert!(has_resolved_symbols, "resolved backtrace must contain BacktraceSymbol instances");

    println!("All backtrace::BacktraceSymbol contract assertions passed successfully.");
}