convoviz 0.2.8__py3-none-any.whl → 0.2.9__py3-none-any.whl

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/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):

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.dist-info → convoviz-0.2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.2.8
+Version: 0.2.9
 Summary: Get analytics and visualizations on your ChatGPT data!
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya

{convoviz-0.2.8.dist-info → convoviz-0.2.9.dist-info}/RECORD

@@ -2,7 +2,7 @@ convoviz/__init__.py,sha256=bQLCHO2U9EyMTGqNgsYiCtBQKTKNj4iIM3-TwIkrnRY,612
 convoviz/__main__.py,sha256=1qiGW13_SgL7wJi8iioIN-AAHGkNGnEl5q_RcPUrI0s,143
 convoviz/analysis/__init__.py,sha256=FxgH5JJpyypiLJpMQn_HlM51jnb8lQdP63_C_W3Dlx4,241
 convoviz/analysis/graphs.py,sha256=gt056UkgGcy9vCkupQmW_HjOLy-W6j4Ekxr315BXPgA,29457
-convoviz/analysis/wordcloud.py,sha256=ZnbA_-rcXHwXIny_xbudfJDQbIuPT7urNFfHcx6QWxQ,4673
+convoviz/analysis/wordcloud.py,sha256=WLZhBo5Ha83o6XJyzjhgx4tDjgPX-Q9kizCxfmxlJ3A,4828
 convoviz/assets/colormaps.txt,sha256=59TSGz428AxY14AEvymAH2IJ2RT9Mlp7Sy0N12NEdXQ,108
 convoviz/assets/fonts/AmaticSC-Regular.ttf,sha256=83clh7a3urnTLud0_yZofuIb6BdyC2LMI9jhE6G2LvU,142696
 convoviz/assets/fonts/ArchitectsDaughter-Regular.ttf,sha256=fnrj5_N_SlY2Lj3Ehqz5aKECPZVJlJAflgsOU94_qIM,37756
@@ -37,13 +37,13 @@ convoviz/assets/fonts/YsabeauSC-Thin.ttf,sha256=hZGOZNTRrxbiUPE2VDeLbtnaRwkMOBaV
 convoviz/assets/fonts/Zeyada-Regular.ttf,sha256=fKhkrp9VHt_3Aw8JfkfkPeC2j3CilLWuPUudzBeawPQ,57468
 convoviz/assets/stopwords.txt,sha256=7_ywpxsKYOj3U5CZTh9lP4GqbbkZLMabSOjKAXFk6Wc,539
 convoviz/cli.py,sha256=TPboT0maH_b_EjiT9cWbUSyMFz4ozoqf1_R-4AzY31g,3730
-convoviz/config.py,sha256=5fklWzwr0aNyeEJG0NAggLhT0xI0kwgxhjyh9_zUvwM,3112
+convoviz/config.py,sha256=9qB9pT2v8q0FD1CBu9yCcEwMskYvUxXMfY17-R-tKbU,3107
 convoviz/exceptions.py,sha256=bQpIKls48uOQpagEJAxpXf5LF7QoagRRfbD0MjWC7Ak,1476
 convoviz/interactive.py,sha256=VXtKgYo9tZGtsoj7zThdnbTrbjSNP5MzAZbdOs3icW4,7424
 convoviz/io/__init__.py,sha256=y70TYypJ36_kaEA04E2wa1EDaKQVjprKItoKR6MMs4M,471
 convoviz/io/assets.py,sha256=WLauNEvk9QRo0Q52KE_bPyCRFa1CjM54L1j8SsTfGwg,2894
 convoviz/io/loaders.py,sha256=RuGiGzpyNcgwTxOM-m2ehhyh2mP1-k1YamK8-VynR3g,5713
-convoviz/io/writers.py,sha256=UW-JF5uq91NV62qpFVqgWTYSzzOAkLv67zDpulz2iBc,5072
+convoviz/io/writers.py,sha256=krGvU6UJMrDxZCqt3u_lyLA_gS0oSbeUXhYNFbY4mHo,6862
 convoviz/models/__init__.py,sha256=6gAfrk6KJT2QxdvX_v15mUdfIqEw1xKxwQlKSfyA5eI,532
 convoviz/models/collection.py,sha256=L658yKMNC6IZrfxYxZBe-oO9COP_bzVfRznnNon7tfU,4467
 convoviz/models/conversation.py,sha256=ssx1Z6LM9kJIx3OucQW8JVoAc8zCdxj1iOLtie2B3ak,5678
@@ -55,7 +55,7 @@ convoviz/renderers/__init__.py,sha256=IQgwD9NqtUgbS9zwyPBNZbBIZcFrbZ9C7WMAV-X3Xd
 convoviz/renderers/markdown.py,sha256=mpDt-xrjsPX_wt9URCDk2wicesaVv_VTWWxTHCMKiLM,7765
 convoviz/renderers/yaml.py,sha256=XG1s4VhDdx-TiqekTkgED87RZ1lVQ7IwrbA-sZHrs7k,4056
 convoviz/utils.py,sha256=IQEKYHhWOnYxlr4GwAHoquG0BXTlVRkORL80oUSaIeQ,3417
-convoviz-0.2.8.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
-convoviz-0.2.8.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
-convoviz-0.2.8.dist-info/METADATA,sha256=DeO9FBLgHoXlvRDnMiBBSM6qT-h-1bqyQSHqIKb1zrg,5757
-convoviz-0.2.8.dist-info/RECORD,,
+convoviz-0.2.9.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
+convoviz-0.2.9.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
+convoviz-0.2.9.dist-info/METADATA,sha256=izOEPI6IMXeW8Ql4v9zjFMvn2Ljfb83wDDjZX1MirfA,5757
+convoviz-0.2.9.dist-info/RECORD,,