convoviz 0.2.8__tar.gz → 0.2.10__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.2.8
+Version: 0.2.10
 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).
 

{convoviz-0.2.8 → convoviz-0.2.10}/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).
 

{convoviz-0.2.8 → convoviz-0.2.10}/convoviz/analysis/wordcloud.py

@@ -139,7 +139,8 @@ def generate_wordclouds(
         text = group.plaintext("user", "assistant")
         if text.strip():
             img = generate_wordcloud(text, config)
-            img.save(output_dir / f"{week.strftime('%Y week %W')}.png", optimize=True)
+            # Format: 2024-W15.png (ISO week format)
+            img.save(output_dir / f"{week.strftime('%Y-W%W')}.png", optimize=True)
 
     for month, group in tqdm(
         month_groups.items(),
@@ -149,7 +150,8 @@ def generate_wordclouds(
         text = group.plaintext("user", "assistant")
         if text.strip():
             img = generate_wordcloud(text, config)
-            img.save(output_dir / f"{month.strftime('%Y %B')}.png", optimize=True)
+            # Format: 2024-03-March.png (consistent with folder naming)
+            img.save(output_dir / f"{month.strftime('%Y-%m-%B')}.png", optimize=True)
 
     for year, group in tqdm(
         year_groups.items(),
@@ -159,4 +161,5 @@ def generate_wordclouds(
         text = group.plaintext("user", "assistant")
         if text.strip():
             img = generate_wordcloud(text, config)
+            # Format: 2024.png
             img.save(output_dir / f"{year.strftime('%Y')}.png", optimize=True)

{convoviz-0.2.8 → convoviz-0.2.10}/convoviz/config.py

@@ -10,8 +10,8 @@ from pydantic import BaseModel, Field
 class FolderOrganization(str, Enum):
     """How to organize markdown output files in folders."""
 
-    FLAT = "flat"  # All files in one directory (default)
-    DATE = "date"  # Nested by year/month/week
+    FLAT = "flat"  # All files in one directory
+    DATE = "date"  # Nested by year/month (default)
 
 
 class AuthorHeaders(BaseModel):
@@ -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.8 → convoviz-0.2.10}/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.8 → convoviz-0.2.10}/convoviz/io/writers.py

@@ -2,6 +2,7 @@
 
 from os import utime as os_utime
 from pathlib import Path
+from urllib.parse import quote
 
 from orjson import OPT_INDENT_2, dumps
 from tqdm import tqdm
@@ -32,8 +33,8 @@ _MONTH_NAMES = [
 def get_date_folder_path(conversation: Conversation) -> Path:
     """Get the date-based folder path for a conversation.
 
-    Creates a nested structure: year/month/week
-    Example: 2024/03-March/Week-02/
+    Creates a nested structure: year/month
+    Example: 2024/03-March/
 
     Args:
         conversation: The conversation to get the path for
@@ -51,13 +52,7 @@ def get_date_folder_path(conversation: Conversation) -> Path:
     month_name = _MONTH_NAMES[month_num - 1]
     month = f"{month_num:02d}-{month_name}"
 
-    # Week folder: "Week-01" through "Week-05" (week of the month)
-    # Calculate which week of the month this date falls into
-    day = create_time.day
-    week_of_month = (day - 1) // 7 + 1
-    week = f"Week-{week_of_month:02d}"
-
-    return Path(year) / month / week
+    return Path(year) / month
 
 
 def save_conversation(
@@ -115,6 +110,62 @@ def save_conversation(
     return final_path
 
 
+def _generate_year_index(year_dir: Path, year: str) -> None:
+    """Generate a _index.md file for a year folder.
+
+    Args:
+        year_dir: Path to the year directory
+        year: The year string (e.g., "2024")
+    """
+    months = sorted(
+        [d.name for d in year_dir.iterdir() if d.is_dir()],
+        key=lambda m: int(m.split("-")[0]),
+    )
+
+    lines = [
+        f"# {year}",
+        "",
+        "## Months",
+        "",
+    ]
+
+    for month in months:
+        month_name = month.split("-", 1)[1] if "-" in month else month
+        lines.append(f"- [{month_name}]({month}/_index.md)")
+
+    index_path = year_dir / "_index.md"
+    index_path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+
+
+def _generate_month_index(month_dir: Path, year: str, month: str) -> None:
+    """Generate a _index.md file for a month folder.
+
+    Args:
+        month_dir: Path to the month directory
+        year: The year string (e.g., "2024")
+        month: The month folder name (e.g., "03-March")
+    """
+    month_name = month.split("-", 1)[1] if "-" in month else month
+    files = sorted(
+        [f.name for f in month_dir.glob("*.md") if f.name != "_index.md"]
+    )
+
+    lines = [
+        f"# {month_name} {year}",
+        "",
+        "## Conversations",
+        "",
+    ]
+
+    for file in files:
+        title = file[:-3]  # Remove .md extension
+        encoded_file = quote(file)
+        lines.append(f"- [{title}]({encoded_file})")
+
+    index_path = month_dir / "_index.md"
+    index_path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+
+
 def save_collection(
     collection: ConversationCollection,
     directory: Path,
@@ -151,6 +202,15 @@ def save_collection(
         filepath = target_dir / f"{sanitize(conv.title)}.md"
         save_conversation(conv, filepath, config, headers, source_path=collection.source_path)
 
+    # Generate index files for date organization
+    if folder_organization == FolderOrganization.DATE:
+        for year_dir in directory.iterdir():
+            if year_dir.is_dir() and year_dir.name.isdigit():
+                for month_dir in year_dir.iterdir():
+                    if month_dir.is_dir():
+                        _generate_month_index(month_dir, year_dir.name, month_dir.name)
+                _generate_year_index(year_dir, year_dir.name)
+
 
 def save_custom_instructions(
     collection: ConversationCollection,

{convoviz-0.2.8 → convoviz-0.2.10}/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.
@@ -99,15 +81,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 +94,7 @@ 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)})")
-
-    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"
+    return render_message_header(node.message.author.role, headers) + "\n"
 
 
 def render_node(
@@ -158,7 +102,6 @@ def render_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.
 
@@ -167,7 +110,6 @@ 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)
 
     Returns:
         Complete markdown string for the node
@@ -178,7 +120,7 @@ def render_node(
     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 +143,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]:
@@ -254,7 +194,7 @@ def render_conversation(
         Complete markdown document string
     """
     use_dollar_latex = config.markdown.latex_delimiters == "dollars"
-    flavor = config.markdown.flavor
+    # Note: config.markdown.flavor is available for future obsidian-specific features
 
     # Start with YAML header
     markdown = render_yaml_header(conversation, config.yaml)
@@ -263,7 +203,7 @@ 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
             )
 
     return markdown

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

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