Remove `rustc_feature::State`.

`State` is used to distinguish active vs accepted vs removed features.
However, these can also be distinguished by their location, in
`ACTIVE_FEATURES`, `ACCEPTED_FEATURES`, and `REMOVED_FEATURES`.

So this commit removes `State` and moves the internals of its variants
next to the `Feature` in each element of `*_FEATURES`, introducing new
types `ActiveFeature` and `RemovedFeature`. (There is no need for
`AcceptedFeature` because `State::Accepted` had no fields.)

This is a tighter type representation, avoids the need for some runtime
checks, and makes the code a bit shorter.
This commit is contained in:
Nicholas Nethercote 2023-10-05 18:59:01 +11:00
parent 64368d0279
commit 41b6899487
5 changed files with 61 additions and 97 deletions

View File

@ -14,12 +14,12 @@ use rustc_ast::{self as ast, AttrStyle, Attribute, HasAttrs, HasTokens, MetaItem
use rustc_attr as attr; use rustc_attr as attr;
use rustc_data_structures::flat_map_in_place::FlatMapInPlace; use rustc_data_structures::flat_map_in_place::FlatMapInPlace;
use rustc_data_structures::fx::FxHashSet; use rustc_data_structures::fx::FxHashSet;
use rustc_feature::{Feature, Features, State as FeatureState}; use rustc_feature::Features;
use rustc_feature::{ACCEPTED_FEATURES, ACTIVE_FEATURES, REMOVED_FEATURES}; use rustc_feature::{ACCEPTED_FEATURES, ACTIVE_FEATURES, REMOVED_FEATURES};
use rustc_parse::validate_attr; use rustc_parse::validate_attr;
use rustc_session::parse::feature_err; use rustc_session::parse::feature_err;
use rustc_session::Session; use rustc_session::Session;
use rustc_span::edition::{Edition, ALL_EDITIONS}; use rustc_span::edition::ALL_EDITIONS;
use rustc_span::symbol::{sym, Symbol}; use rustc_span::symbol::{sym, Symbol};
use rustc_span::Span; use rustc_span::Span;
use thin_vec::ThinVec; use thin_vec::ThinVec;
@ -36,16 +36,6 @@ pub struct StripUnconfigured<'a> {
} }
pub fn features(sess: &Session, krate_attrs: &[Attribute]) -> Features { pub fn features(sess: &Session, krate_attrs: &[Attribute]) -> Features {
fn active_features_up_to(edition: Edition) -> impl Iterator<Item = &'static Feature> {
ACTIVE_FEATURES.iter().filter(move |feature| {
if let Some(feature_edition) = feature.edition {
feature_edition <= edition
} else {
false
}
})
}
fn feature_list(attr: &Attribute) -> ThinVec<ast::NestedMetaItem> { fn feature_list(attr: &Attribute) -> ThinVec<ast::NestedMetaItem> {
if attr.has_name(sym::feature) if attr.has_name(sym::feature)
&& let Some(list) = attr.meta_item_list() && let Some(list) = attr.meta_item_list()
@ -83,11 +73,13 @@ pub fn features(sess: &Session, krate_attrs: &[Attribute]) -> Features {
// Enable edition-dependent features based on `features_edition`. // Enable edition-dependent features based on `features_edition`.
// - E.g. enable `test_2018_feature` if `features_edition` is 2018 or higher // - E.g. enable `test_2018_feature` if `features_edition` is 2018 or higher
let mut edition_enabled_features = FxHashSet::default(); let mut edition_enabled_features = FxHashSet::default();
for feature in active_features_up_to(features_edition) { for f in ACTIVE_FEATURES {
// FIXME(Manishearth) there is currently no way to set lib features by if let Some(edition) = f.feature.edition && edition <= features_edition {
// edition. // FIXME(Manishearth) there is currently no way to set lib features by
edition_enabled_features.insert(feature.name); // edition.
feature.set(&mut features); edition_enabled_features.insert(f.feature.name);
(f.set_enabled)(&mut features);
}
} }
// Process all features declared in the code. // Process all features declared in the code.
@ -147,19 +139,17 @@ pub fn features(sess: &Session, krate_attrs: &[Attribute]) -> Features {
} }
// If the declared feature has been removed, issue an error. // If the declared feature has been removed, issue an error.
if let Some(Feature { state, .. }) = REMOVED_FEATURES.iter().find(|f| name == f.name) { if let Some(f) = REMOVED_FEATURES.iter().find(|f| name == f.feature.name) {
if let FeatureState::Removed { reason } = state { sess.emit_err(FeatureRemoved {
sess.emit_err(FeatureRemoved { span: mi.span(),
span: mi.span(), reason: f.reason.map(|reason| FeatureRemovedReason { reason }),
reason: reason.map(|reason| FeatureRemovedReason { reason }), });
}); continue;
continue;
}
} }
// If the declared feature is stable, record it. // If the declared feature is stable, record it.
if let Some(Feature { since, .. }) = ACCEPTED_FEATURES.iter().find(|f| name == f.name) { if let Some(f) = ACCEPTED_FEATURES.iter().find(|f| name == f.name) {
let since = Some(Symbol::intern(since)); let since = Some(Symbol::intern(f.since));
features.set_declared_lang_feature(name, mi.span(), since); features.set_declared_lang_feature(name, mi.span(), since);
continue; continue;
} }
@ -175,8 +165,8 @@ pub fn features(sess: &Session, krate_attrs: &[Attribute]) -> Features {
} }
// If the declared feature is unstable, record it. // If the declared feature is unstable, record it.
if let Some(f) = ACTIVE_FEATURES.iter().find(|f| name == f.name) { if let Some(f) = ACTIVE_FEATURES.iter().find(|f| name == f.feature.name) {
f.set(&mut features); (f.set_enabled)(&mut features);
features.set_declared_lang_feature(name, mi.span(), None); features.set_declared_lang_feature(name, mi.span(), None);
continue; continue;
} }

View File

@ -1,6 +1,6 @@
//! List of the accepted feature gates. //! List of the accepted feature gates.
use super::{to_nonzero, Feature, State}; use super::{to_nonzero, Feature};
use rustc_span::symbol::sym; use rustc_span::symbol::sym;
macro_rules! declare_features { macro_rules! declare_features {
@ -9,15 +9,12 @@ macro_rules! declare_features {
)+) => { )+) => {
/// Those language feature has since been Accepted (it was once Active) /// Those language feature has since been Accepted (it was once Active)
pub const ACCEPTED_FEATURES: &[Feature] = &[ pub const ACCEPTED_FEATURES: &[Feature] = &[
$( $(Feature {
Feature { name: sym::$feature,
state: State::Accepted, since: $ver,
name: sym::$feature, issue: to_nonzero($issue),
since: $ver, edition: None,
issue: to_nonzero($issue), }),+
edition: None,
}
),+
]; ];
} }
} }

View File

@ -1,12 +1,17 @@
//! List of the active feature gates. //! List of the active feature gates.
use super::{to_nonzero, Feature, State}; use super::{to_nonzero, Feature};
use rustc_data_structures::fx::FxHashSet; use rustc_data_structures::fx::FxHashSet;
use rustc_span::edition::Edition; use rustc_span::edition::Edition;
use rustc_span::symbol::{sym, Symbol}; use rustc_span::symbol::{sym, Symbol};
use rustc_span::Span; use rustc_span::Span;
pub struct ActiveFeature {
pub feature: Feature,
pub set_enabled: fn(&mut Features),
}
#[derive(PartialEq)] #[derive(PartialEq)]
enum FeatureStatus { enum FeatureStatus {
Default, Default,
@ -32,21 +37,18 @@ macro_rules! declare_features {
)+) => { )+) => {
/// Represents active features that are currently being implemented or /// Represents active features that are currently being implemented or
/// currently being considered for addition/removal. /// currently being considered for addition/removal.
pub const ACTIVE_FEATURES: pub const ACTIVE_FEATURES: &[ActiveFeature] = &[
&[Feature] = $(ActiveFeature {
&[$( feature: Feature {
// (sym::$feature, $ver, $issue, $edition, set!($feature))
Feature {
state: State::Active {
// Sets this feature's corresponding bool within `features`.
set: |features| features.$feature = true,
},
name: sym::$feature, name: sym::$feature,
since: $ver, since: $ver,
issue: to_nonzero($issue), issue: to_nonzero($issue),
edition: $edition, edition: $edition,
} },
),+]; // Sets this feature's corresponding bool within `features`.
set_enabled: |features| features.$feature = true,
}),+
];
/// A set of features to be used by later passes. /// A set of features to be used by later passes.
#[derive(Clone, Default, Debug)] #[derive(Clone, Default, Debug)]
@ -134,16 +136,6 @@ macro_rules! declare_features {
}; };
} }
impl Feature {
/// Sets this feature in `Features`. Panics if called on a non-active feature.
pub fn set(&self, features: &mut Features) {
match self.state {
State::Active { set } => set(features),
_ => panic!("called `set` on feature `{}` which is not `active`", self.name),
}
}
}
// See https://rustc-dev-guide.rust-lang.org/feature-gates.html#feature-gates for more // See https://rustc-dev-guide.rust-lang.org/feature-gates.html#feature-gates for more
// documentation about handling feature gates. // documentation about handling feature gates.
// //

View File

@ -24,29 +24,10 @@ mod removed;
mod tests; mod tests;
use rustc_span::{edition::Edition, symbol::Symbol}; use rustc_span::{edition::Edition, symbol::Symbol};
use std::fmt;
use std::num::NonZeroU32; use std::num::NonZeroU32;
#[derive(Clone, Copy)]
pub enum State {
Accepted,
Active { set: fn(&mut Features) },
Removed { reason: Option<&'static str> },
}
impl fmt::Debug for State {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
State::Accepted { .. } => write!(f, "accepted"),
State::Active { .. } => write!(f, "active"),
State::Removed { .. } => write!(f, "removed"),
}
}
}
#[derive(Debug, Clone)] #[derive(Debug, Clone)]
pub struct Feature { pub struct Feature {
pub state: State,
pub name: Symbol, pub name: Symbol,
pub since: &'static str, pub since: &'static str,
issue: Option<NonZeroU32>, issue: Option<NonZeroU32>,
@ -106,17 +87,16 @@ impl UnstableFeatures {
fn find_lang_feature_issue(feature: Symbol) -> Option<NonZeroU32> { fn find_lang_feature_issue(feature: Symbol) -> Option<NonZeroU32> {
// Search in all the feature lists. // Search in all the feature lists.
let found = [] if let Some(f) = ACTIVE_FEATURES.iter().find(|f| f.feature.name == feature) {
.iter() return f.feature.issue;
.chain(ACTIVE_FEATURES)
.chain(ACCEPTED_FEATURES)
.chain(REMOVED_FEATURES)
.find(|t| t.name == feature);
match found {
Some(found) => found.issue,
None => panic!("feature `{feature}` is not declared anywhere"),
} }
if let Some(f) = ACCEPTED_FEATURES.iter().find(|f| f.name == feature) {
return f.issue;
}
if let Some(f) = REMOVED_FEATURES.iter().find(|f| f.feature.name == feature) {
return f.feature.issue;
}
panic!("feature `{feature}` is not declared anywhere");
} }
const fn to_nonzero(n: Option<u32>) -> Option<NonZeroU32> { const fn to_nonzero(n: Option<u32>) -> Option<NonZeroU32> {

View File

@ -1,23 +1,28 @@
//! List of the removed feature gates. //! List of the removed feature gates.
use super::{to_nonzero, Feature, State}; use super::{to_nonzero, Feature};
use rustc_span::symbol::sym; use rustc_span::symbol::sym;
pub struct RemovedFeature {
pub feature: Feature,
pub reason: Option<&'static str>,
}
macro_rules! declare_features { macro_rules! declare_features {
($( ($(
$(#[doc = $doc:tt])* (removed, $feature:ident, $ver:expr, $issue:expr, None, $reason:expr), $(#[doc = $doc:tt])* (removed, $feature:ident, $ver:expr, $issue:expr, None, $reason:expr),
)+) => { )+) => {
/// Represents unstable features which have since been removed (it was once Active) /// Represents unstable features which have since been removed (it was once Active)
pub const REMOVED_FEATURES: &[Feature] = &[ pub const REMOVED_FEATURES: &[RemovedFeature] = &[
$( $(RemovedFeature {
Feature { feature: Feature {
state: State::Removed { reason: $reason },
name: sym::$feature, name: sym::$feature,
since: $ver, since: $ver,
issue: to_nonzero($issue), issue: to_nonzero($issue),
edition: None, edition: None,
} },
),+ reason: $reason
}),+
]; ];
}; };
} }