cave-cli 3.5.0__tar.gz → 3.5.1__tar.gz

{cave_cli-3.5.0/cave_cli.egg-info → cave_cli-3.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cave_cli
-Version: 3.5.0
+Version: 3.5.1
 Summary: CLI for creating and managing Docker-based CAVE web applications.
 Author-email: MIT-CAVE <cave-contact@mit.edu>
 License: Apache-2.0
@@ -58,16 +58,39 @@ docker run hello-world
 
 ## Installation
 
+Install with [pipx](https://pipx.pypa.io/) (recommended — keeps the CLI isolated from your system Python):
+
 ```sh
-pip install git+https://github.com/MIT-CAVE/cave_cli.git
+pipx install cave_cli
 ```
 
-Or with [pipx](https://pipx.pypa.io/) (recommended for CLI tools):
+If you don't have pipx, install it first:
+
+<details>
+<summary>macOS</summary>
 
 ```sh
-pipx install git+https://github.com/MIT-CAVE/cave_cli.git
+# With Homebrew (recommended)
+brew install pipx
+pipx ensurepath
+
+# Or with pip
+pip3 install --user pipx
+pipx ensurepath
 ```
 
+</details>
+<details>
+<summary>Other Linux / Windows (WSL)</summary>
+
+```sh
+python3 -m pip install --user pipx
+pipx ensurepath
+```
+</details>
+
+For more options see the [pipx installation guide](https://pipx.pypa.io/stable/installation/).
+
 Verify the installation:
 
 ```sh
@@ -129,13 +152,13 @@ cave --help
 ## Updating
 
 ```sh
-pip install --upgrade git+https://github.com/MIT-CAVE/cave_cli.git
+cave update
 ```
 
-Or:
+Or directly via pipx:
 
 ```sh
-cave update
+pipx upgrade cave_cli
 ```
 
 ## License Notice

{cave_cli-3.5.0 → cave_cli-3.5.1}/README.md

@@ -41,16 +41,39 @@ docker run hello-world
 
 ## Installation
 
+Install with [pipx](https://pipx.pypa.io/) (recommended — keeps the CLI isolated from your system Python):
+
 ```sh
-pip install git+https://github.com/MIT-CAVE/cave_cli.git
+pipx install cave_cli
 ```
 
-Or with [pipx](https://pipx.pypa.io/) (recommended for CLI tools):
+If you don't have pipx, install it first:
+
+<details>
+<summary>macOS</summary>
 
 ```sh
-pipx install git+https://github.com/MIT-CAVE/cave_cli.git
+# With Homebrew (recommended)
+brew install pipx
+pipx ensurepath
+
+# Or with pip
+pip3 install --user pipx
+pipx ensurepath
 ```
 
+</details>
+<details>
+<summary>Other Linux / Windows (WSL)</summary>
+
+```sh
+python3 -m pip install --user pipx
+pipx ensurepath
+```
+</details>
+
+For more options see the [pipx installation guide](https://pipx.pypa.io/stable/installation/).
+
 Verify the installation:
 
 ```sh
@@ -112,13 +135,13 @@ cave --help
 ## Updating
 
 ```sh
-pip install --upgrade git+https://github.com/MIT-CAVE/cave_cli.git
+cave update
 ```
 
-Or:
+Or directly via pipx:
 
 ```sh
-cave update
+pipx upgrade cave_cli
 ```
 
 ## License Notice

{cave_cli-3.5.0 → cave_cli-3.5.1}/cave_cli/commands/uninstall.py

@@ -1,15 +1,18 @@
 import argparse
+import shutil
 import subprocess
 import sys
 
 from cave_cli.utils.logger import logger
 
+PIPX_DOCS_URL = "https://pipx.pypa.io/stable/installation/"
+
 
 def uninstall(args: argparse.Namespace) -> None:
     """
     Usage:
 
-    - Removes the CAVE CLI package
+    - Removes the CAVE CLI package via pipx.
     """
     try:
         response = input(
@@ -24,9 +27,17 @@ def uninstall(args: argparse.Namespace) -> None:
         logger.error("Uninstall canceled")
         return
 
+    pipx = shutil.which("pipx")
+    if not pipx:
+        logger.error(
+            "pipx not found. Please uninstall cave_cli manually."
+        )
+        logger.error(f"See: {PIPX_DOCS_URL}")
+        sys.exit(1)
+
     logger.info("Removing installation...")
     result = subprocess.run(
-        [sys.executable, "-m", "pip", "uninstall", "cave_cli", "-y"],
+        [pipx, "uninstall", "cave_cli"],
         stdout=subprocess.PIPE,
         stderr=subprocess.PIPE,
         text=True,

{cave_cli-3.5.0 → cave_cli-3.5.1}/cave_cli/commands/update.py

@@ -1,30 +1,47 @@
 import argparse
+import shutil
 import subprocess
 import sys
 
 from cave_cli.utils.logger import logger
 
+PIPX_DOCS_URL = "https://pipx.pypa.io/stable/installation/"
+
 
 def update(args: argparse.Namespace) -> None:
     """
     Usage:
 
-    - Updates the CAVE CLI via pip install --upgrade
+    - Updates the CAVE CLI via pipx.
+
+    Notes:
+
+    - Without ``--version``, runs ``pipx upgrade cave_cli``.
+    - With ``--version``, reinstalls via ``pipx install --force`` from the
+      specified git tag or branch.
     """
     logger.info("Updating CAVE CLI...")
+
+    pipx = shutil.which("pipx")
+    if not pipx:
+        logger.error(
+            "pipx not found. Please install pipx and reinstall cave_cli."
+        )
+        logger.error(f"See: {PIPX_DOCS_URL}")
+        sys.exit(1)
+
     version = getattr(args, "version", None)
     if version:
         spec = (
             f"cave_cli @ "
             f"git+https://github.com/MIT-CAVE/cave_cli.git@{version}"
         )
+        cmd = [pipx, "install", "--force", spec]
     else:
-        spec = (
-            "cave_cli @ "
-            "git+https://github.com/MIT-CAVE/cave_cli.git@main"
-        )
+        cmd = [pipx, "upgrade", "cave_cli"]
+
     result = subprocess.run(
-        [sys.executable, "-m", "pip", "install", "--upgrade", spec],
+        cmd,
         stdout=subprocess.PIPE,
         stderr=subprocess.PIPE,
         text=True,

{cave_cli-3.5.0 → cave_cli-3.5.1/cave_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cave_cli
-Version: 3.5.0
+Version: 3.5.1
 Summary: CLI for creating and managing Docker-based CAVE web applications.
 Author-email: MIT-CAVE <cave-contact@mit.edu>
 License: Apache-2.0
@@ -58,16 +58,39 @@ docker run hello-world
 
 ## Installation
 
+Install with [pipx](https://pipx.pypa.io/) (recommended — keeps the CLI isolated from your system Python):
+
 ```sh
-pip install git+https://github.com/MIT-CAVE/cave_cli.git
+pipx install cave_cli
 ```
 
-Or with [pipx](https://pipx.pypa.io/) (recommended for CLI tools):
+If you don't have pipx, install it first:
+
+<details>
+<summary>macOS</summary>
 
 ```sh
-pipx install git+https://github.com/MIT-CAVE/cave_cli.git
+# With Homebrew (recommended)
+brew install pipx
+pipx ensurepath
+
+# Or with pip
+pip3 install --user pipx
+pipx ensurepath
 ```
 
+</details>
+<details>
+<summary>Other Linux / Windows (WSL)</summary>
+
+```sh
+python3 -m pip install --user pipx
+pipx ensurepath
+```
+</details>
+
+For more options see the [pipx installation guide](https://pipx.pypa.io/stable/installation/).
+
 Verify the installation:
 
 ```sh
@@ -129,13 +152,13 @@ cave --help
 ## Updating
 
 ```sh
-pip install --upgrade git+https://github.com/MIT-CAVE/cave_cli.git
+cave update
 ```
 
-Or:
+Or directly via pipx:
 
 ```sh
-cave update
+pipx upgrade cave_cli
 ```
 
 ## License Notice

{cave_cli-3.5.0 → cave_cli-3.5.1}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cave_cli"
-version = "3.5.0"
+version = "3.5.1"
 description = "CLI for creating and managing Docker-based CAVE web applications."
 authors = [
     {name = "MIT-CAVE", email = "cave-contact@mit.edu"}