lillinput 0.3.0

Library for connecting libinput gestures to i3 and others
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! Components for representing actions.

pub mod commandaction;
pub mod errors;
pub mod i3action;

pub use crate::actions::commandaction::CommandAction;
pub use crate::actions::errors::ActionError;
pub use crate::actions::i3action::{I3Action, SharedConnection};

use std::fmt;
use strum::{Display, EnumString, EnumVariantNames};

/// Possible choices for action types.
#[derive(Display, EnumString, EnumVariantNames)]
#[strum(serialize_all = "kebab_case")]
pub enum ActionType {
    /// Action for interacting with `i3`.
    I3,
    /// Action for executing commands.
    Command,
}

/// Handler for a single action triggered by an event.
pub trait Action: std::fmt::Debug {
    /// Execute the command for this action.
    ///
    /// # Errors
    ///
    /// Returns `Err` if the execution of the command was not successful.
    fn execute_command(&mut self) -> Result<(), ActionError>;
    /// Format the contents of the action as a [`String`].
    ///
    /// # Errors
    ///
    /// Returns `Err` if the action cannot be formatted as a [`String`].
    fn fmt_command(&self, f: &mut fmt::Formatter) -> fmt::Result;
}

impl fmt::Display for dyn Action {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        // Delegate on the structs specific `fmt` implementation.
        self.fmt_command(f)
    }
}