convoviz 0.2.9__tar.gz → 0.2.11__tar.gz

{convoviz-0.2.9 → convoviz-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.2.9
+Version: 0.2.11
 Summary: Get analytics and visualizations on your ChatGPT data!
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -36,7 +36,6 @@ Convert your ChatGPT history into well-formatted Markdown files. Additionally, v
 - **YAML Headers**: Optional and included by default.
 - **Inline Images**: Media attachments rendered directly in Markdown.
 - **Data Visualizations**: Word clouds, graphs, and more.
-- **Custom Instructions**: All your custom instructions in one JSON file.
 
 See examples [here](demo).
 
@@ -125,7 +124,10 @@ And if you've had a great experience, consider giving the project a star ⭐. It
 
 ## Notes
 
-This is just a small thing I coded to help me see my convos in beautiful markdown. It was originally built with [Obsidian](https://obsidian.md/) (my go-to note-taking app) in mind, but the default output is standard Markdown (and you can choose an Obsidian-flavored mode in the interactive config if you want block IDs / navigation links).
+This is just a small thing I coded to help me see my convos in beautiful markdown. It was originally built with [Obsidian](https://obsidian.md/) (my go-to note-taking app) in mind, but the default output is standard Markdown.
+
+You can choose obsidian flavored md in the cli to get extra features like:
+- model reasoning (`reasoning_recap`, `thoughts`) rendered as collapsible `> [!NOTE]-` callouts instead of being hidden.
 
 I wasn't a fan of the clunky, and sometimes paid, browser extensions.
 
@@ -137,12 +139,6 @@ It should(?) also work as library, so you can import and use the models and func
 
 Convoviz uses NLTK stopwords for word clouds. If you’re offline and NLTK data isn’t already installed, pre-download it once:
 
-```bash
-python -c "import nltk; nltk.download('stopwords')"
-```
-
-If you’re using `uv` without a global install, you can run:
-
 ```bash
 uv run python -c "import nltk; nltk.download('stopwords')"
 ```

{convoviz-0.2.9 → convoviz-0.2.11}/README.md

@@ -10,7 +10,6 @@ Convert your ChatGPT history into well-formatted Markdown files. Additionally, v
 - **YAML Headers**: Optional and included by default.
 - **Inline Images**: Media attachments rendered directly in Markdown.
 - **Data Visualizations**: Word clouds, graphs, and more.
-- **Custom Instructions**: All your custom instructions in one JSON file.
 
 See examples [here](demo).
 
@@ -99,7 +98,10 @@ And if you've had a great experience, consider giving the project a star ⭐. It
 
 ## Notes
 
-This is just a small thing I coded to help me see my convos in beautiful markdown. It was originally built with [Obsidian](https://obsidian.md/) (my go-to note-taking app) in mind, but the default output is standard Markdown (and you can choose an Obsidian-flavored mode in the interactive config if you want block IDs / navigation links).
+This is just a small thing I coded to help me see my convos in beautiful markdown. It was originally built with [Obsidian](https://obsidian.md/) (my go-to note-taking app) in mind, but the default output is standard Markdown.
+
+You can choose obsidian flavored md in the cli to get extra features like:
+- model reasoning (`reasoning_recap`, `thoughts`) rendered as collapsible `> [!NOTE]-` callouts instead of being hidden.
 
 I wasn't a fan of the clunky, and sometimes paid, browser extensions.
 
@@ -111,12 +113,6 @@ It should(?) also work as library, so you can import and use the models and func
 
 Convoviz uses NLTK stopwords for word clouds. If you’re offline and NLTK data isn’t already installed, pre-download it once:
 
-```bash
-python -c "import nltk; nltk.download('stopwords')"
-```
-
-If you’re using `uv` without a global install, you can run:
-
 ```bash
 uv run python -c "import nltk; nltk.download('stopwords')"
 ```

{convoviz-0.2.9 → convoviz-0.2.11}/convoviz/config.py

@@ -27,7 +27,7 @@ class MarkdownConfig(BaseModel):
     """Configuration for markdown output."""
 
     latex_delimiters: Literal["default", "dollars"] = "default"
-    flavor: Literal["obsidian", "standard"] = "standard"
+    flavor: Literal["standard", "obsidian"] = "standard"
 
 
 class YAMLConfig(BaseModel):

{convoviz-0.2.9 → convoviz-0.2.11}/convoviz/interactive.py

@@ -143,11 +143,11 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
 
     # Prompt for markdown flavor
     flavor_result = cast(
-        Literal["obsidian", "standard"],
+        Literal["standard", "obsidian"],
         _ask_or_cancel(
             select(
                 "Select the markdown flavor:",
-                choices=["obsidian", "standard"],
+                choices=["standard", "obsidian"],
                 default=config.conversation.markdown.flavor,
                 style=CUSTOM_STYLE,
             )

{convoviz-0.2.9 → convoviz-0.2.11}/convoviz/renderers/markdown.py

@@ -8,24 +8,6 @@ from convoviz.exceptions import MessageContentError
 from convoviz.models import Conversation, Node
 from convoviz.renderers.yaml import render_yaml_header
 
-# Length for shortened node IDs in markdown output (similar to Git short hashes)
-SHORT_ID_LENGTH = 8
-
-
-def shorten_id(node_id: str) -> str:
-    """Shorten a node ID for display in markdown.
-
-    Takes the first 8 characters of the ID, which is typically the first
-    segment of a UUID and provides sufficient uniqueness within a conversation.
-
-    Args:
-        node_id: The full node ID (often a UUID)
-
-    Returns:
-        Shortened ID string
-    """
-    return node_id[:SHORT_ID_LENGTH]
-
 
 def close_code_blocks(text: str) -> str:
     """Ensure all code blocks in the text are properly closed.
@@ -80,6 +62,32 @@ def code_block(text: str, lang: str = "python") -> str:
     return f"```{lang}\n{text}\n```"
 
 
+def render_obsidian_callout(
+    content: str,
+    title: str,
+    callout_type: str = "NOTE",
+    collapsed: bool = True,
+) -> str:
+    """Render content as an Obsidian collapsible callout.
+
+    Syntax: > [!TYPE]+/- Title
+    This is Obsidian-specific; on GitHub/standard markdown it renders as a blockquote.
+
+    Args:
+        content: The content to wrap
+        title: The callout title
+        callout_type: The callout type (NOTE, TIP, WARNING, etc.)
+        collapsed: Whether to default to collapsed (-) or expanded (+)
+
+    Returns:
+        Markdown callout string
+    """
+    fold = "-" if collapsed else "+"
+    lines = content.strip().split("\n")
+    quoted_lines = [f"> {line}" for line in lines]
+    return f"> [!{callout_type}]{fold} {title}\n" + "\n".join(quoted_lines)
+
+
 def render_message_header(role: str, headers: AuthorHeaders) -> str:
     """Get the markdown header for a message author.
 
@@ -99,15 +107,12 @@ def render_message_header(role: str, headers: AuthorHeaders) -> str:
     return header_map.get(role, f"### {role.title()}")
 
 
-def render_node_header(node: Node, headers: AuthorHeaders, flavor: str = "standard") -> str:
+def render_node_header(node: Node, headers: AuthorHeaders) -> str:
     """Render the header section of a node.
 
-    Includes the node ID, parent link, and message author header.
-
     Args:
         node: The node to render
         headers: Configuration for author headers
-        flavor: Markdown flavor (obsidian, standard)
 
     Returns:
         The header markdown string
@@ -115,42 +120,15 @@ def render_node_header(node: Node, headers: AuthorHeaders, flavor: str = "standa
     if node.message is None:
         return ""
 
-    if flavor == "standard":
-        return render_message_header(node.message.author.role, headers) + "\n"
-
-    # Obsidian flavor
-    parts = []
-
-    # Add parent link if parent has a message
-    if node.parent_node and node.parent_node.message:
-        parts.append(f"[⬆️](#^{shorten_id(node.parent_node.id)})")
+    return render_message_header(node.message.author.role, headers) + "\n"
 
-    author_header = render_message_header(node.message.author.role, headers)
-    parts.append(f"{author_header} ^{shorten_id(node.id)}")
 
-    return "\n".join(parts) + "\n"
-
-
-def render_node_footer(node: Node, flavor: str = "standard") -> str:
-    """Render the footer section of a node with child links.
-
-    Args:
-        node: The node to render
-        flavor: Markdown flavor (obsidian, standard)
-
-    Returns:
-        The footer markdown string with child navigation links
-    """
-    if flavor == "standard" or not node.children_nodes:
-        return ""
-
-    if len(node.children_nodes) == 1:
-        return f"\n[⬇️](#^{shorten_id(node.children_nodes[0].id)})\n"
-
-    links = " | ".join(
-        f"[{i + 1} ⬇️](#^{shorten_id(child.id)})" for i, child in enumerate(node.children_nodes)
-    )
-    return f"\n{links}\n"
+# Content types that can be rendered as collapsible callouts in Obsidian
+OBSIDIAN_COLLAPSIBLE_TYPES: dict[str, tuple[str, str]] = {
+    # content_type: (callout_type, title)
+    "reasoning_recap": ("NOTE", "🧠 AI Reasoning"),
+    "thoughts": ("NOTE", "💭 AI Thoughts"),
+}
 
 
 def render_node(
@@ -167,7 +145,7 @@ def render_node(
         headers: Configuration for author headers
         use_dollar_latex: Whether to convert LaTeX delimiters to dollars
         asset_resolver: Function to resolve asset IDs to paths
-        flavor: Markdown flavor (obsidian, standard)
+        flavor: Markdown flavor ("standard" or "obsidian")
 
     Returns:
         Complete markdown string for the node
@@ -175,10 +153,30 @@ def render_node(
     if node.message is None:
         return ""
 
+    content_type = node.message.content.content_type
+
+    # For Obsidian flavor, render certain hidden types as collapsible callouts
+    # No separator (---) since these are visually distinct and may appear consecutively
+    if flavor == "obsidian" and content_type in OBSIDIAN_COLLAPSIBLE_TYPES:
+        try:
+            text = node.message.text
+        except MessageContentError:
+            text = ""
+
+        if text.strip():
+            callout_type, title = OBSIDIAN_COLLAPSIBLE_TYPES[content_type]
+            callout = render_obsidian_callout(
+                content=text,
+                title=title,
+                callout_type=callout_type,
+                collapsed=True,
+            )
+            return f"\n{callout}\n"
+
     if node.message.is_hidden:
         return ""
 
-    header = render_node_header(node, headers, flavor=flavor)
+    header = render_node_header(node, headers)
 
     # Get and process content
     try:
@@ -201,9 +199,7 @@ def render_node(
                 # Obsidian handles this well.
                 content += f"\n![Image]({rel_path})\n"
 
-    footer = render_node_footer(node, flavor=flavor)
-
-    return f"\n{header}{content}{footer}\n---\n"
+    return f"\n{header}{content}\n---\n"
 
 
 def _ordered_nodes(conversation: Conversation) -> list[Node]:
@@ -263,7 +259,11 @@ def render_conversation(
     for node in _ordered_nodes(conversation):
         if node.message:
             markdown += render_node(
-                node, headers, use_dollar_latex, asset_resolver=asset_resolver, flavor=flavor
+                node,
+                headers,
+                use_dollar_latex,
+                asset_resolver=asset_resolver,
+                flavor=flavor,
             )
 
     return markdown

{convoviz-0.2.9 → convoviz-0.2.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "convoviz"
-version = "0.2.9"
+version = "0.2.11"
 description = "Get analytics and visualizations on your ChatGPT data!"
 license = "MIT"
 keywords = [