Struct BuildState 

pub struct BuildState {

    pub working_dir_path: PathBuf,
    pub source_stem: String,
    pub source_name: String,
    pub source_dir_path: PathBuf,
    pub source_path: PathBuf,
    pub cargo_home: PathBuf,
    pub target_dir_path: PathBuf,
    pub target_path: PathBuf,
    pub cargo_toml_path: PathBuf,
    pub rs_manifest: Option<Manifest>,
    pub cargo_manifest: Option<Manifest>,
    pub must_gen: bool,
    pub must_build: bool,
    pub build_from_orig_source: bool,
    pub thag_auto_processed: bool,
    pub ast: Option<Ast>,
    pub crates_finder: Option<CratesFinder>,
    pub metadata_finder: Option<MetadataFinder>,
    pub infer: DependencyInference,
    pub features: Option<String>,
    pub args: Vec<String>,
}

A struct to encapsulate the attributes of the current build as needed by the various functions co-operating in the generation, build and execution of the code.

Fields

working_dir_path: PathBuf

The working directory path where the build is initiated

source_stem: String

The source file name without the .rs extension

source_name: String

The full source file name including the .rs extension

source_dir_path: PathBuf

The directory path containing the source file

source_path: PathBuf

The full path to the source file

cargo_home: PathBuf

The path to the Cargo home directory

target_dir_path: PathBuf

The path to the target directory for build artifacts

target_path: PathBuf

The path to the compiled executable

cargo_toml_path: PathBuf

The path to the generated Cargo.toml file

rs_manifest: Option<Manifest>

The manifest extracted from the Rust source code toml block

cargo_manifest: Option<Manifest>

The final Cargo manifest to be used for building

must_gen: bool

Flag indicating whether generation step must be performed

must_build: bool

Flag indicating whether build step must be performed

build_from_orig_source: bool

Flag indicating whether to build from original source without wrapping

thag_auto_processed: bool

Flag indicating whether thag-auto dependencies were processed

ast: Option<Ast>

The parsed abstract syntax tree of the source code

crates_finder: Option<CratesFinder>

Finder for extracting crate dependencies from the AST

metadata_finder: Option<MetadataFinder>

Finder for extracting metadata from the AST

infer: DependencyInference

The level of dependency inference to apply

features: Option<String>

Optional feature flags to pass to Cargo

args: Vec<String>

Command-line arguments to pass to the built program

Implementations

impl BuildState

pub fn pre_configure( proc_flags: &ProcFlags, cli: &Cli, script_state: &ScriptState, ) -> ThagResult<Self>

Configures a new BuildState instance based on processing flags, CLI arguments, and script state.

This function coordinates the complete setup process by:

1. Extracting and validating script information
2. Determining execution mode flags
3. Setting up all required directory paths
4. Creating the initial build state
5. Determining build requirements

Arguments

• proc_flags - Processing flags that control build and execution behavior
• cli - Command-line arguments parsed from the CLI
• script_state - Current state of the script being processed

Returns

• ThagResult<Self> - Configured BuildState instance if successful

Errors

Returns a ThagError if:

• No script is specified in the script state
• Script filename is invalid or cannot be converted to a string
• Unable to strip .rs suffix from script name
• Cannot resolve working directory or home directory
• Cannot resolve script directory path
• Script file does not exist at the specified path
• Cannot resolve parent directory of script
• Cannot determine if source has been modified since last compilation

Example

let proc_flags = ProcFlags::default();
let cli = Cli::parse();
let script_state = ScriptState::new("example.rs");
let build_state = BuildState::pre_configure(&proc_flags, &cli, &script_state)?;

Trait Implementations

impl Clone for BuildState

fn clone(&self) -> BuildState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BuildState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BuildState

fn default() -> BuildState

Returns the “default value” for a type.