tenacious 0.2.3

[RETIRED: Will not work with MIR] A plugin to prevent certain types from being moved
docs.rs failed to build tenacious-0.2.3
Please check the build logs and, if you believe this is docs.rs' fault, open an issue.

This crate is retired, since it will no longer work with MIR

rust-tenacious

Build Status

This plugin warns when types marked #[no_move] are being moved.

This is quite useful for ensuring that things don't get moved around when data is shared via an FFI. Servo uses this for safely sharing rooted values with the spidermonkey GC.

Note that #[no_move] is transitive, any struct or enum containing a #[no_move] type must be annotated as well. Similarly, any type with #[no_move] substitutions in its type parameters (E.g. Vec<Foo> where Foo is no_move) will be treated as immovable.

Example:

#![plugin(tenacious)]
#![feature(custom_attribute, plugin)]

#[no_move]
#[derive(Debug)]
struct Foo;

fn main() {
    let x = Foo;
    let y = x; // warning
    bar(Some(y)); // warning   
}

fn bar(t: Option<Foo>) {
    match t {
        Some(foo) => { // warning
            println!("{:?}", foo)
        },
        _ => ()
    }

}

struct MoreFoo {
    foos: Vec<Foo> // warning
}

#[no_move]
struct MoreFoo2 {
    foos: Vec<Foo> // no warning
}

Note that this will not lint on the moving of temporaries (though it's easy to tweak it to do so). For example, if foo() returns a move-protected value, bar(foo()) will not error even though let x = foo(); bar(x) will, since the value returned by foo() is a temporary (rvalue) and doesn't actualy get moved in memory.

It also will not catch moves within generic functions like mem::swap() and `mem::replace()``

Adding the #[allow(moved_no_move)] annotation to a struct will suppress warnings that the struct contains a #[no_move] type but is not marked as #[no_move]. The #[allow_movable_interior] attribute does the above and additionally permits moveable types in type parameters. See tests/run-pass/allow-move.rs for examples.

Be aware that if you depend on a crate using #[no_move], you must have #![plugin(tenacious)] in your own crate to see the warnings.