Enum LogMessage 

pub enum LogMessage {
    BuildStarted {
        cwd: PathBuf,
        host: String,
        jobs: u32,
        num_cpus: Option<u64>,
        profile: String,
        rustc_version: String,
        rustc_version_verbose: String,
        target_dir: PathBuf,
        workspace_root: PathBuf,
    },
    ResolutionStarted {
        elapsed: f64,
    },
    ResolutionFinished {
        elapsed: f64,
    },
    UnitGraphStarted {
        elapsed: f64,
    },
    UnitGraphFinished {
        elapsed: f64,
    },
    UnitRegistered {
        package_id: PackageIdSpec,
        target: Target,
        mode: CompileMode,
        platform: String,
        index: u64,
        features: Vec<String>,
        requested: bool,
    },
    UnitStarted {
        index: u64,
        elapsed: f64,
    },
    UnitRmetaFinished {
        index: u64,
        elapsed: f64,
        unblocked: Vec<u64>,
    },
    UnitSectionStarted {
        index: u64,
        elapsed: f64,
        section: String,
    },
    UnitSectionFinished {
        index: u64,
        elapsed: f64,
        section: String,
    },
    UnitFinished {
        index: u64,
        elapsed: f64,
        unblocked: Vec<u64>,
    },
    UnitFingerprint {
        index: u64,
        status: FingerprintStatus,
        cause: Option<DirtyReason>,
    },
}

A log message.

Each variant represents a different type of event.

Variants

BuildStarted

Emitted when a build starts.

Fields

cwd: PathBuf

Current working directory.

host: String

Host triple.

jobs: u32

Number of parallel jobs.

num_cpus: Option<u64>

Available parallelism of the compilation environment.

profile: String

Build profile name (e.g., “dev”, “release”).

rustc_version: String

The rustc version (1.23.4-beta.2).

rustc_version_verbose: String

The rustc verbose version information (the output of rustc -vV).

target_dir: PathBuf

Target directory for build artifacts.

workspace_root: PathBuf

Workspace root directory.

ResolutionStarted

Emitted when resolving dependencies starts.

Fields

elapsed: f64

Seconds elapsed from build start.

ResolutionFinished

Emitted when resolving dependencies finishes.

Fields

elapsed: f64

Seconds elapsed from build start.

UnitGraphStarted

Emitted when unit graph generation starts.

Fields

elapsed: f64

Seconds elapsed from build start.

UnitGraphFinished

Emitted when unit graph generation finishes.

Fields

elapsed: f64

Seconds elapsed from build start.

UnitRegistered

Emitted when a compilation unit is registered in the unit graph, right before LogMessage::UnitGraphFinished that Cargo finalizes the unit graph.

Fields

package_id: PackageIdSpec

Package ID specification.

target: Target

Cargo target (lib, bin, example, etc.).

mode: CompileMode

The compilation action this unit is for (check, build, test, etc.).

platform: String

The target platform this unit builds for.

It is either a target triple the compiler accepts, or a file name with the json extension for a custom target.

index: u64

Unit index for compact reference in subsequent events.

features: Vec<String>

Enabled features.

requested: bool

Whether this is requested to build by user directly, like via the -p flag or the default workspace members.

UnitStarted

Emitted when a compilation unit starts.

Fields

index: u64

Unit index from the associated unit-registered event.

elapsed: f64

Seconds elapsed from build start.

UnitRmetaFinished

Emitted when a section (e.g., rmeta, link) of the compilation unit finishes.

Fields

index: u64

Unit index from the associated unit-registered event.

elapsed: f64

Seconds elapsed from build start.

unblocked: Vec<u64>

Unit indices that were unblocked by this rmeta completion.

UnitSectionStarted

Emitted when a section (e.g., rmeta, link) of the compilation unit starts.

Requires -Zsection-timings to be enabled.

Fields

index: u64

Unit index from the associated unit-registered event.

elapsed: f64

Seconds elapsed from build start.

section: String

Section name from rustc’s -Zjson=timings (e.g., “codegen”, “link”).

UnitSectionFinished

Emitted when a section (e.g., rmeta, link) of the compilation unit finishes.

Requires -Zsection-timings to be enabled.

Fields

index: u64

Unit index from the associated unit-registered event.

elapsed: f64

Seconds elapsed from build start.

section: String

Section name from rustc’s -Zjson=timings (e.g., “codegen”, “link”).

UnitFinished

Emitted when a compilation unit finishes.

Fields

index: u64

Unit index from the associated unit-registered event.

elapsed: f64

Seconds elapsed from build start.

unblocked: Vec<u64>

Unit indices that were unblocked by this completion.

UnitFingerprint

Emitted when rebuild fingerprint information is determined for a unit.

Fields

index: u64

Unit index from the associated unit-registered event.

status: FingerprintStatus

Status of the rebuild detection fingerprint of this unit

cause: Option<DirtyReason>

Reason why the unit is dirty and needs rebuilding.

Implementations

impl LogMessage

pub fn write_json_log<W: Write>( &self, writer: &mut W, run_id: &str, ) -> Result<()>

Serializes this message as a JSON log line directly to the writer.

Trait Implementations

impl<'de> Deserialize<'de> for LogMessage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LogMessage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 312 bytes

Size for each variant:

• BuildStarted: 200 bytes
• ResolutionStarted: 16 bytes
• ResolutionFinished: 16 bytes
• UnitGraphStarted: 16 bytes
• UnitGraphFinished: 16 bytes
• UnitRegistered: 312 bytes
• UnitStarted: 24 bytes
• UnitRmetaFinished: 48 bytes
• UnitSectionStarted: 48 bytes
• UnitSectionFinished: 48 bytes
• UnitFinished: 48 bytes
• UnitFingerprint: 120 bytes