tasks-toolkit 0.1.6__tar.gz → 0.1.7__tar.gz

{tasks_toolkit-0.1.6 → tasks_toolkit-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasks-toolkit
-Version: 0.1.6
+Version: 0.1.7
 Summary: Task tracker toolkit: CLI + MCP server for sprint/task/subtask management, delegation helpers.
 Author: prachwal
 License: MIT License
@@ -67,6 +67,23 @@ tasks-init
 tasks overview
 ```
 
+### Run with uvx
+
+With [uv installed](https://docs.astral.sh/uv/getting-started/installation/),
+run commands directly from PyPI without a separate tool installation:
+
+```bash
+cd /path/to/your-project
+uvx --from tasks-toolkit tasks-init
+uvx --from tasks-toolkit tasks overview
+uvx --from tasks-toolkit tasks next
+```
+
+Use `--from tasks-toolkit` because the package and executable names differ.
+The same form works for `tasks-run`, `tasks-sprint`, and `tasks-mcp`.
+To select a specific release, use `--from tasks-toolkit==0.1.6`.
+See the [uv tools guide](https://docs.astral.sh/uv/guides/tools/).
+
 ### From source
 
 ```bash
@@ -109,6 +126,25 @@ the project, not to the toolkit installation. An installed server needs no copy
 this source repository. Use an absolute executable path if the client cannot find
 `tasks-mcp` on its PATH; `command -v tasks-mcp` shows it on Unix.
 
+To launch the MCP server through `uvx`, use the following configuration in clients
+with an `mcpServers` section (such as Claude Desktop or Cursor):
+
+```json
+{
+  "mcpServers": {
+    "tasks": {
+      "command": "uvx",
+      "args": ["--from", "tasks-toolkit", "tasks-mcp"],
+      "env": {"TASKS_ROOT": "/absolute/path/to/your-project"}
+    }
+  }
+}
+```
+
+Use the absolute path returned by `command -v uvx` if the client cannot find `uvx`.
+For the other client schemas below, use the same executable and arguments with
+the client's configuration keys.
+
 ### Claude Desktop
 
 Open **Settings → Developer → Edit Config**, merge this entry into

{tasks_toolkit-0.1.6 → tasks_toolkit-0.1.7}/README.md

@@ -18,6 +18,23 @@ tasks-init
 tasks overview
 ```
 
+### Run with uvx
+
+With [uv installed](https://docs.astral.sh/uv/getting-started/installation/),
+run commands directly from PyPI without a separate tool installation:
+
+```bash
+cd /path/to/your-project
+uvx --from tasks-toolkit tasks-init
+uvx --from tasks-toolkit tasks overview
+uvx --from tasks-toolkit tasks next
+```
+
+Use `--from tasks-toolkit` because the package and executable names differ.
+The same form works for `tasks-run`, `tasks-sprint`, and `tasks-mcp`.
+To select a specific release, use `--from tasks-toolkit==0.1.6`.
+See the [uv tools guide](https://docs.astral.sh/uv/guides/tools/).
+
 ### From source
 
 ```bash
@@ -60,6 +77,25 @@ the project, not to the toolkit installation. An installed server needs no copy
 this source repository. Use an absolute executable path if the client cannot find
 `tasks-mcp` on its PATH; `command -v tasks-mcp` shows it on Unix.
 
+To launch the MCP server through `uvx`, use the following configuration in clients
+with an `mcpServers` section (such as Claude Desktop or Cursor):
+
+```json
+{
+  "mcpServers": {
+    "tasks": {
+      "command": "uvx",
+      "args": ["--from", "tasks-toolkit", "tasks-mcp"],
+      "env": {"TASKS_ROOT": "/absolute/path/to/your-project"}
+    }
+  }
+}
+```
+
+Use the absolute path returned by `command -v uvx` if the client cannot find `uvx`.
+For the other client schemas below, use the same executable and arguments with
+the client's configuration keys.
+
 ### Claude Desktop
 
 Open **Settings → Developer → Edit Config**, merge this entry into

{tasks_toolkit-0.1.6 → tasks_toolkit-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tasks-toolkit"
-version = "0.1.6"
+version = "0.1.7"
 description = "Task tracker toolkit: CLI + MCP server for sprint/task/subtask management, delegation helpers."
 readme = "README.md"
 license = { file = "LICENSE" }

{tasks_toolkit-0.1.6 → tasks_toolkit-0.1.7}/scripts/test_tasks_watch.py

@@ -1,4 +1,4 @@
-"""Tests for scripts/tasks_watch.py and .vscode/tasks.json.
+"""Tests for scripts/tasks_watch.py.
 
 Run: python3 -m unittest scripts/test_tasks_watch.py
 
@@ -6,7 +6,6 @@ All tests use a temporary root so the real tasks/ directory is never touched.
 """
 import contextlib
 import hashlib
-import json
 import sqlite3
 import tempfile
 import unittest
@@ -188,48 +187,5 @@ class WatchRefreshTests(WatchTestCase):
         self.assertIn("snapshot", stderr)
 
 
-class TasksJsonTests(unittest.TestCase):
-    """Validate .vscode/tasks.json structure and command references."""
-
-    def test_tasks_json_is_valid(self):
-        """.vscode/tasks.json must be valid JSON."""
-        tasks_json = Path(".vscode/tasks.json")
-        self.assertTrue(tasks_json.exists(), ".vscode/tasks.json does not exist")
-        with open(tasks_json, encoding="utf-8") as f:
-            data = json.load(f)
-        self.assertEqual(data["version"], "2.0.0")
-
-    def test_tasks_json_has_six_labels(self):
-        """.vscode/tasks.json must contain exactly the six expected labels."""
-        with open(".vscode/tasks.json", encoding="utf-8") as f:
-            data = json.load(f)
-        labels = {t["label"] for t in data["tasks"]}
-        expected = {
-            "Tracker: refresh view",
-            "Tracker: sync (view + snapshot)",
-            "Tracker: check",
-            "Tracker: next",
-            "Tracker: list",
-            "Tracker: watch view",
-        }
-        self.assertEqual(labels, expected)
-
-    def test_task_commands_reference_existing_scripts(self):
-        """Every command in tasks.json must reference an existing scripts/*.py file."""
-        with open(".vscode/tasks.json", encoding="utf-8") as f:
-            data = json.load(f)
-        for task in data["tasks"]:
-            cmd = task["command"]
-            # Extract the script file from the command (e.g., "python3 scripts/tasks.py render")
-            parts = cmd.split()
-            for part in parts:
-                if part.startswith("scripts/") and part.endswith(".py"):
-                    script_path = Path(part)
-                    self.assertTrue(
-                        script_path.exists(),
-                        f"Task '{task['label']}' references non-existent script: {script_path}"
-                    )
-
-
 if __name__ == "__main__":
     unittest.main()

{tasks_toolkit-0.1.6 → tasks_toolkit-0.1.7}/tasks_toolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasks-toolkit
-Version: 0.1.6
+Version: 0.1.7
 Summary: Task tracker toolkit: CLI + MCP server for sprint/task/subtask management, delegation helpers.
 Author: prachwal
 License: MIT License
@@ -67,6 +67,23 @@ tasks-init
 tasks overview
 ```
 
+### Run with uvx
+
+With [uv installed](https://docs.astral.sh/uv/getting-started/installation/),
+run commands directly from PyPI without a separate tool installation:
+
+```bash
+cd /path/to/your-project
+uvx --from tasks-toolkit tasks-init
+uvx --from tasks-toolkit tasks overview
+uvx --from tasks-toolkit tasks next
+```
+
+Use `--from tasks-toolkit` because the package and executable names differ.
+The same form works for `tasks-run`, `tasks-sprint`, and `tasks-mcp`.
+To select a specific release, use `--from tasks-toolkit==0.1.6`.
+See the [uv tools guide](https://docs.astral.sh/uv/guides/tools/).
+
 ### From source
 
 ```bash
@@ -109,6 +126,25 @@ the project, not to the toolkit installation. An installed server needs no copy
 this source repository. Use an absolute executable path if the client cannot find
 `tasks-mcp` on its PATH; `command -v tasks-mcp` shows it on Unix.
 
+To launch the MCP server through `uvx`, use the following configuration in clients
+with an `mcpServers` section (such as Claude Desktop or Cursor):
+
+```json
+{
+  "mcpServers": {
+    "tasks": {
+      "command": "uvx",
+      "args": ["--from", "tasks-toolkit", "tasks-mcp"],
+      "env": {"TASKS_ROOT": "/absolute/path/to/your-project"}
+    }
+  }
+}
+```
+
+Use the absolute path returned by `command -v uvx` if the client cannot find `uvx`.
+For the other client schemas below, use the same executable and arguments with
+the client's configuration keys.
+
 ### Claude Desktop
 
 Open **Settings → Developer → Edit Config**, merge this entry into