cabinpkg 0.17.0

A package manager and build system for C/C++
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

//! Network-free schema-lock tests for the bundled stb
//! foundation port.  The end-to-end build/run path is covered by
//! `cabin_examples.rs::stb_usage_builds_and_runs`.

use super::*;

#[test]
fn port_toml_schema_for_real_ports_stb_matches_published_values() {
    // stb has no upstream releases; the version is the pinned
    // commit's date spelled as SemVer.
    let descriptor = load_real_port_and_assert_schema(
        "stb",
        &semver::Version::new(2026, 4, 15),
        "MIT OR Unlicense",
    );
    match &descriptor.source {
        cabin_port::PortSource::Archive { url, .. } => {
            // The archive is an immutable commit tarball, pinned by
            // full 40-hex commit id (no floating branch or tag).
            assert!(
                url.path()
                    .ends_with("/31c1ad37456438565541f4919958214b6e762fb4.tar.gz"),
                "expected a commit-pinned tarball, got {url}"
            );
        }
    }
    assert_tar_gz_source(&descriptor, "stb-31c1ad37456438565541f4919958214b6e762fb4");
}

#[test]
fn stb_is_bundled_and_parses() {
    assert_builtin_port_bundled_and_parses("stb", "^2026", "2026.4.15");
}

#[test]
fn stb_overlay_declares_header_only_target() {
    let overlay = builtin_overlay("stb");
    assert!(overlay.contains("[target.stb]"), "overlay: {overlay}");
    assert!(
        overlay.contains("type = \"header-only\""),
        "overlay: {overlay}"
    );
    assert!(
        overlay.contains("include-dirs = [\".\"]"),
        "overlay: {overlay}"
    );
    // Which implementation TUs exist is the consumer's choice; the
    // port itself compiles nothing.
    assert!(
        !overlay.contains("sources"),
        "overlay should not list sources: {overlay}"
    );
    // The math-heavy stb implementations need libm on Unix; the port
    // propagates it so consumers do not have to know.
    assert!(
        overlay.contains("link-libs = [\"m\"]"),
        "overlay: {overlay}"
    );
}