rustls-pki-types 1.15.1: rustls_pki_types::Ipv4Addr

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

[[package]]
name = "rustls-pki-types"
version = "1.15.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2f4925028c7eb5d1fcdaf196971378ed9d2c1c4efc7dc5d011256f76c99c0a96"
dependencies = [
 "zeroize",
]

[[package]]
name = "sample-rustls-pki-types"
version = "1.0.0"
dependencies = [
 "rustls-pki-types",
]

[[package]]
name = "zeroize"
version = "1.9.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e13c156562582aa81c60cb29407084cdb54c4164760106ab78e6c5b0858cf64e"

[package]
name = "sample-rustls-pki-types"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
rustls-pki-types = { version = "=1.15.1" }

[[bin]]
name = "contract"
path = "test/contract.rs"

# rustls-pki-types 1.15.1 Ipv4Addr Contracts

## What `search_known_solution` answered
`search_known_solution` returned a sample verified on alpine/musl, requiring verification on linux glibc.

## What a model would have written instead
A model would often assume `rustls_pki_types::Ipv4Addr` mirrors standard library `std::net::Ipv4Addr` with methods like `Ipv4Addr::new(a, b, c, d)`, `.octets()`, or direct conversions to `std::net::Ipv4Addr`.

## How the wrong version fails
`rustls_pki_types` is a `no_std` crate where `std` is not enabled by default. `Ipv4Addr` is a tuple struct `Ipv4Addr([u8; 4])`. Calling `Ipv4Addr::new(...)` fails with E0599 (no associated function `new`). Calling `.octets()` fails with E0599 (no method `octets`). Using `From<std::net::Ipv4Addr>` without the optional `std` feature fails with E0277. Correct construction uses `Ipv4Addr::from([u8; 4])` or `Ipv4Addr::try_from(&str)`, slice/array access uses `AsRef<[u8; 4]>` (`ip.as_ref()`), and conversion to `ServerName` uses `ServerName::from(ip)`.

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 rustls_pki_types::Ipv4Addr in pkg:cargo/rustls-pki-types@1.15.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/rustls-pki-types@1.15.1
Demonstrate these symbols/APIs:
  - rustls_pki_types::Ipv4Addr

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:6a6e4384b749b4a9dcb08233c590a74a546ef9ea35a79a536c659f9cf5a869b6","contract":["Ipv4Addr::from([u8; 4]) constructs Ipv4Addr from raw byte octets","Ipv4Addr::try_from parses valid IPv4 strings into Ipv4Addr","Ipv4Addr::try_from rejects invalid IPv4 addresses and strings longer than 15 octets with AddrParseError","Ipv4Addr::as_ref provides a reference to the inner [u8; 4] octet array","Ipv4Addr implements Copy, Clone, Eq, and PartialEq preserving value equality","ServerName::from converts Ipv4Addr into ServerName::IpAddress"],"goal":"verify rustls_pki_types::Ipv4Addr in pkg:cargo/rustls-pki-types@1.15.1","kind":"HOW","packages":["pkg:cargo/rustls-pki-types@1.15.1"],"schemaVersion":1,"symbols":["rustls_pki_types::Ipv4Addr"]},"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/rustls-pki-types@1.15.1"],"schemaVersion":1,"subject":"pkg:cargo/rustls-pki-types@1.15.1","symbols":["rustls_pki_types::Ipv4Addr"],"verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify rustls_pki_types::Ipv4Addr in pkg:cargo/rustls-pki-types@1.15.1",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/rustls-pki-types@1.15.1"
  ],
  "symbols": [
    "rustls_pki_types::Ipv4Addr"
  ]
}

//! Clean-room verification sample for rustls-pki-types Ipv4Addr.

pub use rustls_pki_types::Ipv4Addr;

use core::convert::TryFrom;
use rustls_pki_types::{IpAddr, Ipv4Addr, ServerName};

fn main() {
    // 1. Ipv4Addr::from([u8; 4]) constructs Ipv4Addr from raw byte octets
    let octets = [192, 168, 1, 1];
    let ip = Ipv4Addr::from(octets);
    assert_eq!(ip.as_ref(), &octets);

    // 2. Ipv4Addr::try_from parses valid IPv4 strings into Ipv4Addr
    let parsed_ip = Ipv4Addr::try_from("127.0.0.1").expect("valid IPv4 string parsing should succeed");
    assert_eq!(parsed_ip, Ipv4Addr::from([127, 0, 0, 1]));
    assert_eq!(parsed_ip.as_ref(), &[127, 0, 0, 1]);

    // 3. Ipv4Addr::try_from rejects invalid IPv4 addresses and strings longer than 15 octets with AddrParseError
    assert!(Ipv4Addr::try_from("256.0.0.1").is_err());
    assert!(Ipv4Addr::try_from("127.0.0").is_err());
    assert!(Ipv4Addr::try_from("192.168.1.1.invalid_length").is_err());

    // 4. Ipv4Addr::as_ref provides a reference to the inner [u8; 4] octet array
    let loopback = Ipv4Addr::from([127, 0, 0, 1]);
    let ref_octets: &[u8; 4] = loopback.as_ref();
    assert_eq!(ref_octets, &[127, 0, 0, 1]);

    // 5. Ipv4Addr implements Copy, Clone, Eq, and PartialEq preserving value equality
    let copied = loopback;
    assert_eq!(copied, loopback);
    #[allow(clippy::clone_on_copy)]
    let cloned = loopback.clone();
    assert_eq!(cloned, loopback);

    // 6. ServerName::from converts Ipv4Addr into ServerName::IpAddress
    let server_name = ServerName::from(loopback);
    assert_eq!(server_name, ServerName::IpAddress(IpAddr::V4(loopback)));

    println!("All rustls_pki_types::Ipv4Addr contract assertions passed successfully.");
}