Crate contract_build

Expand description

contract-build

A crate for building ink! smart contracts. Used by cargo-contract.

Usage

use contract_build::{
    ManifestPath,
    Verbosity,
    BuildArtifacts,
    BuildMode,
    Features,
    Network,
    OptimizationPasses,
    OutputType,
    UnstableFlags,
};

let manifest_path = ManifestPath::new("my-contract/Cargo.toml").unwrap();

let args = contract_build::ExecuteArgs {
    manifest_path,
    verbosity: Verbosity::Default,
    build_mode: BuildMode::Release,
    features: Features::default(),
    network: Network::Online,
    build_artifact: BuildArtifacts::All,
    unstable_flags: UnstableFlags::default(),
    optimization_passes: Some(OptimizationPasses::default()),
    keep_debug_symbols: false,
    lint: false,
    output_type: OutputType::Json,
    skip_wasm_validation: false,
};

contract_build::execute(args);

Re-exports

pub use self::metadata::BuildInfo;

pub use self::metadata::MetadataResult;

pub use self::metadata::WasmOptSettings;

pub use self::util::DEFAULT_KEY_COL_WIDTH;

Macros

maybe_println

Prints to stdout if verbosity.is_verbose() is true.

name_value_println

Pretty print name value, name right aligned with colour.

Structs

BuildResult

Result of the build process.

BuildSteps

Track and display the current and total number of steps.

CrateMetadata

Relevant metadata obtained from Cargo.toml.

ExecuteArgs

Arguments to use when executing build or check commands.

Features

Define the standard cargo features args to be passed through.

Manifest

Create, amend and save a copy of the specified Cargo.toml.

ManifestPath

Path to a Cargo.toml file

OptimizationResult

Result of the optimization process.

Profile

Subset of cargo profile settings to configure defaults for building contracts

Make a copy of a cargo workspace, maintaining only the directory structure and manifest files. Relative paths to source files and non-workspace dependencies are rewritten to absolute paths to the original locations.