Module insert_unit_bundle

Checks for calls to Commands::spawn() that inserts unit () as a component.

Motivation

It is possible to use Commands::spawn() to spawn an entity with a unit () component, since unit implements Bundle. Unit is not a Component, however, and will be ignored instead of added to the entity. Often, inserting a unit is unintentional and is a sign that the author intended to do something else.

Example

fn spawn(mut commands: Commands) {
    commands.spawn(());

    commands.spawn((
        Name::new("Decal"),
        // This is likely a mistake! `Transform::rotate_z()` returns a unit `()`, not a
        // `Transform`! As such, no `Transform` will be inserted into the entity.
        Transform::from_translation(Vec3::new(0.75, 0.0, 0.0))
            .rotate_z(PI / 4.0),
    ));
}

Use instead:

fn spawn(mut commands: Commands) {
    // `Commands::spawn_empty()` is preferred if you do not need any components.
    commands.spawn_empty();

    commands.spawn((
        Name::new("Decal"),
        // `Transform::with_rotation()` returns a `Transform`, which was likely the intended
        // behavior.
        Transform::from_translation(Vec3::new(0.75, 0.0, 0.0))
            .with_rotation(Quat::from_rotation_z(PI / 4.0)),
    ));
}

Structs

InsertUnitBundle

Statics

INSERT_UNIT_BUNDLE

Click me for more information.