mirror of
https://github.com/wez/wezterm.git
synced 2024-12-25 14:22:37 +03:00
2d02df5f38
`wezterm`, `wezterm-gui` and `wezterm-mux-server` now all support a new `--config name=value` CLI option that can be specified multiple times to supply config overrides. Since there isn't a simple, direct way to update arbitrary fields of a struct in Rust (there's no runtime reflection), we do this work in lua. The config file returns a config table. Before that is mapped to the Rust Config type, we have a new phase that takes each of the `--config` values and applies it to the config table. For example, you can think of configuration as working like this if wezterm is started as `wezterm --config foo="bar"`: ```lua config = load_config_file(); config.foo = "bar"; return config; ``` The `--config name=value` option is split into `name` and `value` parts. The name part is literally concatenated with `config` in the generated lua code, so the name MUST be valid in that context. The `value` portion is literally inserted verbatim as the rvalue in the assignment. Not quoting or other processing is done, which means that you can (and must!) use the same form that you would use in the config file for the RHS. Strings must be quoted. This allows you to use more complicated expressions on the right hand side, such as: ``` wezterm --config 'font=wezterm.font("Fira Code")' ``` The overrides stick for the lifetime of the process; even if you change the config file and reload, then the value specified by the override will take precedence. refs: https://github.com/wez/wezterm/issues/469 refs: https://github.com/wez/wezterm/issues/499 |
||
---|---|---|
.. | ||
colorschemes | ||
config | ||
install | ||
screenshots | ||
_config.yml | ||
book.toml | ||
changelog.md | ||
contributing.md | ||
copymode.md | ||
custom.css | ||
escape-sequences.md | ||
faq.md | ||
features.md | ||
help.md | ||
hyperlinks.md | ||
imgcat.md | ||
index.md | ||
installation.md | ||
multiplexing.md | ||
scrollback.md | ||
serial.md | ||
shell-integration.md | ||
ssh.md |