Struct Generator 

pub struct Generator { /* private fields */ }

Bindings generator.

This does:

• Compile Futhark code to C code for each target.
• Generate unsafe Rust bindings for each target.
• Generate a single safe wrapper around all targets.
• Compile and link generated C code.

Usage

In your build.rs file:

use cargo_futhark::{Generator, Result, Target};

fn main() -> Result<()> {
    Generator::new("src/lib.fut")
        .with_target_if(Target::C, cfg!(feature = "c"))
        .with_target_if(Target::MultiCore, cfg!(feature = "multicore"))
        .with_target_if(Target::OpenCL, cfg!(feature = "opencl"))
        .with_target_if(Target::Cuda, cfg!(feature = "cuda"))
        .with_target_if(Target::ISPC, cfg!(feature = "ispc"))
        .run()
}

Implementations

impl Generator

pub fn new(source: impl Into<PathBuf>) -> Self

Returns a new Generator with default settings.

The source should be the .fut file containing the entry functions.

The defaults are:

• watch_sources = true
• targets = EMPTY

You must add at least on Target before you call Generator::run.

pub fn watch_sources(&mut self, watch: bool) -> &mut Self

Watch Futhark source file for changes.

Enabled by default.

pub fn with_cuda_home( &mut self, cuda_home: impl Into<PathBuf>, ) -> Result<&mut Self>

Specify a custom CUDA home path.

This will add the following:

• $cuda_home/include to include path
• $cuda_home/lib64 to link path

pub fn with_target(&mut self, target: Target) -> &mut Self

Enable the given Target.

pub fn with_target_if(&mut self, target: Target, condition: bool) -> &mut Self

Enable the given Target conditionally.

This is especially useful with the cfg! macro.

pub fn run(&mut self) -> Result<()>

Run the generator.