convoviz 0.4.4__tar.gz → 0.4.6__tar.gz

{convoviz-0.4.4 → convoviz-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.4.4
+Version: 0.4.6
 Summary: Convert your ChatGPT export (ZIP) into clean Markdown text files with inline media, and generate data visualizations like word clouds and usage graphs.
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -194,6 +194,19 @@ Interested in contributing? Check out the **[Contributing Guide](https://github.
 
 ## 📝 Notes
 
+<details>
+<summary><strong>Offline</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')"
+```
+
+**NOTE:** The install script already handles this, so you can immediately go offline after running it.
+
+</details>
+
 <details>
 <summary><strong>About This Project</strong></summary>
 
@@ -212,17 +225,6 @@ It should also work as a library, so you can import and use the models and funct
 
 </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>
 

{convoviz-0.4.4 → convoviz-0.4.6}/README.md

@@ -169,6 +169,19 @@ Interested in contributing? Check out the **[Contributing Guide](https://github.
 
 ## 📝 Notes
 
+<details>
+<summary><strong>Offline</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')"
+```
+
+**NOTE:** The install script already handles this, so you can immediately go offline after running it.
+
+</details>
+
 <details>
 <summary><strong>About This Project</strong></summary>
 
@@ -187,17 +200,6 @@ It should also work as a library, so you can import and use the models and funct
 
 </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>
 

{convoviz-0.4.4 → convoviz-0.4.6}/convoviz/interactive.py

@@ -8,10 +8,16 @@ from questionary import Choice, Style, checkbox, select
 from questionary import path as qst_path
 from questionary import text as qst_text
 
-from convoviz.config import ConvovizConfig, OutputKind, get_default_config
+from convoviz.config import ConvovizConfig, OutputKind, YAMLConfig, get_default_config
 from convoviz.io.loaders import find_latest_zip, validate_zip
 from convoviz.utils import colormaps, default_font_path, font_names, font_path, validate_header
 
+OUTPUT_TITLES = {
+    OutputKind.MARKDOWN: "Markdown conversations",
+    OutputKind.GRAPHS: "Graphs (usage analytics)",
+    OutputKind.WORDCLOUDS: "Word clouds",
+}
+
 CUSTOM_STYLE = Style(
     [
         ("qmark", "fg:#34eb9b bold"),
@@ -92,7 +98,7 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
     input_default = str(config.input_path) if config.input_path else ""
     input_result: str = _ask_or_cancel(
         qst_path(
-            "Enter the path to the export ZIP, conversations JSON, or extracted directory:",
+            "Enter the path to the export ZIP:",  # , conversations JSON, or extracted directory:",
             default=input_default,
             validate=_validate_input_path,
             style=CUSTOM_STYLE,
@@ -118,9 +124,12 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
 
     # Prompt for outputs to generate
     output_choices = [
-        Choice(title="Markdown conversations", value=OutputKind.MARKDOWN, checked=True),
-        Choice(title="Graphs (usage analytics)", value=OutputKind.GRAPHS, checked=True),
-        Choice(title="Word clouds", value=OutputKind.WORDCLOUDS, checked=True),
+        Choice(
+            title=OUTPUT_TITLES.get(kind, kind.value.title()),
+            value=kind,
+            checked=kind in config.outputs,
+        )
+        for kind in OutputKind
     ]
 
     selected_outputs: list[OutputKind] = _ask_or_cancel(
@@ -172,20 +181,9 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
 
         # Prompt for YAML headers
         yaml_config = config.conversation.yaml
+        yaml_fields = list(YAMLConfig.model_fields.keys())
         yaml_choices = [
-            Choice(title=field, checked=getattr(yaml_config, field))
-            for field in [
-                "title",
-                "tags",
-                "chat_link",
-                "create_time",
-                "update_time",
-                "model",
-                "used_plugins",
-                "message_count",
-                "content_types",
-                "custom_instructions",
-            ]
+            Choice(title=field, checked=getattr(yaml_config, field)) for field in yaml_fields
         ]
 
         selected: list[str] = _ask_or_cancel(
@@ -197,18 +195,7 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
         )
 
         selected_set = set(selected)
-        for field_name in [
-            "title",
-            "tags",
-            "chat_link",
-            "create_time",
-            "update_time",
-            "model",
-            "used_plugins",
-            "message_count",
-            "content_types",
-            "custom_instructions",
-        ]:
+        for field_name in yaml_fields:
             setattr(yaml_config, field_name, field_name in selected_set)
 
     # Prompt for wordcloud settings (only if wordclouds output is selected)

{convoviz-0.4.4 → convoviz-0.4.6}/pyproject.toml

@@ -1,7 +1,12 @@
 [project]
 name = "convoviz"
-version = "0.4.4"
+version = "0.4.6"
 description = "Convert your ChatGPT export (ZIP) into clean Markdown text files with inline media, and generate data visualizations like word clouds and usage graphs."
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+  { name = "Mohamed Cheikh Sidiya", email = "mohamedcheikhsidiya77@gmail.com" },
+]
 license = "MIT"
 keywords = [
   "markdown",
@@ -19,11 +24,6 @@ classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.12",
 ]
-readme = "README.md"
-requires-python = ">=3.12"
-authors = [
-  { name = "Mohamed Cheikh Sidiya", email = "mohamedcheikhsidiya77@gmail.com" },
-]
 dependencies = [
   "orjson>=3.11.5",
   "pydantic>=2.12.5",
@@ -34,37 +34,11 @@ dependencies = [
   "typer>=0.21.0",
 ]
 
-[project.optional-dependencies]
-viz = ["nltk>=3.9.2", "wordcloud>=1.9.5"]
-
 [project.urls]
 Repository = "https://github.com/mohamed-chs/convoviz"
 
-[build-system]
-requires = ["uv_build"]
-build-backend = "uv_build"
-
-[tool.uv.build-backend]
-# Add this line to tell uv your code is in the root, not in src/
-module-root = "."
-
-# Files to exclude from the Source Distribution (sdist)
-source-exclude = [
-  ".github",
-  ".vscode",
-  ".gitattributes",
-  ".gitignore",
-  "dev",
-  "playground.ipynb",
-  "pyproject.toml.bak",
-  "uv.lock",
-  "demo",
-  "js",
-  "tests",
-]
-
-[project.scripts]
-convoviz = "convoviz.cli:main_entry"
+[project.optional-dependencies]
+viz = ["nltk>=3.9.2", "wordcloud>=1.9.5"]
 
 [dependency-groups]
 dev = [
@@ -75,8 +49,20 @@ dev = [
   # Viz extras for testing (wordcloud pulls in matplotlib + pillow)
   "nltk>=3.9.2",
   "wordcloud>=1.9.5",
+  "poethepoet>=0.40.0",
 ]
 
+# run with 'uv run poe <task>' eg. 'uv run poe fmt'
+# or if poe is installed globally, 'poe fmt'
+[tool.poe.tasks]
+lint = "ruff check --fix convoviz tests"
+fmt = "ruff format"
+test = "pytest"
+ty = "ty check convoviz"
+
+[project.scripts]
+convoviz = "convoviz.cli:main_entry"
+
 [tool.ruff]
 target-version = "py312"
 line-length = 100
@@ -107,3 +93,26 @@ python-version = "3.12"
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["."]
+
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+# Add this line to tell uv your code is in the root, not in src/
+module-root = "."
+
+# Files to exclude from the Source Distribution (sdist)
+source-exclude = [
+  ".github",
+  ".vscode",
+  ".gitattributes",
+  ".gitignore",
+  "dev",
+  "playground.ipynb",
+  "pyproject.toml.bak",
+  "uv.lock",
+  "demo",
+  "js",
+  "tests",
+]