django-lucide 1.2.0__py3-none-any.whl

django_lucide-1.2.0.dist-info/METADATA

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: django-lucide
+Version: 1.2.0
+Summary: Use lucide in your Django and Jinja templates.
+Author-email: Francisco Macedo <me@fmacedo.com>
+License: MIT
+Project-URL: Changelog, https://github.com/franciscobmacedo/lucide/blob/main/CHANGELOG.md
+Project-URL: Funding, https://ko-fi.com/fmacedo
+Project-URL: Repository, https://github.com/franciscobmacedo/lucide
+Keywords: Django
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+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 :: Implementation :: CPython
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: django
+Requires-Dist: django>=2.2; extra == "django"
+Provides-Extra: jinja
+Requires-Dist: jinja2>=2.8; extra == "jinja"
+Dynamic: license-file
+
+# lucide
+
+Use [Lucide icons](https://lucide.dev/) in your Django and Jinja templates.
+
+> **Fork of [franciscobmacedo/lucide](https://github.com/franciscobmacedo/lucide)** with additional features:
+> - Dynamic template attribute rendering (use `{{ variables }}` in attributes)
+> - Icon alias support with deprecation warnings (246 aliases)
+> - Automatic icon updates via GitHub Actions
+
+## Requirements
+
+Python 3.8 to 3.12 supported.
+
+Django 3.2 to 5.0 supported.
+
+## Installation
+
+```bash
+pip install django-lucide
+```
+
+## Usage
+
+The `lucide` package supports both Django templates and Jinja templates.
+
+### Django templates
+
+1. Add to your `INSTALLED_APPS`:
+
+    ```python
+    INSTALLED_APPS = [
+        ...,
+        "lucide",
+        ...,
+    ]
+    ```
+
+2. Load the template library:
+
+    ```django
+    {% load lucide %}
+    ```
+
+3. Use icons:
+
+    ```django
+    {% lucide "arrow-down" %}
+    {% lucide "arrow-down" size=40 class="mr-4" %}
+    {% lucide "arrow-down" stroke_width=1 data_controller="icon" %}
+    ```
+
+#### Dynamic attributes
+
+You can use template variables in attributes:
+
+```django
+{% lucide "user" class="{{ css_class }}" data-id="{{ user.id }}" %}
+```
+
+#### Icon aliases
+
+Old icon names automatically resolve to new names with a deprecation warning:
+
+```django
+{% lucide "edit-2" %}  {# Works, but warns to use "pen" instead #}
+```
+
+### Jinja templates
+
+1. Add the global function to your environment:
+
+    ```python
+    from lucide.jinja import lucide
+    from jinja2 import Environment
+
+    env = Environment()
+    env.globals.update({"lucide": lucide})
+    ```
+
+2. Use icons:
+
+    ```jinja
+    {{ lucide("arrow-down") }}
+    {{ lucide("arrow-down", size=40, class="mr-4") }}
+    ```
+
+## Icon reference
+
+Browse all available icons at [lucide.dev/icons](https://lucide.dev/icons/).
+
+## Acknowledgements
+
+- Original package by [franciscobmacedo](https://github.com/franciscobmacedo/lucide)
+- Inspired by [Adam Johnson's heroicons](https://github.com/adamchainz/heroicons)

django_lucide-1.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+django_lucide-1.2.0.dist-info/licenses/LICENSE,sha256=giQ34SCBLlgHTV4u1GYERElJLV-y_59xNDf95rNkhKA,2039
+lucide/__init__.py,sha256=ujIrBOkMJ7Uxtos5XymkWJ6fJ2UeRCLp4yIKmcp1XHU,3249
+lucide/_compat.py,sha256=9CsDL4Gwi7v7ESDAEZV2iWurecfChHQVjk56MqxzF4E,778
+lucide/aliases.json,sha256=fqNfivlisrRW41vhuBN5n_xifeB770EpP2g2_yq18Jg,9156
+lucide/jinja.py,sha256=Yach1qdVEnR0jMOIqdFWBxdE-61pOE5vyLOlIE0a8lI,350
+lucide/lucide.zip,sha256=boOujNArFYrIxwcaM2ubNU_TXlxx4EZWxVM702_2MlY,625790
+lucide/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lucide/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lucide/templatetags/lucide.py,sha256=SXiLPaDFj_hcm9qUNkMGAuo0JEyFyETcj7g4vELrRTo,1967
+django_lucide-1.2.0.dist-info/METADATA,sha256=z53Kq3WeYS7b5WSg68O6soEf2qYQCMUT-CWJiAjRnR4,3476
+django_lucide-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+django_lucide-1.2.0.dist-info/top_level.txt,sha256=kB-N0BjFblvzHlNhWT73sXeCYCWbbhuvfRMaEoVYECM,7
+django_lucide-1.2.0.dist-info/RECORD,,

django_lucide-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

django_lucide-1.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,39 @@
+MIT License
+
+Copyright (c) 2021 Adam Johnson
+Copyright (c) 2024 Francisco Macedo
+
+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.
+
+
+The contained Lucide zip file is distributed under MIT License:
+
+Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part of Feather (MIT). All other copyright (c) for Lucide are held by Lucide Contributors 2022.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

django_lucide-1.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+lucide

lucide/__init__.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+import functools
+import json
+import warnings
+from contextlib import closing
+from copy import deepcopy
+from xml.etree import ElementTree
+from zipfile import ZipFile
+
+from lucide._compat import open_binary
+from lucide._compat import open_text
+from lucide._compat import str_removeprefix
+
+
+class IconDoesNotExist(Exception):
+    pass
+
+
+@functools.lru_cache(maxsize=1)
+def _load_aliases() -> dict[str, str]:
+    """Load alias mappings from aliases.json."""
+    try:
+        aliases_data = open_text("lucide", "aliases.json")
+        with closing(aliases_data):
+            return json.load(aliases_data)
+    except FileNotFoundError:
+        return {}
+
+
+def _resolve_icon_name(name: str) -> tuple[str, bool]:
+    """
+    Resolve icon name, checking aliases if needed.
+    Returns (resolved_name, was_alias).
+    """
+    aliases = _load_aliases()
+    if name in aliases:
+        return aliases[name], True
+    return name, False
+
+
+@functools.lru_cache(maxsize=128)
+def _load_icon_svg(name: str) -> ElementTree.Element:
+    """Load icon SVG by exact name (no alias resolution)."""
+    zip_data = open_binary("lucide", "lucide.zip")
+    with closing(zip_data), ZipFile(zip_data, "r") as zip_file:
+        try:
+            svg_bytes = zip_file.read(f"{name}.svg")
+        except KeyError:
+            raise IconDoesNotExist(f"The icon {name!r} does not exist.")
+
+        svg = ElementTree.fromstring(svg_bytes.decode())
+        for node in svg.iter():
+            # Prevent output using the 'ns0' prefix for tags
+            node.tag = ElementTree.QName(
+                str_removeprefix(node.tag, "{http://www.w3.org/2000/svg}")
+            )  # type: ignore[assignment]  # unclear if really allowed
+        return svg
+
+
+def _load_icon(name: str) -> ElementTree.Element:
+    """Load icon by name, resolving aliases with deprecation warning."""
+    try:
+        return _load_icon_svg(name)
+    except IconDoesNotExist:
+        # Try alias resolution
+        resolved_name, was_alias = _resolve_icon_name(name)
+        if was_alias:
+            warnings.warn(
+                f"Icon '{name}' is deprecated, use '{resolved_name}' instead.",
+                DeprecationWarning,
+                stacklevel=4,  # Point to the template/caller
+            )
+            return _load_icon_svg(resolved_name)
+        raise
+
+
+_PATH_ATTR_NAMES = frozenset(
+    {
+        "stroke-linecap",
+        "stroke-linejoin",
+        "vector-effect",
+    }
+)
+
+
+def _render_icon(name: str, size: int | None, **kwargs: object) -> str:
+    svg = deepcopy(_load_icon(name))
+    if size is not None:
+        svg.attrib["width"] = svg.attrib["height"] = str(size)
+
+    svg_attrs = {}
+    path_attrs = {}
+    for raw_name, value in kwargs.items():
+        attr_name = raw_name.replace("_", "-")
+        if attr_name in _PATH_ATTR_NAMES:
+            path_attrs[attr_name] = str(value)
+        else:
+            svg_attrs[attr_name] = str(value)
+
+    svg.attrib.update(svg_attrs)
+    if path_attrs:
+        for path in svg.findall("path"):
+            path.attrib.update(path_attrs)
+
+    string = ElementTree.tostring(svg, encoding="unicode")
+    # Inline SVG's don't need xmlns
+    return string.replace(' xmlns="http://www.w3.org/2000/svg"', "", 1)

lucide/_compat.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import sys
+from typing import IO
+
+if sys.version_info < (3, 9):
+
+    def str_removeprefix(self: str, prefix: str) -> str:
+        if self.startswith(prefix):
+            return self[len(prefix) :]
+        else:  # pragma: no cover
+            return self[:]
+
+else:
+    str_removeprefix = str.removeprefix
+
+
+if sys.version_info >= (3, 9):
+    from importlib.resources import files
+
+    def open_binary(pkg: str, filename: str) -> IO[bytes]:
+        return (files(pkg) / filename).open("rb")
+
+    def open_text(pkg: str, filename: str) -> IO[str]:
+        return (files(pkg) / filename).open("r", encoding="utf-8")
+
+else:
+    from importlib.resources import open_binary  # noqa: F401
+    from importlib.resources import open_text  # noqa: F401

lucide/aliases.json

@@ -0,0 +1,248 @@
+{
+  "activity-square": "square-activity",
+  "alarm-check": "alarm-clock-check",
+  "alarm-minus": "alarm-clock-minus",
+  "alarm-plus": "alarm-clock-plus",
+  "alert-circle": "circle-alert",
+  "alert-octagon": "octagon-alert",
+  "alert-triangle": "triangle-alert",
+  "align-center": "text-align-center",
+  "align-justify": "text-align-justify",
+  "align-left": "text-align-start",
+  "align-right": "text-align-end",
+  "area-chart": "chart-area",
+  "arrow-down-01": "arrow-down-0-1",
+  "arrow-down-10": "arrow-down-1-0",
+  "arrow-down-az": "arrow-down-a-z",
+  "arrow-down-circle": "circle-arrow-down",
+  "arrow-down-left-from-circle": "circle-arrow-out-down-left",
+  "arrow-down-left-from-square": "square-arrow-out-down-left",
+  "arrow-down-left-square": "square-arrow-down-left",
+  "arrow-down-right-from-circle": "circle-arrow-out-down-right",
+  "arrow-down-right-from-square": "square-arrow-out-down-right",
+  "arrow-down-right-square": "square-arrow-down-right",
+  "arrow-down-square": "square-arrow-down",
+  "arrow-down-za": "arrow-down-z-a",
+  "arrow-left-circle": "circle-arrow-left",
+  "arrow-left-square": "square-arrow-left",
+  "arrow-right-circle": "circle-arrow-right",
+  "arrow-right-square": "square-arrow-right",
+  "arrow-up-01": "arrow-up-0-1",
+  "arrow-up-10": "arrow-up-1-0",
+  "arrow-up-az": "arrow-up-a-z",
+  "arrow-up-circle": "circle-arrow-up",
+  "arrow-up-left-from-circle": "circle-arrow-out-up-left",
+  "arrow-up-left-from-square": "square-arrow-out-up-left",
+  "arrow-up-left-square": "square-arrow-up-left",
+  "arrow-up-right-from-circle": "circle-arrow-out-up-right",
+  "arrow-up-right-from-square": "square-arrow-out-up-right",
+  "arrow-up-right-square": "square-arrow-up-right",
+  "arrow-up-square": "square-arrow-up",
+  "arrow-up-za": "arrow-up-z-a",
+  "asterisk-square": "square-asterisk",
+  "axis-3-d": "axis-3d",
+  "badge-help": "badge-question-mark",
+  "bar-chart": "chart-no-axes-column-increasing",
+  "bar-chart-2": "chart-no-axes-column",
+  "bar-chart-3": "chart-column",
+  "bar-chart-4": "chart-column-increasing",
+  "bar-chart-big": "chart-column-big",
+  "bar-chart-horizontal": "chart-bar",
+  "bar-chart-horizontal-big": "chart-bar-big",
+  "between-horizonal-end": "between-horizontal-end",
+  "between-horizonal-start": "between-horizontal-start",
+  "book-template": "book-dashed",
+  "box-select": "square-dashed",
+  "candlestick-chart": "chart-candlestick",
+  "check-circle": "circle-check-big",
+  "check-circle-2": "circle-check",
+  "check-square": "square-check-big",
+  "check-square-2": "square-check",
+  "chevron-down-circle": "circle-chevron-down",
+  "chevron-down-square": "square-chevron-down",
+  "chevron-left-circle": "circle-chevron-left",
+  "chevron-left-square": "square-chevron-left",
+  "chevron-right-circle": "circle-chevron-right",
+  "chevron-right-square": "square-chevron-right",
+  "chevron-up-circle": "circle-chevron-up",
+  "chevron-up-square": "square-chevron-up",
+  "chrome": "chromium",
+  "circle-help": "circle-question-mark",
+  "circle-slashed": "circle-slash-2",
+  "clipboard-edit": "clipboard-pen",
+  "clipboard-signature": "clipboard-pen-line",
+  "code-2": "code-xml",
+  "code-square": "square-code",
+  "columns": "columns-2",
+  "columns-settings": "columns-3-cog",
+  "contact-2": "contact-round",
+  "curly-braces": "braces",
+  "divide-circle": "circle-divide",
+  "divide-square": "square-divide",
+  "dot-square": "square-dot",
+  "download-cloud": "cloud-download",
+  "edit": "square-pen",
+  "edit-2": "pen",
+  "edit-3": "pen-line",
+  "equal-square": "square-equal",
+  "file-audio": "file-headphone",
+  "file-audio-2": "file-headphone",
+  "file-axis-3-d": "file-axis-3d",
+  "file-badge-2": "file-badge",
+  "file-bar-chart": "file-chart-column-increasing",
+  "file-bar-chart-2": "file-chart-column",
+  "file-check-2": "file-check-corner",
+  "file-code-2": "file-code-corner",
+  "file-cog-2": "file-cog",
+  "file-edit": "file-pen",
+  "file-json": "file-braces",
+  "file-json-2": "file-braces-corner",
+  "file-key-2": "file-key",
+  "file-line-chart": "file-chart-line",
+  "file-lock-2": "file-lock",
+  "file-minus-2": "file-minus-corner",
+  "file-pie-chart": "file-chart-pie",
+  "file-plus-2": "file-plus-corner",
+  "file-question": "file-question-mark",
+  "file-search-2": "file-search-corner",
+  "file-signature": "file-pen-line",
+  "file-type-2": "file-type-corner",
+  "file-video": "file-play",
+  "file-video-2": "file-video-camera",
+  "file-volume-2": "file-signal",
+  "file-warning": "file-exclamation-point",
+  "file-x-2": "file-x-corner",
+  "filter": "funnel",
+  "filter-x": "funnel-x",
+  "fingerprint": "fingerprint-pattern",
+  "folder-cog-2": "folder-cog",
+  "folder-edit": "folder-pen",
+  "fork-knife": "utensils",
+  "fork-knife-crossed": "utensils-crossed",
+  "form-input": "rectangle-ellipsis",
+  "function-square": "square-function",
+  "gantt-chart": "chart-no-axes-gantt",
+  "gantt-chart-square": "square-chart-gantt",
+  "gauge-circle": "circle-gauge",
+  "git-commit": "git-commit-horizontal",
+  "globe-2": "earth",
+  "grab": "hand-grab",
+  "grid": "grid-3x3",
+  "grid-2-x-2": "grid-2x2",
+  "grid-2-x-2-check": "grid-2x2-check",
+  "grid-2-x-2-plus": "grid-2x2-plus",
+  "grid-2-x-2-x": "grid-2x2-x",
+  "grid-3-x-3": "grid-3x3",
+  "help-circle": "circle-question-mark",
+  "helping-hand": "hand-helping",
+  "home": "house",
+  "ice-cream": "ice-cream-cone",
+  "ice-cream-2": "ice-cream-bowl",
+  "indent": "list-indent-increase",
+  "indent-decrease": "list-indent-decrease",
+  "indent-increase": "list-indent-increase",
+  "inspect": "square-mouse-pointer",
+  "kanban-square": "square-kanban",
+  "kanban-square-dashed": "square-dashed-kanban",
+  "laptop-2": "laptop-minimal",
+  "layers-3": "layers",
+  "layout": "panels-top-left",
+  "letter-text": "text-initial",
+  "library-square": "square-library",
+  "line-chart": "chart-line",
+  "loader-2": "loader-circle",
+  "location-edit": "map-pin-pen",
+  "m-square": "square-m",
+  "mail-question": "mail-question-mark",
+  "menu-square": "square-menu",
+  "message-circle-question": "message-circle-question-mark",
+  "mic-2": "mic-vocal",
+  "minus-circle": "circle-minus",
+  "minus-square": "square-minus",
+  "more-horizontal": "ellipsis",
+  "more-vertical": "ellipsis-vertical",
+  "mouse-pointer-square-dashed": "square-dashed-mouse-pointer",
+  "move-3-d": "move-3d",
+  "outdent": "list-indent-decrease",
+  "paintbrush-2": "paintbrush-vertical",
+  "palmtree": "tree-palm",
+  "panel-bottom-inactive": "panel-bottom-dashed",
+  "panel-left-inactive": "panel-left-dashed",
+  "panel-right-inactive": "panel-right-dashed",
+  "panel-top-inactive": "panel-top-dashed",
+  "panels-left-right": "columns-3",
+  "panels-top-bottom": "rows-3",
+  "parking-circle": "circle-parking",
+  "parking-circle-off": "circle-parking-off",
+  "parking-square": "square-parking",
+  "parking-square-off": "square-parking-off",
+  "pause-circle": "circle-pause",
+  "pause-octagon": "octagon-pause",
+  "pen-box": "square-pen",
+  "pen-square": "square-pen",
+  "percent-circle": "circle-percent",
+  "percent-diamond": "diamond-percent",
+  "percent-square": "square-percent",
+  "pi-square": "square-pi",
+  "pie-chart": "chart-pie",
+  "pilcrow-square": "square-pilcrow",
+  "play-circle": "circle-play",
+  "play-square": "square-play",
+  "plug-zap-2": "plug-zap",
+  "plus-circle": "circle-plus",
+  "plus-square": "square-plus",
+  "power-circle": "circle-power",
+  "power-square": "square-power",
+  "rotate-3-d": "rotate-3d",
+  "rows": "rows-2",
+  "scale-3-d": "scale-3d",
+  "scatter-chart": "chart-scatter",
+  "school-2": "university",
+  "scissors-square": "square-scissors",
+  "scissors-square-dashed-bottom": "square-bottom-dashed-scissors",
+  "send-horizonal": "send-horizontal",
+  "shield-close": "shield-x",
+  "shield-question": "shield-question-mark",
+  "sidebar": "panel-left",
+  "sidebar-close": "panel-left-close",
+  "sidebar-open": "panel-left-open",
+  "sigma-square": "square-sigma",
+  "slash-square": "square-slash",
+  "sliders": "sliders-vertical",
+  "sort-asc": "arrow-up-narrow-wide",
+  "sort-desc": "arrow-down-wide-narrow",
+  "split-square-horizontal": "square-split-horizontal",
+  "split-square-vertical": "square-split-vertical",
+  "square-gantt-chart": "square-chart-gantt",
+  "stars": "sparkles",
+  "stop-circle": "circle-stop",
+  "subtitles": "captions",
+  "table-config": "columns-3-cog",
+  "terminal-square": "square-terminal",
+  "test-tube-2": "test-tube-diagonal",
+  "text": "text-align-start",
+  "text-selection": "text-select",
+  "train": "tram-front",
+  "tv-2": "tv-minimal",
+  "unlock": "lock-open",
+  "unlock-keyhole": "lock-keyhole-open",
+  "upload-cloud": "cloud-upload",
+  "user-2": "user-round",
+  "user-check-2": "user-round-check",
+  "user-circle": "circle-user",
+  "user-circle-2": "circle-user-round",
+  "user-cog-2": "user-round-cog",
+  "user-minus-2": "user-round-minus",
+  "user-plus-2": "user-round-plus",
+  "user-square": "square-user",
+  "user-square-2": "square-user-round",
+  "user-x-2": "user-round-x",
+  "users-2": "users-round",
+  "verified": "badge-check",
+  "wallet-2": "wallet-minimal",
+  "wand-2": "wand-sparkles",
+  "wrap-text": "text-wrap",
+  "x-circle": "circle-x",
+  "x-octagon": "octagon-x",
+  "x-square": "square-x"
+}

lucide/jinja.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from markupsafe import Markup
+
+import lucide as _lucide
+
+
+def lucide(name: str, *, size: int | None = 24, **kwargs: object) -> str:
+    return _render_icon(name, size, **kwargs)
+
+
+def _render_icon(name: str, size: int | None, **kwargs: object) -> str:
+    return Markup(_lucide._render_icon(name, size, **kwargs))

lucide/templatetags/lucide.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from django import template
+from django.template import Context, Template, TemplateSyntaxError
+from django.utils.safestring import SafeString, mark_safe
+
+import lucide as _lucide
+
+register = template.Library()
+
+
+@register.simple_tag(takes_context=True) # Added takes_context=True
+def lucide(context: Context, name: str, *, size: int | None = 24, **kwargs: object) -> str:
+    return _render_icon(context, name, size, **kwargs) # Pass context
+
+
+def _render_icon(context: Context, name: str, size: int | None, **kwargs: object) -> str:
+    processed_kwargs = {}
+    for key, value in kwargs.items():
+        # Original SafeString to str conversion logic
+        value_to_process = value + "" if isinstance(value, SafeString) else value
+
+        if isinstance(value_to_process, str) and \
+           ("{" in value_to_process and ("{{" in value_to_process or "{%" in value_to_process)):
+            # If the string value appears to contain Django template syntax,
+            # try to render it using the current template context.
+            try:
+                # Create a Template object from the attribute value and render it
+                attr_template = Template(value_to_process)
+                processed_kwargs[key] = attr_template.render(context)
+            except TemplateSyntaxError:
+                # In case of a syntax error within the attribute's template string,
+                # fall back to using the original (un-rendered) string.
+                # This prevents breaking templates with unintentional or malformed template syntax in attributes.
+                processed_kwargs[key] = value_to_process
+        else:
+            # Value is not a string or does not appear to contain template syntax.
+            # Use it as is (after SafeString conversion if applicable).
+            processed_kwargs[key] = value_to_process
+            
+    return mark_safe(_lucide._render_icon(name, size, **processed_kwargs))