fuel-nn 0.19.1

Minimalist ML framework.
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
60
61
62
63

// SPDX-License-Identifier: MIT OR Apache-2.0
//! Neural-network building blocks for Fuel's lazy graph.
//!
//! Extracted from `fuel-core` (2026-08-19). This crate sits **above**
//! `fuel-core`: the whole surface is built on `Tensor`, which lives in
//! `fuel_tensor::lazy`, so `fuel-nn` is a *consumer* of `fuel-core` and
//! `fuel-core` deliberately does **not** re-export it — that would be a
//! dependency cycle.
//!
//! # Why this could be extracted now
//!
//! The `fuel-core` dissolution was recorded as "downstream of the eager-
//! dispatch retirement (B6)". **B6 is complete** — verify with
//! `git grep "pub struct Tensor" -- fuel-core/src/` (expect 0).
//!
//! ⚠️ **The control here was CORRUPTED by my own `Lazy`-prefix rename and is
//! repaired.** It used to read *"control: `pub struct LazyTensor` returns 1"* —
//! the sweep rewrote the control string to match the claim string, leaving one
//! sentence asserting the same query returns both 0 and 1. A control must anchor
//! on something a rename cannot reach, so it is now STRUCTURAL:
//! `git ls-files 'fuel-core/src/*.rs' | wc -l` → **190** (proves the path is
//! live; if it returns 0 the claim above is vacuous rather than true).
//!
//! And this surface never depended on the EAGER tensor type in the first place:
//! measured across all 22 files, every tensor mention is the lazy
//! `fuel_tensor::lazy::Tensor` or a doc comment, with one exception
//! (`optim.rs`, `fuel_graph::NodeHandle::from_existing`) which is the graph
//! handle from a crate already *below* `fuel-core`.
//!
//! So this crate inherited a blocker it never had, from a program that has
//! since finished.

pub mod conv_transpose;
pub mod dropout;
pub mod gru;
pub mod loss;
pub mod modules;
pub mod one_hot;
pub mod optim;
pub mod prelu;
pub mod varbuilder;
pub mod varmap;

// GAP-347 PR 4 (bail! consolidation): before/after test for this consumer
// crate family. `fuel_ir::bail!` is now `fuel_ir::bail!` re-exported
// (the fuel-core-local `macro_rules!` duplicate was deleted), which can
// change `$crate::Error` resolution silently across a macro-path swap.
// This proves the error text/variant this crate actually relies on
// (gru.rs/two_proj_attention.rs/prelu.rs's `fuel_ir::bail!`) is unchanged.
#[cfg(test)]
mod bail_consolidation_tests {
    fn always_bails() -> fuel_ir::error::Result<()> {
        fuel_ir::bail!("deliberate failure for the fuel-core dissolution bail! consolidation test");
        #[allow(unreachable_code)]
        Ok(())
    }

    #[test]
    fn fuel_core_bail_still_produces_a_typed_err_with_the_message() {
        let err = always_bails().expect_err("bail! must produce an Err, never panic");
        assert!(err.to_string().contains("deliberate failure"));
    }
}