tailwhip 0.9__py3-none-any.whl

tailwhip/__init__.py

@@ -0,0 +1,11 @@
+"""Tailwhip - Sort Tailwind CSS classes in HTML and CSS files."""
+
+from __future__ import annotations
+
+from importlib import metadata
+
+from tailwhip.cli import main
+
+__version__ = metadata.version("tailwhip")
+__author__ = "Martin Mahner"
+__all__ = ["__author__", "__version__", "main"]

tailwhip/__main__.py

@@ -0,0 +1,8 @@
+"""Entry point for python -m tailwhip."""
+
+from __future__ import annotations
+
+from tailwhip.cli import main
+
+if __name__ == "__main__":
+    main()

tailwhip/cli.py

@@ -0,0 +1,158 @@
+"""CLI entrypoint."""
+
+from __future__ import annotations
+
+import sys
+import time
+from importlib import metadata
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from rich.console import Console
+
+from tailwhip.configuration import (
+    CONSOLE_THEME,
+    VerbosityLevel,
+    config,
+    get_pyproject_toml_data,
+    update_configuration,
+)
+from tailwhip.files import apply_changes, find_files
+
+
+def version_callback(value: bool) -> None:
+    """Print version and exit."""
+    if value:
+        version = metadata.version("tailwhip")
+        typer.echo(f"tailwhip {version}")
+        raise typer.Exit
+
+
+app = typer.Typer(
+    help="Sort Tailwind CSS classes in HTML and CSS files.",
+    add_completion=False,
+    rich_markup_mode="rich",
+)
+
+
+def main() -> None:
+    """Entrypoint for the CLI."""
+    app()
+
+
+@app.command(context_settings={"help_option_names": ["-h", "--help"]})
+def run(  # noqa: PLR0913
+    paths: Annotated[
+        list[Path],
+        typer.Argument(
+            help="Files or directories to process.",
+            metavar="PATH",
+        ),
+    ],
+    version: Annotated[  # noqa: ARG001
+        bool,
+        typer.Option(
+            "--version",
+            "-V",
+            callback=version_callback,
+            is_eager=True,
+            help="Show version and exit.",
+        ),
+    ] = False,
+    write_mode: Annotated[
+        bool,
+        typer.Option(
+            "--write",
+            "-w",
+            help="Write changes to files (default: dry-run mode).",
+        ),
+    ] = False,
+    quiet: Annotated[
+        bool,
+        typer.Option(
+            "--quiet",
+            "-q",
+            help="Suppress output except errors and warnings.",
+        ),
+    ] = False,
+    verbosity: Annotated[
+        int,
+        typer.Option(
+            "--verbose",
+            "-v",
+            count=True,
+            help="Increase output verbosity (-v: changes, -vv: diff, -vvv: debug).",
+        ),
+    ] = 0,
+    custom_configuration_file: Annotated[
+        Path | None,
+        typer.Option(
+            "--configuration",
+            "-c",
+            help="Load custom configuration file (overrides pyproject.toml settings).",
+            metavar="FILE",
+        ),
+    ] = None,
+) -> None:
+    """
+    Sort Tailwind CSS classes in HTML and CSS files.
+
+    Automatically discovers and sorts Tailwind classes according to a consistent
+    ordering. Supports HTML, CSS, and template files with Tailwind @apply directives.
+    """
+    # Check if the given configuration file exists
+    if custom_configuration_file and not custom_configuration_file.exists():
+        typer.echo(
+            f"Custom configuration file {custom_configuration_file} not found.",
+            err=True,
+        )
+        raise typer.Exit(1)
+
+    # Setup configuration values -------------------------------------------------------
+
+    # 1. Overwrite config defaults with pyproject.toml settings if they exist
+    if pyproject_data := get_pyproject_toml_data(Path.cwd()):
+        update_configuration(pyproject_data)
+
+    # 2. Overwrite config defaults with custom settings if they exist
+    if custom_configuration_file:
+        update_configuration(custom_configuration_file)
+
+    # 3. Overwrite config defaults with CLI options
+    update_configuration(
+        {
+            "write_mode": write_mode,
+            "verbosity": 0 if quiet else verbosity + 1,
+        }
+    )
+
+    # Setup helper tools ---------------------------------------------------------------
+
+    config.console = Console(quiet=quiet, theme=CONSOLE_THEME)
+
+    # Start Tailwhipping ---------------------------------------------------------------
+
+    start_time = time.time()
+    found_any, skipped, changed = apply_changes(targets=find_files(paths=paths))
+    duration = time.time() - start_time
+
+    if not found_any:
+        config.console.print("[red]Error: No files found[/red]")
+        sys.exit(1)
+
+    if config.verbosity == VerbosityLevel.NORMAL:
+        config.console.print(
+            "\nUse [important] -v [/important] (show unchanged files) or [important] -vv [/important] (show diff preview) for more detail."
+        )
+
+    if not config.write_mode:
+        config.console.print(
+            "\n:warning: Dry Run. No files were actually written. "
+            "Use [important] --write [/important] to write changes."
+        )
+
+    config.console.print(
+        f"⏱ Completed in [bold]{duration:.3f}s[/bold] for {changed} files. [dim]({skipped} skipped)[/dim]",
+        highlight=False,
+    )

tailwhip/configuration.py

@@ -0,0 +1,119 @@
+"""Configuration management for tailwhip."""
+
+from __future__ import annotations
+
+import re
+from enum import IntEnum
+from pathlib import Path
+
+import dynaconf
+import rich
+import tomllib
+
+# Path to default configuration file
+BASE_CONFIGURATION_FILE = Path(__file__).parent / "configuration.toml"
+
+# Console theme for rich.Console output
+CONSOLE_THEME = rich.theme.Theme(
+    {
+        "important": "white on deep_pink4",
+        "highlight": "yellow1",
+        "filename": "white",
+        "bold": "sky_blue1",
+    }
+)
+
+
+def get_pyproject_toml_data(start_path: Path) -> Path | None:
+    """Search for pyproject.toml starting at the given path."""
+    pyproject_path = None
+
+    for directory in [start_path, *start_path.resolve().parents]:
+        candidate = directory / "pyproject.toml"
+        if candidate.exists():
+            pyproject_path = candidate
+            break
+
+    with pyproject_path.open("rb") as f:
+        data = tomllib.load(f)
+
+    return data.get("tool", {}).get("tailwhip")
+
+
+def update_configuration(data: dict | Path) -> None:
+    """Update configuration with the given data."""
+    if isinstance(data, dict):
+        config.update(data, merge=False)
+        _recompile_constants()
+        return
+
+    if isinstance(data, Path):
+        with data.open("rb") as f:
+            config_data = tomllib.load(f)
+        config.update(config_data, merge=False)
+        _recompile_constants()
+        return
+
+    # pragma: no cover
+    msg = f"Invalid data type '{type(data)}' for configuration update."  # pragma: no cover
+    raise TypeError(msg)  # pragma: no cover
+
+
+def _recompile_constants() -> None:
+    """Re-compile regular expressions pattern objects."""
+    config.tailwind_colors = set(config.tailwind_colors)
+    config.custom_colors = set(config.custom_colors)
+
+    config.UTILITY_PATTERNS = [re.compile("^" + g) for g in config.utility_groups]
+    config.VARIANT_PATTERNS = [re.compile(v) for v in config.variant_groups]
+    config.CLASS_ATTR_RE = re.compile(config.class_regex, re.IGNORECASE | re.DOTALL)
+    config.APPLY_RE = re.compile(config.apply_regex, re.MULTILINE)
+
+
+class VerbosityLevel(IntEnum):
+    """Verbosity level enum."""
+
+    QUIET = 0
+    NORMAL = 1  # Default
+    VERBOSE = 2 # Show unchanged files
+    DIFF = 3    # Show diff of changes
+    DEBUG = 4
+
+
+class TailwhipConfig(dynaconf.Dynaconf):
+    """Configuration for tailwhip."""
+
+    # Utilities created at runtime
+    console: rich.console.Console
+
+    # Settings provided by the base config
+    verbosity: VerbosityLevel
+    write_mode: bool
+    default_globs: list[str]
+    skip_expressions: list[str]
+    variant_separator: str
+    utility_groups: list[str]
+    variant_groups: list[str]
+    tailwind_colors: set[str]
+    custom_colors: set[str]
+    class_regex: str
+    apply_regex: str
+
+    # Compiled regex patterns
+    UTILITY_PATTERNS: list[re.Pattern]
+    VARIANT_PATTERNS: list[re.Pattern]
+    CLASS_ATTR_RE: re.Pattern
+    APPLY_RE: re.Pattern
+
+
+config = TailwhipConfig(
+    settings_files=[str(BASE_CONFIGURATION_FILE)],
+    merge_enabled=False,
+    envvar_prefix="TAILWHIP",
+    root_path=Path.cwd(),
+    load_dotenv=False,
+    lowercase_read=True,
+)
+
+# Initialize constants on module load
+_recompile_constants()