baracuda-forge 0.0.1-alpha.68

Build-time CUDA kernel compiler for the baracuda ecosystem: nvcc-driven incremental builds, parallel compilation, GPU auto-detection, and CUTLASS / custom git dependency support.
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

//! Error types for baracuda-forge.

use std::path::PathBuf;
use thiserror::Error;

/// Result type alias for baracuda-forge operations.
pub type Result<T> = std::result::Result<T, Error>;

/// Errors that can occur during CUDA kernel building.
#[derive(Debug, Error)]
pub enum Error {
    /// nvcc binary not found.
    #[error("nvcc not found: {0}. Set NVCC environment variable or ensure nvcc is in PATH")]
    NvccNotFound(String),

    /// CUDA toolkit not found.
    #[error("CUDA toolkit not found at {0}")]
    CudaToolkitNotFound(PathBuf),

    /// Compute capability detection failed.
    #[error("Failed to detect compute capability: {0}")]
    ComputeCapDetectionFailed(String),

    /// Kernel compilation failed.
    #[error("Kernel compilation failed for {path}: {message}")]
    CompilationFailed {
        /// Path to the kernel file that failed.
        path: PathBuf,
        /// Error message from nvcc.
        message: String,
    },

    /// Linking failed.
    #[error("Linking failed: {0}")]
    LinkingFailed(String),

    /// Invalid source path.
    #[error("Source path does not exist: {0}")]
    SourcePathNotFound(PathBuf),

    /// Git operation failed.
    #[error("Git operation failed: {0}")]
    GitOperationFailed(String),

    /// IO error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// Cache error.
    #[error("Cache error: {0}")]
    CacheError(String),

    /// Invalid configuration.
    #[error("Invalid configuration: {0}")]
    InvalidConfig(String),
}