hadalized 0.4.0__py3-none-any.whl

hadalized/templates/starship.toml

@@ -0,0 +1,233 @@
+# This theme is autogenerated by the hadalized theme generation tool
+"$schema" = "https://starship.rs/config-schema.json"
+
+scan_timeout = 200
+
+format = """
+[](rose)\
+$env_var\
+$os\
+$username\
+$hostname\
+$localip\
+$shlvl\
+[](bg:blue fg:rose)\
+$directory\
+[](bg:magenta fg:blue)\
+$git_branch\
+$git_state\
+$git_metrics\
+$git_status\
+[](fg:magenta bg:green)\
+$c\
+$rust\
+$golang\
+$nodejs\
+$php\
+$java\
+$kotlin\
+$haskell\
+$python\
+$package\
+[](fg:green bg:azure)\
+$conda\
+[](fg:azure bg:violet)\
+$time\
+[ ](fg:violet)\
+$cmd_duration\
+$line_break\
+$character"""
+
+palette = "hadalized"
+
+[env_var.STARSHIP_SHELL]
+style = "bg:rose fg:bg"
+format = "[ $env_value ]($style)"
+
+[os]
+disabled = false
+style = "bg:rose fg:bg"
+
+[os.symbols]
+Alpaquita = " "
+Alpine = " "
+AlmaLinux = " "
+Amazon = " "
+Android = " "
+AOSC = " "
+Arch = " "
+Artix = " "
+CachyOS = " "
+CentOS = " "
+Debian = " "
+DragonFly = " "
+Elementary = " "
+Emscripten = " "
+EndeavourOS = " "
+Fedora = " "
+FreeBSD = " "
+Garuda = "󰛓 "
+Gentoo = " "
+HardenedBSD = "󰞌 "
+Illumos = "󰈸 "
+Ios = "󰀷 "
+Kali = " "
+Linux = " "
+Mabox = " "
+Macos = " "
+Manjaro = " "
+Mariner = " "
+MidnightBSD = " "
+Mint = " "
+NetBSD = " "
+NixOS = " "
+Nobara = " "
+OpenBSD = "󰈺 "
+openSUSE = " "
+OracleLinux = "󰌷 "
+Pop = " "
+Raspbian = " "
+Redhat = " "
+RedHatEnterprise = " "
+RockyLinux = " "
+Redox = "󰀘 "
+Solus = "󰠳 "
+SUSE = " "
+Ubuntu = " "
+Unknown = " "
+Void = " "
+Windows = "󰍲 "
+Zorin = " "
+
+[username]
+show_always = true
+style_user = "bg:rose fg:bg"
+style_root = "bg:red fg:bg"
+format = "[ $user]($style)"
+
+[directory]
+style = "bg:blue fg:bg"
+format = "[ $path ]($style)"
+truncation_length = 3
+truncation_symbol = "…/"
+
+[directory.substitutions]
+".config" = " "
+".git" = " "
+"Documents" = "󰈙 "
+"Downloads" = " "
+"Music" = "󰝚 "
+"Pictures" = " "
+"Developer" = "󰲋 "
+src = "󰲋 "
+
+[git_branch]
+symbol = ""
+style = "bg:magenta"
+format = "[[ $symbol $branch ](fg:bg bg:magenta)]($style)"
+
+[git_status]
+style = "bg:magenta"
+format = "[[($all_status$ahead_behind )](fg:bg bg:magenta)]($style)"
+
+[nodejs]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[package]
+style = "bg:green fg:bg"
+symbol = "󰏗 "
+format = '[$symbol$version]($style)'
+
+
+[c]
+symbol = " "
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[rust]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[golang]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[php]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[java]
+symbol = " "
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[kotlin]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[haskell]
+symbol = ""
+style = "bg:green"
+format = "[[ $symbol( $version) ](fg:bg bg:green)]($style)"
+
+[python]
+symbol = ""
+style = "bg:green"
+format = '[[ $symbol( $version)( \($virtualenv\)) ](fg:bg bg:green)]($style)'
+
+[docker_context]
+symbol = ""
+style = "bg:azure"
+format = "[[ $symbol( $context) ](fg:bg bg:azure)]($style)"
+
+[conda]
+symbol = "  "
+style = "fg:bg bg:azure"
+format = "[$symbol$environment ]($style)"
+ignore_base = false
+
+[time]
+disabled = false
+time_format = "%R"
+style = "bg:violet"
+format = "[[  $time ](fg:bg bg:violet)]($style)"
+
+[line_break]
+disabled = false
+
+[character]
+disabled = false
+success_symbol = "[❯](bold fg:green)"
+error_symbol = "[❯](bold fg:red)"
+vimcmd_symbol = "[❮](bold fg:green)"
+vimcmd_replace_one_symbol = "[❮](bold fg:violet)"
+vimcmd_replace_symbol = "[❮](bold fg:violet)"
+vimcmd_visual_symbol = "[❮](bold fg:yellow)"
+
+[cmd_duration]
+show_milliseconds = true
+format = "  $duration "
+style = "bg:violet"
+disabled = false
+show_notifications = true
+min_time_to_notify = 45000
+
+{% for palette in context.palettes.values() %}
+[palettes."{{palette.name}}"]
+name = "{{ palette.name }}"
+gamut = "{{ palette.gamut }}"
+mode = "{{ palette.mode }}"
+{% for name, code in palette.hue -%}
+{{name}} = "{{code}}"
+{% endfor -%}
+{% for name, code in palette.base -%}
+{{ name }} = "{{code}}"
+{% endfor -%}
+{% endfor %}
+

hadalized/templates/wezterm.toml

@@ -0,0 +1,45 @@
+# Autogenerated file defining a wezterm colorscheme.
+# WARNING: Do not edit by hand.
+# Pass in a Palette instance, e.g., palette.hex()
+
+[colors]
+ansi = [
+    "{{context.base.hidden}}",
+    "{{context.hue.red}}",
+    "{{context.hue.green}}",
+    "{{context.hue.yellow}}",
+    "{{context.hue.blue}}",
+    "{{context.hue.magenta}}",
+    "{{context.hue.cyan}}",
+    "{{context.base.fg}}",
+]
+brights = [
+    "{{context.base.subfg}}",
+    "{{context.hue.rose}}",
+    "{{context.hue.lime}}",
+    "{{context.hue.orange}}",
+    "{{context.hue.azure}}",
+    "{{context.hue.violet}}",
+    "{{context.hue.mint}}",
+    "{{context.base.op2}}",
+]
+
+background    = "{{context.base.bg}}"
+foreground    = "{{context.base.fg}}"
+cursor_border = "{{context.base.op}}"
+cursor_bg     = "{{context.base.bg6}}"
+cursor_fg     = "{{context.base.emph}}"
+selection_bg  = "{{context.base.bg3}}"
+selection_fg  = "{{context.base.subfg}}"
+
+[colors.indexed]
+
+[metadata]
+name = "{{context.name}}"
+origin_url = "https://github.com/shawnohare/hadalized.nvim"
+
+[metadata.palette]
+name  = "{{context.name}}"
+desc  = "{{context.desc}}"
+gamut = "{{context.gamut}}"
+mode  = "{{context.mode}}"

hadalized/web.py

@@ -0,0 +1,168 @@
+"""Named CSS Colors."""
+
+from hadalized.color import ColorField, ColorMap
+
+
+class CSSNamedColors(ColorMap):
+    """Standard CSS named colors as ColorInfo objects.
+
+    Generally there is only a single instance of this class,
+    with the values defined lazily in the `get` method.
+    """
+
+    pink: ColorField = "oklch(0.86774 0.07354 7.0855)"
+    lightpink: ColorField = "oklch(0.84739 0.08579 9.0865)"
+    snow: ColorField = "oklch(0.98894 0.00534 17.247)"
+    rosybrown: ColorField = "oklch(0.69274 0.0548 18.565)"
+    crimson: ColorField = "oklch(0.57119 0.22194 20.087)"
+    lightcoral: ColorField = "oklch(0.72464 0.13774 21.029)"
+    indianred: ColorField = "oklch(0.61544 0.14415 22.228)"
+    mistyrose: ColorField = "oklch(0.94001 0.03008 25.281)"
+    brown: ColorField = "oklch(0.48061 0.15966 25.562)"
+    firebrick: ColorField = "oklch(0.49677 0.17969 26.815)"
+    salmon: ColorField = "oklch(0.735 0.15151 28.06)"
+    maroon: ColorField = "oklch(0.37669 0.15458 29.234)"
+    darkred: ColorField = "oklch(0.39986 0.16408 29.234)"
+    red: ColorField = "oklch(0.62796 0.25768 29.234)"
+    tomato: ColorField = "oklch(0.69622 0.19552 32.321)"
+    orangered: ColorField = "oklch(0.6602 0.22936 35.403)"
+    darksalmon: ColorField = "oklch(0.75074 0.10818 39.394)"
+    coral: ColorField = "oklch(0.73511 0.16799 40.247)"
+    lightsalmon: ColorField = "oklch(0.79376 0.12483 42.425)"
+    sienna: ColorField = "oklch(0.52648 0.11512 44.604)"
+    chocolate: ColorField = "oklch(0.6344 0.15499 50.266)"
+    saddlebrown: ColorField = "oklch(0.47078 0.11214 50.845)"
+    seashell: ColorField = "oklch(0.97602 0.01425 57.592)"
+    darkorange: ColorField = "oklch(0.75054 0.17911 58.283)"
+    sandybrown: ColorField = "oklch(0.784 0.12691 59.71)"
+    peru: ColorField = "oklch(0.67819 0.12275 62.182)"
+    peachpuff: ColorField = "oklch(0.91125 0.06 63.699)"
+    linen: ColorField = "oklch(0.96024 0.01715 67.622)"
+    orange: ColorField = "oklch(0.79269 0.17103 70.67)"
+    bisque: ColorField = "oklch(0.93286 0.05145 71.849)"
+    burlywood: ColorField = "oklch(0.80454 0.07786 73.417)"
+    tan: ColorField = "oklch(0.78619 0.06382 74.619)"
+    antiquewhite: ColorField = "oklch(0.94669 0.03108 75.219)"
+    navajowhite: ColorField = "oklch(0.9164 0.07301 77.436)"
+    blanchedalmond: ColorField = "oklch(0.94844 0.04493 78.06)"
+    papayawhip: ColorField = "oklch(0.95808 0.03826 80.032)"
+    moccasin: ColorField = "oklch(0.92962 0.06754 81.379)"
+    darkgoldenrod: ColorField = "oklch(0.65207 0.1322 81.572)"
+    wheat: ColorField = "oklch(0.90883 0.0615 83.033)"
+    oldlace: ColorField = "oklch(0.97234 0.02156 83.264)"
+    goldenrod: ColorField = "oklch(0.75157 0.14693 83.988)"
+    floralwhite: ColorField = "oklch(0.98623 0.01422 84.583)"
+    gold: ColorField = "oklch(0.88677 0.18219 95.33)"
+    cornsilk: ColorField = "oklch(0.9773 0.03726 95.439)"
+    lemonchiffon: ColorField = "oklch(0.97781 0.05822 102.16)"
+    khaki: ColorField = "oklch(0.91349 0.11192 102.83)"
+    palegoldenrod: ColorField = "oklch(0.92105 0.07981 103.18)"
+    darkkhaki: ColorField = "oklch(0.76747 0.09804 104.51)"
+    ivory: ColorField = "oklch(0.99598 0.01962 106.75)"
+    beige: ColorField = "oklch(0.96357 0.03278 107)"
+    lightyellow: ColorField = "oklch(0.99201 0.04024 107.11)"
+    lightgoldenrodyellow: ColorField = "oklch(0.97501 0.05184 107.32)"
+    olive: ColorField = "oklch(0.58066 0.12658 109.77)"
+    yellow: ColorField = "oklch(0.96798 0.21101 109.77)"
+    darkolivegreen: ColorField = "oklch(0.49552 0.0896 126.19)"
+    olivedrab: ColorField = "oklch(0.59948 0.13738 126.32)"
+    yellowgreen: ColorField = "oklch(0.78485 0.18374 126.64)"
+    greenyellow: ColorField = "oklch(0.91305 0.23346 130.02)"
+    chartreuse: ColorField = "oklch(0.89026 0.2648 136.01)"
+    lawngreen: ColorField = "oklch(0.88175 0.26307 136.17)"
+    darkgreen: ColorField = "oklch(0.43602 0.14837 142.5)"
+    green: ColorField = "oklch(0.51975 0.17686 142.5)"
+    lime: ColorField = "oklch(0.86644 0.29483 142.5)"
+    limegreen: ColorField = "oklch(0.74187 0.22865 142.83)"
+    forestgreen: ColorField = "oklch(0.5578 0.16878 142.89)"
+    palegreen: ColorField = "oklch(0.90354 0.16242 144.09)"
+    lightgreen: ColorField = "oklch(0.868 0.1558 144.09)"
+    darkseagreen: ColorField = "oklch(0.75086 0.07971 144.73)"
+    honeydew: ColorField = "oklch(0.98484 0.02521 145.38)"
+    springgreen: ColorField = "oklch(0.87493 0.23526 151.02)"
+    seagreen: ColorField = "oklch(0.56853 0.11871 154.95)"
+    mediumseagreen: ColorField = "oklch(0.68404 0.14402 155)"
+    mediumspringgreen: ColorField = "oklch(0.86681 0.20674 156.9)"
+    mintcream: ColorField = "oklch(0.99117 0.01237 164.81)"
+    mediumaquamarine: ColorField = "oklch(0.77669 0.10985 168.82)"
+    aquamarine: ColorField = "oklch(0.91499 0.13039 168.99)"
+    turquoise: ColorField = "oklch(0.82233 0.13074 185.09)"
+    lightseagreen: ColorField = "oklch(0.6912 0.11421 188.96)"
+    mediumturquoise: ColorField = "oklch(0.7868 0.11622 191.56)"
+    darkcyan: ColorField = "oklch(0.57652 0.09841 194.77)"
+    teal: ColorField = "oklch(0.54312 0.09271 194.77)"
+    aqua: ColorField = "oklch(0.9054 0.15455 194.77)"
+    cyan: ColorField = "oklch(0.9054 0.15455 194.77)"
+    darkslategray: ColorField = "oklch(0.40296 0.03772 195.76)"
+    darkslategrey: ColorField = "oklch(0.40296 0.03772 195.76)"
+    paleturquoise: ColorField = "oklch(0.90691 0.06323 196.09)"
+    lightcyan: ColorField = "oklch(0.97786 0.03203 196.64)"
+    darkturquoise: ColorField = "oklch(0.77193 0.13144 196.64)"
+    azure: ColorField = "oklch(0.98895 0.01572 196.9)"
+    cadetblue: ColorField = "oklch(0.65768 0.06501 198.3)"
+    powderblue: ColorField = "oklch(0.87508 0.0502 205.73)"
+    lightblue: ColorField = "oklch(0.85623 0.04894 219.65)"
+    skyblue: ColorField = "oklch(0.81482 0.08192 225.75)"
+    deepskyblue: ColorField = "oklch(0.75535 0.15342 231.64)"
+    lightskyblue: ColorField = "oklch(0.82062 0.09453 236.75)"
+    aliceblue: ColorField = "oklch(0.97514 0.01266 244.25)"
+    steelblue: ColorField = "oklch(0.588 0.09934 245.74)"
+    slategray: ColorField = "oklch(0.5925 0.03092 248.35)"
+    slategrey: ColorField = "oklch(0.5925 0.03092 248.35)"
+    lightslategray: ColorField = "oklch(0.61902 0.0325 248.35)"
+    lightslategrey: ColorField = "oklch(0.61902 0.0325 248.35)"
+    dodgerblue: ColorField = "oklch(0.65201 0.19012 253.21)"
+    lightsteelblue: ColorField = "oklch(0.81362 0.04281 255.03)"
+    cornflowerblue: ColorField = "oklch(0.67462 0.14136 261.34)"
+    blue: ColorField = "oklch(0.45201 0.31321 264.05)"
+    darkblue: ColorField = "oklch(0.28782 0.19944 264.05)"
+    mediumblue: ColorField = "oklch(0.38345 0.26571 264.05)"
+    navy: ColorField = "oklch(0.27115 0.18789 264.05)"
+    royalblue: ColorField = "oklch(0.55985 0.18823 266.4)"
+    midnightblue: ColorField = "oklch(0.28812 0.14363 272.76)"
+    mediumslateblue: ColorField = "oklch(0.60447 0.19389 285.5)"
+    slateblue: ColorField = "oklch(0.54357 0.17123 285.54)"
+    lavender: ColorField = "oklch(0.9309 0.02694 285.86)"
+    darkslateblue: ColorField = "oklch(0.41434 0.12484 286.04)"
+    ghostwhite: ColorField = "oklch(0.98112 0.00927 286.23)"
+    mediumpurple: ColorField = "oklch(0.62518 0.15415 297.27)"
+    blueviolet: ColorField = "oklch(0.53376 0.25031 301.37)"
+    indigo: ColorField = "oklch(0.33898 0.17927 301.68)"
+    rebeccapurple: ColorField = "oklch(0.44027 0.1603 303.37)"
+    darkviolet: ColorField = "oklch(0.51491 0.26067 309.81)"
+    darkorchid: ColorField = "oklch(0.54111 0.22724 311.51)"
+    mediumorchid: ColorField = "oklch(0.62558 0.20244 319.23)"
+    thistle: ColorField = "oklch(0.83329 0.04391 325.96)"
+    plum: ColorField = "oklch(0.78328 0.10776 326.54)"
+    violet: ColorField = "oklch(0.7619 0.18612 327.21)"
+    fuchsia: ColorField = "oklch(0.70167 0.32249 328.36)"
+    magenta: ColorField = "oklch(0.70167 0.32249 328.36)"
+    darkmagenta: ColorField = "oklch(0.4468 0.20535 328.36)"
+    purple: ColorField = "oklch(0.42091 0.19345 328.36)"
+    orchid: ColorField = "oklch(0.70213 0.18126 328.71)"
+    mediumvioletred: ColorField = "oklch(0.55337 0.22165 349.69)"
+    hotpink: ColorField = "oklch(0.7283 0.19708 351.99)"
+    lavenderblush: ColorField = "oklch(0.96833 0.01741 355.1)"
+    deeppink: ColorField = "oklch(0.65493 0.26134 356.94)"
+    palevioletred: ColorField = "oklch(0.67397 0.135 359.97)"
+    # Zero Hue
+    black: ColorField = "oklch(0 0 0)"
+    darkgray: ColorField = "oklch(0.73481 0 0)"
+    darkgrey: ColorField = "oklch(0.73481 0 0)"
+    dimgray: ColorField = "oklch(0.52081 0 0)"
+    dimgrey: ColorField = "oklch(0.52081 0 0)"
+    gainsboro: ColorField = "oklch(0.89449 0 0)"
+    gray: ColorField = "oklch(0.59987 0 0)"
+    grey: ColorField = "oklch(0.59987 0 0)"
+    lightgray: ColorField = "oklch(0.86686 0 0)"
+    lightgrey: ColorField = "oklch(0.86686 0 0)"
+    silver: ColorField = "oklch(0.8078 0 0)"
+    white: ColorField = "oklch(1 0 0)"
+    whitesmoke: ColorField = "oklch(0.97015 0 0)"
+    transparent: ColorField = "oklch(0 0 0 / 0)"
+    # Added
+    offblack: ColorField = "oklch(0.10 0.01 220)"
+    offdarkgray: ColorField = "oklch(0.30 0.01 220)"
+    neutralgray: ColorField = "oklch(0.50 0.01 220)"
+    offlightgray: ColorField = "oklch(0.70 0.01 220)"
+    offwhite: ColorField = "oklch(0.995 0.01 220)"

hadalized/writer.py

@@ -0,0 +1,243 @@
+"""Render templates and write outputs."""
+
+from contextlib import suppress
+from functools import cache
+from hashlib import blake2b
+from pathlib import Path
+from typing import TYPE_CHECKING, ClassVar
+
+from jinja2 import (
+    Environment,
+    FileSystemLoader,
+    PackageLoader,
+    StrictUndefined,
+    Template,
+    TemplateNotFound,
+    select_autoescape,
+)
+from loguru import logger
+
+from hadalized import const
+from hadalized.cache import Cache
+from hadalized.config import BuildConfig, Config, ContextType
+
+if TYPE_CHECKING:
+    from hadalized.base import BaseNode
+    from hadalized.palette import Palette
+
+
+@cache
+def _encode(val: Template | BaseNode) -> bytes:
+    if isinstance(val, Template):
+        data: bytes = b"null"
+        if (fname := val.filename) is not None:
+            with suppress(FileNotFoundError):
+                data = Path(fname).read_bytes()
+    else:
+        data = val.model_dump_json().encode()
+
+    return data
+
+
+def _hash(template: Template, context: BaseNode) -> str:
+    data = _encode(template) + b":::" + _encode(context)
+    return blake2b(data, digest_size=32).hexdigest()
+
+
+class ThemeWriter:
+    """Generate application theme files."""
+
+    _package_template_env: ClassVar[Environment] = Environment(
+        loader=PackageLoader(const.APP_NAME),
+        undefined=StrictUndefined,
+        # autoescape=True,
+        autoescape=select_autoescape("html", "xml"),
+    )
+
+    def __init__(self, config: Config):
+        """Prepare an instance for writing files.
+
+        Initializtion does not connect to the cache database or write
+        any files.
+
+        Args:
+            config: A configuration instance if customization is required.
+
+        """
+        self.config = config
+        self.cache = Cache(config)
+        self._fs_template_env = Environment(
+            loader=FileSystemLoader(searchpath=config.template_dir),
+            undefined=StrictUndefined,
+            autoescape=select_autoescape("html", "xml"),
+        )
+        self._parsed = False
+
+    def _skip(self, path: Path, digest: str) -> bool:
+        return (
+            not self.config.force
+            and not self.config.no_cache
+            and path.exists()
+            and self.cache.get(path) == digest
+        )
+
+    def get_template(self, name: str | Path) -> Template:
+        """Load theme template.
+
+        Returns:
+            A jinja2.Template instance.
+
+        """
+        tname = str(name)
+        if self.config.no_templates or self.config.no_config:
+            template = self._package_template_env.get_template(tname)
+        else:
+            try:
+                template = self._fs_template_env.get_template(tname)
+            except TemplateNotFound:
+                template = self._package_template_env.get_template(tname)
+        return template
+
+    def _parse(self):
+        """Parse each palette in the underlying configuration."""
+        if not self._parsed:
+            self.config = self.config.parse_palettes()
+            self._parsed = True
+
+    def build_file(
+        self,
+        bconf: BuildConfig,
+        data: Palette | Config,
+    ) -> tuple[Path, bool]:
+        """Build a single color theme file.
+
+        Returns:
+            A path of the built file and whether it was generated.
+
+        """
+        opt = self.config
+        template = self.get_template(bconf.template)
+        path = self.config.build_dir / bconf.format_path(data)
+        context = data.to(bconf.color_type)
+        digest = _hash(template, context)
+
+        if opt.verbose:
+            logger.info(f"Checking whether to build {path} with hash {digest}.")
+        if self._skip(path, digest):
+            return path, False
+
+        if not opt.quiet:
+            logger.info(f"Building {path} {digest}.")
+
+        text = template.render(context=context)
+        if not opt.dry_run:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.write_text(text, encoding="utf-8")
+        if opt.use_cache and not opt.dry_run:
+            self.cache.add(path, digest)
+        return path, True
+
+    def copy_file(self, build_path: Path) -> Path | None:
+        """Copy a built theme file to an output directory.
+
+        Args:
+            build_path: Path to a built theme file, typically saved in
+                the applicate state directory.
+
+        Returns:
+            The path of the copied file or None if no copy was performed.
+
+        """
+        opt = self.config
+        if opt.output_dir is None:
+            return None
+
+        output_dir = opt.output_dir
+        if opt.prefix:
+            output_dir /= build_path.parent.name
+        copy_path = (output_dir / build_path.name).absolute()
+        if not opt.quiet:
+            logger.info(f"Copying {build_path} to {output_dir}")
+        if not opt.dry_run:
+            output_dir.mkdir(parents=True, exist_ok=True)
+            build_path.copy(copy_path)
+        return copy_path
+
+    def build(self, bconf: BuildConfig) -> list[Path]:
+        """Generate color theme files for a specific app.
+
+        Args:
+            bconf: A configuration specifying how theme files shoud be built.
+
+        Returns:
+            A list of theme file paths that were built.
+
+        """
+        self._parse()
+        opt = self.config
+        if opt.verbose:
+            logger.info(f"Handling themes for {bconf.name}.")
+        includes = set(opt.include_palettes)
+        filtered_palettes = {
+            k: v
+            for k, v in opt.palettes.items()
+            if not includes
+            or k in includes
+            or v.name in includes
+            or not set(v.aliases).isdisjoint(includes)
+        }
+
+        match bconf.context_type:
+            case ContextType.palette:
+                contexts = filtered_palettes.values()
+            case ContextType.full:
+                if not includes:
+                    contexts = [self.config]
+                else:
+                    contexts = [self.config.replace(palettes=filtered_palettes)]
+
+        files_built: list[Path] = []
+        for item in contexts:
+            build_path, is_built = self.build_file(bconf, item)
+            if is_built:
+                files_built.append(build_path)
+            self.copy_file(build_path)
+
+        return files_built
+
+    def run(self) -> list[Path]:
+        """Generate all relevant app theme files.
+
+        Returns:
+            A list of file paths that were generated.
+
+        """
+        includes = set(self.config.include_builds)
+        builds = (
+            v
+            for k, v in self.config.builds.items()
+            if not includes or k in includes or v.name in includes
+        )
+
+        written = []
+        for directive in builds:
+            written += self.build(directive)
+        return written
+
+    def __enter__(self):
+        """Connect to the cache.
+
+        Returns:
+            The instance with a connection to the cache db.
+
+        """
+        if self.config.use_cache:
+            self.cache.connect()
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        """Close cache db connection."""
+        if exc_type is not None:
+            logger.error((exc_type, exc_value, traceback))
+        if self.config.use_cache:
+            self.cache.close()