GSettings Macro

Macro for easy 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 Rust code. 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 code for each key for following gio::Settings methods:

• set -> set_#key, which panics when writing in a readonly key, and try_set_#key, which behaves the same as the original method.
• get -> get_#key
• connect_changed -> connect_#key_changed
• bind -> bind_#key
• create_action -> create_#key_action

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

• Add bind_#key writable, default_#key_value, user_#key_value, reset_#key, connect_#key_writable_changed variants