codeannex 0.4.3__tar.gz → 0.4.4__tar.gz

{codeannex-0.4.3 → codeannex-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeannex
-Version: 0.4.3
+Version: 0.4.4
 Summary: Generates a professional PDF source code annex with Smart Index, Images and Emoji support.
 License: MIT
 Project-URL: Repository, https://github.com/tanhleno/codeannex
@@ -36,6 +36,8 @@ Generates a professional PDF annex from a project's source code — featuring sy
 ## 🚀 Key Features
 
 - **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **Smart Emoji Support** — Automatic discovery of standard emoji fonts (**Segoe UI Emoji** on Windows, **DejaVu Sans** on Linux).
+- **Graceful Emoji Fallback** — If no emoji font is found, it uses official Unicode names (e.g., `[ROCKET]`) for perfect readability.
 - **Git Version Tracking** — Automatically detects **Repository URL**, **Branch**, and **Commit SHA**. Smart root detection avoids Git metadata on subdirectories.
 - **Smart SVG Rendering** — Files are rendered as both a high-quality image and XML code. Entries are intelligently deduplicated in the summary.
 - **Improved Document Structure** — Subdirectories and their contents are listed before root files for better organization.
@@ -58,7 +60,7 @@ For full SVG support (required for crisp line numbers and SVG image rendering):
 pipx install "codeannex[svg]"
 ```
 
-*Alternatively, you can use standard pip:* `pip install codeannex`
+*Note: For best emoji rendering on Linux, you may want to install `fonts-noto-color-emoji` or `ttf-dejavu`.*
 
 ## 📖 Usage
 
@@ -102,6 +104,8 @@ Default output filename is `{project_name}_code_annex.pdf`.
 ### Fonts
 - `--font-path PATH` — Additional directory to search for `.ttf`/`.otf` files.
 - `--title-font` / `--normal-font` / `--mono-font` — System font names.
+- `--emoji-font NAME` — Custom font for emojis.
+- `--emoji-description` — Force textual descriptions (e.g., `[GRINNING FACE]`) instead of glyphs.
 
 ## 🧪 Testing
 

{codeannex-0.4.3 → codeannex-0.4.4}/README.md

@@ -5,6 +5,8 @@ Generates a professional PDF annex from a project's source code — featuring sy
 ## 🚀 Key Features
 
 - **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **Smart Emoji Support** — Automatic discovery of standard emoji fonts (**Segoe UI Emoji** on Windows, **DejaVu Sans** on Linux).
+- **Graceful Emoji Fallback** — If no emoji font is found, it uses official Unicode names (e.g., `[ROCKET]`) for perfect readability.
 - **Git Version Tracking** — Automatically detects **Repository URL**, **Branch**, and **Commit SHA**. Smart root detection avoids Git metadata on subdirectories.
 - **Smart SVG Rendering** — Files are rendered as both a high-quality image and XML code. Entries are intelligently deduplicated in the summary.
 - **Improved Document Structure** — Subdirectories and their contents are listed before root files for better organization.
@@ -27,7 +29,7 @@ For full SVG support (required for crisp line numbers and SVG image rendering):
 pipx install "codeannex[svg]"
 ```
 
-*Alternatively, you can use standard pip:* `pip install codeannex`
+*Note: For best emoji rendering on Linux, you may want to install `fonts-noto-color-emoji` or `ttf-dejavu`.*
 
 ## 📖 Usage
 
@@ -71,6 +73,8 @@ Default output filename is `{project_name}_code_annex.pdf`.
 ### Fonts
 - `--font-path PATH` — Additional directory to search for `.ttf`/`.otf` files.
 - `--title-font` / `--normal-font` / `--mono-font` — System font names.
+- `--emoji-font NAME` — Custom font for emojis.
+- `--emoji-description` — Force textual descriptions (e.g., `[GRINNING FACE]`) instead of glyphs.
 
 ## 🧪 Testing
 

{codeannex-0.4.3 → codeannex-0.4.4}/codeannex/__main__.py

@@ -36,6 +36,13 @@ def check_emoji_font_style():
 
 
 def main():
+    try:
+        _main_impl()
+    except KeyboardInterrupt:
+        print(f"\n\n\033[33m⚠️  Operation aborted by user (Ctrl+C).\033[0m")
+        sys.exit(0)
+
+def _main_impl():
     args, unknown = parse_args()
     is_interactive = len(sys.argv) <= 2 and not args.no_input
     if is_interactive: run_interactive_wizard(args)

{codeannex-0.4.3 → codeannex-0.4.4}/codeannex/interface/cli.py

@@ -2,6 +2,7 @@ import argparse
 from pathlib import Path
 from ..core.config import PDFConfig
 from ..io.git_utils import get_git_info, get_git_remotes
+from ..renderer.fonts import register_emoji_font
 
 # ANSI Colors for a better CLI experience
 BOLD = "\033[1m"
@@ -96,19 +97,27 @@ def run_interactive_wizard(args):
         if has_git:
             if len(remotes) > 1:
                 _print_header(2, total_steps, "Repository Info", "Multiple Git remotes detected")
-                print(f"   Available remotes:")
                 remote_names = list(remotes.keys())
+
+                # Identify default index
+                default_idx = 1
+                if "origin" in remote_names:
+                    default_idx = remote_names.index("origin") + 1
+
                 for i, name in enumerate(remote_names, 1):
-                    print(f"     {i}. {name} ({remotes[name]})")
-                
-                choice = _input_field("Select remote (number) or press Enter for origin", "1")
-                if choice.isdigit() and 1 <= int(choice) <= len(remote_names):
+                    marker = f"{GREEN}*{RESET}" if i == default_idx else " "
+                    print(f"     {i}. {marker} {name} ({remotes[name]})")
+                print(f"     0.   [ Manual / None ]")
+
+                choice = _input_field(f"Select remote (1-{len(remote_names)}) or '0' for manual", str(default_idx))
+
+                if choice == "0":
+                    git_url = None
+                elif choice.isdigit() and 1 <= int(choice) <= len(remote_names):
                     selected_remote = remote_names[int(choice)-1]
                     git_url = remotes[selected_remote]
-                elif "origin" in remotes:
-                    git_url = remotes["origin"]
                 else:
-                    git_url = remotes[remote_names[0]]
+                    git_url = remotes[remote_names[default_idx-1]]
             elif len(remotes) == 1:
                 git_url = list(remotes.values())[0]
 
@@ -137,11 +146,23 @@ def run_interactive_wizard(args):
             args.normal_font = _input_field("Normal Font", args.normal_font or 'Helvetica') or args.normal_font
             args.mono_font = _input_field("Monospace Font", args.mono_font or 'Auto') or args.mono_font
             args.code_size = int(_input_field("Code Font Size", args.code_size) or args.code_size)
-            
+
             paths = _input_field("Additional Font Paths (comma-separated)", "None")
             if paths:
                 args.font_path = [p.strip() for p in paths.split(",") if p.strip()]
 
+            # Emoji Font Check & Support
+            emoji_f, emoji_p = register_emoji_font()
+            if not emoji_f:
+                print(f"\n   {YELLOW}⚠️  No emoji font detected!{RESET}")
+                print(f"      To render emojis, install {BOLD}Symbola{RESET} or {BOLD}Google Noto Emoji{RESET}.")
+                print(f"      Or provide a custom path above.")
+
+                choice = input(f"   Use text descriptions for emojis (e.g. [smile])? (y/{GREEN}N{RESET}): ").strip().lower()
+                if choice == 'y':
+                    args.emoji_description = True
+            else:
+                print(f"   {GREEN}✅ Emoji font detected:{RESET} {emoji_f} ({emoji_p or 'System'})")
         # 5. Page Layout
         if _ask_section(5, total_steps, "Page Layout & Margins", "Margins, Paper Size, Page Numbering"):
             args.margin_top = float(_input_field("Top Margin (cm)", args.margin_top or 2.0) or (args.margin_top or 2.0))

{codeannex-0.4.3 → codeannex-0.4.4}/codeannex/renderer/fonts.py

@@ -86,7 +86,13 @@ TTF_SEARCH_PATHS = [
     "/usr/share/fonts/truetype/noto/NotoSansMono-Regular.ttf", "/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf", "/usr/share/fonts/truetype/liberation/LiberationMono-Regular.ttf",
     "C:\\Windows\\Fonts\\consola.ttf", "C:\\Windows\\Fonts\\cour.ttf", "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf", "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf", "C:\\Windows\\Fonts\\arial.ttf"
 ]
-EMOJI_SEARCH_PATHS = ["/usr/share/fonts/truetype/noto/NotoEmoji-Regular.ttf", "/usr/share/fonts/truetype/ancient-scripts/Symbola_hint.ttf"]
+EMOJI_SEARCH_PATHS = [
+    "C:\\Windows\\Fonts\\seguiemj.ttf",          # Windows Standard Emoji
+    "C:\\Windows\\Fonts\\seguisym.ttf",          # Windows Standard Symbol
+    "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf", # Linux Standard Fallback
+    "/usr/share/fonts/truetype/noto/NotoEmoji-Regular.ttf", 
+    "/usr/share/fonts/truetype/ancient-scripts/Symbola_hint.ttf"
+]
 
 def _register_font(name: str, paths: list, fallback):
     for p in paths:

{codeannex-0.4.3 → codeannex-0.4.4}/codeannex/renderer/text_utils.py

@@ -1,4 +1,5 @@
 import re
+import unicodedata
 from reportlab.lib import colors
 from reportlab.pdfbase import pdfmetrics
 
@@ -7,16 +8,29 @@ def sanitize_text(text: str) -> str:
     if not text: return ""
     return re.sub(r'[\x00-\x08\x0b\x0c\x0e-\x1f]', '', text)
 
+def _get_emoji_label(char: str) -> str:
+    """Returns a textual label for an emoji character."""
+    try:
+        name = unicodedata.name(char)
+        return f"[{name}]"
+    except (ValueError, KeyError):
+        return f"[Emoji-{ord(char):X}]"
+
 def get_safe_string_width(text, font_name, font_size, emoji_font=None, emoji_description=False):
     from .fonts import is_char_supported
     total_w = 0.0
     for char in text:
         if is_char_supported(char, font_name):
             total_w += pdfmetrics.stringWidth(char, font_name, font_size)
+        elif emoji_description:
+            label = _get_emoji_label(char)
+            total_w += pdfmetrics.stringWidth(label, font_name, font_size)
         elif emoji_font:
-            if emoji_description: total_w += pdfmetrics.stringWidth(f"[{char}]", font_name, font_size)
-            else: total_w += pdfmetrics.stringWidth(char, emoji_font, font_size)
-        else: total_w += pdfmetrics.stringWidth("?", font_name, font_size)
+            total_w += pdfmetrics.stringWidth(char, emoji_font, font_size)
+        else:
+            # Fallback to description if no font is available, even if emoji_description=False
+            label = _get_emoji_label(char)
+            total_w += pdfmetrics.stringWidth(label, font_name, font_size)
     return total_w
 
 def draw_text_with_fallback(canvas, x, y, text, font_name, font_size, emoji_font=None, color=None, emoji_description=False):
@@ -28,20 +42,21 @@ def draw_text_with_fallback(canvas, x, y, text, font_name, font_size, emoji_font
             canvas.setFont(font_name, font_size)
             canvas.drawString(curr_x, y, char)
             curr_x += pdfmetrics.stringWidth(char, font_name, font_size)
+        elif emoji_description:
+            canvas.setFont(font_name, font_size)
+            label = _get_emoji_label(char)
+            canvas.drawString(curr_x, y, label)
+            curr_x += pdfmetrics.stringWidth(label, font_name, font_size)
         elif emoji_font:
-            if emoji_description:
-                canvas.setFont(font_name, font_size)
-                label = f"[{char}]"
-                canvas.drawString(curr_x, y, label)
-                curr_x += pdfmetrics.stringWidth(label, font_name, font_size)
-            else:
-                canvas.setFont(emoji_font, font_size)
-                canvas.drawString(curr_x, y, char)
-                curr_x += pdfmetrics.stringWidth(char, emoji_font, font_size)
+            canvas.setFont(emoji_font, font_size)
+            canvas.drawString(curr_x, y, char)
+            curr_x += pdfmetrics.stringWidth(char, emoji_font, font_size)
         else:
+            # Fallback to description if no font is available
             canvas.setFont(font_name, font_size)
-            canvas.drawString(curr_x, y, "?")
-            curr_x += pdfmetrics.stringWidth("?", font_name, font_size)
+            label = _get_emoji_label(char)
+            canvas.drawString(curr_x, y, label)
+            curr_x += pdfmetrics.stringWidth(label, font_name, font_size)
     return curr_x
 
 def draw_centred_text_with_fallback(canvas, x, y, text, font_name, font_size, emoji_font=None, color=None, emoji_description=False):

{codeannex-0.4.3 → codeannex-0.4.4}/codeannex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeannex
-Version: 0.4.3
+Version: 0.4.4
 Summary: Generates a professional PDF source code annex with Smart Index, Images and Emoji support.
 License: MIT
 Project-URL: Repository, https://github.com/tanhleno/codeannex
@@ -36,6 +36,8 @@ Generates a professional PDF annex from a project's source code — featuring sy
 ## 🚀 Key Features
 
 - **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **Smart Emoji Support** — Automatic discovery of standard emoji fonts (**Segoe UI Emoji** on Windows, **DejaVu Sans** on Linux).
+- **Graceful Emoji Fallback** — If no emoji font is found, it uses official Unicode names (e.g., `[ROCKET]`) for perfect readability.
 - **Git Version Tracking** — Automatically detects **Repository URL**, **Branch**, and **Commit SHA**. Smart root detection avoids Git metadata on subdirectories.
 - **Smart SVG Rendering** — Files are rendered as both a high-quality image and XML code. Entries are intelligently deduplicated in the summary.
 - **Improved Document Structure** — Subdirectories and their contents are listed before root files for better organization.
@@ -58,7 +60,7 @@ For full SVG support (required for crisp line numbers and SVG image rendering):
 pipx install "codeannex[svg]"
 ```
 
-*Alternatively, you can use standard pip:* `pip install codeannex`
+*Note: For best emoji rendering on Linux, you may want to install `fonts-noto-color-emoji` or `ttf-dejavu`.*
 
 ## 📖 Usage
 
@@ -102,6 +104,8 @@ Default output filename is `{project_name}_code_annex.pdf`.
 ### Fonts
 - `--font-path PATH` — Additional directory to search for `.ttf`/`.otf` files.
 - `--title-font` / `--normal-font` / `--mono-font` — System font names.
+- `--emoji-font NAME` — Custom font for emojis.
+- `--emoji-description` — Force textual descriptions (e.g., `[GRINNING FACE]`) instead of glyphs.
 
 ## 🧪 Testing
 

{codeannex-0.4.3 → codeannex-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codeannex"
-version = "0.4.3"
+version = "0.4.4"
 description = "Generates a professional PDF source code annex with Smart Index, Images and Emoji support."
 readme = "README.md"
 license = { text = "MIT" }