Files
beets/beetsplug/substitute.py
2026-06-29 11:20:15 +02:00

39 lines
1.1 KiB
Python

"""The substitute plugin module.
Uses user-specified substitution rules to canonicalize names for path formats.
"""
import re
from beets.plugins import BeetsPlugin
class Substitute(BeetsPlugin):
"""The substitute plugin class.
Create a template field function that substitute the given field with the
given substitution rules. ``rules`` must be a list of (pattern,
replacement) pairs.
"""
def tmpl_substitute(self, text):
"""Do the actual replacing."""
if text:
for pattern, replacement in self.substitute_rules:
text = pattern.sub(replacement, text)
return text
return ""
def __init__(self):
"""Initialize the substitute plugin.
Get the configuration, register template function and create list of
substitute rules.
"""
super().__init__()
self.template_funcs["substitute"] = self.tmpl_substitute
self.substitute_rules = [
(re.compile(key, flags=re.IGNORECASE), value)
for key, value in self.config.flatten().items()
]