Merge branch 'exporter-plaintext'

merge pr from @loganbyers plus some cli behavior updates

Author: kovaca

src/palettize/cli.py

@@ -49,7 +49,6 @@ class ExitCodes:
 class AppState:
     def __init__(self):
         self.verbose_level = 0
-        self.quiet = False
 
 
 app_state = AppState()
@@ -76,9 +75,7 @@ def verbosity_callback(ctx: typer.Context, param: typer.CallbackParam, value: in
     return value
 
 
-def quiet_callback(ctx: typer.Context, param: typer.CallbackParam, value: bool):
-    app_state.quiet = value
-    return value
+ 
 
 
 @app.callback()
@@ -101,15 +98,6 @@ def global_options(
         help="Increase output verbosity. Use -vv for more detail.",
         show_default=False,
     ),
-    quiet: Optional[bool] = typer.Option(
-        False,
-        "--quiet",
-        "-q",
-        callback=quiet_callback,
-        is_flag=True,
-        help="Suppress all informational output; only errors will be shown.",
-        show_default=False,
-    ),
 ):
     """
     Palettize: Generate, preview, and export colormaps from the command line.
@@ -203,7 +191,7 @@ def _create_colormap_from_options(
             f"[bold red]An unexpected error occurred during colormap creation:[/bold red] {e}",
             style="bold red",
         )
-        if app_state.verbose_level > 0:
+        if app_state.verbose_level > 1:
             console.print(
                 Panel(
                     traceback.format_exc(),
@@ -249,7 +237,7 @@ def _render_colormap_to_terminal(
     actual_width = width if width is not None else console_width
     actual_width = max(10, actual_width)
 
-    if not app_state.quiet:
+    if app_state.verbose_level > 0:
         console.print(
             f"Rendering preview of '{colormap_obj.name or 'custom'}' ({actual_width}x{height} chars):"
         )
@@ -481,7 +469,7 @@ def create(
             overall_success = False
             continue
 
-        if not app_state.quiet:
+        if app_state.verbose_level > 0:
             console.print(f"Exporting to [cyan]{fmt}[/cyan] format...")
 
         # Combine global and format-specific options
@@ -509,7 +497,7 @@ def create(
                 output_path = Path(output_path_str)
                 output_path.parent.mkdir(parents=True, exist_ok=True)
                 output_path.write_text(output_str)
-                if not app_state.quiet:
+                if app_state.verbose_level > 0:
                     console.print(f"[green]Successfully wrote to {output_path}[/green]")
             else:
                 # If no output path, print to stdout
@@ -519,7 +507,7 @@ def create(
             console.print(
                 f"[bold red]Failed to export to {fmt}:[/bold red] {e}", style="bold red"
             )
-            if app_state.verbose_level > 0:
+            if app_state.verbose_level > 1:
                 console.print(
                     Panel(
                         traceback.format_exc(),
@@ -532,5 +520,5 @@ def create(
     if not overall_success:
         raise typer.Exit(code=ExitCodes.EXPORT_ERROR)
 
-    if not app_state.quiet:
+    if app_state.verbose_level > 0:
         console.print("[bold green]Export process completed.[/bold green]")

src/palettize/exporters/__init__.py

@@ -14,6 +14,7 @@
 from .mapgl import MapglExporter
 from .observable_plot import ObservablePlotExporter
 from .gee import GEEExporter
+from .plaintext import HexExporter, RGBAExporter
 
 # Global registry for exporters
 # Maps an identifier string to an instantiated exporter object or a callable that returns one.
@@ -86,6 +87,8 @@ def list_available_exporters() -> Dict[str, str]:
     MapglExporter(),
     ObservablePlotExporter(),
     GEEExporter(),
+    HexExporter(),
+    RGBAExporter(),
 ]
 
 for exporter_instance in _BUILTIN_EXPORTERS:

src/palettize/exporters/plaintext.py

@@ -0,0 +1,105 @@
+"""Exporter for plain text files - newline delimited representations of color."""
+
+from typing import Any, Dict, Optional
+
+from palettize.core import Colormap, ScalingFunction
+from ._base import BaseExporter
+
+
+class HexExporter(BaseExporter):
+    """
+    Exporter for plain text hashed hex values for rgb.
+    """
+
+    @property
+    def identifier(self) -> str:
+        return "hex"
+
+    @property
+    def name(self) -> str:
+        return "Plaintext Hashed Hexadecimal"
+
+    @property
+    def default_file_extension(self) -> str:
+        return "txt"
+
+    def export(
+        self,
+        colormap: Colormap,
+        scaler: ScalingFunction,
+        domain_min: float,
+        domain_max: float,
+        options: Optional[Dict[str, Any]] = None,
+    ) -> str:
+        """
+        Exports the colormap to a plain text hash-prefixed hexadecimal format.
+
+        Accepted options:
+            num_colors (int): Number of color steps to generate. Default 256.
+        """
+        options = options or {}
+        num_colors = options.get("num_colors", 256)
+        if not isinstance(num_colors, int):
+            raise ValueError("Option 'num_colors' must be an integer.")
+        if num_colors < 2:
+            raise ValueError("Number of colors must be at least 2.")
+        
+        # palette colors are hex strings with the '#' prefix
+        colors = []
+        for i in range(num_colors):
+            position = i / (num_colors - 1)
+            color_hex = colormap.get_color(position, output_format="hex")
+            colors.append(color_hex)
+
+        palette_str = "\n".join(colors)
+        return palette_str
+
+
+class RGBAExporter(BaseExporter):
+    """
+    Exporter for plain text RGBA values suitable for CSS, for instance.
+    """
+
+    @property
+    def identifier(self) -> str:
+        return "rgba"
+
+    @property
+    def name(self) -> str:
+        return "Plaintext RGBA"
+
+    @property
+    def default_file_extension(self) -> str:
+        return "txt"
+
+    def export(
+        self,
+        colormap: Colormap,
+        scaler: ScalingFunction,
+        domain_min: float,
+        domain_max: float,
+        options: Optional[Dict[str, Any]] = None,
+    ) -> str:
+        """
+        Exports the colormap to a plain text rgba(intR, intG, intB, intA) format.
+
+        Accepted options:
+            num_colors (int): Number of color steps to generate. Default 256.
+        """
+        options = options or {}
+        num_colors = options.get("num_colors", 256)
+        if not isinstance(num_colors, int):
+            raise ValueError("Option 'num_colors' must be an integer.")
+        if num_colors < 2:
+            raise ValueError("Number of colors must be at least 2.")
+        
+        colors = []
+        for i in range(num_colors):
+            position = i / (num_colors - 1)
+            r, g, b, a = colormap.get_color(position, output_format="rgba_tuple")
+            color_string = f"rgba({r}, {g}, {b}, {a})"
+            colors.append(color_string)
+
+        palette_str = "\n".join(colors)
+        return palette_str
+