Enum KeyMap 

#[non_exhaustive]
pub enum KeyMap {
    AsWritten,
    PortableShortcuts,
}

How Windows modifier names translate on macOS.

{CTRLDOWN}c{CTRLUP} means Copy on Windows and Control-C on macOS, where Copy is Command-C. There is no reading of that sequence that is right on both platforms, so this makes the choice explicit rather than guessing.

// The default: CTRL means Control. A shortcut written for Windows will
// not do what it did there, and will do so loudly.
assert_eq!(Options::default().key_map, KeyMap::AsWritten);

Which to choose

If your {CTRLDOWN}...{CTRLUP} sequences are all editing shortcuts — copy, paste, select-all, save — PortableShortcuts is what you want, and it is a one-line change.

If any of them mean Control literally — a terminal’s Ctrl-C, an application’s own Control binding — leave the default and translate those call sites deliberately. Silent remapping would turn “interrupt this process” into “copy”, which is not a bug anyone enjoys finding.

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.

AsWritten

Names mean what they say: CTRL is Control, ALT is Option, LWIN is Command.

The default, because a shortcut that quietly does something else is worse than one that plainly does nothing.

PortableShortcuts

Translates Windows shortcut intent to the macOS equivalent.

written	AsWritten	PortableShortcuts
CTRL	Control	Command
ALT	Option	Option
LWIN / RWIN	Command	Control

CTRL and the Windows key swap places, which is what makes {CTRLDOWN}c{CTRLUP} copy and {LWINDOWN}... reach the Control-key bindings it would have reached on Windows.

Trait Implementations

impl Clone for KeyMap

fn clone(&self) -> KeyMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for KeyMap

impl Debug for KeyMap

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

Formats the value using the given formatter.

impl Default for KeyMap

fn default() -> KeyMap

Returns the “default value” for a type.

impl Eq for KeyMap

impl Hash for KeyMap

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 PartialEq for KeyMap

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for KeyMap