GSettings Macro

Macro for typesafe GSettings key access

The macro's main purpose is to reduce the risk of mistyping a key, using the wrong method to access values, inputing incorrect values, and reduce boilerplate. Additionally, the summary, the description, and the default of the value are included in the documentation of each generated methods. This would be beneficial if you use tools like rust-analyzer.

Example

```rust use gsettingsmacro::gensettings;

use std::path::{Path, PathBuf};

[gen_settings(

file = "./tests/io.github.seadve.test.gschema.xml",
id = "io.github.seadve.test"

)]

[gensettingsdefine(

key_name = "cache-dir",
arg_type = "&Path",
ret_type = "PathBuf"

)]

[gensettingsskip(signature = "ay")]

pub struct ApplicationSettings;

let settings = ApplicationSettings::default();

// i DBus type settings.setwindowwidth(100); asserteq!(settings.windowwidth(), 100)

// enums settings.setalertsound(AlertSound::Glass); asserteq!(settings.alertsound(), AlertSound::Glass);

// bitflags settings.setspacestyle(SpaceStyle::BEFORECOLON | SpaceStyle::BEFORECOMMA); asserteq!( settings.spacestyle(), SpaceStyle::BEFORECOLON | SpaceStyle::BEFORECOMMA );

// customly defined settings.setcachedir(Path::new("/somedir/")); asserteq!(settings.cachedir(), PathBuf::from("/somedir/")); ```

For more examples and detailed information see the documentation.

Generated methods

The procedural macro generates the following [gio::Settings] methods for each key in the schema:

• set -> set_${key}, which panics when writing in a readonly key, and try_set_${key}, which behaves the same as the original method.
• get -> ${key}
• connect_changed -> connect_${key}_changed
• bind -> bind_${key}
• create_action -> create_${key}_action
• default_value -> ${key}_default_value
• reset -> reset_${key}

Known issues

• Not updating when the gschema file is modified
  • Use hacks like include_str!
  • See https://github.com/rust-lang/rust/issues/73921 or https://github.com/rust-lang/rust/issues/55904

Todos

• Remove serde dependency
• Add way to map setter and getters value
• Add bind_#key writable, user_#key_value, connect_#key_writable_changed variants