convoviz 0.2.10__tar.gz → 0.2.12__tar.gz

{convoviz-0.2.10 → convoviz-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.2.10
+Version: 0.2.12
 Summary: Get analytics and visualizations on your ChatGPT data!
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -124,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.
 
@@ -136,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.10 → convoviz-0.2.12}/README.md

@@ -98,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.
 
@@ -110,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.12/convoviz/assets/stopwords.txt

@@ -0,0 +1 @@
+

{convoviz-0.2.10 → convoviz-0.2.12}/convoviz/renderers/markdown.py

@@ -62,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.
 
@@ -97,11 +123,20 @@ def render_node_header(node: Node, headers: AuthorHeaders) -> str:
     return render_message_header(node.message.author.role, headers) + "\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(
     node: Node,
     headers: AuthorHeaders,
     use_dollar_latex: bool = False,
     asset_resolver: Callable[[str], str | None] | None = None,
+    flavor: str = "standard",
 ) -> str:
     """Render a complete node as markdown.
 
@@ -110,6 +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 ("standard" or "obsidian")
 
     Returns:
         Complete markdown string for the node
@@ -117,6 +153,26 @@ 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 ""
 
@@ -194,7 +250,7 @@ def render_conversation(
         Complete markdown document string
     """
     use_dollar_latex = config.markdown.latex_delimiters == "dollars"
-    # Note: config.markdown.flavor is available for future obsidian-specific features
+    flavor = config.markdown.flavor
 
     # Start with YAML header
     markdown = render_yaml_header(conversation, config.yaml)
@@ -203,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
+                node,
+                headers,
+                use_dollar_latex,
+                asset_resolver=asset_resolver,
+                flavor=flavor,
             )
 
     return markdown

{convoviz-0.2.10 → convoviz-0.2.12}/pyproject.toml

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

convoviz-0.2.10/convoviz/assets/stopwords.txt

@@ -1,75 +0,0 @@
-# Python
-def
-class
-import
-from
-as
-elif
-finally
-yield
-pass
-lambda
-async
-await
-nonlocal
-assert
-self
-cls
-# JavaScript / TypeScript
-const
-let
-var
-function
-export
-default
-extends
-implements
-static
-# Java / C#
-final
-abstract
-new
-super
-package
-throws
-synchronized
-volatile
-transient
-native
-strictfp
-override
-# C / C++
-unsigned
-signed
-typedef
-sizeof
-extern
-register
-restrict
-inline
-template
-typename
-virtual
-friend
-mutable
-explicit
-operator
-typeid
-# Rust
-mut
-fn
-pub
-mod
-trait
-impl
-where
-loop
-unsafe
-crate
-dyn
-# Go
-func
-chan
-defer
-fallthrough
-goto