cabinpkg-build 0.17.0

Backend-independent build graph planner for Cabin
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

//! Backend-independent build planning for Cabin.
//!
//! This crate consumes a validated [`cabin_core::Package`] plus a
//! resolved C/C++ toolchain (from `cabin-toolchain`) and produces a
//! [`BuildGraph`] - a list of compile, archive, and link actions
//! plus the metadata needed to write a Clang-style compilation
//! database.
//!
//! The graph is intentionally backend-agnostic. `cabin-ninja` knows how to
//! serialize it as `build.ninja` + `compile_commands.json`; future backends
//! (e.g. a Bazel exporter, or a direct in-process executor) could consume
//! the same structure.

#![allow(
    clippy::too_many_lines,
    // Remaining hits are `field: Default::default()` in test graph
    // fixtures, where clippy's typed-default suggestion is MaybeIncorrect.
    clippy::default_trait_access
)]

pub mod check;
pub mod clean;
pub mod error;
pub mod graph;
pub mod link_diagnostics;
pub mod planner;
pub mod standard_compat;
pub mod validate;

// The toolchain-independent build IR and its dialect selector live in
// `cabin-driver`; re-export the pieces that appear in this crate's
// public surface (`BuildGraph`, `PlanRequest`) so consumers keep one
// import path.  The lowering itself (`cabin_driver::lower`) is a
// backend concern, consumed directly by `cabin-ninja`.
pub use cabin_driver::{
    ArchiveAction, BuildAction, CompileAction, CompileArguments, CompileMode, Dialect, LinkAction,
};
pub use check::into_check_graph;
pub use error::{BuildError, FeatureGateFix};
pub use graph::{BuildGraph, CompileCommand, StandardViolation};
pub use planner::{
    ManifestTargetSelector, PlanRequest, plan, select_targets_of_kind,
    selector_required_features_met,
};
pub use standard_compat::{
    DeclScope, DeclSite, EdgeRequirement, RequirementOrigin, StandardCompatViolation,
};
pub use validate::{
    RequestedStandards, collect_requested_standards, msvc_external_includes_supported,
    requested_standards_of, validate_planned_standards, validate_toolchain_for_backend,
    validate_toolchain_standards,
};