rustls-pki-types 1.15.1: rustls_pki_types::IpAddr

# 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 = "=1.15.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 rustls_pki_types::IpAddr 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::IpAddr

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:d7ddbc750e32e232bc3eb8e5bcf2e25f74f35155f26c1f94bd35710b2a39d516","contract":["IpAddr parses valid IPv4 string representation into IpAddr::V4","IpAddr parses valid IPv6 string representation into IpAddr::V6","IpAddr parsing fails with AddrParseError for invalid IP address strings","IpAddr::V4 wraps Ipv4Addr constructible from 4-octet byte array and provides octet access","IpAddr::V6 wraps Ipv6Addr constructible from 8-segment u16 array and provides octet access","IpAddr converts into ServerName::IpAddress enum variant"],"goal":"verify rustls_pki_types::IpAddr 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::IpAddr"]},"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::IpAddr"],"verifierAdapter":"cargo@1"}

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

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

pub use rustls_pki_types::*;

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

fn main() {
    // 1. IpAddr parses valid IPv4 string representation into IpAddr::V4
    let v4_parsed = IpAddr::try_from("192.168.1.1").expect("should parse valid IPv4");
    match v4_parsed {
        IpAddr::V4(addr) => {
            assert_eq!(addr.as_ref(), &[192, 168, 1, 1]);
        }
        IpAddr::V6(_) => panic!("expected IPv4 variant"),
    }

    // 2. IpAddr parses valid IPv6 string representation into IpAddr::V6
    let v6_parsed = IpAddr::try_from("2001:db8::1").expect("should parse valid IPv6");
    match v6_parsed {
        IpAddr::V6(addr) => {
            let expected_bytes = [
                0x20, 0x01, 0x0d, 0xb8, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 1,
            ];
            assert_eq!(addr.as_ref(), &expected_bytes);
        }
        IpAddr::V4(_) => panic!("expected IPv6 variant"),
    }

    // 3. IpAddr parsing fails with AddrParseError for invalid IP address strings
    assert!(IpAddr::try_from("invalid.ip.string").is_err());
    assert!(IpAddr::try_from("256.0.0.1").is_err());
    assert!(IpAddr::try_from("").is_err());

    // 4. IpAddr::V4 wraps Ipv4Addr constructible from 4-octet byte array and provides octet access
    let v4_raw = Ipv4Addr::from([127, 0, 0, 1]);
    assert_eq!(v4_raw.as_ref(), &[127, 0, 0, 1]);
    let ip_v4 = IpAddr::V4(v4_raw);
    assert_eq!(ip_v4, IpAddr::try_from("127.0.0.1").unwrap());

    // 5. IpAddr::V6 wraps Ipv6Addr constructible from 8-segment u16 array and provides octet access
    let v6_raw = Ipv6Addr::from([0, 0, 0, 0, 0, 0, 0, 1]);
    let ip_v6 = IpAddr::V6(v6_raw);
    assert_eq!(ip_v6, IpAddr::try_from("::1").unwrap());

    // 6. IpAddr converts into ServerName::IpAddress enum variant
    let sn = ServerName::from(ip_v4);
    assert_eq!(sn, ServerName::IpAddress(ip_v4));

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