tmuxrs 0.1.1

A modern, Rust-based tmux session manager with centralized configuration and directory-aware execution. Drop-in replacement for tmuxinator.
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use crate::error::{Result, TmuxrsError};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;
use std::path::{Path, PathBuf};

#[derive(Debug, Deserialize, Serialize)]
pub struct Config {
    pub name: String,
    pub root: Option<String>,
    pub windows: Vec<WindowConfig>,
}

#[derive(Debug, Deserialize, Serialize)]
#[serde(untagged)]
pub enum WindowConfig {
    Simple(String),
    Complex {
        #[serde(flatten)]
        window: HashMap<String, String>,
    },
    WithLayout {
        #[serde(flatten)]
        window: HashMap<String, WindowLayout>,
    },
}

#[derive(Debug, Deserialize, Serialize)]
pub struct WindowLayout {
    pub layout: Option<String>,
    pub panes: Vec<String>,
}

impl Config {
    /// Detect session name from directory basename
    /// If path is None, uses current directory
    #[allow(dead_code)]
    pub fn detect_session_name(path: Option<&Path>) -> Result<String> {
        let dir = match path {
            Some(p) => p.to_path_buf(),
            None => std::env::current_dir()?,
        };
        let basename = dir
            .file_name()
            .and_then(|name| name.to_str())
            .ok_or_else(|| {
                TmuxrsError::ConfigNotFound("Could not determine directory name".to_string())
            })?;
        Ok(basename.to_string())
    }

    /// Get config file path for a session name
    #[allow(dead_code)]
    pub fn get_config_file_path(session_name: &str) -> Result<PathBuf> {
        let home_dir = dirs::home_dir().ok_or_else(|| {
            TmuxrsError::ConfigNotFound("Could not find home directory".to_string())
        })?;

        let config_dir = home_dir.join(".config").join("tmuxrs");
        let config_file = config_dir.join(format!("{session_name}.yml"));

        Ok(config_file)
    }

    /// Load configuration for a session
    #[allow(dead_code)]
    pub fn load(session_name: &str) -> Result<Config> {
        let config_path = Self::get_config_file_path(session_name)?;

        if !config_path.exists() {
            return Err(TmuxrsError::ConfigNotFound(format!(
                "Configuration file not found: {}",
                config_path.display()
            )));
        }

        Self::parse_file(&config_path)
    }

    /// Parse configuration from a YAML file
    #[allow(dead_code)]
    pub fn parse_file(file_path: &Path) -> Result<Config> {
        let content = std::fs::read_to_string(file_path)?;
        let config: Config = serde_yaml::from_str(&content)?;
        Ok(config)
    }
}