python-lucide 0.5.10__tar.gz → 0.5.11__tar.gz

{python_lucide-0.5.10 → python_lucide-0.5.11}/.gitignore

@@ -95,10 +95,7 @@ ipython_config.py
 #Pipfile.lock
 
 # UV
-#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-uv.lock
+# uv.lock is committed: it pins development and CI, never what users install.
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.

{python_lucide-0.5.10 → python_lucide-0.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-lucide
-Version: 0.5.10
+Version: 0.5.11
 Summary: A Python package for working with Lucide icons
 Project-URL: Bug Tracker, https://github.com/mmacpherson/python-lucide/issues
 Project-URL: Homepage, https://github.com/mmacpherson/python-lucide
@@ -13,13 +13,12 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Provides-Extra: search
 Requires-Dist: cairosvg>=2.7.0; extra == 'search'
 Requires-Dist: fastembed>=0.4.0; extra == 'search'
@@ -57,12 +56,12 @@ pip install python-lucide
 ```
 This installs the package with a pre-built database of all Lucide icons, ready to use immediately.
 
-Python 3.10–3.14 are supported. **Python 3.15 support is experimental:** core
+Python 3.11–3.14 are supported. **Python 3.15 support is experimental:** core
 rendering, aliases, and SQL-backed package builds pass tests on 3.15 RC2 and have
 a dedicated CI job, but semantic search is currently unsupported because ONNX
 Runtime does not yet provide compatible wheels. Core installation remains
 available on 3.15; full support will be advertised once search is validated too.
-Use Python 3.10–3.14 for search and full development tooling. HDBSCAN and UMAP's
+Use Python 3.11–3.14 for search and full development tooling. HDBSCAN and UMAP's
 dependencies affect cluster generation during development, not ordinary searches.
 
 To run the core tests on Python 3.15 from a source checkout:
@@ -446,13 +445,17 @@ This project follows a manual release process:
 
 2. **Create and merge PR** for the version bump
 
-3. **Trigger publishing workflow**:
-   - Go to [Actions](../../actions/workflows/publish.yml)
-   - Click "Run workflow"
-   - Select the main branch
-   - Click "Run workflow"
+3. **Tag the merged commit on main** with the same version:
+   ```bash
+   git checkout main && git pull
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
 
-4. **Automatic publishing**: The `publish.yml` workflow builds and publishes the package to PyPI using trusted publishing.
+4. **Automatic publishing**: The `release.yml` workflow checks that the tag
+   matches `pyproject.toml` and is on main, runs CI on the tagged commit,
+   publishes that build to PyPI using trusted publishing, creates the GitHub
+   Release, and attaches the rebuilt search database to its `search-v*` release.
 
 ## How It Works
 The package comes with a pre-built SQLite database containing all Lucide icons. When you call `lucide_icon()`, it fetches the icon's SVG from the database and applies your customizations. This approach means:

{python_lucide-0.5.10 → python_lucide-0.5.11}/README.md

@@ -30,12 +30,12 @@ pip install python-lucide
 ```
 This installs the package with a pre-built database of all Lucide icons, ready to use immediately.
 
-Python 3.10–3.14 are supported. **Python 3.15 support is experimental:** core
+Python 3.11–3.14 are supported. **Python 3.15 support is experimental:** core
 rendering, aliases, and SQL-backed package builds pass tests on 3.15 RC2 and have
 a dedicated CI job, but semantic search is currently unsupported because ONNX
 Runtime does not yet provide compatible wheels. Core installation remains
 available on 3.15; full support will be advertised once search is validated too.
-Use Python 3.10–3.14 for search and full development tooling. HDBSCAN and UMAP's
+Use Python 3.11–3.14 for search and full development tooling. HDBSCAN and UMAP's
 dependencies affect cluster generation during development, not ordinary searches.
 
 To run the core tests on Python 3.15 from a source checkout:
@@ -419,13 +419,17 @@ This project follows a manual release process:
 
 2. **Create and merge PR** for the version bump
 
-3. **Trigger publishing workflow**:
-   - Go to [Actions](../../actions/workflows/publish.yml)
-   - Click "Run workflow"
-   - Select the main branch
-   - Click "Run workflow"
+3. **Tag the merged commit on main** with the same version:
+   ```bash
+   git checkout main && git pull
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
 
-4. **Automatic publishing**: The `publish.yml` workflow builds and publishes the package to PyPI using trusted publishing.
+4. **Automatic publishing**: The `release.yml` workflow checks that the tag
+   matches `pyproject.toml` and is on main, runs CI on the tagged commit,
+   publishes that build to PyPI using trusted publishing, creates the GitHub
+   Release, and attaches the rebuilt search database to its `search-v*` release.
 
 ## How It Works
 The package comes with a pre-built SQLite database containing all Lucide icons. When you call `lucide_icon()`, it fetches the icon's SVG from the database and applies your customizations. This approach means:

{python_lucide-0.5.10 → python_lucide-0.5.11}/pyproject.toml

@@ -32,7 +32,6 @@ classifiers = [
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -45,8 +44,8 @@ keywords = ["lucide", "icons", "svg", "sqlite"]
 license = { text = "MIT" }
 name = "python-lucide"
 readme = "README.md"
-requires-python = ">=3.10"
-version = "0.5.10"
+requires-python = ">=3.11"
+version = "0.5.11"
 
 [project.optional-dependencies]
 search = ["cairosvg>=2.7.0", "fastembed>=0.4.0"]
@@ -80,7 +79,7 @@ disallow_untyped_decorators = true
 disallow_untyped_defs = true
 ignore_missing_imports = true
 no_implicit_optional = true
-python_version = "3.10"
+python_version = "3.11"
 show_column_numbers = true
 show_error_context = true
 strict_optional = true
@@ -105,7 +104,7 @@ xfail_strict = true
 
 [tool.ruff]
 line-length = 88
-target-version = "py310"
+target-version = "py311"
 
 [tool.ruff.format]
 docstring-code-format = true
@@ -161,3 +160,8 @@ convention = "google"
 [tool.uv]
 # SQL edits must invalidate uv's cached editable build too.
 cache-keys = [{ file = "pyproject.toml" }, { file = "hatch_build.py" }, { file = "build_support.py" }, { file = "src/lucide/data/lucide-icons.sql" }]
+# fastembed (search extra) caps pillow below 13, but every pillow before 13.0.0
+# has critical advisories (GHSA-8g5g-8vmr-9782, GHSA-332p-7hrc-92wf,
+# GHSA-w889-685w-c8fh). Override it for development and CI; this doesn't change
+# what users install. Remove once fastembed allows pillow 13.
+override-dependencies = ["pillow>=13"]

{python_lucide-0.5.10 → python_lucide-0.5.11}/src/lucide/build_clusters.py

@@ -13,7 +13,7 @@ import logging
 import os
 import pathlib
 import sqlite3
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 
 from pydantic import BaseModel, field_validator
 from pydantic_ai import Agent
@@ -229,7 +229,7 @@ def save_clusters_json(
         "coords": {
             name: [round(c[0], 5), round(c[1], 5)] for name, c in data["coords"].items()
         },
-        "generated_at": datetime.now(tz=timezone.utc).isoformat(),
+        "generated_at": datetime.now(tz=UTC).isoformat(),
         "naming_model": CLUSTER_NAMING_MODEL,
     }
     output_path.write_text(json.dumps(out, indent=2, ensure_ascii=False) + "\n")

{python_lucide-0.5.10 → python_lucide-0.5.11}/src/lucide/build_search.py

@@ -26,7 +26,7 @@ import sqlite3
 import subprocess
 import threading
 import urllib.request
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from typing import TypedDict
 
 from .config import (
@@ -444,7 +444,7 @@ def generate_descriptions(  # noqa: PLR0913, PLR0915
             "lucide_version": lucide_version,
             "tags": meta["tags"],
             "categories": meta["categories"],
-            "timestamp": datetime.now(tz=timezone.utc).isoformat(),
+            "timestamp": datetime.now(tz=UTC).isoformat(),
         }
         with write_lock:
             _append_jsonl(jsonl_path, record)
@@ -598,7 +598,7 @@ def _write_search_db(  # noqa: PLR0913
         # Metadata
         first = records[ordered_names[0]]
         resolved_version = version or first.get("lucide_version", "unknown")
-        now = datetime.now(tz=timezone.utc).isoformat()
+        now = datetime.now(tz=UTC).isoformat()
         model_dims = json.dumps({mid: EMBEDDING_MODELS[mid].dim for mid in embeddings})
         for key, value in [
             ("version", resolved_version),

{python_lucide-0.5.10 → python_lucide-0.5.11}/src/lucide/config.py

@@ -6,7 +6,7 @@ This module contains default configuration values used throughout the package.
 from dataclasses import dataclass
 
 # Default Lucide tag to use when building the icon database
-DEFAULT_LUCIDE_TAG = "1.59.0"
+DEFAULT_LUCIDE_TAG = "1.61.0"
 
 # Default size for the LRU cache used by lucide_icon function
 DEFAULT_ICON_CACHE_SIZE = 128

{python_lucide-0.5.10 → python_lucide-0.5.11}/src/lucide/core.py

@@ -58,7 +58,7 @@ def _process_classes(root: ET.Element, cls: str | None, icon_name: str) -> None:
         del root.attrib["class"]
 
 
-def _apply_attributes(  # noqa: D417
+def _apply_attributes(  # noqa: D417, PLR0917
     root: ET.Element,
     width: str | int | None = None,
     height: str | int | None = None,
@@ -98,7 +98,7 @@ def _apply_attributes(  # noqa: D417
             root.set(svg_attr_name, str(value))
 
 
-def _modify_svg(  # noqa: D417
+def _modify_svg(  # noqa: D417, PLR0917
     original_svg_content: str,
     icon_name: str,
     cls: str | None,
@@ -158,7 +158,7 @@ def _modify_svg(  # noqa: D417
 
 
 @functools.lru_cache(maxsize=DEFAULT_ICON_CACHE_SIZE)
-def lucide_icon(
+def lucide_icon(  # noqa: PLR0917 -- public API; positional arguments are supported
     icon_name: str,
     cls: str = "",
     fallback_text: str | None = None,

{python_lucide-0.5.10 → python_lucide-0.5.11}/src/lucide/data/gemini-icon-descriptions.jsonl

@@ -1928,3 +1928,15 @@
 {"name": "user-round-star", "description": "This icon visually represents a stylized person icon adjacent to a star. It signifies a featured user, a favorite contact, a positive review, or a verified account. The star suggests excellence, endorsement, or special status.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.59.0", "tags": ["person", "account", "favorite", "contact", "like", "review", "rating", "admin", "avatar", "profile", "featured", "moderator", "verified", "badge", "award", "champion", "starred"], "categories": ["account"], "timestamp": "2026-10-18T15:12:33.937788+00:00"}
 {"name": "scratch-blocks", "description": "The icon depicts two interlocking, abstract blocks, suggesting a puzzle or a building process. It represents visual programming, block-based coding, and the creative act of assembling code elements for learning and integration.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.59.0", "tags": ["code", "blocks", "scratch", "turbowarp", "mistwarp", "visual programming", "block-based", "drag-and-drop", "editor", "education", "learning", "programming", "kids", "integration"], "categories": ["development"], "timestamp": "2026-10-18T15:12:33.940221+00:00"}
 {"name": "server-nas", "description": "This icon visually represents a network-attached storage device, often housing multiple disks. It evokes concepts of data storage, backup, file sharing, and local area networking, signifying robust hardware for managing and distributing digital information.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.59.0", "tags": ["storage", "network", "server", "backup", "raid", "files", "sharing", "disk", "hardware", "lan", "cloud"], "categories": ["devices", "development"], "timestamp": "2026-10-18T15:12:33.947118+00:00"}
+{"name": "tombstone", "description": "This icon depicts a simple, rounded tombstone with two horizontal lines representing an inscription. It evokes concepts of death, remembrance, memorials, and the finality of life, often associated with cemeteries and funerals.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["grave", "gravestone", "headstone", "cemetery", "graveyard", "death", "memorial", "funeral", "halloween", "rip", "obituary", "deceased", "epitaph", "mourning", "bereavement", "condolence", "deprecated", "retired", "archived", "decommissioned"], "categories": ["gaming", "navigation", "people", "development"], "timestamp": "2026-10-22T17:51:24.629752+00:00"}
+{"name": "line-height", "description": "This icon depicts the letter \"A\" centered between two horizontal lines. It visually represents the concept of line height or leading in typography, illustrating the vertical spacing between lines of text to improve readability and aesthetic presentation.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["leading", "text", "letters", "characters", "font", "typography", "spacing", "paragraph", "formatting", "editor", "readability", "typesetting"], "categories": ["text"], "timestamp": "2026-10-22T17:51:24.643352+00:00"}
+{"name": "smartphone-user-round", "description": "This icon shows a simplified outline of a smartphone with a person's silhouette positioned to the side. It visually represents managing a user profile on a mobile device, signifying personal accounts, identity management, and device ownership.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["phone", "cellphone", "device", "mobile", "person", "profile", "account", "avatar", "contact", "identity", "owner", "authentication"], "categories": ["account", "devices", "people"], "timestamp": "2026-10-22T17:51:24.661708+00:00"}
+{"name": "avocado", "description": "This icon depicts a halved avocado with its pit. It represents healthy eating, nutritious ingredients, and the vibrant flavors of Mexican cuisine, often associated with snacks, meals, and plant-based diets.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["fruit", "snack", "meal", "lunch", "ingredient", "cooking", "cookery", "kitchen", "cuisine", "eating", "healthy", "nutrition", "diet", "guacamole", "mexican", "green", "pit", "seed", "half", "produce", "vegetarian", "vegan", "grocery", "supermarket", "toast", "superfood", "plant based", "ripe"], "categories": ["food-beverage"], "timestamp": "2026-10-22T17:51:24.687912+00:00"}
+{"name": "graph-hub", "description": "This icon shows a central node connected to three outward branching nodes. It visually represents distribution, connection, and the organization of data or processes, embodying concepts of networking, parallelization, and hierarchical routing.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["load balancer", "distribute", "traffic", "network", "nodes", "parallel", "branch", "hierarchy", "routing", "dispatcher", "cluster", "backend", "fan-out", "topology", "orchestration"], "categories": ["connectivity", "development"], "timestamp": "2026-10-22T17:51:24.771466+00:00"}
+{"name": "circle-chevrons-left", "description": "This icon features two chevrons pointing left, enclosed within a circle. It visually represents moving backward or skipping to the beginning, suggesting actions like rewinding, going to the previous track, or returning to the start.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["previous", "rewind", "backward", "first", "beginning", "start", "west", "music", "caret", "button", "pagination", "skip", "skip-back", "seek-back", "media-controls", "player", "playlist", "track", "chapter", "jump", "timeline", "controls"], "categories": ["arrows", "navigation", "multimedia"], "timestamp": "2026-10-22T17:51:24.810143+00:00"}
+{"name": "circle-chevrons-right", "description": "This icon features two chevrons pointing right, enclosed within a circle. It visually represents forward motion, progress, and skipping ahead. It can also signify advancement, quick progression, or reaching the end.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["next", "forward", "skip", "fast forward", "last", "end", "east", "music", "caret", "button", "pagination", "jump", "seek", "seek forward", "player control", "chapter", "track", "timeline", "navigation control"], "categories": ["arrows", "navigation", "multimedia"], "timestamp": "2026-10-22T17:51:24.815100+00:00"}
+{"name": "brain-off", "description": "This icon visually represents a stylized brain with a diagonal line striking through it. It symbolizes concepts like mental rest, a pause in thinking, or the absence of cognitive activity, suggesting a shutdown or deactivation of the mind.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["medical", "mind", "mental", "intellect", "cerebral", "consciousness", "genius", "artificial intelligence", "ai", "think", "deep learning", "machine learning", "computing"], "categories": ["medical", "science", "development"], "timestamp": "2026-10-22T17:51:24.841486+00:00"}
+{"name": "circle-chevrons-up", "description": "This icon shows two upward-pointing chevrons within a circle. It symbolizes ascending, jumping to the top, or fast scrolling upwards. It represents progress, moving towards a goal, or returning to the beginning quickly.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["top", "ascend", "page", "page up", "back to top", "scroll", "jump", "north", "caret", "button", "skip", "pagination", "first page", "fast", "fast scroll", "rewind", "jump to start", "floating action button", "anchor", "timeline"], "categories": ["arrows", "navigation"], "timestamp": "2026-10-22T17:51:24.844362+00:00"}
+{"name": "circle-chevrons-down", "description": "This icon features two downward-pointing chevrons nested within a circle. It signifies a downward motion, progress to the end or bottom of content, or a fast scroll action. It also represents a jump or skip to the latest item in a feed or chat.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["bottom", "descend", "page", "page down", "scroll", "jump", "south", "caret", "button", "skip", "end", "last page", "latest", "feed", "chat", "pagination", "fast", "media"], "categories": ["arrows", "navigation"], "timestamp": "2026-10-22T17:51:24.845799+00:00"}
+{"name": "bacon", "description": "This icon visually depicts a wavy strip of bacon, often associated with breakfast and savory meals. It evokes the concept of delicious, indulgent food, representing a common ingredient in various dishes and a popular culinary item.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["rashers", "smoked", "streaky", "crispy", "meat", "fast food", "junk food", "snack", "dish", "restaurant", "brunch", "lunch", "meal", "savory", "savoury", "cookery", "cooking", "grilled", "barbecue", "barbeque", "bbq", "pig", "pork", "breakfast", "cured", "butcher", "sandwich", "protein", "grocery", "kitchen"], "categories": ["food-beverage"], "timestamp": "2026-10-22T17:51:24.848759+00:00"}
+{"name": "letter-spacing", "description": "This icon visually represents the letter \"A\" enclosed by vertical lines, symbolizing spacing. It conveys the concept of adjusting the space between letters or characters, essential for text formatting and design. It suggests control over typography and visual aesthetics.", "model": "gemini-2.5-flash-lite", "prompt_template_hash": "7ae15a902cba", "lucide_version": "1.61.0", "tags": ["tracking", "kerning", "design", "lettering", "text", "letters", "characters", "font", "typography", "formatting"], "categories": ["text"], "timestamp": "2026-10-22T17:51:24.852628+00:00"}