convoviz 0.3.0__tar.gz → 0.3.1__tar.gz

{convoviz-0.3.0 → convoviz-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.3.0
+Version: 0.3.1
 Summary: Get analytics and visualizations on your ChatGPT data!
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -9,19 +9,18 @@ License-Expression: MIT
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: matplotlib>=3.9.4
-Requires-Dist: nltk>=3.9.2
 Requires-Dist: orjson>=3.11.5
-Requires-Dist: pillow>=11.3.0
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: questionary>=2.1.1
 Requires-Dist: rich>=14.2.0
 Requires-Dist: tqdm>=4.67.1
 Requires-Dist: typer>=0.21.0
-Requires-Dist: wordcloud>=1.9.5
+Requires-Dist: nltk>=3.9.2 ; extra == 'viz'
+Requires-Dist: wordcloud>=1.9.5 ; extra == 'viz'
 Requires-Python: >=3.12
 Project-URL: Repository, https://github.com/mohamed-chs/chatgpt-history-export-to-md
+Provides-Extra: viz
 Description-Content-Type: text/markdown
 
 # Convoviz 📊: Visualize your entire ChatGPT data
@@ -49,23 +48,19 @@ See examples [here](demo).
 
 ### 2. Install the tool 🛠
 
-Try it without installing using uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
+With uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
 
 ```bash
-uvx convoviz
-```
-
-You can install it with uv (Recommended):
-
-```bash
-uv tool install convoviz
+uv tool install convoviz[viz]
 ```
 
 or pipx:
 ```bash
-pipx install convoviz
+pipx install convoviz[viz]
 ```
 
+The `[viz]` extra includes graphs and word clouds. If you only need markdown conversion, you can skip it for a faster install (`uv tool install convoviz`).
+
 ### 3. Run the tool 🏃‍♂️
 
 Simply run the command and follow the prompts:
@@ -137,12 +132,12 @@ It should(?) also work as library, so you can import and use the models and func
 
 ### Offline / reproducible runs
 
-Convoviz uses NLTK stopwords for word clouds. If you’re offline and NLTK data isn’t already installed, pre-download it once:
+Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
 
 ```bash
-uv run python -c "import nltk; nltk.download('stopwords')"
+python -c "import nltk; nltk.download('stopwords')"
 ```
 
 ### Bookmarklet
 
-There’s also a JavaScript bookmarklet flow under `js/` (experimental) for exporting additional conversation data outside the official ZIP export.
+There's also a JavaScript bookmarklet flow under `js/` (experimental) for exporting additional conversation data outside the official ZIP export.

{convoviz-0.3.0 → convoviz-0.3.1}/README.md

@@ -23,23 +23,19 @@ See examples [here](demo).
 
 ### 2. Install the tool 🛠
 
-Try it without installing using uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
+With uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
 
 ```bash
-uvx convoviz
-```
-
-You can install it with uv (Recommended):
-
-```bash
-uv tool install convoviz
+uv tool install convoviz[viz]
 ```
 
 or pipx:
 ```bash
-pipx install convoviz
+pipx install convoviz[viz]
 ```
 
+The `[viz]` extra includes graphs and word clouds. If you only need markdown conversion, you can skip it for a faster install (`uv tool install convoviz`).
+
 ### 3. Run the tool 🏃‍♂️
 
 Simply run the command and follow the prompts:
@@ -111,12 +107,12 @@ It should(?) also work as library, so you can import and use the models and func
 
 ### Offline / reproducible runs
 
-Convoviz uses NLTK stopwords for word clouds. If you’re offline and NLTK data isn’t already installed, pre-download it once:
+Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
 
 ```bash
-uv run python -c "import nltk; nltk.download('stopwords')"
+python -c "import nltk; nltk.download('stopwords')"
 ```
 
 ### Bookmarklet
 
-There’s also a JavaScript bookmarklet flow under `js/` (experimental) for exporting additional conversation data outside the official ZIP export.
+There's also a JavaScript bookmarklet flow under `js/` (experimental) for exporting additional conversation data outside the official ZIP export.

{convoviz-0.3.0 → convoviz-0.3.1}/convoviz/__init__.py

@@ -1,6 +1,6 @@
 """Convoviz - ChatGPT data visualization and export tool."""
 
-from convoviz import analysis, config, io, models, renderers, utils
+from convoviz import config, io, models, renderers, utils
 from convoviz.config import ConvovizConfig, get_default_config
 from convoviz.models import Conversation, ConversationCollection, Message, Node
 from convoviz.pipeline import run_pipeline
@@ -23,3 +23,12 @@ __all__ = [
     "get_default_config",
     "run_pipeline",
 ]
+
+
+def __getattr__(name: str):
+    """Lazy import for optional submodules like analysis."""
+    if name == "analysis":
+        from convoviz import analysis
+
+        return analysis
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

convoviz-0.3.1/convoviz/analysis/__init__.py

@@ -0,0 +1,22 @@
+"""Data analysis and visualization for convoviz.
+
+Requires the [viz] extra: pip install convoviz[viz]
+"""
+
+__all__ = [
+    "generate_week_barplot",
+    "generate_wordcloud",
+]
+
+
+def __getattr__(name: str):
+    """Lazy import for visualization functions requiring optional dependencies."""
+    if name == "generate_week_barplot":
+        from convoviz.analysis.graphs import generate_week_barplot
+
+        return generate_week_barplot
+    if name == "generate_wordcloud":
+        from convoviz.analysis.wordcloud import generate_wordcloud
+
+        return generate_wordcloud
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{convoviz-0.3.0 → convoviz-0.3.1}/convoviz/pipeline.py

@@ -6,7 +6,7 @@ from shutil import rmtree
 from rich.console import Console
 
 from convoviz.config import ConvovizConfig, OutputKind
-from convoviz.exceptions import InvalidZipError
+from convoviz.exceptions import ConfigurationError, InvalidZipError
 from convoviz.io.loaders import (
     find_latest_bookmarklet_json,
     load_collection_from_json,
@@ -122,7 +122,13 @@ def run_pipeline(config: ConvovizConfig) -> None:
     # Generate graphs (if selected)
     if OutputKind.GRAPHS in selected_outputs:
         # Lazy import to allow markdown-only usage without matplotlib
-        from convoviz.analysis.graphs import generate_graphs
+        try:
+            from convoviz.analysis.graphs import generate_graphs
+        except ModuleNotFoundError as e:
+            raise ConfigurationError(
+                "Graph generation requires matplotlib. "
+                "Install with: pip install convoviz[viz]"
+            ) from e
 
         graph_folder = output_folder / "Graphs"
         graph_folder.mkdir(parents=True, exist_ok=True)
@@ -140,7 +146,13 @@ def run_pipeline(config: ConvovizConfig) -> None:
     # Generate word clouds (if selected)
     if OutputKind.WORDCLOUDS in selected_outputs:
         # Lazy import to allow markdown-only usage without wordcloud/nltk
-        from convoviz.analysis.wordcloud import generate_wordclouds
+        try:
+            from convoviz.analysis.wordcloud import generate_wordclouds
+        except ModuleNotFoundError as e:
+            raise ConfigurationError(
+                "Word cloud generation requires wordcloud and nltk. "
+                "Install with: pip install convoviz[viz]"
+            ) from e
 
         wordcloud_folder = output_folder / "Word-Clouds"
         wordcloud_folder.mkdir(parents=True, exist_ok=True)

{convoviz-0.3.0 → convoviz-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "convoviz"
-version = "0.3.0"
+version = "0.3.1"
 description = "Get analytics and visualizations on your ChatGPT data!"
 license = "MIT"
 keywords = [
@@ -18,16 +18,18 @@ authors = [
     { name = "Mohamed Cheikh Sidiya", email = "mohamedcheikhsidiya77@gmail.com" }
 ]
 dependencies = [
-    "matplotlib>=3.9.4",
-    "nltk>=3.9.2",
     "orjson>=3.11.5",
-    "pillow>=11.3.0",
     "pydantic>=2.12.5",
     "pydantic-settings>=2.7.0",
     "questionary>=2.1.1",
     "rich>=14.2.0",
     "tqdm>=4.67.1",
     "typer>=0.21.0",
+]
+
+[project.optional-dependencies]
+viz = [
+    "nltk>=3.9.2",
     "wordcloud>=1.9.5",
 ]
 
@@ -66,6 +68,9 @@ dev = [
     "ruff>=0.14.10",
     "ty>=0.0.11",
     "types-tqdm>=4.67.0.20250809",
+    # Viz extras for testing (wordcloud pulls in matplotlib + pillow)
+    "nltk>=3.9.2",
+    "wordcloud>=1.9.5",
 ]
 
 [tool.ruff]

convoviz-0.3.0/convoviz/analysis/__init__.py

@@ -1,9 +0,0 @@
-"""Data analysis and visualization for convoviz."""
-
-from convoviz.analysis.graphs import generate_week_barplot
-from convoviz.analysis.wordcloud import generate_wordcloud
-
-__all__ = [
-    "generate_week_barplot",
-    "generate_wordcloud",
-]