convoviz 0.3.9__tar.gz → 0.4.1__tar.gz

convoviz-0.4.1/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: convoviz
+Version: 0.4.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
+Author-email: Mohamed Cheikh Sidiya <mohamedcheikhsidiya77@gmail.com>
+License-Expression: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: orjson>=3.11.5
+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: 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/convoviz
+Provides-Extra: viz
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">Convoviz 📊</h1>
+  <p align="center"><strong>Visualize your entire ChatGPT data</strong></p>
+  <p align="center">
+    Convert your ChatGPT history into well-formatted Markdown files.<br>
+    Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/convoviz/"><img src="https://img.shields.io/pypi/v/convoviz?style=flat-square&logo=pypi&logoColor=white&label=PyPI" alt="PyPI Version"></a>
+  <a href="https://pepy.tech/projects/convoviz"><img src="https://static.pepy.tech/personalized-badge/convoviz?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=GREEN&left_text=Downloads" alt="PyPI Downloads"></a>
+  <a href="https://github.com/mohamed-chs/convoviz/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mohamed-chs/convoviz?style=flat-square" alt="License"></a>
+</p>
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 📝 **Markdown Export** | Clean, well-formatted Markdown with optional YAML headers |
+| 🖼️ **Inline Images** | Media attachments rendered directly in your Markdown files |
+| ☁️ **Word Clouds** | Visual breakdowns of your most-used words and phrases |
+| 📈 **Usage Graphs** | Bar plots and charts showing your conversation patterns |
+
+> 💡 **See examples in the [`demo/`](demo) folder!**
+
+---
+
+## 📖 How to Use
+
+### Step 1: Export Your ChatGPT Data
+
+1. Sign in at [chatgpt.com](https://chatgpt.com)
+2. Navigate to: **Profile Name** (bottom left) → **Settings** → **Data controls** → **Export**
+3. Click **Confirm export**
+4. Wait for the email from OpenAI, then download the `.zip` file
+
+---
+
+### Step 2: Install Convoviz
+
+<details open>
+<summary><strong>🚀 Quick Install (Recommended)</strong></summary>
+
+One command installs everything you need — [uv](https://github.com/astral-sh/uv) (a fast Python package manager) and convoviz with graphs and word clouds.
+
+**Linux / macOS:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.ps1 | iex
+```
+
+</details>
+
+<details>
+<summary><strong>📦 Alternative: Install with pip</strong></summary>
+
+If you prefer using `pip` directly:
+
+```bash
+# Create a virtual environment (keeps your system Python clean)
+python3 -m venv .venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install convoviz with visualization extras
+pip install "convoviz[viz]"
+```
+
+</details>
+
+---
+
+### Step 3: Run Convoviz
+
+The simplest way is to run the command and follow the interactive prompts:
+
+```bash
+convoviz
+```
+
+Or, provide arguments directly to skip the prompts:
+
+```bash
+convoviz --input path/to/your/export.zip --output path/to/output/folder
+```
+
+<details>
+<summary><strong>⚙️ Command Line Options</strong></summary>
+
+#### Selective Output
+
+By default, all outputs (Markdown, graphs, word clouds) are generated. Use `--outputs` to pick specific ones:
+
+```bash
+convoviz --input export.zip --outputs markdown --outputs graphs
+```
+
+Available options: `markdown`, `graphs`, `wordclouds`
+
+> In interactive mode, you'll be prompted to choose which outputs to generate.
+
+#### Other Useful Flags
+
+| Flag | Description |
+|------|-------------|
+| `--zip` / `-z` | Alias for `--input` (for convenience) |
+| `--no-interactive` | Force non-interactive mode |
+| `--flat` | Put all Markdown files in a single folder (instead of organizing by date) |
+| `--verbose` / `-v` | Enable detailed logging (use `-vv` for debug logs) |
+| `--log-file PATH` | Specify a custom log file location |
+
+For a complete list of options:
+
+```bash
+convoviz --help
+```
+
+</details>
+
+---
+
+### Step 4: Check the Output 🎉
+
+After running the script, head to your output folder to see:
+- 📝 Neatly formatted Markdown files
+- 📊 Visualizations and graphs
+
+![wordcloud example](demo/wordcloud-example.png)
+
+---
+
+## 💌 Share Your Feedback!
+
+I hope you find this tool useful. I'm continuously looking to improve on this, but I need your help for that.
+
+Whether you're a tech wizard or you're new to all this, I'd love to hear about your journey with the tool. Found a quirk? Have a suggestion? Or just want to send some good vibes? I'm all ears!
+
+👉 **[Open an Issue](https://github.com/mohamed-chs/convoviz/issues)**
+
+And if you've had a great experience, consider giving the project a ⭐ **star**! It keeps me motivated and helps others discover it!
+
+---
+
+## 📝 Notes
+
+<details>
+<summary><strong>About This Project</strong></summary>
+
+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.
+
+I wasn't a fan of the clunky, and sometimes paid, browser extensions.
+
+It was also a great opportunity to learn more about Python and type annotations. I had mypy, pyright, and ruff all on strict mode, 'twas fun.
+
+</details>
+
+<details>
+<summary><strong>Using as a Library</strong></summary>
+
+It should also work as a library, so you can import and use the models and functions. I need to add more documentation for that though. Feel free to reach out if you need help.
+
+</details>
+
+<details>
+<summary><strong>Offline / Reproducible Runs</strong></summary>
+
+Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
+
+```bash
+python -c "import nltk; nltk.download('stopwords')"
+```
+
+</details>
+
+<details>
+<summary><strong>Bookmarklet (Experimental)</strong></summary>
+
+There's also a JavaScript bookmarklet flow under `js/` for exporting additional conversation data outside the official ZIP export. This is experimental.
+
+</details>

convoviz-0.4.1/README.md

@@ -0,0 +1,190 @@
+<p align="center">
+  <h1 align="center">Convoviz 📊</h1>
+  <p align="center"><strong>Visualize your entire ChatGPT data</strong></p>
+  <p align="center">
+    Convert your ChatGPT history into well-formatted Markdown files.<br>
+    Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/convoviz/"><img src="https://img.shields.io/pypi/v/convoviz?style=flat-square&logo=pypi&logoColor=white&label=PyPI" alt="PyPI Version"></a>
+  <a href="https://pepy.tech/projects/convoviz"><img src="https://static.pepy.tech/personalized-badge/convoviz?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=GREEN&left_text=Downloads" alt="PyPI Downloads"></a>
+  <a href="https://github.com/mohamed-chs/convoviz/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mohamed-chs/convoviz?style=flat-square" alt="License"></a>
+</p>
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 📝 **Markdown Export** | Clean, well-formatted Markdown with optional YAML headers |
+| 🖼️ **Inline Images** | Media attachments rendered directly in your Markdown files |
+| ☁️ **Word Clouds** | Visual breakdowns of your most-used words and phrases |
+| 📈 **Usage Graphs** | Bar plots and charts showing your conversation patterns |
+
+> 💡 **See examples in the [`demo/`](demo) folder!**
+
+---
+
+## 📖 How to Use
+
+### Step 1: Export Your ChatGPT Data
+
+1. Sign in at [chatgpt.com](https://chatgpt.com)
+2. Navigate to: **Profile Name** (bottom left) → **Settings** → **Data controls** → **Export**
+3. Click **Confirm export**
+4. Wait for the email from OpenAI, then download the `.zip` file
+
+---
+
+### Step 2: Install Convoviz
+
+<details open>
+<summary><strong>🚀 Quick Install (Recommended)</strong></summary>
+
+One command installs everything you need — [uv](https://github.com/astral-sh/uv) (a fast Python package manager) and convoviz with graphs and word clouds.
+
+**Linux / macOS:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.ps1 | iex
+```
+
+</details>
+
+<details>
+<summary><strong>📦 Alternative: Install with pip</strong></summary>
+
+If you prefer using `pip` directly:
+
+```bash
+# Create a virtual environment (keeps your system Python clean)
+python3 -m venv .venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install convoviz with visualization extras
+pip install "convoviz[viz]"
+```
+
+</details>
+
+---
+
+### Step 3: Run Convoviz
+
+The simplest way is to run the command and follow the interactive prompts:
+
+```bash
+convoviz
+```
+
+Or, provide arguments directly to skip the prompts:
+
+```bash
+convoviz --input path/to/your/export.zip --output path/to/output/folder
+```
+
+<details>
+<summary><strong>⚙️ Command Line Options</strong></summary>
+
+#### Selective Output
+
+By default, all outputs (Markdown, graphs, word clouds) are generated. Use `--outputs` to pick specific ones:
+
+```bash
+convoviz --input export.zip --outputs markdown --outputs graphs
+```
+
+Available options: `markdown`, `graphs`, `wordclouds`
+
+> In interactive mode, you'll be prompted to choose which outputs to generate.
+
+#### Other Useful Flags
+
+| Flag | Description |
+|------|-------------|
+| `--zip` / `-z` | Alias for `--input` (for convenience) |
+| `--no-interactive` | Force non-interactive mode |
+| `--flat` | Put all Markdown files in a single folder (instead of organizing by date) |
+| `--verbose` / `-v` | Enable detailed logging (use `-vv` for debug logs) |
+| `--log-file PATH` | Specify a custom log file location |
+
+For a complete list of options:
+
+```bash
+convoviz --help
+```
+
+</details>
+
+---
+
+### Step 4: Check the Output 🎉
+
+After running the script, head to your output folder to see:
+- 📝 Neatly formatted Markdown files
+- 📊 Visualizations and graphs
+
+![wordcloud example](demo/wordcloud-example.png)
+
+---
+
+## 💌 Share Your Feedback!
+
+I hope you find this tool useful. I'm continuously looking to improve on this, but I need your help for that.
+
+Whether you're a tech wizard or you're new to all this, I'd love to hear about your journey with the tool. Found a quirk? Have a suggestion? Or just want to send some good vibes? I'm all ears!
+
+👉 **[Open an Issue](https://github.com/mohamed-chs/convoviz/issues)**
+
+And if you've had a great experience, consider giving the project a ⭐ **star**! It keeps me motivated and helps others discover it!
+
+---
+
+## 📝 Notes
+
+<details>
+<summary><strong>About This Project</strong></summary>
+
+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.
+
+I wasn't a fan of the clunky, and sometimes paid, browser extensions.
+
+It was also a great opportunity to learn more about Python and type annotations. I had mypy, pyright, and ruff all on strict mode, 'twas fun.
+
+</details>
+
+<details>
+<summary><strong>Using as a Library</strong></summary>
+
+It should also work as a library, so you can import and use the models and functions. I need to add more documentation for that though. Feel free to reach out if you need help.
+
+</details>
+
+<details>
+<summary><strong>Offline / Reproducible Runs</strong></summary>
+
+Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
+
+```bash
+python -c "import nltk; nltk.download('stopwords')"
+```
+
+</details>
+
+<details>
+<summary><strong>Bookmarklet (Experimental)</strong></summary>
+
+There's also a JavaScript bookmarklet flow under `js/` for exporting additional conversation data outside the official ZIP export. This is experimental.
+
+</details>

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/logging_config.py

@@ -1,30 +1,29 @@
 """Logging configuration for convoviz."""
 
 import logging
-import sys
 import tempfile
 from pathlib import Path
-from typing import Optional
 
 from rich.logging import RichHandler
 
+
 def setup_logging(
     verbosity: int = 0,
-    log_file: Optional[Path] = None,
+    log_file: Path | None = None,
 ) -> Path:
     """Set up logging configuration.
-    
+
     Args:
         verbosity: Level of verbosity (0=WARNING, 1=INFO, 2=DEBUG)
         log_file: Path to log file. If None, a temporary file is created.
-        
+
     Returns:
         Path to the log file used.
     """
     # clear existing handlers
     root_logger = logging.getLogger()
     root_logger.handlers.clear()
-    
+
     # Determine log level for console
     if verbosity >= 2:
         console_level = logging.DEBUG
@@ -32,7 +31,7 @@ def setup_logging(
         console_level = logging.INFO
     else:
         console_level = logging.WARNING
-        
+
     # Console handler (Rich)
     console_handler = RichHandler(
         rich_tracebacks=True,
@@ -41,37 +40,30 @@ def setup_logging(
         show_path=False,
     )
     console_handler.setLevel(console_level)
-    
+
     # File handler
     if log_file is None:
         # Create temp file if not specified
-        tf = tempfile.NamedTemporaryFile(
-            prefix="convoviz_", 
-            suffix=".log", 
-            delete=False
-        )
-        log_file = Path(tf.name)
-        tf.close()
-    
+        with tempfile.NamedTemporaryFile(prefix="convoviz_", suffix=".log", delete=False) as tf:
+            log_file = Path(tf.name)
+
     # Ensure parent dir exists
     if not log_file.parent.exists():
         log_file.parent.mkdir(parents=True, exist_ok=True)
-        
+
     file_handler = logging.FileHandler(log_file, encoding="utf-8")
-    file_handler.setLevel(logging.DEBUG) # Always log DEBUG to file
-    file_formatter = logging.Formatter(
-        "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-    )
+    file_handler.setLevel(logging.DEBUG)  # Always log DEBUG to file
+    file_formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
     file_handler.setFormatter(file_formatter)
-    
+
     # Configure root logger
     # We set root level to DEBUG so that the handlers can filter as they please
     root_logger.setLevel(logging.DEBUG)
     root_logger.addHandler(console_handler)
     root_logger.addHandler(file_handler)
-    
+
     # Reduce noise from explicit libraries if necessary
     logging.getLogger("matplotlib").setLevel(logging.WARNING)
     logging.getLogger("PIL").setLevel(logging.WARNING)
-    
+
     return log_file

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/pipeline.py

@@ -1,8 +1,8 @@
 """Main processing pipeline for convoviz."""
 
+import logging
 from pathlib import Path
 from shutil import rmtree
-import logging
 
 from rich.console import Console
 
@@ -180,5 +180,5 @@ def run_pipeline(config: ConvovizConfig) -> None:
         f"Explore the full gallery [bold yellow]🖼️[/bold yellow] at: {_safe_uri(output_folder)} 🔗\n\n"
         "I hope you enjoy the outcome 🤞.\n\n"
         "If you appreciate it, kindly give the project a star 🌟 on GitHub:\n\n"
-        "➡️ https://github.com/mohamed-chs/chatgpt-history-export-to-md 🔗\n\n"
+        "➡️ https://github.com/mohamed-chs/convoviz 🔗\n\n"
     )

{convoviz-0.3.9 → convoviz-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "convoviz"
-version = "0.3.9"
+version = "0.4.1"
 description = "Get analytics and visualizations on your ChatGPT data!"
 license = "MIT"
 keywords = [
@@ -34,7 +34,7 @@ viz = [
 ]
 
 [project.urls]
-Repository = "https://github.com/mohamed-chs/chatgpt-history-export-to-md"
+Repository = "https://github.com/mohamed-chs/convoviz"
 
 [build-system]
 requires = ["uv_build"]

convoviz-0.3.9/PKG-INFO

@@ -1,152 +0,0 @@
-Metadata-Version: 2.4
-Name: convoviz
-Version: 0.3.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
-Author-email: Mohamed Cheikh Sidiya <mohamedcheikhsidiya77@gmail.com>
-License-Expression: MIT
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: orjson>=3.11.5
-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: 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
-
-Convert your ChatGPT history into well-formatted Markdown files. Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
-
-## Features
-
-- **YAML Headers**: Optional and included by default.
-- **Inline Images**: Media attachments rendered directly in Markdown.
-- **Data Visualizations**: Word clouds, graphs, and more.
-
-See examples [here](demo).
-
-## How to Use 📖
-
-### 1. Export Your ChatGPT Data 🗂
-
-- Sign in at [chatgpt.com](https://chatgpt.com).
-- Navigate: Profile Name (bottom left) -> **Settings** -> **Data controls** -> **Export** -> **Confirm export**.
-- Await email from OpenAI and download the `.zip` file.
-
-### 2. Install the tool 🛠
-
-First, install [uv](https://github.com/astral-sh/uv) (if you don't have it):
-
-MacOS / Linux:
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-Windows:
-
-```powershell
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-
-Then install convoviz:
-
-```bash
-uv tool install "convoviz[viz]"
-```
-
-The `[viz]` extra includes graphs and word clouds. Skip it for a faster markdown-only install.
-
-### Alternative: pip
-
-```bash
-python3 -m venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
-pip install "convoviz[viz]"
-```
-
-### 3. Run the tool 🏃‍♂️
-
-Simply run the command and follow the prompts:
-
-```bash
-convoviz
-```
-
-#### Command Line Arguments
-
-You can provide arguments directly to skip the prompts:
-
-```bash
-convoviz --input path/to/your/export.zip --output path/to/output/folder
-```
-
-##### Selective Output
-
-By default, all outputs are generated. Use `--outputs` to pick specific ones:
-
-```bash
-convoviz --input export.zip --outputs markdown --outputs graphs
-```
-
-Options: `markdown`, `graphs`, `wordclouds`. In interactive mode, you'll be prompted.
-
-##### Other Notes
-
-- `--zip` / `-z` is kept as an alias for `--input` for convenience.
-- You can force non-interactive mode with `--no-interactive`.
-- Use `--flat` to put all Markdown files in a single folder instead of organizing by date.
-- Use `--verbose` or `-v` for detailed logging (use `-vv` for debug logs).
-- Use `--log-file` to specify a custom log file (logs default to a temporary file if not specified).
-
-For more options, run:
-
-```bash
-convoviz --help
-```
-
-### 4. Check the Output 🎉
-
-And that's it! After running the script, head over to the output folder to see your neatly formatted Markdown files and visualizations.
-
-![wordcloud example](demo/wordcloud-example.png)
-
-## Share Your Feedback! 💌
-
-I hope you find this tool useful. I'm continuously looking to improve on this, but I need your help for that.
-
-Whether you're a tech wizard or you're new to all this, I'd love to hear about your journey with the tool. Found a quirk? Have a suggestion? Or just want to send some good vibes? I'm all ears! (see [issues](https://github.com/mohamed-chs/chatgpt-history-export-to-md/issues))
-
-And if you've had a great experience, consider giving the project a star ⭐. It keeps me motivated and helps others discover 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.
-
-I wasn't a fan of the clunky, and sometimes paid, browser extensions.
-
-It was also a great opportunity to learn more about Python and type annotations. I had mypy, pyright, and ruff all on strict mode, 'twas fun.
-
-It should(?) also work as library, so you can import and use the models and functions. I need to add more documentation for that tho. Feel free to reach out if you need help.
-
-### Offline / reproducible runs
-
-Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
-
-```bash
-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.

convoviz-0.3.9/README.md

@@ -1,127 +0,0 @@
-# Convoviz 📊: Visualize your entire ChatGPT data
-
-Convert your ChatGPT history into well-formatted Markdown files. Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
-
-## Features
-
-- **YAML Headers**: Optional and included by default.
-- **Inline Images**: Media attachments rendered directly in Markdown.
-- **Data Visualizations**: Word clouds, graphs, and more.
-
-See examples [here](demo).
-
-## How to Use 📖
-
-### 1. Export Your ChatGPT Data 🗂
-
-- Sign in at [chatgpt.com](https://chatgpt.com).
-- Navigate: Profile Name (bottom left) -> **Settings** -> **Data controls** -> **Export** -> **Confirm export**.
-- Await email from OpenAI and download the `.zip` file.
-
-### 2. Install the tool 🛠
-
-First, install [uv](https://github.com/astral-sh/uv) (if you don't have it):
-
-MacOS / Linux:
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-Windows:
-
-```powershell
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-
-Then install convoviz:
-
-```bash
-uv tool install "convoviz[viz]"
-```
-
-The `[viz]` extra includes graphs and word clouds. Skip it for a faster markdown-only install.
-
-### Alternative: pip
-
-```bash
-python3 -m venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
-pip install "convoviz[viz]"
-```
-
-### 3. Run the tool 🏃‍♂️
-
-Simply run the command and follow the prompts:
-
-```bash
-convoviz
-```
-
-#### Command Line Arguments
-
-You can provide arguments directly to skip the prompts:
-
-```bash
-convoviz --input path/to/your/export.zip --output path/to/output/folder
-```
-
-##### Selective Output
-
-By default, all outputs are generated. Use `--outputs` to pick specific ones:
-
-```bash
-convoviz --input export.zip --outputs markdown --outputs graphs
-```
-
-Options: `markdown`, `graphs`, `wordclouds`. In interactive mode, you'll be prompted.
-
-##### Other Notes
-
-- `--zip` / `-z` is kept as an alias for `--input` for convenience.
-- You can force non-interactive mode with `--no-interactive`.
-- Use `--flat` to put all Markdown files in a single folder instead of organizing by date.
-- Use `--verbose` or `-v` for detailed logging (use `-vv` for debug logs).
-- Use `--log-file` to specify a custom log file (logs default to a temporary file if not specified).
-
-For more options, run:
-
-```bash
-convoviz --help
-```
-
-### 4. Check the Output 🎉
-
-And that's it! After running the script, head over to the output folder to see your neatly formatted Markdown files and visualizations.
-
-![wordcloud example](demo/wordcloud-example.png)
-
-## Share Your Feedback! 💌
-
-I hope you find this tool useful. I'm continuously looking to improve on this, but I need your help for that.
-
-Whether you're a tech wizard or you're new to all this, I'd love to hear about your journey with the tool. Found a quirk? Have a suggestion? Or just want to send some good vibes? I'm all ears! (see [issues](https://github.com/mohamed-chs/chatgpt-history-export-to-md/issues))
-
-And if you've had a great experience, consider giving the project a star ⭐. It keeps me motivated and helps others discover 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.
-
-I wasn't a fan of the clunky, and sometimes paid, browser extensions.
-
-It was also a great opportunity to learn more about Python and type annotations. I had mypy, pyright, and ruff all on strict mode, 'twas fun.
-
-It should(?) also work as library, so you can import and use the models and functions. I need to add more documentation for that tho. Feel free to reach out if you need help.
-
-### Offline / reproducible runs
-
-Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
-
-```bash
-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.

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/analysis/graphs.py

@@ -8,11 +8,11 @@ Goals:
 
 from __future__ import annotations
 
+import logging
 from collections import defaultdict
 from collections.abc import Callable, Iterable
 from datetime import UTC, datetime
 from pathlib import Path
-import logging
 
 import matplotlib.dates as mdates
 import matplotlib.font_manager as fm

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/analysis/wordcloud.py

@@ -1,10 +1,10 @@
 """Word cloud generation for conversation text."""
 
+import logging
 import os
 from concurrent.futures import ProcessPoolExecutor
 from functools import lru_cache
 from pathlib import Path
-import logging
 
 from nltk import download as nltk_download
 from nltk.corpus import stopwords as nltk_stopwords

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/cli.py

@@ -1,5 +1,6 @@
 """Command-line interface for convoviz."""
 
+import logging
 from pathlib import Path
 
 import typer
@@ -10,10 +11,9 @@ from convoviz.config import FolderOrganization, OutputKind, get_default_config
 from convoviz.exceptions import ConfigurationError, InvalidZipError
 from convoviz.interactive import run_interactive_config
 from convoviz.io.loaders import find_latest_zip
+from convoviz.logging_config import setup_logging
 from convoviz.pipeline import run_pipeline
 from convoviz.utils import default_font_path
-from convoviz.logging_config import setup_logging
-import logging
 
 app = typer.Typer(
     add_completion=False,

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/interactive.py

@@ -1,12 +1,12 @@
 """Interactive configuration prompts using questionary."""
 
+import logging
 from pathlib import Path
 from typing import Literal, Protocol, cast
 
 from questionary import Choice, Style, checkbox, select
 from questionary import path as qst_path
 from questionary import text as qst_text
-import logging
 
 from convoviz.config import ConvovizConfig, OutputKind, get_default_config
 from convoviz.io.loaders import find_latest_zip, validate_zip

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/io/assets.py

@@ -1,8 +1,8 @@
 "Asset management functions."
 
+import logging
 import shutil
 from pathlib import Path
-import logging
 
 logger = logging.getLogger(__name__)
 

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/io/loaders.py

@@ -1,8 +1,8 @@
 """Loading functions for conversations and collections."""
 
+import logging
 from pathlib import Path, PurePosixPath
 from zipfile import ZipFile
-import logging
 
 from orjson import loads
 

{convoviz-0.3.9 → convoviz-0.4.1}/convoviz/io/writers.py

@@ -1,5 +1,6 @@
 """Writing functions for conversations and collections."""
 
+import logging
 from os import utime as os_utime
 from pathlib import Path
 from urllib.parse import quote
@@ -12,7 +13,6 @@ from convoviz.io.assets import copy_asset, resolve_asset_path
 from convoviz.models import Conversation, ConversationCollection
 from convoviz.renderers import render_conversation
 from convoviz.utils import sanitize
-import logging
 
 logger = logging.getLogger(__name__)