codeannex 0.3.7__tar.gz → 0.4.1__tar.gz

{codeannex-0.3.7 → codeannex-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeannex
-Version: 0.3.7
+Version: 0.4.1
 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
@@ -31,22 +31,22 @@ Dynamic: license-file
 
 # 📂 codeannex
 
-Generates a professional PDF annex from a project's source code — with syntax highlighting, a hierarchical table of contents, image rendering, and intelligent font discovery.
+Generates a professional PDF annex from a project's source code — featuring syntax highlighting, a hierarchical table of contents, image rendering, and version tracking.
 
 ## 🚀 Key Features
 
-- **Interactive Wizard 2.0** — Organized by sections (Project, Style, Typography, Layout, Filters) with smart defaults and explicit (Y/n) prompts.
-- **Git Integration & Version Tracking** — Automatically detects Repository URL, Branch, and **Commit SHA**. Supports subdirectories by intelligently ignoring Git metadata if not at the root.
-- **Subdirectories First** — Improved document organization by listing subdirectories and their contents before root files.
+- **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **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.
+- **High-Contrast Design** — Redesigned cover page, thickened image frames, and optimized line number legibility.
+- **Intelligent Font Discovery** — Automatically finds fonts from your system or custom directories via `--font-path`.
 - **Flexible File Filtering** — Multi-pattern include and exclude glob filters (e.g., `--include "src/*" --exclude "tests/*"`).
-- **Intelligent Font Discovery** — Automatically finds fonts from your system (Windows, Linux, macOS) or custom paths via `--font-path`.
-- **Fully Customizable UI** — Control everything: paper size (mm), margins (cm), colors (HEX), and font sizes.
-- **Hierarchical Summary** — Real tree-structured Table of Contents with increasing page numbers and terminal-like connection lines.
-- **Professional Design** — High-contrast line numbers, clean cover page, and smart contrast (auto-switching text between black/white based on accent brightness).
+- **Pro-Level UI** — Control paper size (mm), margins (cm), accent colors (HEX), and font sizes.
 
 ## 🛠 Installation
 
-The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx), which installs the tool in an isolated environment:
+The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx):
 
 ```bash
 pipx install codeannex
@@ -63,7 +63,7 @@ pipx install "codeannex[svg]"
 ## 📖 Usage
 
 ### Interactive Mode (Wizard)
-Simply run without arguments to start the step-by-step configuration:
+Simply run without arguments to start the configuration:
 ```bash
 python3 -m codeannex
 ```
@@ -79,13 +79,15 @@ python3 -m codeannex . \
   --no-input
 ```
 
+Default output filename is `{project_name}_code_annex.pdf`.
+
 ## ⚙️ Configuration Options
 
 ### Git & Metadata
 - `--repo-url URL` — Manual repository URL.
 - `--branch NAME` — Manual branch name.
 - `--no-git` — Force disable Git integration.
-- `--repo-label LABEL` — Label for repo (default: "Repository Name: ").
+- `--repo-label LABEL` — Label for repo (default: "Repository: ").
 
 ### File Selection
 - `--include PATTERN` — Include glob pattern (can be used multiple times).
@@ -94,7 +96,7 @@ python3 -m codeannex . \
 ### Design & Layout
 - `--page-width MM` / `--page-height MM` — Custom paper size in mm (default: A4).
 - `--margin CM` — General margin (top, bottom, left, right).
-- `--primary-color HEX` — Accent color for headers and summary icons.
+- `--primary-color HEX` — Accent color for headers, summary icons, and links.
 - `--code-size N` — Font size for code and line numbers.
 
 ### Fonts
@@ -104,7 +106,7 @@ python3 -m codeannex . \
 ## 🧪 Testing
 
 ```bash
-PYTHONPATH=. pytest
+PYTHONPATH=. pytest tests --cov=codeannex
 ```
 
 ## 📄 License

{codeannex-0.3.7 → codeannex-0.4.1}/README.md

@@ -1,21 +1,21 @@
 # 📂 codeannex
 
-Generates a professional PDF annex from a project's source code — with syntax highlighting, a hierarchical table of contents, image rendering, and intelligent font discovery.
+Generates a professional PDF annex from a project's source code — featuring syntax highlighting, a hierarchical table of contents, image rendering, and version tracking.
 
 ## 🚀 Key Features
 
-- **Interactive Wizard 2.0** — Organized by sections (Project, Style, Typography, Layout, Filters) with smart defaults and explicit (Y/n) prompts.
-- **Git Integration & Version Tracking** — Automatically detects Repository URL, Branch, and **Commit SHA**. Supports subdirectories by intelligently ignoring Git metadata if not at the root.
-- **Subdirectories First** — Improved document organization by listing subdirectories and their contents before root files.
+- **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **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.
+- **High-Contrast Design** — Redesigned cover page, thickened image frames, and optimized line number legibility.
+- **Intelligent Font Discovery** — Automatically finds fonts from your system or custom directories via `--font-path`.
 - **Flexible File Filtering** — Multi-pattern include and exclude glob filters (e.g., `--include "src/*" --exclude "tests/*"`).
-- **Intelligent Font Discovery** — Automatically finds fonts from your system (Windows, Linux, macOS) or custom paths via `--font-path`.
-- **Fully Customizable UI** — Control everything: paper size (mm), margins (cm), colors (HEX), and font sizes.
-- **Hierarchical Summary** — Real tree-structured Table of Contents with increasing page numbers and terminal-like connection lines.
-- **Professional Design** — High-contrast line numbers, clean cover page, and smart contrast (auto-switching text between black/white based on accent brightness).
+- **Pro-Level UI** — Control paper size (mm), margins (cm), accent colors (HEX), and font sizes.
 
 ## 🛠 Installation
 
-The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx), which installs the tool in an isolated environment:
+The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx):
 
 ```bash
 pipx install codeannex
@@ -32,7 +32,7 @@ pipx install "codeannex[svg]"
 ## 📖 Usage
 
 ### Interactive Mode (Wizard)
-Simply run without arguments to start the step-by-step configuration:
+Simply run without arguments to start the configuration:
 ```bash
 python3 -m codeannex
 ```
@@ -48,13 +48,15 @@ python3 -m codeannex . \
   --no-input
 ```
 
+Default output filename is `{project_name}_code_annex.pdf`.
+
 ## ⚙️ Configuration Options
 
 ### Git & Metadata
 - `--repo-url URL` — Manual repository URL.
 - `--branch NAME` — Manual branch name.
 - `--no-git` — Force disable Git integration.
-- `--repo-label LABEL` — Label for repo (default: "Repository Name: ").
+- `--repo-label LABEL` — Label for repo (default: "Repository: ").
 
 ### File Selection
 - `--include PATTERN` — Include glob pattern (can be used multiple times).
@@ -63,7 +65,7 @@ python3 -m codeannex . \
 ### Design & Layout
 - `--page-width MM` / `--page-height MM` — Custom paper size in mm (default: A4).
 - `--margin CM` — General margin (top, bottom, left, right).
-- `--primary-color HEX` — Accent color for headers and summary icons.
+- `--primary-color HEX` — Accent color for headers, summary icons, and links.
 - `--code-size N` — Font size for code and line numbers.
 
 ### Fonts
@@ -73,7 +75,7 @@ python3 -m codeannex . \
 ## 🧪 Testing
 
 ```bash
-PYTHONPATH=. pytest
+PYTHONPATH=. pytest tests --cov=codeannex
 ```
 
 ## 📄 License

{codeannex-0.3.7 → codeannex-0.4.1}/codeannex/__main__.py

@@ -106,20 +106,15 @@ def main():
     )
 
     all_files = sort_files(get_project_files(root, includes=args.include, excludes=args.exclude, use_git=use_git), root)
-    
-    # Early Filter: Remove the output file and the script itself from processing
-    def is_self_or_output(fp):
-        try:
-            res = fp.resolve()
-            return res == output_path or res == script_path
-        except: return False
-
-    all_files = [fp for fp in all_files if not is_self_or_output(fp)]
-
     included = []
     from .core.config import IMAGE_EXTENSIONS, BINARY_EXTENSIONS
 
     for fp in all_files:
+        # We only silently skip the script itself to avoid infinite recursion if it's in the same folder
+        try:
+            if fp.resolve() == script_path: continue
+        except: pass
+        
         if not fp.is_file(): continue
         
         ext = fp.suffix.lower()

{codeannex-0.3.7 → codeannex-0.4.1}/codeannex/core/config.py

@@ -72,7 +72,7 @@ class PDFConfig:
     page_bg_color: str = "#ffffff"
     
     summary_title: str = "Summary / File Index"
-    repo_label: str = "Repository Name: "
+    repo_label: str = "Repository: "
     project_label: str = "Project: "
     file_part_format: str = "(part {current}/{total})"
 

{codeannex-0.3.7 → codeannex-0.4.1}/codeannex/core/pdf_builder.py

@@ -55,12 +55,12 @@ class ModernAnnexPDF:
         self.c.setTitle(f"Source code: {project_name}")
 
     def _dtf(self, x, y, text, font, size, color=None):
-        draw_text_with_fallback(self.c, x, y, text, font, size, self.emoji_font, color,
-                                emoji_description=self.config.emoji_description)
+        return draw_text_with_fallback(self.c, x, y, text, font, size, self.emoji_font, color,
+                                       emoji_description=self.config.emoji_description)
 
     def _dctf(self, x, y, text, font, size, color=None):
-        draw_centred_text_with_fallback(self.c, x, y, text, font, size, self.emoji_font, color,
-                                        emoji_description=self.config.emoji_description)
+        return draw_centred_text_with_fallback(self.c, x, y, text, font, size, self.emoji_font, color,
+                                               emoji_description=self.config.emoji_description)
 
     def _gsw(self, text, font, size) -> float:
         return get_safe_string_width(text, font, size, self.emoji_font,
@@ -133,16 +133,27 @@ class ModernAnnexPDF:
             curr_y = self.config.page_height * 0.45
             
             if project_name:
-                display_repo = f"{self.config.repo_label}{project_name}"
-                name_w = self._gsw(display_repo, self.config.normal_font, 14)
-                start_x = mid_x - name_w / 2
+                label = self.config.repo_label
+                name = project_name
                 
-                # Draw the name (blue if it has a link)
-                final_color = colors.HexColor(self.config.primary_color) if self.config.repo_url else text_color
-                self._dtf(start_x, curr_y, display_repo, self.config.normal_font, 14, final_color)
+                # Calculate total block width for initial centering
+                label_w = self._gsw(label, self.config.normal_font, 14)
+                name_w  = self._gsw(name, self.config.normal_font, 14)
+                total_w = label_w + name_w
                 
+                start_x = mid_x - total_w / 2
+                
+                # 1. Draw the label and capture EXACT end position
+                name_x = self._dtf(start_x, curr_y, label, self.config.normal_font, 14, text_color)
+                
+                # 2. Draw the name starting exactly where label ended
+                final_name_color = colors.HexColor(self.config.primary_color) if self.config.repo_url else text_color
+                end_x = self._dtf(name_x, curr_y, name, self.config.normal_font, 14, final_name_color)
+                
+                # 3. Apply link using the real coordinates
                 if self.config.repo_url:
-                    self.c.linkURL(self.config.repo_url, (start_x, curr_y - 2, start_x + name_w, curr_y + 12), relative=0, thickness=0, border=None)
+                    # Coordinates are (x1, y1, x2, y2)
+                    self.c.linkURL(self.config.repo_url, (name_x, curr_y - 2, end_x, curr_y + 12), relative=0, thickness=0, border=None)
                 
                 curr_y -= 8*mm
             

{codeannex-0.3.7 → codeannex-0.4.1}/codeannex/io/git_utils.py

@@ -31,8 +31,8 @@ def get_git_info(root: Path, use_git: bool = True) -> tuple[str | None, str | No
                 branch_name = res_branch.stdout.strip()
                 if branch_name == "HEAD": branch_name = None
 
-        # 3. Get commit SHA (short)
-        res_sha = subprocess.run(["git", "rev-parse", "--short", "HEAD"], cwd=root, capture_output=True, text=True)
+        # 3. Get commit SHA (8 chars)
+        res_sha = subprocess.run(["git", "rev-parse", "--short=8", "HEAD"], cwd=root, capture_output=True, text=True)
         if res_sha.returncode == 0: commit_sha = res_sha.stdout.strip()
 
     except (subprocess.CalledProcessError, FileNotFoundError): pass

{codeannex-0.3.7 → codeannex-0.4.1}/codeannex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeannex
-Version: 0.3.7
+Version: 0.4.1
 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
@@ -31,22 +31,22 @@ Dynamic: license-file
 
 # 📂 codeannex
 
-Generates a professional PDF annex from a project's source code — with syntax highlighting, a hierarchical table of contents, image rendering, and intelligent font discovery.
+Generates a professional PDF annex from a project's source code — featuring syntax highlighting, a hierarchical table of contents, image rendering, and version tracking.
 
 ## 🚀 Key Features
 
-- **Interactive Wizard 2.0** — Organized by sections (Project, Style, Typography, Layout, Filters) with smart defaults and explicit (Y/n) prompts.
-- **Git Integration & Version Tracking** — Automatically detects Repository URL, Branch, and **Commit SHA**. Supports subdirectories by intelligently ignoring Git metadata if not at the root.
-- **Subdirectories First** — Improved document organization by listing subdirectories and their contents before root files.
+- **Interactive Wizard 2.0** — Step-by-step configuration with smart sections (Project, Style, Typography, Layout, Filters) and explicit default prompts.
+- **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.
+- **High-Contrast Design** — Redesigned cover page, thickened image frames, and optimized line number legibility.
+- **Intelligent Font Discovery** — Automatically finds fonts from your system or custom directories via `--font-path`.
 - **Flexible File Filtering** — Multi-pattern include and exclude glob filters (e.g., `--include "src/*" --exclude "tests/*"`).
-- **Intelligent Font Discovery** — Automatically finds fonts from your system (Windows, Linux, macOS) or custom paths via `--font-path`.
-- **Fully Customizable UI** — Control everything: paper size (mm), margins (cm), colors (HEX), and font sizes.
-- **Hierarchical Summary** — Real tree-structured Table of Contents with increasing page numbers and terminal-like connection lines.
-- **Professional Design** — High-contrast line numbers, clean cover page, and smart contrast (auto-switching text between black/white based on accent brightness).
+- **Pro-Level UI** — Control paper size (mm), margins (cm), accent colors (HEX), and font sizes.
 
 ## 🛠 Installation
 
-The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx), which installs the tool in an isolated environment:
+The recommended way to install **codeannex** is via [pipx](https://github.com/pypa/pipx):
 
 ```bash
 pipx install codeannex
@@ -63,7 +63,7 @@ pipx install "codeannex[svg]"
 ## 📖 Usage
 
 ### Interactive Mode (Wizard)
-Simply run without arguments to start the step-by-step configuration:
+Simply run without arguments to start the configuration:
 ```bash
 python3 -m codeannex
 ```
@@ -79,13 +79,15 @@ python3 -m codeannex . \
   --no-input
 ```
 
+Default output filename is `{project_name}_code_annex.pdf`.
+
 ## ⚙️ Configuration Options
 
 ### Git & Metadata
 - `--repo-url URL` — Manual repository URL.
 - `--branch NAME` — Manual branch name.
 - `--no-git` — Force disable Git integration.
-- `--repo-label LABEL` — Label for repo (default: "Repository Name: ").
+- `--repo-label LABEL` — Label for repo (default: "Repository: ").
 
 ### File Selection
 - `--include PATTERN` — Include glob pattern (can be used multiple times).
@@ -94,7 +96,7 @@ python3 -m codeannex . \
 ### Design & Layout
 - `--page-width MM` / `--page-height MM` — Custom paper size in mm (default: A4).
 - `--margin CM` — General margin (top, bottom, left, right).
-- `--primary-color HEX` — Accent color for headers and summary icons.
+- `--primary-color HEX` — Accent color for headers, summary icons, and links.
 - `--code-size N` — Font size for code and line numbers.
 
 ### Fonts
@@ -104,7 +106,7 @@ python3 -m codeannex . \
 ## 🧪 Testing
 
 ```bash
-PYTHONPATH=. pytest
+PYTHONPATH=. pytest tests --cov=codeannex
 ```
 
 ## 📄 License

{codeannex-0.3.7 → codeannex-0.4.1}/pyproject.toml

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