compiler/rustc_span/src/edition.rs

   1 use crate::symbol::{sym, Symbol};
   2 use std::fmt;
   3 use std::str::FromStr;
   4
   5 use rustc_macros::HashStable_Generic;
   6
   7 /// The edition of the compiler. (See [RFC 2052](https://github.com/rust-lang/rfcs/blob/master/text/2052-epochs.md).)
   8 #[derive(Clone, Copy, Hash, PartialEq, PartialOrd, Debug, Encodable, Decodable, Eq)]
   9 #[derive(HashStable_Generic)]
  10 pub enum Edition {
  11     // When adding new editions, be sure to do the following:
  12     //
  13     // - update the `ALL_EDITIONS` const
  14     // - update the `EDITION_NAME_LIST` const
  15     // - add a `rust_####()` function to the session
  16     // - update the enum in Cargo's sources as well
  17     //
  18     // Editions *must* be kept in order, oldest to newest.
  19     /// The 2015 edition
  20     Edition2015,
  21     /// The 2018 edition
  22     Edition2018,
  23     /// The 2021 edition
  24     Edition2021,
  25 }
  26
  27 // Must be in order from oldest to newest.
  28 pub const ALL_EDITIONS: &[Edition] =
  29     &[Edition::Edition2015, Edition::Edition2018, Edition::Edition2021];
  30
  31 pub const EDITION_NAME_LIST: &str = "2015|2018|2021";
  32
  33 pub const DEFAULT_EDITION: Edition = Edition::Edition2015;
  34
  35 pub const LATEST_STABLE_EDITION: Edition = Edition::Edition2018;
  36
  37 impl fmt::Display for Edition {
  38     fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
  39         let s = match *self {
  40             Edition::Edition2015 => "2015",
  41             Edition::Edition2018 => "2018",
  42             Edition::Edition2021 => "2021",
  43         };
  44         write!(f, "{}", s)
  45     }
  46 }
  47
  48 impl Edition {
  49     pub fn lint_name(&self) -> &'static str {
  50         match *self {
  51             Edition::Edition2015 => "rust_2015_compatibility",
  52             Edition::Edition2018 => "rust_2018_compatibility",
  53             Edition::Edition2021 => "rust_2021_compatibility",
  54         }
  55     }
  56
  57     pub fn feature_name(&self) -> Symbol {
  58         match *self {
  59             Edition::Edition2015 => sym::rust_2015_preview,
  60             Edition::Edition2018 => sym::rust_2018_preview,
  61             Edition::Edition2021 => sym::rust_2021_preview,
  62         }
  63     }
  64
  65     pub fn is_stable(&self) -> bool {
  66         match *self {
  67             Edition::Edition2015 => true,
  68             Edition::Edition2018 => true,
  69             Edition::Edition2021 => false,
  70         }
  71     }
  72 }
  73
  74 impl FromStr for Edition {
  75     type Err = ();
  76     fn from_str(s: &str) -> Result<Self, ()> {
  77         match s {
  78             "2015" => Ok(Edition::Edition2015),
  79             "2018" => Ok(Edition::Edition2018),
  80             "2021" => Ok(Edition::Edition2021),
  81             _ => Err(()),
  82         }
  83     }
  84 }