windows-link 0.2.1: windows_link::link

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

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

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

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

[dependencies]
windows-link = "=0.2.1"

[[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/windows-link@0.2.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/windows-link@0.2.1

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:695bd9e811abafbc813b7ffc11906476d140aaa5f070a2bb08a3a453d636579b","contract":["link! declares and links standard C ABI functions with 32-bit integer parameters","link! handles 64-bit integer parameters and return values","link! handles character conversion functions across FFI boundaries","link! handles raw pointer arguments for string length calculation"],"goal":"verify pkg:cargo/windows-link@0.2.1","kind":"HOW","packages":["pkg:cargo/windows-link@0.2.1"],"schemaVersion":1,"symbols":["windows_link::link"]},"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/windows-link@0.2.1"],"schemaVersion":1,"subject":"pkg:cargo/windows-link@0.2.1","symbols":["windows_link::link"],"verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify pkg:cargo/windows-link@0.2.1",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/windows-link@0.2.1"
  ],
  "symbols": [
    "windows_link::link"
  ]
}

//! Clean-room verification sample for windows-link.

pub use windows_link::*;

use windows_link::link;

// 1. Declare standard C ABI function with single 32-bit integer argument and return
link!("c" "C" fn abs(x: i32) -> i32);

// 2. Declare standard C ABI function with 64-bit integer argument and return
link!("c" "C" fn labs(x: i64) -> i64);

// 3. Declare standard C ABI function with character argument and return
link!("c" "C" fn toupper(c: i32) -> i32);

// 4. Declare standard C ABI function with pointer argument
link!("c" "C" fn strlen(s: *const u8) -> usize);

fn main() {
    // 1. abs computes absolute value of 32-bit integer
    let val32 = unsafe { abs(-42) };
    assert_eq!(val32, 42);

    // 2. labs computes absolute value of 64-bit integer
    let val64 = unsafe { labs(-100_000_000_000i64) };
    assert_eq!(val64, 100_000_000_000i64);

    // 3. toupper converts lowercase ASCII character to uppercase
    let upper = unsafe { toupper(b'z' as i32) };
    assert_eq!(upper, b'Z' as i32);

    // 4. strlen computes length of null-terminated string
    let bytes = b"windows-link\0";
    let len = unsafe { strlen(bytes.as_ptr()) };
    assert_eq!(len, 12);

    println!("All windows-link contract assertions passed successfully.");
}