Most applications provide you configuration files that are data / text based. Whether it is toml, JSON, yaml or some other format, you are usually defining values for pre-determined keys and that’s all.
This makes sense for many applications, but involved applications have explored configurations that make use of scripting. For example, vim uses VimScript, neovim uses Lua, but vscode uses json (as far as I remember), and Helix (vim inspired editor) argues editor configurations must be data, not scripting, and uses toml.
many tiling window managers use various programming languages (Qtile uses python, xmonad uses Haskell, Awesome uses Lua) while others stick to data configuration (i3).
Do you think that scriptable configuration is over-engineered and brings weaknesses, or is it warranted and grants the user power in these big applications? What are the benefits of scriptable configurations?
Turing Complete Configuration
- more extensible
- tend to be heavier
- harder to provide detailed error messages
- more difficult for new users
Data Based Configuration
- easier to use
- easier to provide documentation
- lighter to embed
- more limited usecases
For stuff like, say, configuring all of your systems and programs in one file, actual programming languages are really useful. coughnixcough
Just started going down the Nix rabbit hole and, yeah, it’s kinda annoying
I’ve become addicted to script-configured window managers. I won’t even try ones that aren’t, anymore.
Bash is a scripting language, so it qualifies per your description, but the main advantage is that anything you can do in the config, you can do on the CLI: these WMs also have first-class CLI tooling, a consequence of CLI-first design. All configuration is runtime adaptable, and although auto config reloading can get you there, it’s fantastic to be able to change a configuration without it having to be persisted in a file.
Seriously, next to tiling, scripted configuration is the most important feature of a WM. I haven’t encountered it outside of WMs very often, but for long running processes, it’s a great design.
Same here! I used to use BSPWM, but I since switched to RiverWM. It’s a lot like BSPWM, but for Wayland. Highly recommend
Apart from text editors/IDEs I don’t really see the use for it. I think it is not practical unless all your users are both power users and programmers, which basically boils down to developer tools.
I think the primary difference is that data based configuration is easier for software to modify and store.
scriptable configuration makes sense if you want to be able to extend or modify the program like with vim while data based configuration makes sense if your program is already extendable/configurable enough like with i3
I think data configuration is fine until you get to a point where you need functions. This is one of my pet peeves: data configuration formats that get creative to work around the format limitation when they should switch to scripting. My example is Home Assistant.
Home Assistant is a home/smart device automation server. It uses Yaml for automation scripts. But you often need functions. So they use jinja2 templates to emulate functions in Yaml. Then you have to manage copying variable values to make them available in the runtime context who where jinja2 templates are evaluated. There is no static validation for templates. And it takes a lot of detective work to figure out what variables and helpers are available. It’s very frustrating. I really wish Home Assistant would use a type-checked scripting language instead. And it’s not the only system out there that uses Yaml with string templates!
Same here, I avoid using Jinja if at all possible because I just hate blindly poking at stuff like that. I wish the YAML portion had schemas available for autocompletion when editing, at the very least.
Ansible comes to mind as something in a similar vein, I’ve been messing with it pretty often these days. At least here you do get robust autocomplete support and whatnot that eliminates a lot of the guesswork, although Jinja is always a bit painful lol.Oh yeah, and with Ansible there is an alternative to point to, Nix, which does configuration better IMO using a scripting language. It’s still not typed so editor LSP support is limited. At least with NixOS modules and with Home Manager modules runtime validation is pretty good.
You can also get the best of both worlds: https://cuelang.org/
People like you are why I love online spaces like this.
Yes, it’s obscure. Yes, nobody uses it. Yes, nobody ever heard of it before. No, that won’t stop me from using it.
it’s not just a json config file, it’s a schema that can be used to validate its input, and a library to load, validate based on said schema, and convert to-in memory representation with no extra code.
As long as it’s not configured by GUI I’m grateful 🙏😔
