How zostera/django-icons works
Project type and purpose
• It is not a standalone web service but a library/plugin that hooks into Django’s template engine and settings system.
File structure
• Top-level:
• pyproject.toml, setup/configuration files (tox.ini, justfile, GitHub workflows)
• README.md, docs/ (Sphinx docs), example/ (demo Django project), tests/
• src/django_icons/:
• core.py: central registry and logic
• css.py: CSS-related helpers
• example/: a small Django project showing plugin usage (settings.py → INSTALLED_APPS + DJANGO_ICONS, template files, manage.py)
• tests/: unit tests for each renderer, core functionality, template tags
README for additional insights
• Shows how to configure DJANGO_ICONS in settings.py
• Mentions extension by subclassing IconRenderer
Elements
• “Django App Server”
• “IconRegistry (core.py)”
• “Browser”
• From Settings → IconRegistry
• From Template Tag → IconRegistry → Renderer → HTML output
• From Browser → External Assets
• Another for “external dependencies” (CSS libraries, image assets)
• A different style for “runtime environment” (browser)