Struct RemapProfile 

pub struct RemapProfile {
    pub name: String,
    pub remaps: Arc<RwLock<HashMap<Key, Key>>>,
    /* private fields */
}

A pre-validated remap profile for fast switching

RemapProfile stores key remappings that have been validated at creation time. This enables atomic profile switching via Arc pointer exchange (O(1) operation).

Examples

let profile = RemapProfile::new("gaming", &config)?;
// remaps is Arc<RwLock<HashMap<Key, Key>>> - ready for O(1) lookup

Fields

name: String

Profile name for identification

remaps: Arc<RwLock<HashMap<Key, Key>>>

Pre-validated remappings from input to output key codes Arc enables cheap cloning for profile switching

Implementations

impl RemapProfile

pub fn new( name: String, config: &HashMap<String, String>, ) -> Result<Self, RemapError>

Create a new RemapProfile from a configuration HashMap

This method validates all key names before creating the profile. If any key name is invalid, the profile creation fails.

Arguments

• name - Profile name for identification
• config - HashMap of key name pairs (input -> output)

Returns

• Ok(RemapProfile) - Profile with validated remappings
• Err(RemapError) - Invalid key name

Examples

let mut config = HashMap::new();
config.insert("capslock".to_string(), "leftctrl".to_string());
let profile = RemapProfile::new("work", &config)?;

pub fn with_key_parser( name: String, config: &HashMap<String, String>, key_parser: Arc<KeyParser>, ) -> Result<Self, RemapError>

Create a new RemapProfile with a shared key parser

This allows sharing a KeyParser instance across multiple components, reducing memory overhead when creating many profiles.

Arguments

• name - Profile name for identification
• config - HashMap of key name pairs (input -> output)
• key_parser - Shared KeyParser instance

pub fn name(&self) -> &str

Get the profile name

pub async fn remap_count(&self) -> usize

Get the number of remappings in this profile

pub async fn has_remap(&self, key_code: Key) -> bool

Check if a specific key has a remapping

pub async fn get_remaps(&self) -> HashMap<Key, Key>

Get a clone of the remappings HashMap

pub fn remaps_arc(&self) -> &Arc<RwLock<HashMap<Key, Key>>>

Get a reference to the shared remappings Arc

This is used for atomic profile switching via Arc pointer exchange. The Arc<RwLock<>> wrapper allows cheap cloning for profile switching.

Examples

let profile = RemapProfile::new("gaming".to_string(), &config)?;
let remaps_arc = profile.remaps_arc();
// Clone Arc for atomic pointer swap (O(1) operation)
let cloned = Arc::clone(remaps_arc);

pub fn key_parser(&self) -> &Arc<KeyParser>

Get the key parser

Trait Implementations

impl Clone for RemapProfile

fn clone(&self) -> RemapProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemapProfile

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

Formats the value using the given formatter.