layaway 0.2.0

Layout creation for Sway via a relative and human-readable DSL.
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
87
88
89
90
91
92
93
94

//! Creates and converts between
//!
//! - [`relative::Layout`], which is a logical description
//!   of how screens should be ordered, and
//! - [`absolute::Layout`], which is a physical description
//!   of at which pixel position and size each screen is
//!
//! See [`parse`] for a description of the format
//! which one can [`str::parse`] into [`relative::Layout`]
//!
//! Note: Conversion via [`relative::Layout::to_absolute`]
//! is not pure, but dependent on the currently running WM
//! to get screen resolutions and the works.
//!
//! Currently only support for Sway is implemented,
//! however, feel feel free to take a look inside [`comms`]
//! and open an issue or send a PR
//! if you'd like to add support for another WM!

pub mod absolute;
pub mod comms;
pub mod config;
pub mod convert;
pub mod geometry;
pub mod info;
pub mod parse;
pub mod relative;

use std::collections::BTreeMap;

use clap::{ArgAction, Parser};
use config::{Config, LayoutDesc};
use eyre::{Context, ContextCompat, Result};

pub type Map<K, V> = BTreeMap<K, V>;

/// Calculates the physical screen layout given a short relative layout description.
#[derive(Debug, Parser)]
pub struct Args {
    #[allow(rustdoc::bare_urls)]
    /// Instead of using the machine-specific layout description from the config file,
    /// use the given layout description.
    ///
    /// See the README at <https://github.com/MultisampledNight/layaway>
    /// for details on the format.
    ///
    /// By default, the config file (`~/.config/layaway/config.toml` on Linux in most cases)
    /// is used to look up the layout description for the given hostname.
    desc: Option<LayoutDesc>,

    /// Instead of applying the calculated layout,
    /// print the corresponding WM configuration to stdout.
    ///
    /// By default, the calculated layout is directly applied to the WM,
    /// so that it becomes effective.
    #[arg(short = 'n', long = "no-apply", action = ArgAction::SetFalse)]
    apply: bool,
}

pub fn run() -> Result<()> {
    let args = Args::parse();

    let desc = args.desc.map_or_else(desc_from_config, Ok)?;

    let relative: relative::Layout = desc
        .parse()
        .context("Could not parse relative layout description")?;

    let mut comms = comms::establish().context("Could not establish connection to WM")?;
    let layout = relative
        .to_absolute(comms.as_mut())
        .context("Could not absolutize layout")?;

    if args.apply {
        comms
            .set_layout(&layout)
            .context("Could not set layout in WM")?;
    } else {
        for cmd in layout.to_sway_commands() {
            println!("{cmd}");
        }
    }

    Ok(())
}

pub fn desc_from_config() -> Result<LayoutDesc> {
    let config = Config::new()?;
    let desc = config
        .machine_layout()
        .context("Could not determine hostname to decide which layout to load")?
        .context("Config file does not define layout for this machine")?;
    Ok(desc.to_string())
}