Adopt XDG base directories for ~/.aqomui #175

New issue

Open

opened 2026-08-27 13:20:32 -04:00 by mysticalsoap · 0 comments

mysticalsoap commented

2026-08-27 13:20:32 -04:00

Owner

/.aqomui predates the XDG base-directory spec. Its contents — server.json, protocol.json, profile.json, bypass_apps.json, last_server.json, firewall_temp.json, temp/ — are all app-managed state, none hand-edited config, so the honest home is $XDG_STATE_HOME/aqomui (/.local/state) rather than ~/.config; a config/data split for its own sake buys nothing.

Portability: $XDG_STATE_HOME is in the spec since v0.8 (2021) and the spec defines the unset-or-empty fallback, so no library support is needed:

os.environ.get("XDG_STATE_HOME") or os.path.expanduser("~/.local/state")

Mechanics: HOMEDIR and the per-file constants live in config.py since #173, so the move is one constant plus a migrate-if-old-dir-exists on first run. The service shares the convention through homedirs.json (it resolves users' .aqomui dirs), so the gui, cli and service change together — tangle with #174, whichever lands first.

~/.aqomui predates the XDG base-directory spec. Its contents — server.json, protocol.json, profile.json, bypass_apps.json, last_server.json, firewall_temp.json, temp/ — are all app-managed state, none hand-edited config, so the honest home is $XDG_STATE_HOME/aqomui (~/.local/state) rather than ~/.config; a config/data split for its own sake buys nothing. Portability: $XDG_STATE_HOME is in the spec since v0.8 (2021) and the spec defines the unset-or-empty fallback, so no library support is needed: os.environ.get("XDG_STATE_HOME") or os.path.expanduser("~/.local/state") Mechanics: HOMEDIR and the per-file constants live in config.py since #173, so the move is one constant plus a migrate-if-old-dir-exists on first run. The service shares the convention through homedirs.json (it resolves users' .aqomui dirs), so the gui, cli and service change together — tangle with #174, whichever lands first.

mysticalsoap added the

architecture

cleanup

labels

2026-08-27 13:20:32 -04:00

mysticalsoap referenced this issue

2026-08-27 13:20:43 -04:00

Move service runtime state out of /usr/share/aqomui #174