506f69aed7
There are 6 new compiler recognised attributes: deprecated, experimental,
unstable, stable, frozen, locked (these levels are taken directly from
Node's "stability index"[1]). These indicate the stability of the
item to which they are attached; e.g. `#[deprecated] fn foo() { .. }`
says that `foo` is deprecated.
This comes with 3 lints for the first 3 levels (with matching names) that
will detect the use of items marked with them (the `unstable` lint
includes items with no stability attribute). The attributes can be given
a short text note that will be displayed by the lint. An example:
#[warn(unstable)]; // `allow` by default
#[deprecated="use `bar`"]
fn foo() { }
#[stable]
fn bar() { }
fn baz() { }
fn main() {
foo(); // "warning: use of deprecated item: use `bar`"
bar(); // all fine
baz(); // "warning: use of unmarked item"
}
The lints currently only check the "edges" of the AST: i.e. functions,
methods[2], structs and enum variants. Any stability attributes on modules,
enums, traits and impls are not checked.
[1]: http://nodejs.org/api/documentation.html
[2]: the method check is currently incorrect and doesn't work.
163 lines
3.4 KiB
Rust
163 lines
3.4 KiB
Rust
// Copyright 2013 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
#[link(name = "lint_stability",
|
|
vers = "0.1")];
|
|
#[crate_type = "lib"];
|
|
|
|
#[deprecated]
|
|
pub fn deprecated() {}
|
|
#[deprecated="text"]
|
|
pub fn deprecated_text() {}
|
|
|
|
#[experimental]
|
|
pub fn experimental() {}
|
|
#[experimental="text"]
|
|
pub fn experimental_text() {}
|
|
|
|
#[unstable]
|
|
pub fn unstable() {}
|
|
#[unstable="text"]
|
|
pub fn unstable_text() {}
|
|
|
|
pub fn unmarked() {}
|
|
|
|
#[stable]
|
|
pub fn stable() {}
|
|
#[stable="text"]
|
|
pub fn stable_text() {}
|
|
|
|
#[locked]
|
|
pub fn locked() {}
|
|
#[locked="text"]
|
|
pub fn locked_text() {}
|
|
|
|
#[frozen]
|
|
pub fn frozen() {}
|
|
#[frozen="text"]
|
|
pub fn frozen_text() {}
|
|
|
|
#[stable]
|
|
pub struct MethodTester;
|
|
|
|
impl MethodTester {
|
|
#[deprecated]
|
|
pub fn method_deprecated(&self) {}
|
|
#[deprecated="text"]
|
|
pub fn method_deprecated_text(&self) {}
|
|
|
|
#[experimental]
|
|
pub fn method_experimental(&self) {}
|
|
#[experimental="text"]
|
|
pub fn method_experimental_text(&self) {}
|
|
|
|
#[unstable]
|
|
pub fn method_unstable(&self) {}
|
|
#[unstable="text"]
|
|
pub fn method_unstable_text(&self) {}
|
|
|
|
pub fn method_unmarked(&self) {}
|
|
|
|
#[stable]
|
|
pub fn method_stable(&self) {}
|
|
#[stable="text"]
|
|
pub fn method_stable_text(&self) {}
|
|
|
|
#[locked]
|
|
pub fn method_locked(&self) {}
|
|
#[locked="text"]
|
|
pub fn method_locked_text(&self) {}
|
|
|
|
#[frozen]
|
|
pub fn method_frozen(&self) {}
|
|
#[frozen="text"]
|
|
pub fn method_frozen_text(&self) {}
|
|
}
|
|
|
|
pub trait Trait {
|
|
#[deprecated]
|
|
fn trait_deprecated(&self) {}
|
|
#[deprecated="text"]
|
|
fn trait_deprecated_text(&self) {}
|
|
|
|
#[experimental]
|
|
fn trait_experimental(&self) {}
|
|
#[experimental="text"]
|
|
fn trait_experimental_text(&self) {}
|
|
|
|
#[unstable]
|
|
fn trait_unstable(&self) {}
|
|
#[unstable="text"]
|
|
fn trait_unstable_text(&self) {}
|
|
|
|
fn trait_unmarked(&self) {}
|
|
|
|
#[stable]
|
|
fn trait_stable(&self) {}
|
|
#[stable="text"]
|
|
fn trait_stable_text(&self) {}
|
|
|
|
#[locked]
|
|
fn trait_locked(&self) {}
|
|
#[locked="text"]
|
|
fn trait_locked_text(&self) {}
|
|
|
|
#[frozen]
|
|
fn trait_frozen(&self) {}
|
|
#[frozen="text"]
|
|
fn trait_frozen_text(&self) {}
|
|
}
|
|
|
|
impl Trait for MethodTester {}
|
|
|
|
#[deprecated]
|
|
pub struct DeprecatedStruct { i: int }
|
|
#[experimental]
|
|
pub struct ExperimentalStruct { i: int }
|
|
#[unstable]
|
|
pub struct UnstableStruct { i: int }
|
|
pub struct UnmarkedStruct { i: int }
|
|
#[stable]
|
|
pub struct StableStruct { i: int }
|
|
#[frozen]
|
|
pub struct FrozenStruct { i: int }
|
|
#[locked]
|
|
pub struct LockedStruct { i: int }
|
|
|
|
#[deprecated]
|
|
pub struct DeprecatedUnitStruct;
|
|
#[experimental]
|
|
pub struct ExperimentalUnitStruct;
|
|
#[unstable]
|
|
pub struct UnstableUnitStruct;
|
|
pub struct UnmarkedUnitStruct;
|
|
#[stable]
|
|
pub struct StableUnitStruct;
|
|
#[frozen]
|
|
pub struct FrozenUnitStruct;
|
|
#[locked]
|
|
pub struct LockedUnitStruct;
|
|
|
|
pub enum Enum {
|
|
#[deprecated]
|
|
DeprecatedVariant,
|
|
#[experimental]
|
|
ExperimentalVariant,
|
|
#[unstable]
|
|
UnstableVariant,
|
|
|
|
UnmarkedVariant,
|
|
#[stable]
|
|
StableVariant,
|
|
#[frozen]
|
|
FrozenVariant,
|
|
#[locked]
|
|
LockedVariant,
|
|
}
|