Enum Lint 

#[non_exhaustive]
pub enum Lint {
    ExtraId,
    UndeclaredVariable,
    UndeclaredMarkup,
    DroppedMarkup,
    DynamicSelect,
    BadOptionValue,
    GatedFunction,
    DoNotTranslate,
    DuplicateId,
    LocaleMismatch,
    UnknownFunction,
    MissingTranslation,
    NeutralNumbers,
    UnpairedMarkup,
    MissingPluralCategory,
    NonNfcSource,
    DroppedPlaceholder,
    UnknownOption,
    UnusedId,
    SuspiciousBidi,
    DynamicCurrency,
    DynamicUnit,
    NonstandardName,
}

One check mf2 check makes.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ExtraId

A translation has an id the source locale does not.

UndeclaredVariable

A translation uses a variable the source message does not declare. A language that needs more input (grammatical gender, say) gets it by the source declaring it with .input, even where its own pattern ignores it.

UndeclaredMarkup

A translation uses a markup name the source message does not.

DroppedMarkup

A translation leaves out markup the source message has: a {#link}terms{/link} gone from the French sentence takes the link away from French readers, and nothing at run time says so. An error by default, where a dropped placeholder is a warning — a plural variant routinely drops {$count} (“one” says “a message”), and nothing routinely drops a link; a corpus that drops emphasis on purpose may turn it down.

DynamicSelect

A select option is not a literal, so nothing can tell which rules a message selects by until it runs. An error by default: the catalog then has to carry both plural rule sets, and the message reports a Bad Option anyway. A corpus that means it may turn it down.

BadOptionValue

A well-known option has a literal value it cannot take. An error by default, though the runtime would report Bad Option on its own — the suite has messages that do exactly that on purpose.

GatedFunction

A function whose client feature is off — :percent, :currency and :unit without fn-number, :datetime, :date and :time without fn-datetime. A translation can never silently add formatting code to the wasm (plans/03-runtime.md §5.1).

DoNotTranslate

An entry marked @do-not-translate differs from the source’s.

DuplicateId

Two entries of one locale have the same id, so one of them would be silently dropped.

LocaleMismatch

A file declares an @locale other than the directory it sits in. An error by default — it is nearly always a copy that was never finished — but a corpus that keeps one locale’s files under another tag on purpose may turn it down.

UnknownFunction

A function no registered crate provides. An error by default and configurable, since custom functions are legal.

MissingTranslation

An id the source locale has and a translation does not: it falls back.

NeutralNumbers

A placeholder can receive a number and fn-number is off, so a number renders without the locale’s symbols. The build cannot see what an application passes, so a placeholder that only receives text raises it too.

UnpairedMarkup

Markup opened and not closed, or closed and not opened.

MissingPluralCategory

A plural .match that does not mention every category the target locale has.

NonNfcSource

Source text that is not in NFC.

DroppedPlaceholder

A placeholder the source has and a translation dropped.

UnknownOption

An option a built-in function does not define — dateStyle on :datetime, say. MF2 ignores it, so the message formats as though it were not there, and nothing at run time says so.

UnusedId

An id no tr! in the workspace names.

SuspiciousBidi

Unpaired bidi isolates in literal text.

DynamicCurrency

A :currency whose currency option is not a literal, so the catalog must carry every currency CLDR has; listing the codes it can hold in mf2.toml [locale_data] carries only those and silences this (plans/02-catalog-format.md §4.4).

DynamicUnit

The same for :unit.

NonstandardName

A variable, option, function, markup or attribute name that is not a Unicode identifier under MF2’s profile of UAX #31, uses a character UTS #39’s General Security Profile does not allow, or mixes scripts — syntax.md asks linters to warn on exactly these.

Implementations

impl Lint

pub const ALL: &'static [Lint]

Every lint, in declaration order.

pub fn name(self) -> &'static str

The name mf2.toml and a report use.

pub fn default_level(self) -> Level

What it does when mf2.toml says nothing.

pub fn floor(self) -> Level

The lowest level mf2.toml may set it to. A lint whose floor is Level::Error states a rule the rest of the pipeline relies on — a build that ignored it could not produce a correct catalog — so it cannot be turned down.

pub fn from_name(name: &str) -> Option<Lint>

The lint named name.

Trait Implementations

impl Clone for Lint

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Lint

impl Debug for Lint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Lint

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Lint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Lint

impl Hash for Lint

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Lint

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Lint

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Lint

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Lint

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Lint