palettize 0.0.1a1__tar.gz

palettize-0.0.1a1/.github/workflows/release.yml

@@ -0,0 +1,19 @@
+name: Release to PyPI
+on:
+  push:
+    tags: ['v*']
+permissions:
+  contents: read
+  id-token: write
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: astral-sh/setup-uv@v5
+    - run: uv build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

palettize-0.0.1a1/.github/workflows/testindex.yml

@@ -0,0 +1,19 @@
+name: Test release on TestPyPI
+on:
+  push:
+    tags: ['test*']
+permissions:
+  contents: read
+  id-token: write
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: astral-sh/setup-uv@v5
+    - run: uv build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

palettize-0.0.1a1/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.ruff_cache/
+.cursor
+/project_docs/
+.DS_Store

palettize-0.0.1a1/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Alex Kovac
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

palettize-0.0.1a1/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: palettize
+Version: 0.0.1a1
+Summary: A Python CLI tool for creating and exporting colormaps for data visualization and mapping applications.
+Author-email: Alex Kovac <5686693+kovaca@users.noreply.github.com>
+License-Expression: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: coloraide>=0.24
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13.0
+Requires-Dist: webcolors>=1.13
+Requires-Dist: cmap>=0.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.5; extra == "dev"
+Requires-Dist: pytest-cov>=6.1.1; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# Palettize
+
+🎨 A Python utility and CLI tool for generating, previewing, and exporting color maps.
+
+Palettize helps you create and manage colormaps for data visualization, GIS, and web mapping. It provides a simple, powerful command-line interface to:
+
+-   Generate colormaps from a list of colors or from built-in presets.
+-   Instantly preview colormaps directly in your terminal.
+-   Export colormaps to various formats suitable for different applications.
+-   Customize interpolation color space, data scaling, and slicing.
+
+## Installation
+
+This project uses `uv` for dependency management. To install from source:
+
+```bash
+git clone https://github.com/your-username/palettize.git # Replace with actual repo URL
+cd palettize
+uv pip install .
+```
+
+For development, install with the `dev` dependencies:
+
+```bash
+uv pip install -e .[dev]
+```
+
+## Usage
+
+Palettize is built on a simple `verb-noun` philosophy. You use a command like `show` or `create` and tell it what to operate on—either a `preset` name or a list of custom `--colors`.
+
+```bash
+palettize --help
+```
+
+### Key Commands
+
+-   **`palettize show`**: Render a colormap preview in your terminal.
+-   **`palettize create`**: Export a colormap to one or more file formats.
+-   **`palettize list`**: List available `presets` or `exporters`.
+
+### Examples
+
+1.  **Show a built-in preset colormap:**
+    ```bash
+    palettize show viridis
+    ```
+
+2.  **Show a custom gradient made of three colors:**
+    ```bash
+    palettize show --colors "midnightblue,orange,gold"
+    ```
+
+3.  **Export the 'spectral' preset to a GDAL color ramp file:**
+    The `--domain` flag maps the colormap to your data's range.
+    ```bash
+    palettize create spectral --format gdal --output spectral_gdal.txt --domain 0,255
+    ```
+
+4.  **Create a custom colormap and export it to multiple formats:**
+    Use `--steps` to define the number of discrete colors in the output.
+    ```bash
+    palettize create -c "blue,white,red" --format qgis,mapgl \
+      --output "output/rwb_{format}.{ext}" --steps 11 --name "RedWhiteBlue"
+    ```
+    This creates `output/rwb_qgis.xml` and `output/rwb_mapgl.json`.
+
+5.  **List all available built-in presets:**
+    ```bash
+    palettize list presets
+    ```
+
+6.  **Pass format-specific options during export:**
+    Use the `-O` or `--option` flag to pass key-value pairs to an exporter.
+    ```bash
+    # Tell the 'observable' exporter to create a diverging scale with a pivot
+    palettize create RdBu -f observable -o plot.json \
+      -O type=diverging -O pivot=0
+    ```
+
+## Features
+
+-   **Flexible Colormap Creation**: Generate colormaps from lists of colors (hex, RGB, named) or use built-in presets.
+-   **Advanced Interpolation**: Supports various color spaces for interpolation via the ColorAide library (e.g., Oklch, sRGB, LAB).
+-   **Terminal Preview**: Instantly visualize any colormap in your terminal.
+-   **Multiple Export Formats**: Supports common formats for GIS (GDAL, QGIS, SLD, Titiler) and web (MapLibre GL, Observable Plot).
+-   **Customizable Scaling**: Apply linear, power, sqrt, or log scaling to map your data domain to the colormap.
+-   **Plugin System for Exporters**: Easily extendable with new export formats.
+-   **CLI with Rich Output**: User-friendly command-line interface with clear help messages and rich formatting.
+
+## Available Presets
+
+The incredibly useful `cmap` library is a core dependency used for presets. To see a list of colormap presets, run:
+`palettize list presets`
+
+
+
+## Available Export Formats
+
+To see a list of all currently registered and available export formats, run:
+`palettize list exporters`
+
+
+

palettize-0.0.1a1/README.md

@@ -0,0 +1,104 @@
+# Palettize
+
+🎨 A Python utility and CLI tool for generating, previewing, and exporting color maps.
+
+Palettize helps you create and manage colormaps for data visualization, GIS, and web mapping. It provides a simple, powerful command-line interface to:
+
+-   Generate colormaps from a list of colors or from built-in presets.
+-   Instantly preview colormaps directly in your terminal.
+-   Export colormaps to various formats suitable for different applications.
+-   Customize interpolation color space, data scaling, and slicing.
+
+## Installation
+
+This project uses `uv` for dependency management. To install from source:
+
+```bash
+git clone https://github.com/your-username/palettize.git # Replace with actual repo URL
+cd palettize
+uv pip install .
+```
+
+For development, install with the `dev` dependencies:
+
+```bash
+uv pip install -e .[dev]
+```
+
+## Usage
+
+Palettize is built on a simple `verb-noun` philosophy. You use a command like `show` or `create` and tell it what to operate on—either a `preset` name or a list of custom `--colors`.
+
+```bash
+palettize --help
+```
+
+### Key Commands
+
+-   **`palettize show`**: Render a colormap preview in your terminal.
+-   **`palettize create`**: Export a colormap to one or more file formats.
+-   **`palettize list`**: List available `presets` or `exporters`.
+
+### Examples
+
+1.  **Show a built-in preset colormap:**
+    ```bash
+    palettize show viridis
+    ```
+
+2.  **Show a custom gradient made of three colors:**
+    ```bash
+    palettize show --colors "midnightblue,orange,gold"
+    ```
+
+3.  **Export the 'spectral' preset to a GDAL color ramp file:**
+    The `--domain` flag maps the colormap to your data's range.
+    ```bash
+    palettize create spectral --format gdal --output spectral_gdal.txt --domain 0,255
+    ```
+
+4.  **Create a custom colormap and export it to multiple formats:**
+    Use `--steps` to define the number of discrete colors in the output.
+    ```bash
+    palettize create -c "blue,white,red" --format qgis,mapgl \
+      --output "output/rwb_{format}.{ext}" --steps 11 --name "RedWhiteBlue"
+    ```
+    This creates `output/rwb_qgis.xml` and `output/rwb_mapgl.json`.
+
+5.  **List all available built-in presets:**
+    ```bash
+    palettize list presets
+    ```
+
+6.  **Pass format-specific options during export:**
+    Use the `-O` or `--option` flag to pass key-value pairs to an exporter.
+    ```bash
+    # Tell the 'observable' exporter to create a diverging scale with a pivot
+    palettize create RdBu -f observable -o plot.json \
+      -O type=diverging -O pivot=0
+    ```
+
+## Features
+
+-   **Flexible Colormap Creation**: Generate colormaps from lists of colors (hex, RGB, named) or use built-in presets.
+-   **Advanced Interpolation**: Supports various color spaces for interpolation via the ColorAide library (e.g., Oklch, sRGB, LAB).
+-   **Terminal Preview**: Instantly visualize any colormap in your terminal.
+-   **Multiple Export Formats**: Supports common formats for GIS (GDAL, QGIS, SLD, Titiler) and web (MapLibre GL, Observable Plot).
+-   **Customizable Scaling**: Apply linear, power, sqrt, or log scaling to map your data domain to the colormap.
+-   **Plugin System for Exporters**: Easily extendable with new export formats.
+-   **CLI with Rich Output**: User-friendly command-line interface with clear help messages and rich formatting.
+
+## Available Presets
+
+The incredibly useful `cmap` library is a core dependency used for presets. To see a list of colormap presets, run:
+`palettize list presets`
+
+
+
+## Available Export Formats
+
+To see a list of all currently registered and available export formats, run:
+`palettize list exporters`
+
+
+

palettize-0.0.1a1/pyproject.toml

@@ -0,0 +1,75 @@
+[project]
+name = "palettize"
+dynamic = ["version"]
+description = "A Python CLI tool for creating and exporting colormaps for data visualization and mapping applications."
+authors = [
+    { name = "Alex Kovac", email = "5686693+kovaca@users.noreply.github.com" }
+]
+license = "MIT"
+readme = {file = "README.md", content-type = "text/markdown"}
+requires-python = ">=3.9"
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+
+dependencies = [
+    "coloraide>=0.24",  
+    "typer>=0.9", 
+    "rich>=13.0",      
+    "webcolors>=1.13", 
+    "cmap>=0.6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.5",
+    "pytest-cov>=6.1.1",
+    "ruff",
+    "mypy",
+]
+
+[project.scripts]
+palettize = "palettize.cli:app"
+
+
+[build-system]
+requires = ["setuptools>=64", "setuptools_scm>=8", "wheel"]
+build-backend = "setuptools.build_meta"
+backend-path = "."
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+palettize = ["py.typed"]
+
+[tool.setuptools_scm]
+local_scheme = "no-local-version"
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+python_files = "test_*.py tests_*.py *_test.py *_tests.py"
+python_classes = "*Test* *Tests Test*"
+python_functions = "test_* *test"
+addopts = "--cov=src/palettize --cov-report=term-missing --cov-report=xml"
+
+# [[tool.uv.index]]
+# name        = "testpypi"                     
+# url         = "https://test.pypi.org/simple/"
+# publish-url = "https://test.pypi.org/legacy/"
+# explicit    = true   
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]

palettize-0.0.1a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

palettize-0.0.1a1/src/palettize/__init__.py

@@ -0,0 +1,7 @@
+"""Palettize: Python utility and CLI tool for generating and exporting color map objects."""
+
+__version__ = "0.0.1.dev0"  # Initial development version
+
+
+def hello() -> str:
+    return "Hello from palettize!"