Last active
November 27, 2024 08:29
-
-
Save tbutts/6abf7fb5b948c066bf180922fb37adcf to your computer and use it in GitHub Desktop.
For tmux configs: Merge deprecated/removed -fg, -bg, and -attr options into the -style option
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
#!/usr/bin/env python | |
# vim: set fileencoding=utf-8 | |
# | |
# USAGE: | |
# Back up your tmux old config, run the script and redirect stdout to your conf | |
# file. Example: | |
# | |
# $ cp ~/.tmux.conf ~/.tmux.conf.orig | |
# $ python ./tmux-migrate-options.py ~/.tmux.conf.orig > ~/.tmux.conf | |
# | |
# | |
# PURPOSE: | |
# This script accepts the path to a tmux conf file to read, then combines the | |
# deprecated -fg, -bg, and -attr options into the new -style option, and | |
# prints the updated tmux conf to stdout. The deprecated options were flagged | |
# for removal in tmux v1.9, and then removed in tmux v2.9 years later. | |
# | |
# The script will place the new "-style" option at the location of the last | |
# matching prefix for that option family. This means if your config file had | |
# a triplet of "window-status-bg", "window-status-fg", and "window-status-attr" | |
# settings, they will be merged into one line at that location with the option | |
# "window-status-style bg=...,fg=...,<attr>", in that order. | |
# | |
# If your config file has duplicate settings for, say, -fg, they will all | |
# appear on the same -style option line, in the same order which should give | |
# the same effect as before. | |
# | |
# The parser used here is a naive regex which should be enough for most configs. | |
# There is *no effort* to handle tmux conditional lines or cases where you | |
# already have -style options as well as old -fg, -bg, -attr options. | |
# If you rely on those to set colors and styles, then you may want to avoid | |
# this script as it will break your config. | |
# --- | |
# ISC License (ISC) | |
# | |
# Copyright 2019 April | tbutts | |
# | |
# Permission to use, copy, modify, and/or distribute this software for any | |
# purpose with or without fee is hereby granted, provided that the above | |
# copyright notice and this permission notice appear in all copies. | |
# | |
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH | |
# REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND | |
# FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, | |
# INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM | |
# LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR | |
# OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR | |
# PERFORMANCE OF THIS SOFTWARE. | |
# | |
from __future__ import print_function, unicode_literals | |
from io import open | |
import os | |
import re | |
import sys | |
if len(sys.argv) < 2: | |
sys.exit("[ERR] specify path to tmux config file") | |
tmux_conf = sys.argv[1] | |
with open(tmux_conf, mode='r', encoding='utf-8') as tmux_file: | |
content = tmux_file.readlines() | |
if not content: | |
sys.exit("[ERR] tmux config file appears to be empty") | |
OPTION_PREFIXES=[ | |
"message-command-", | |
"message-", | |
"mode-", | |
"pane-active-border-", | |
"pane-border-", | |
"status-left-", | |
"status-right-", | |
"status-", | |
"window-active-", | |
"window-status-activity-", | |
"window-status-bell-", | |
"window-status-current-", | |
"window-status-last-", | |
"window-status-", | |
"window-", | |
] | |
SET_OPTION_RE=r""" | |
^\s*[^#]* # ignore comment lines | |
(?P<set_option>set\S*\s+-g) # set, setw, set-option, etc. | |
\s+ | |
{prefix} # any of the above option strings | |
(?P<style>fg|bg|attr) # the style part name | |
\s+ | |
(?P<value>\S+) # color value, attribute (bold/dim/none/etc) | |
""" | |
for opt in OPTION_PREFIXES: | |
option_matcher = re.compile(SET_OPTION_RE.format(prefix=opt), re.VERBOSE) | |
set_cmd = "" # track type of "set-option" command | |
line_no = 0 # track last line number of any matching set-option* command | |
settings = [] # track -fg, -bg, and -attr options | |
# Going line-by-line from content, attempt a string match with the current 'opt' option family. | |
# Use index-based iteration, so that 'content' can be modified while looping. | |
i = 0 | |
while i < len(content): | |
match = option_matcher.search(content[i]) | |
if match: | |
re_groups = match.groupdict() | |
set_cmd = re_groups["set_option"] | |
style = re_groups["style"] | |
value = re_groups["value"] | |
if style in ["fg", "bg"]: | |
settings.append("{}={}".format(style, value)) | |
else: | |
# One of the -attr options (bold, dim, none, etc.) | |
settings.append(value) | |
line_no = i | |
content.pop(i) | |
else: | |
i += 1 | |
if set_cmd: | |
style_replacement_line = "{} {} {}{}".format( | |
set_cmd, | |
opt+"style", | |
",".join(settings), | |
os.linesep) | |
content.insert(line_no, style_replacement_line) | |
# Print the updated config to stdout | |
if sys.version_info.major > 2: | |
print(''.join(content), end='') | |
else: | |
import codecs | |
codecs.getwriter('utf8')(sys.stdout).write(''.join(content)) |
Thank you!!!
thank you
thank you !!!!
Awesome, saved me some time, thank you very much!
Thank you very much!
Great! Thank you!
This is amazing. Just brew upgraded tmux for the first time a long while and this saved my day
<3
I love you.
<3
Thank you. tmux devs should have provided a migration util like this instead of blaming the users.
This is awesome. Thank you!
Amazing 💯
Arigatou so much for this!
Thanks for this.
Thanks a lot!
Appreciated, save lots works to figure out migration !
Thanks!
❤️
Very nice.
Verified to work on both tmux 3.0a
on Ubuntu 20.04 and tmux 2.7
on Centos 8.
LGTM!
Thank you for saving my morning
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Thanks so much for this!