python-lucide 0.5.4__tar.gz → 0.5.6__tar.gz

python_lucide-0.5.6/.beads/README.md

@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --claim
+bd update <issue-id> --status done
+
+# Sync with Dolt remote
+bd dolt push
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in Dolt database with version control and branching
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Dolt-native three-way merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡

python_lucide-0.5.6/.gitignore

@@ -0,0 +1,191 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#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
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Claude Code local settings
+.claude/
+
+# Beads / Dolt files (added by bd init)
+.dolt/
+*.db
+.beads-credential-key
+
+# Web SPA (Svelte/Vite) — source lives on feat/semantic-search-web
+web/node_modules/
+web/public/data/
+web/dist/
+!web/src/lib/
+
+# Generated embedding/cluster visualizations
+lucide-*-map.html

python_lucide-0.5.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mike Macpherson
+
+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.

python_lucide-0.5.6/Makefile

@@ -0,0 +1,124 @@
+# Makefile for python-lucide development
+
+# Variables
+UV_CMD := uv
+PRE_COMMIT_CMD := $(UV_CMD) run pre-commit
+PYTEST_CMD := $(UV_CMD) run pytest
+LUCIDE_CMD := $(UV_CMD) run lucide
+
+# Get default Lucide tag from the package's config.py
+PYTHON_CMD_FOR_TAG := $(UV_CMD) run python -c "from lucide.config import DEFAULT_LUCIDE_TAG; print(DEFAULT_LUCIDE_TAG)"
+DEFAULT_LUCIDE_TAG := $(shell $(PYTHON_CMD_FOR_TAG))
+# Allow overriding the tag via make argument, e.g., make db TAG=0.500.0
+TAG ?= $(DEFAULT_LUCIDE_TAG)
+DB_OUTPUT_PATH := src/lucide/data/lucide-icons.db
+SEARCH_DB_OUTPUT_PATH := src/lucide/data/lucide-search.db
+DESCRIPTIONS_JSONL := src/lucide/data/gemini-icon-descriptions.jsonl
+VENV_DIR := .venv
+
+# Phony targets prevent conflicts with files of the same name.
+.PHONY: help default env lucide-db restore-db describe build-search cluster search-data lucide-db-full test install-hooks run-hooks-all-files check-lucide-version clean nuke
+
+# Default target
+default: help
+
+help:
+	@echo "Makefile for python-lucide development"
+	@echo ""
+	@echo "Usage: make [target]"
+	@echo ""
+	@echo "Available targets:"
+	@echo "  help                   Show this help message."
+	@echo "  env                    Set up the development environment (creates $(VENV_DIR) and installs dependencies)."
+	@echo "  lucide-db              (Re)builds the Lucide icon database into $(DB_OUTPUT_PATH)."
+	@echo "                         Uses TAG=$(TAG). Default TAG is read from src/lucide/config.py (currently $(DEFAULT_LUCIDE_TAG))."
+	@echo "                         Example: make lucide-db TAG=0.520.0"
+	@echo "  restore-db             Restore SQLite from the checked-in SQL without downloading icons."
+	@echo "  describe               Generate icon descriptions via VLM (requires GEMINI_API_KEY)."
+	@echo "  build-search           Build search SQLite DB from descriptions JSONL."
+	@echo "  cluster                Regenerate semantic clusters from the search DB (requires GEMINI_API_KEY)."
+	@echo "  search-data            Run describe + build-search + cluster, then rebuild with fresh clusters."
+	@echo "  lucide-db-full         Build icons database + search data."
+	@echo "  test                   Run tests using pytest."
+	@echo "  install-hooks          Install pre-commit hooks."
+	@echo "  update-hooks           Update pre-commit hooks to latest version."
+	@echo "  run-hooks-all-files    Run all pre-commit hooks on all files."
+	@echo "  check-lucide-version   Check if Lucide version/artifacts need updating."
+	@echo "  clean                  Remove build artifacts, __pycache__, .pytest_cache, .ruff_cache, coverage data, etc."
+	@echo "  nuke                   A more thorough clean: runs 'clean', 'uv cache clean', and removes $(VENV_DIR)."
+	@echo ""
+
+env: $(VENV_DIR)/pyvenv.cfg
+	@echo "Installing/updating development dependencies into $(VENV_DIR)..."
+	$(UV_CMD) pip install -e ".[dev]"
+	@echo "Development environment ready in $(VENV_DIR)/."
+
+$(VENV_DIR)/pyvenv.cfg:
+	@echo "Creating virtual environment in $(VENV_DIR)/ using $(UV_CMD)..."
+	$(UV_CMD) venv $(VENV_DIR)
+
+lucide-db:
+	@echo "Building Lucide icon database with tag $(TAG) into $(DB_OUTPUT_PATH)..."
+	@mkdir -p src/lucide/data # Ensure data directory exists
+	$(LUCIDE_CMD) db -o $(DB_OUTPUT_PATH) -t $(TAG) -v
+	$(UV_CMD) run --no-sync python build_support.py export
+	@echo "Database build complete: $(DB_OUTPUT_PATH)"
+
+restore-db:
+	$(UV_CMD) run python build_support.py restore
+
+describe:
+	@echo "Generating icon descriptions..."
+	$(LUCIDE_CMD) describe --icons-db $(DB_OUTPUT_PATH) -o $(DESCRIPTIONS_JSONL) -v
+
+CLUSTERS_JSON := src/lucide/data/lucide-icon-clusters.json
+
+build-search:
+	@echo "Building search DB from descriptions..."
+	$(LUCIDE_CMD) build-search --descriptions-file $(DESCRIPTIONS_JSONL) --clusters-file $(CLUSTERS_JSON) --icons-db $(DB_OUTPUT_PATH) -o $(SEARCH_DB_OUTPUT_PATH) -v
+
+cluster:
+	@echo "Discovering and naming semantic clusters..."
+	$(LUCIDE_CMD) cluster --search-db $(SEARCH_DB_OUTPUT_PATH) -o $(CLUSTERS_JSON) -v
+
+# build-search runs twice: clustering needs the embeddings from the first
+# pass, then the DB is rebuilt so it carries the refreshed cluster data.
+search-data: describe build-search cluster
+	@$(MAKE) build-search
+
+lucide-db-full: lucide-db search-data
+
+test:
+	@echo "Running tests..."
+	$(PYTEST_CMD)
+
+install-hooks:
+	@echo "Installing pre-commit hooks..."
+	$(PRE_COMMIT_CMD) install
+
+update-hooks:
+	@echo "Updating pre-commit hooks..."
+	$(PRE_COMMIT_CMD) autoupdate
+
+run-hooks-all-files:
+	@echo "Running all pre-commit hooks on all files..."
+	$(PRE_COMMIT_CMD) run --all-files
+
+check-lucide-version:
+	@echo "Checking Lucide version and artifact status..."
+	$(UV_CMD) run check-lucide-version
+
+clean:
+	@echo "Cleaning up project..."
+	find . -type f -name '*.py[co]' -delete
+	find . -type d -name '__pycache__' -exec rm -rf {} +
+	rm -rf build/ dist/ .eggs/ *.egg-info/ site/
+	rm -rf .pytest_cache/ .ruff_cache/ htmlcov/ .coverage .coverage.* coverage.xml
+	rm -f lucide-icons.db # Remove db if built in root by mistake
+	@echo "Clean complete."
+
+nuke: clean
+	@echo "Nuking project (includes 'clean', 'uv cache clean', and removing $(VENV_DIR))..."
+	$(UV_CMD) cache clean
+	rm -rf $(VENV_DIR)/
+	@echo "Nuke complete."

python_lucide-0.5.4/README.md → python_lucide-0.5.6/PKG-INFO

@@ -1,3 +1,30 @@
+Metadata-Version: 2.5
+Name: python-lucide
+Version: 0.5.6
+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
+Project-URL: Source Code, https://github.com/mmacpherson/python-lucide
+Author: Mike Macpherson
+License: MIT
+License-File: LICENSE
+Keywords: icons,lucide,sqlite,svg
+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
+Provides-Extra: search
+Requires-Dist: cairosvg>=2.7.0; extra == 'search'
+Requires-Dist: fastembed>=0.4.0; extra == 'search'
+Description-Content-Type: text/markdown
+
 # python-lucide
 
 [![CI](https://github.com/mmacpherson/python-lucide/actions/workflows/ci.yml/badge.svg)](https://github.com/mmacpherson/python-lucide/actions/workflows/ci.yml)
@@ -59,6 +86,50 @@ lucide_icon("user", fill="currentColor")  # Inherit color from CSS
 lucide_icon("user", stroke="#ff6b6b")     # Hex colors work too
 ```
 
+### Renamed icons and aliases
+
+Every database build imports Lucide's alias mappings and deprecation metadata
+from the selected upstream release. For example, `lucide_icon("album")` resolves
+to `square-bookmark`, while keeping the requested name in its CSS classes.
+Canonical names take precedence over aliases.
+
+Prefer the current canonical name in new code:
+
+```python
+lucide_icon("square-bookmark")  # Preferred name
+lucide_icon("album")            # Still works; deprecated upstream alias
+```
+
+Aliases marked deprecated by Lucide emit a standard Python `DeprecationWarning`
+with the recommended replacement. Ordinary aliases do not warn. Warnings occur
+on uncached renders and follow Python's warning filters; they are normally hidden
+outside `__main__`. To see them during development, run your application with
+`python -W default::DeprecationWarning app.py`. Existing databases without
+deprecation metadata still resolve aliases without warnings.
+
+### Database source and builds
+
+The repository tracks `src/lucide/data/lucide-icons.sql`: a deterministic SQL
+export with sorted tables and rows. The generated `.db` is ignored by Git.
+The volatile `created_at` build timestamp is omitted from SQL; the upstream
+version and all icon content, tags, categories, and alias metadata are retained.
+
+`uv sync` reconstructs the local database as part of the editable build.
+After changing branches or SQL, run `uv sync` again; SQL changes invalidate uv's
+editable-build cache. `make restore-db` also restores a missing local database
+without downloading icons. Source-only development via `PYTHONPATH=src` can
+bootstrap it with `python build_support.py restore` before importing the package.
+
+`make lucide-db TAG=1.45.0` downloads the selected upstream release, rebuilds
+SQLite, and exports the updated SQL for review. Commit the SQL file alongside
+the version and generated search-data changes. Use this target rather than
+editing SQL or committing a generated database.
+
+Packaging uses a Hatchling build hook: source distributions contain SQL and the
+build helpers; wheels contain the reconstructed, validated SQLite database.
+Wheel installation and runtime need no reconstruction, writes, downloads, or
+additional dependencies. The separate search database remains a release asset.
+
 ## Semantic Search
 
 Find icons by describing what you mean, not what they're called — in English

python_lucide-0.5.4/PKG-INFO → python_lucide-0.5.6/README.md

@@ -1,29 +1,3 @@
-Metadata-Version: 2.3
-Name: python-lucide
-Version: 0.5.4
-Summary: A Python package for working with Lucide icons
-Keywords: lucide,icons,svg,sqlite
-Author: Mike Macpherson
-License: MIT
-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-Dist: cairosvg>=2.7.0 ; extra == 'search'
-Requires-Dist: fastembed>=0.4.0 ; extra == 'search'
-Requires-Python: >=3.10
-Project-URL: Bug Tracker, https://github.com/mmacpherson/python-lucide/issues
-Project-URL: Homepage, https://github.com/mmacpherson/python-lucide
-Project-URL: Source Code, https://github.com/mmacpherson/python-lucide
-Provides-Extra: search
-Description-Content-Type: text/markdown
-
 # python-lucide
 
 [![CI](https://github.com/mmacpherson/python-lucide/actions/workflows/ci.yml/badge.svg)](https://github.com/mmacpherson/python-lucide/actions/workflows/ci.yml)
@@ -85,6 +59,50 @@ lucide_icon("user", fill="currentColor")  # Inherit color from CSS
 lucide_icon("user", stroke="#ff6b6b")     # Hex colors work too
 ```
 
+### Renamed icons and aliases
+
+Every database build imports Lucide's alias mappings and deprecation metadata
+from the selected upstream release. For example, `lucide_icon("album")` resolves
+to `square-bookmark`, while keeping the requested name in its CSS classes.
+Canonical names take precedence over aliases.
+
+Prefer the current canonical name in new code:
+
+```python
+lucide_icon("square-bookmark")  # Preferred name
+lucide_icon("album")            # Still works; deprecated upstream alias
+```
+
+Aliases marked deprecated by Lucide emit a standard Python `DeprecationWarning`
+with the recommended replacement. Ordinary aliases do not warn. Warnings occur
+on uncached renders and follow Python's warning filters; they are normally hidden
+outside `__main__`. To see them during development, run your application with
+`python -W default::DeprecationWarning app.py`. Existing databases without
+deprecation metadata still resolve aliases without warnings.
+
+### Database source and builds
+
+The repository tracks `src/lucide/data/lucide-icons.sql`: a deterministic SQL
+export with sorted tables and rows. The generated `.db` is ignored by Git.
+The volatile `created_at` build timestamp is omitted from SQL; the upstream
+version and all icon content, tags, categories, and alias metadata are retained.
+
+`uv sync` reconstructs the local database as part of the editable build.
+After changing branches or SQL, run `uv sync` again; SQL changes invalidate uv's
+editable-build cache. `make restore-db` also restores a missing local database
+without downloading icons. Source-only development via `PYTHONPATH=src` can
+bootstrap it with `python build_support.py restore` before importing the package.
+
+`make lucide-db TAG=1.45.0` downloads the selected upstream release, rebuilds
+SQLite, and exports the updated SQL for review. Commit the SQL file alongside
+the version and generated search-data changes. Use this target rather than
+editing SQL or committing a generated database.
+
+Packaging uses a Hatchling build hook: source distributions contain SQL and the
+build helpers; wheels contain the reconstructed, validated SQLite database.
+Wheel installation and runtime need no reconstruction, writes, downloads, or
+additional dependencies. The separate search database remains a release asset.
+
 ## Semantic Search
 
 Find icons by describing what you mean, not what they're called — in English

python_lucide-0.5.6/build_support.py

@@ -0,0 +1,95 @@
+"""Convert between reviewable SQL source and the packaged icon database."""
+
+import argparse
+import contextlib
+import sqlite3
+import tempfile
+from pathlib import Path
+
+DATA_DIR = Path(__file__).parent / "src" / "lucide" / "data"
+SQL_SOURCE = DATA_DIR / "lucide-icons.sql"
+DATABASE = DATA_DIR / "lucide-icons.db"
+
+
+def _identifier(name: str) -> str:
+    return '"' + name.replace('"', '""') + '"'
+
+
+def export_database(database: Path, source: Path) -> None:
+    """Export sorted schema and rows, excluding the volatile build timestamp."""
+    lines = [
+        "-- Generated by build_support.py export; do not edit by hand.",
+        "BEGIN TRANSACTION;",
+    ]
+    with contextlib.closing(
+        sqlite3.connect(f"{database.resolve().as_uri()}?mode=ro", uri=True)
+    ) as conn:
+        tables = conn.execute(
+            "SELECT name, sql FROM sqlite_master WHERE type = 'table' "
+            "AND name NOT LIKE 'sqlite_%' ORDER BY name"
+        ).fetchall()
+        for name, schema in tables:
+            lines.append(schema + ";")
+            table = _identifier(name)
+            columns = [row[1] for row in conn.execute(f"PRAGMA table_info({table})")]
+            quoted = ", ".join(_identifier(column) for column in columns)
+            values = ", ".join(f"quote({_identifier(column)})" for column in columns)
+            # Creation time describes a generated artifact, not the icon content.
+            where = " WHERE key != 'created_at'" if name == "metadata" else ""
+            for row in conn.execute(
+                f"SELECT {values} FROM {table}{where} ORDER BY {quoted}"
+            ):
+                lines.append(f"INSERT INTO {table} VALUES({','.join(row)});")
+        for (schema,) in conn.execute(
+            "SELECT sql FROM sqlite_master WHERE type = 'index' AND sql IS NOT NULL "
+            "ORDER BY name"
+        ):
+            lines.append(schema + ";")
+    lines.append("COMMIT;")
+    source.write_text("\n".join(lines) + "\n", encoding="utf-8", newline="\n")
+
+
+def restore_database(source: Path, database: Path) -> None:
+    """Reconstruct and validate SQLite, replacing the destination only on success."""
+    database.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.NamedTemporaryFile(
+        dir=database.parent, suffix=".db", delete=False
+    ) as tmp:
+        temporary = Path(tmp.name)
+    try:
+        with contextlib.closing(sqlite3.connect(temporary)) as conn:
+            conn.executescript(source.read_text(encoding="utf-8"))
+            if conn.execute("PRAGMA integrity_check").fetchone() != ("ok",):
+                raise ValueError("Reconstructed icon database failed integrity_check")
+            if not conn.execute("SELECT 1 FROM icons LIMIT 1").fetchone():
+                raise ValueError("Reconstructed icon database contains no icons")
+            if not conn.execute(
+                "SELECT value FROM metadata WHERE key = 'version'"
+            ).fetchone():
+                raise ValueError("Reconstructed icon database has no version")
+            if conn.execute(
+                "SELECT 1 FROM icon_aliases LEFT JOIN icons "
+                "ON icons.name = icon_aliases.name WHERE icons.name IS NULL LIMIT 1"
+            ).fetchone():
+                raise ValueError(
+                    "Reconstructed icon database contains dangling aliases"
+                )
+        temporary.chmod(0o644)
+        temporary.replace(database)
+    finally:
+        temporary.unlink(missing_ok=True)
+
+
+def main() -> None:
+    """Export the updated database or restore the local development database."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("action", choices=("export", "restore"))
+    args = parser.parse_args()
+    if args.action == "export":
+        export_database(DATABASE, SQL_SOURCE)
+    else:
+        restore_database(SQL_SOURCE, DATABASE)
+
+
+if __name__ == "__main__":
+    main()