cutf 0.0.8__tar.gz

cutf-0.0.8/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  quality-and-build:
+    name: Quality And Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Run Quality Gates
+        run: make ci-quality
+
+      - name: Build Package
+        run: make build
+

cutf-0.0.8/.github/workflows/publish-chocolatey.yml

@@ -0,0 +1,63 @@
+name: Publish Chocolatey
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  ci-config:
+    name: Read CI Config
+    runs-on: ubuntu-latest
+    outputs:
+      enable_chocolatey_publish: ${{ steps.config.outputs.enable_chocolatey_publish }}
+      chocolatey_environment: ${{ steps.config.outputs.chocolatey_environment }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Export Config To GitHub Output
+        id: config
+        run: make ci-export-config
+
+  publish:
+    name: Publish To Chocolatey
+    needs: ci-config
+    if: needs.ci-config.outputs.enable_chocolatey_publish == '1'
+    runs-on: windows-latest
+    environment: ${{ needs.ci-config.outputs.chocolatey_environment }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install Make
+        run: choco install make
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Build Windows Assets
+        run: make ci-build-chocolatey-assets
+
+      - name: Pack Chocolatey Package
+        run: make ci-pack-chocolatey
+
+      - name: Publish Chocolatey Package
+        run: make ci-publish-chocolatey
+        env:
+          CHOCOLATEY_API_KEY: ${{ secrets.CHOCOLATEY_API_KEY }}
+

cutf-0.0.8/.github/workflows/publish-dockerhub.yml

@@ -0,0 +1,62 @@
+name: Publish Docker Hub
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  ci-config:
+    name: Read CI Config
+    runs-on: ubuntu-latest
+    outputs:
+      enable_dockerhub_publish: ${{ steps.config.outputs.enable_dockerhub_publish }}
+      dockerhub_environment: ${{ steps.config.outputs.dockerhub_environment }}
+      dockerhub_image: ${{ steps.config.outputs.dockerhub_image }}
+      dockerfile: ${{ steps.config.outputs.dockerfile }}
+      docker_build_context: ${{ steps.config.outputs.docker_build_context }}
+      docker_push_latest: ${{ steps.config.outputs.docker_push_latest }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Export Config To GitHub Output
+        id: config
+        run: make ci-export-config
+
+  publish:
+    name: Publish Docker Image
+    needs: ci-config
+    if: needs.ci-config.outputs.enable_dockerhub_publish == '1'
+    runs-on: ubuntu-latest
+    environment: ${{ needs.ci-config.outputs.dockerhub_environment }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Docker Hub Login
+        run: make ci-docker-login
+        env:
+          DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
+          DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Resolve Docker Image Tag
+        id: docker_tag
+        run: make ci-export-docker-tag
+
+      - name: Build And Push Docker Image
+        run: make ci-publish-dockerhub
+        env:
+          DOCKER_IMAGE_TAG: ${{ steps.docker_tag.outputs.docker_image_tag }}
+

cutf-0.0.8/.github/workflows/publish-pypi.yml

@@ -0,0 +1,58 @@
+name: Publish PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  ci-config:
+    name: Read CI Config
+    runs-on: ubuntu-latest
+    outputs:
+      enable_pypi_publish: ${{ steps.config.outputs.enable_pypi_publish }}
+      pypi_environment: ${{ steps.config.outputs.pypi_environment }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Export Config To GitHub Output
+        id: config
+        run: make ci-export-config
+
+  publish:
+    name: Publish To PyPI
+    needs: ci-config
+    if: needs.ci-config.outputs.enable_pypi_publish == '1'
+    runs-on: ubuntu-latest
+    environment: ${{ needs.ci-config.outputs.pypi_environment }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Build Package
+        run: make build-uv
+
+      - name: Publish Package
+        run: make ci-publish-pypi
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+

cutf-0.0.8/.github/workflows/release.yml

@@ -0,0 +1,169 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  ci-config:
+    name: Read CI Config
+    runs-on: ubuntu-latest
+    outputs:
+      release_branch: ${{ steps.config.outputs.release_branch }}
+      windows_installer_enabled: ${{ steps.config.outputs.windows_installer_enabled }}
+      build_linux: ${{ steps.config.outputs.build_linux }}
+      build_macos: ${{ steps.config.outputs.build_macos }}
+      build_windows: ${{ steps.config.outputs.build_windows }}
+      enable_release_docs: ${{ steps.config.outputs.enable_release_docs }}
+      release_artifacts: ${{ steps.config.outputs.release_artifacts }}
+      changelog_file: ${{ steps.config.outputs.changelog_file }}
+      release_notes_file: ${{ steps.config.outputs.release_notes_file }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Export Config To GitHub Output
+        id: config
+        run: make ci-export-config
+
+  changelog-and-release:
+    name: Generate Changelog And Create Release
+    needs: ci-config
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Install git-cliff
+        run: make ci-install-git-cliff
+
+      - name: Generate Changelog
+        run: make ci-generate-changelog
+
+      - name: Commit Changelog
+        run: make ci-commit-changelog
+
+      - name: Generate Docs
+        if: needs.ci-config.outputs.enable_release_docs == '1'
+        run: make ci-generate-docs
+
+      - name: Commit Docs
+        if: needs.ci-config.outputs.enable_release_docs == '1'
+        run: make ci-commit-docs
+
+      - name: Generate Release Notes
+        run: make ci-generate-release-notes
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: ${{ needs.ci-config.outputs.release_notes_file }}
+
+  build-linux:
+    name: Build Assets (Linux)
+    needs:
+      - ci-config
+      - changelog-and-release
+    if: needs.ci-config.outputs.build_linux == '1'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Build Release Assets
+        run: make ci-build-release-assets
+
+      - name: Upload Artifacts
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ needs.ci-config.outputs.release_artifacts }}
+
+  build-macos:
+    name: Build Assets (macOS)
+    needs:
+      - ci-config
+      - changelog-and-release
+    if: needs.ci-config.outputs.build_macos == '1'
+    runs-on: macos-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Build Release Assets
+        run: make ci-build-release-assets
+
+      - name: Upload Artifacts
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ needs.ci-config.outputs.release_artifacts }}
+
+  build-windows:
+    name: Build Assets (Windows)
+    needs:
+      - ci-config
+      - changelog-and-release
+    if: needs.ci-config.outputs.build_windows == '1'
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Make
+        run: choco install make
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Setup CI Environment
+        run: make ci-setup
+
+      - name: Build Release Assets
+        run: make ci-build-release-assets
+
+      - name: Upload Artifacts
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ needs.ci-config.outputs.release_artifacts }}
+

cutf-0.0.8/.gitignore

@@ -0,0 +1,5 @@
+.idea
+build
+dist
+cutf.spec
+temp

cutf-0.0.8/.mk-scripts/convert_logo.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python
+"""
+convert_logo.py – Convert a .svg logo to all standard icon/image formats.
+
+Usage:
+    uv run python .mk-scripts/convert_logo.py <path/to/logo.svg>
+
+Generates in the SAME directory as the source SVG:
+  • PNG  – 16, 32, 48, 64, 128, 256, 512, 1024 px
+  • JPG  – 64, 128, 256, 512, 1024 px  (white background, 95 % quality)
+  • ICO  – multi-size  (16, 24, 32, 48, 64, 128, 256 px)
+  • ICNS – macOS icon  (16, 32, 64, 128, 256, 512, 1024 px)
+
+Renderer: skia-python  – ships pre-compiled Skia wheels on PyPI,
+          zero system-library dependencies (no cairo, no ImageMagick).
+"""
+
+from __future__ import annotations
+
+import io
+import struct
+import sys
+from pathlib import Path
+
+# ── Sizes ─────────────────────────────────────────────────────────────────────
+
+PNG_SIZES  = [16, 32, 48, 64, 128, 256, 512, 1024]
+JPG_SIZES  = [64, 128, 256, 512, 1024]
+ICO_SIZES  = [16, 24, 32, 48, 64, 128, 256]
+ICNS_SIZES = [16, 32, 64, 128, 256, 512, 1024]
+
+# Apple ICNS OSType codes per pixel size (1x variants – PNG-compressed entries)
+ICNS_TYPES: dict[int, bytes] = {
+    16:   b"icp4",
+    32:   b"icp5",
+    64:   b"icp6",
+    128:  b"ic07",
+    256:  b"ic08",
+    512:  b"ic09",
+    1024: b"ic10",
+}
+
+# ── SVG renderer (skia-python) ────────────────────────────────────────────────
+
+def _render_svg(svg_path: Path, size: int) -> bytes:
+    """
+    Render *svg_path* at *size* × *size* pixels using Skia.
+    Returns raw PNG bytes (RGBA).
+    """
+    import skia  # type: ignore[import-untyped]
+
+    svg_bytes = svg_path.read_bytes()
+    stream    = skia.MemoryStream(svg_bytes)
+    svg_dom   = skia.SVGDOM.MakeFromStream(stream)
+    if svg_dom is None:
+        raise RuntimeError(f"Skia could not parse SVG: {svg_path}")
+
+    surface = skia.Surface(size, size)
+    with surface as canvas:
+        canvas.clear(skia.ColorTRANSPARENT)
+        svg_dom.setContainerSize(skia.Size.Make(size, size))
+        svg_dom.render(canvas)
+
+    image   = surface.makeImageSnapshot()
+    png_data = image.encodeToData()
+    return bytes(png_data)
+
+
+# ── Image helpers ─────────────────────────────────────────────────────────────
+
+def _open_rgba(png_bytes: bytes):
+    """Open raw PNG bytes as a PIL RGBA Image."""
+    from PIL import Image  # type: ignore[import-untyped]
+    return Image.open(io.BytesIO(png_bytes)).convert("RGBA")
+
+
+def _resize(base_img, size: int):
+    from PIL import Image  # type: ignore[import-untyped]
+    return base_img.resize((size, size), Image.LANCZOS)
+
+
+def _to_png_bytes(img) -> bytes:
+    buf = io.BytesIO()
+    img.save(buf, format="PNG", optimize=True)
+    return buf.getvalue()
+
+
+# ── ICNS builder ──────────────────────────────────────────────────────────────
+
+def _build_icns(png_map: dict[int, bytes]) -> bytes:
+    """
+    Hand-craft an ICNS binary from {size: png_bytes}.
+
+    ICNS layout:
+        magic   4 bytes  b"icns"
+        length  4 bytes  total file length (big-endian uint32)
+        entries …
+            type    4 bytes
+            length  4 bytes  (type + length + data)
+            data    N bytes  PNG bytes (ic07 … ic10 / icp4 … icp6)
+    """
+    body = b""
+    for size in sorted(png_map):
+        ostype = ICNS_TYPES.get(size)
+        if ostype is None:
+            continue
+        data  = png_map[size]
+        body += ostype + struct.pack(">I", 8 + len(data)) + data
+    return b"icns" + struct.pack(">I", 8 + len(body)) + body
+
+
+# ── Main conversion ───────────────────────────────────────────────────────────
+
+def convert(svg_path: Path) -> None:
+    if not svg_path.exists():
+        print(f"ERROR: file not found: {svg_path}", file=sys.stderr)
+        sys.exit(1)
+    if svg_path.suffix.lower() != ".svg":
+        print(f"ERROR: expected a .svg file, got: {svg_path}", file=sys.stderr)
+        sys.exit(1)
+
+    out_dir = svg_path.parent
+    stem    = svg_path.stem
+
+    print(f"Source : {svg_path}")
+    print(f"Output : {out_dir}/")
+    print()
+
+    # Render at the largest size once; downscale from that master image.
+    max_size = max(PNG_SIZES + ICNS_SIZES)
+    print(f"Rendering SVG at {max_size}×{max_size} px (skia-python) …")
+    base_img = _open_rgba(_render_svg(svg_path, max_size))
+    print()
+
+    from PIL import Image as _Image  # type: ignore[import-untyped]
+
+    # ── PNG ──────────────────────────────────────────────────────────────────
+    print("PNG files:")
+    for size in PNG_SIZES:
+        img      = _resize(base_img, size)
+        out_path = out_dir / f"{stem}-{size}x{size}.png"
+        img.save(out_path, format="PNG", optimize=True)
+        print(f"  {out_path}")
+    print()
+
+    # ── JPG ──────────────────────────────────────────────────────────────────
+    print("JPG files:")
+    for size in JPG_SIZES:
+        rgba = _resize(base_img, size)
+        bg   = _Image.new("RGB", (size, size), (255, 255, 255))
+        bg.paste(rgba, mask=rgba.split()[3])        # composite over white bg
+        out_path = out_dir / f"{stem}-{size}x{size}.jpg"
+        bg.save(out_path, format="JPEG", quality=95, optimize=True)
+        print(f"  {out_path}")
+    print()
+
+    # ── ICO ───────────────────────────────────────────────────────────────────
+    print("ICO file:")
+    ico_images = [_resize(base_img, s) for s in ICO_SIZES]
+    ico_path   = out_dir / f"{stem}.ico"
+    ico_images[0].save(
+        ico_path,
+        format="ICO",
+        sizes=[(s, s) for s in ICO_SIZES],
+        append_images=ico_images[1:],
+    )
+    print(f"  {ico_path}")
+    print()
+
+    # ── ICNS ─────────────────────────────────────────────────────────────────
+    print("ICNS file:")
+    icns_png_map = {s: _to_png_bytes(_resize(base_img, s)) for s in ICNS_SIZES}
+    icns_path    = out_dir / f"{stem}.icns"
+    icns_path.write_bytes(_build_icns(icns_png_map))
+    print(f"  {icns_path}")
+    print()
+
+    print("Done.")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python convert_logo.py <path/to/logo.svg>", file=sys.stderr)
+        sys.exit(1)
+    convert(Path(sys.argv[1]))
+
+

cutf-0.0.8/.mk-scripts/gen-project-py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python
+from pathlib import Path
+import sys
+import tomllib
+
+
+def main() -> int:
+    if len(sys.argv) != 3:
+        print(
+            "Usage: python .mk-scripts/gen-project-py <pyproject.toml> <output.py>",
+            file=sys.stderr,
+        )
+        return 1
+
+    pyproject_path = Path(sys.argv[1])
+    py_file = Path(sys.argv[2])
+
+    try:
+        if not pyproject_path.exists():
+            raise FileNotFoundError(f"File {pyproject_path} does not exist.")
+
+        with pyproject_path.open("rb") as f:
+            data = tomllib.load(f)
+
+        project = data.get("project", {})
+        raw_authors = project.get("authors", [])
+        authors: list[tuple[str | None, str | None]] = []
+        for entry in raw_authors:
+            name = entry.get("name")
+            email = entry.get("email")
+            if name or email:
+                authors.append((name, email))
+
+        info = {
+            "name": project.get("name"),
+            "version": project.get("version"),
+            "description": project.get("description"),
+            "requires_python": project.get("requires-python"),
+            "authors": authors,
+        }
+
+        authors_repr = "[" + ", ".join(
+            f"({repr(name)}, {repr(email)})" for name, email in info["authors"]
+        ) + "]"
+
+        lines = [
+            "# fmt: off",
+            "name = " + repr(info["name"]),
+            "version = " + repr(info["version"]),
+            "description = " + repr(info["description"]),
+            "requires_python = " + repr(info["requires_python"]),
+            "authors = " + authors_repr,
+            "# fmt: on",
+        ]
+
+        py_file.parent.mkdir(parents=True, exist_ok=True)
+        with py_file.open("w", encoding="utf-8") as f:
+            f.write("\n".join(lines) + "\n")
+
+        print(f"Generated: {py_file}")
+        return 0
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+