Add icons

Author: apiad

README.md

@@ -1,3 +1,7 @@
+<div style="text-align: center;">
+  <img src="https://github.com/apiad/violetear/blob/main/logo.png?raw=true" height="200px" style="border-radius:5px;">
+</div>
+
 # 🐦 violetear
 
 **The Full-Stack Web Framework for Pythonistas.**

logo.png

@@ -31,3 +31,6 @@ dev = [
     "pytest>=9.0.2",
     "pytest-cov>=7.0.0",
 ]
+
+[tool.setuptools.package-data]
+violetear = ["*.png"]

pyproject.toml

@@ -11,9 +11,13 @@
 from .selector import Selector
 from .units import Unit
 from .color import Color
+from .markup import Document, Element, Component
 
 # New Framework export (lazy import to avoid hard dependency errors if possible,
 # though our App class handles the check internally)
-from .app import App
+try:
+    from .app import App
+except ImportError:
+    pass
 
 __version__ = "1.2.0"

violetear/__init__.py

@@ -4,24 +4,22 @@
 from textwrap import dedent
 from typing import Any, Callable, Dict, List, Union
 
-from pydantic import create_model
-
 
 # --- Optional Server Dependencies ---
 try:
+    from pydantic import create_model
     from fastapi import FastAPI, APIRouter, Request, Response
-    from fastapi.responses import HTMLResponse
+    from fastapi.responses import HTMLResponse, FileResponse
     from fastapi.staticfiles import StaticFiles
     import uvicorn
 
     HAS_SERVER = True
+
 except ImportError:
-    HAS_SERVER = False
-    # Dummy classes for type hinting
-    FastAPI = object  # type: ignore
-    APIRouter = object  # type: ignore
-    Request = object  # type: ignore
-    Response = object  # type: ignore
+    raise ImportError(
+        "Violetear Server dependencies are missing. "
+        "Please install them with: uv add --extra server 'fastapi[standard]'"
+    )
 
 
 from .stylesheet import StyleSheet
@@ -34,16 +32,20 @@ class App:
     Wraps FastAPI to provide a full-stack Python web framework experience.
     """
 
-    def __init__(self, title: str = "Violetear App"):
-        if not HAS_SERVER:
-            raise ImportError(
-                "Violetear Server dependencies are missing. "
-                "Please install them with: uv add --extra server 'fastapi[standard]'"
-            )
-
+    def __init__(self, title: str = "Violetear App", favicon: str | None = None):
         self.title = title
         self.api = FastAPI(title=title)
 
+        if favicon is None:
+            favicon = str(Path(__file__).parent / "icon.png")
+
+        self.favicon = favicon
+
+        # Standard path for browser favicon requests
+        @self.api.get("/favicon.ico", include_in_schema=False)
+        async def favicon():
+            return FileResponse(self.favicon)
+
         # Registry of served styles to prevent duplicate route registration
         self.served_styles: Dict[str, StyleSheet] = {}
 

violetear/app.py

@@ -335,9 +335,15 @@ def _render(self, fp, indent: int):
 
 
 class Head(Markup):
-    def __init__(self, charset: str = "UTF-8", title: str = "") -> None:
+    def __init__(
+        self,
+        charset: str = "UTF-8",
+        title: str = "",
+        favicon: str = "/favicon.ico"
+    ) -> None:
         self.charset = charset
         self.title = title
+        self.favicon = favicon
         self.styles: list[StyleResource] = []
         self.scripts: list[ScriptResource] = []
 
@@ -354,6 +360,14 @@ def _render(self, fp, indent: int):
         )
         self._write_line(fp, f"<title>{self.title}</title>", indent + 1)
 
+        # Render Favicon
+        if self.favicon:
+            self._write_line(
+                fp,
+                f'<link rel="icon" href="{self.favicon}">',
+                indent + 1
+            )
+
         for style in self.styles:
             if style.inline and style.sheet:
                 # Render Inline