convoviz 0.4.7__py3-none-any.whl → 0.4.8__py3-none-any.whl

convoviz/io/assets.py

@@ -4,6 +4,8 @@ import logging
 import shutil
 from pathlib import Path
 
+from convoviz.utils import sanitize
+
 logger = logging.getLogger(__name__)
 
 
@@ -83,12 +85,13 @@ def resolve_asset_path(source_dir: Path, asset_id: str) -> Path | None:
     return None
 
 
-def copy_asset(source_path: Path, dest_dir: Path) -> str:
+def copy_asset(source_path: Path, dest_dir: Path, target_name: str | None = None) -> str:
     """Copy an asset to the destination directory.
 
     Args:
         source_path: The source file path
         dest_dir: The root output directory (assets will be in dest_dir/assets)
+        target_name: Optional name to rename the file to
 
     Returns:
         Relative path to the asset (e.g., "assets/image.png")
@@ -96,14 +99,15 @@ def copy_asset(source_path: Path, dest_dir: Path) -> str:
     assets_dir = dest_dir / "assets"
     assets_dir.mkdir(parents=True, exist_ok=True)
 
-    dest_path = assets_dir / source_path.name
+    filename = sanitize(target_name) if target_name else source_path.name
+    dest_path = assets_dir / filename
 
     if not dest_path.exists():
         try:
             shutil.copy2(source_path, dest_path)
-            logger.debug(f"Copied asset: {source_path.name}")
+            logger.debug(f"Copied asset: {source_path.name} -> {filename}")
         except Exception as e:
             logger.warning(f"Failed to copy asset {source_path}: {e}")
 
     # Return forward-slash path for Markdown compatibility even on Windows
-    return f"assets/{source_path.name}"
+    return f"assets/{filename}"

convoviz/io/writers.py

@@ -90,7 +90,7 @@ def save_conversation(
         final_path = filepath.with_name(f"{base_name} ({counter}){filepath.suffix}")
 
     # Define asset resolver
-    def asset_resolver(asset_id: str) -> str | None:
+    def asset_resolver(asset_id: str, target_name: str | None = None) -> str | None:
         if not source_path:
             return None
 
@@ -99,7 +99,7 @@ def save_conversation(
             return None
 
         # Copy to output directory (relative to the markdown file's directory)
-        return copy_asset(src_file, final_path.parent)
+        return copy_asset(src_file, final_path.parent, target_name)
 
     # Render and write
     markdown = render_conversation(conversation, config, headers, asset_resolver=asset_resolver)

convoviz/models/message.py

@@ -49,6 +49,7 @@ class MessageMetadata(BaseModel):
     citations: list[dict[str, Any]] | None = None
     search_result_groups: list[dict[str, Any]] | None = None
     content_references: list[dict[str, Any]] | None = None
+    attachments: list[dict[str, Any]] | None = None
 
     model_config = ConfigDict(protected_namespaces=())
 

convoviz/renderers/markdown.py

@@ -3,6 +3,7 @@
 import re
 from collections.abc import Callable
 from typing import Any
+from urllib.parse import quote
 
 from convoviz.config import AuthorHeaders, ConversationConfig
 from convoviz.exceptions import MessageContentError
@@ -212,7 +213,7 @@ def render_node(
     node: Node,
     headers: AuthorHeaders,
     use_dollar_latex: bool = False,
-    asset_resolver: Callable[[str], str | None] | None = None,
+    asset_resolver: Callable[[str, str | None], str | None] | None = None,
     flavor: str = "standard",
     citation_map: dict[str, dict[str, str | None]] | None = None,
 ) -> str:
@@ -222,7 +223,7 @@ def render_node(
         node: The node to render
         headers: Configuration for author headers
         use_dollar_latex: Whether to convert LaTeX delimiters to dollars
-        asset_resolver: Function to resolve asset IDs to paths
+        asset_resolver: Function to resolve asset IDs to paths, optionally renaming them
         flavor: Markdown flavor ("standard" or "obsidian")
         citation_map: Global map of citations
     """
@@ -281,12 +282,25 @@ def render_node(
 
     # Append images if resolver is provided and images exist
     if asset_resolver and node.message.images:
+        # Build map of file-id -> desired name from metadata.attachments
+        attachment_map = {}
+        if node.message.metadata.attachments:
+            for att in node.message.metadata.attachments:
+                if (att_id := att.get("id")) and (name := att.get("name")):
+                    attachment_map[att_id] = name
+
         for image_id in node.message.images:
-            rel_path = asset_resolver(image_id)
+            # Pass the desired name if we have one for this ID
+            target_name = attachment_map.get(image_id)
+            rel_path = asset_resolver(image_id, target_name)
             if rel_path:
+                # URL-encode the path to handle spaces/special characters in Markdown links
+                # We only encode the filename part if we want to be safe, but rel_path is "assets/..."
+                # quote() by default doesn't encode / which is good.
+                encoded_path = quote(rel_path)
                 # Using standard markdown image syntax.
                 # Obsidian handles this well.
-                content += f"\n![Image]({rel_path})\n"
+                content += f"\n![Image]({encoded_path})\n"
 
     return f"\n{header}{content}\n---\n"
 
@@ -325,7 +339,7 @@ def render_conversation(
     conversation: Conversation,
     config: ConversationConfig,
     headers: AuthorHeaders,
-    asset_resolver: Callable[[str], str | None] | None = None,
+    asset_resolver: Callable[[str, str | None], str | None] | None = None,
 ) -> str:
     """Render a complete conversation as markdown.
 
@@ -333,7 +347,7 @@ def render_conversation(
         conversation: The conversation to render
         config: Conversation rendering configuration
         headers: Configuration for author headers
-        asset_resolver: Function to resolve asset IDs to paths
+        asset_resolver: Function to resolve asset IDs to paths, optionally renaming them
 
     Returns:
         Complete markdown document string

{convoviz-0.4.7.dist-info → convoviz-0.4.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.4.7
+Version: 0.4.8
 Summary: Convert your ChatGPT export (ZIP) into clean Markdown text files with inline media, and generate data visualizations like word clouds and usage graphs.
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -24,8 +24,7 @@ Provides-Extra: viz
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <h1 align="center">Convoviz 📊</h1>
-  <p align="center"><strong>Visualize your entire ChatGPT data</strong></p>
+  <h1 align="center">Convoviz</h1>
   <p align="center">
     Convert your ChatGPT history into clean, readable Markdown (text files).
   </p>
@@ -52,6 +51,7 @@ Description-Content-Type: text/markdown
 |---------|-------------|
 | 📝 **Markdown Export** | Clean, well-formatted Markdown with optional YAML headers |
 | 🖼️ **Inline Images** | Media attachments rendered directly in your Markdown files |
+| 🔗 **Citations** | Web search results and source links accurately preserved |
 | ☁️ **Word Clouds** | Visual breakdowns of your most-used words and phrases |
 | 📈 **Usage Graphs** | Bar plots and charts showing your conversation patterns |
 

{convoviz-0.4.7.dist-info → convoviz-0.4.8.dist-info}/RECORD

@@ -41,22 +41,22 @@ convoviz/config.py,sha256=4L0gSOYUPWPEif6lJM1VhkkJq7rAZwAkMi5DIv1Pkwc,3677
 convoviz/exceptions.py,sha256=bQpIKls48uOQpagEJAxpXf5LF7QoagRRfbD0MjWC7Ak,1476
 convoviz/interactive.py,sha256=z4Xdhk_47R1Zx_CaPpY_Gq88i6l9A8YKN3mlc5Uz6KU,8284
 convoviz/io/__init__.py,sha256=y70TYypJ36_kaEA04E2wa1EDaKQVjprKItoKR6MMs4M,471
-convoviz/io/assets.py,sha256=5zcZPlQa9niDw9o-sqJIKgLc0OJ9auzd6KAve5WfBkQ,3459
+convoviz/io/assets.py,sha256=dQxpPreM5M1k1Fw2UY2QjRrPAnYUS4yByiOYhedOiQ0,3657
 convoviz/io/loaders.py,sha256=SqmBWUBqT5lsCf01yy-FUhwIxbiKTFMQnj4k213DsGI,5891
-convoviz/io/writers.py,sha256=-HTvj7D9sqM8M-RsGwd44AquxCVmcDVHgta22QlfNzU,7068
+convoviz/io/writers.py,sha256=X1Y0GZJoEbvniYDpnCwBi6eXn0eF5ObKh5WSGISL-Eg,7113
 convoviz/logging_config.py,sha256=PRuOKij8UD6sKdg3lAsu9lUsTUZ3O6_6uffnyg07M1U,2060
 convoviz/models/__init__.py,sha256=6gAfrk6KJT2QxdvX_v15mUdfIqEw1xKxwQlKSfyA5eI,532
 convoviz/models/collection.py,sha256=L658yKMNC6IZrfxYxZBe-oO9COP_bzVfRznnNon7tfU,4467
 convoviz/models/conversation.py,sha256=IZvDMXxbHSW3Hvxljm8ZpB5eJceJkJ3prDUvZOtrKyM,6419
-convoviz/models/message.py,sha256=lJV51fVLaiIamcTG96VyVq5Khluyp6E_87BWynbxUXg,11591
+convoviz/models/message.py,sha256=nKexz0I5_Ac5Hh67ID1ne9f6omy1xEv-UwfqP1KHuTo,11643
 convoviz/models/node.py,sha256=1vBAtKVscYsUBDnKAOyLxuZaK9KoVF1dFXiKXRHxUnY,1946
 convoviz/pipeline.py,sha256=1kLtsNDN3LYNudyPBlyKwQZ8zWCmRKveP3VWfIgichw,6765
 convoviz/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 convoviz/renderers/__init__.py,sha256=IQgwD9NqtUgbS9zwyPBNZbBIZcFrbZ9C7WMAV-X3Xdg,261
-convoviz/renderers/markdown.py,sha256=uv6SshqY6Nuj374I8qpRXQSlCJ7pLF0IUBl0y-Nd3so,11323
+convoviz/renderers/markdown.py,sha256=htNmng83D2PKMgwhx3xwSa-b9t9naK3SOnPFLr71XeI,12208
 convoviz/renderers/yaml.py,sha256=R6hjXCpgeVm3rPuPVgaj2VopfpPqRFxAFWY7Nxtf6Vg,4213
 convoviz/utils.py,sha256=IQEKYHhWOnYxlr4GwAHoquG0BXTlVRkORL80oUSaIeQ,3417
-convoviz-0.4.7.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
-convoviz-0.4.7.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
-convoviz-0.4.7.dist-info/METADATA,sha256=VbjYg-utjxShJNRT4p3Pf1Lp37TyJcE4FZbUzDE1j3s,7883
-convoviz-0.4.7.dist-info/RECORD,,
+convoviz-0.4.8.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+convoviz-0.4.8.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
+convoviz-0.4.8.dist-info/METADATA,sha256=P2_bHi1L3mCxKOPNlu15hiv6NPuv3LnbGasP4K-pKMY,7884
+convoviz-0.4.8.dist-info/RECORD,,