vuer-cli 0.0.3__py3-none-any.whl → 0.0.5__py3-none-any.whl

vuer_cli/upgrade.py

@@ -1,159 +1,144 @@
 """Upgrade command - upgrade an environment in environment.json to latest version."""
 
-from dataclasses import dataclass
+import json
 from pathlib import Path
-from typing import Optional
 
-import json
+from params_proto import proto
 
 from .envs_publish import Hub
 from .sync import Sync, _extract_backend_error
 from .utils import is_dry_run, print_error
 
 
-@dataclass
+@proto
 class Upgrade:
-    """Upgrade a single environment in environment.json to the latest version.
-
-    Usage:
-        vuer upgrade some-environment-name
-    """
-
-    # Primary usage is positional: `vuer upgrade some-environment-name`.
-    env: Optional[str] = None  # Environment name to upgrade (no version part)
-    # Kept for params-proto compatibility; not used in the new workflow.
-    version: Optional[str] = None
-
-    def __call__(self) -> int:
-        """Execute upgrade command."""
-        try:
-            env_name = (self.env or "").strip()
-            if not env_name:
-                raise ValueError(
-                    "Missing environment name. Usage: vuer upgrade some-environment-name"
-                )
-
-            cwd = Path.cwd()
-            env_json_path = cwd / "environment.json"
-            if not env_json_path.exists():
-                raise FileNotFoundError(
-                    "environment.json not found. Cannot upgrade environments."
-                )
-
-            try:
-                with env_json_path.open("r", encoding="utf-8") as f:
-                    data = json.load(f)
-            except json.JSONDecodeError as e:
-                raise ValueError(f"Invalid environment.json: {e}") from e
-
-            deps = data.get("dependencies") or {}
-            if not isinstance(deps, dict):
-                raise ValueError(
-                    "environment.json 'dependencies' field must be an object"
-                )
-
-            current_version = deps.get(env_name)
-            if not isinstance(current_version, str) or not current_version:
-                raise ValueError(
-                    f"Environment '{env_name}' not found in environment.json; nothing to upgrade."
-                )
-
-            dry_run = is_dry_run()
-
-            if dry_run:
-                print(
-                    f"[INFO] (dry-run) Would check latest version for '{env_name}', "
-                    f"current version is '{current_version}'."
-                )
-                print(
-                    "[INFO] (dry-run) Skipping upgrade and sync (no network calls).")
-                return 0
-
-            # Real upgrade: require hub configuration
-            if not Hub.url:
-                raise RuntimeError(
-                    "Missing VUER_HUB_URL. Please set the VUER_HUB_URL environment variable "
-                    "or pass --hub.url on the command line."
-                )
-            if not Hub.auth_token:
-                raise RuntimeError(
-                    "Missing VUER_AUTH_TOKEN. Please set the VUER_AUTH_TOKEN environment "
-                    "variable or pass --hub.auth-token on the command line."
-                )
-
-            latest_version = _fetch_latest_version(env_name)
-
-            if latest_version == current_version:
-                print(
-                    f"[INFO] Environment '{env_name}' is already at latest version "
-                    f"({current_version})."
-                )
-                return 0
-
-            # Update environment.json with the new version and run sync
-            deps[env_name] = latest_version
-            data["dependencies"] = deps
-            with env_json_path.open("w", encoding="utf-8") as f:
-                json.dump(data, f, indent=2, ensure_ascii=False)
-                f.write("\n")
-
-            print(
-                f"[INFO] Upgraded {env_name} from {current_version} to {latest_version} "
-                "in environment.json. Running sync..."
-            )
-            return Sync()()
-
-        except (FileNotFoundError, ValueError, RuntimeError) as e:
-            print_error(str(e))
-            return 1
-        except Exception as e:
-            print_error(f"Unexpected error: {e}")
-            return 1
-
+  """Upgrade a single environment in environment.json to the latest version.
 
-def _fetch_latest_version(env_name: str) -> str:
-    """Call backend /environments/latest-by-name to get latest versionId for env_name."""
-    import requests  # Lazy import
+  Usage:
+      vuer upgrade some-environment-name
+  """
 
-    params = {"name": env_name}
-    url = f"{Hub.url.rstrip('/')}/environments/latest-by-name"
-    headers = {
-        "Authorization": f"Bearer {Hub.auth_token}"
-    } if Hub.auth_token else {}
+  # Required positional arg: environment name to upgrade (no version part)
+  env: str
 
+  def __call__(self) -> int:
+    """Execute upgrade command."""
     try:
-        response = requests.get(url, params=params, headers=headers,
-                                timeout=300)
-        response.raise_for_status()
-    except requests.exceptions.HTTPError as e:
-        resp = getattr(e, "response", None)
-        status = resp.status_code if resp is not None else "unknown"
-        detail = _extract_backend_error(resp)
-        raise RuntimeError(
-            f"Failed to fetch latest version for '{env_name}' ({status}): {detail}"
-        ) from e
-    except requests.exceptions.RequestException as e:
-        raise RuntimeError(
-            f"Failed to fetch latest version for '{env_name}': {e}"
-        ) from e
+      env_name = self.env.strip()
+
+      cwd = Path.cwd()
+      env_json_path = cwd / "environment.json"
+      if not env_json_path.exists():
+        raise FileNotFoundError(
+          "environment.json not found. Cannot upgrade environments."
+        )
+
+      try:
+        with env_json_path.open("r", encoding="utf-8") as f:
+          data = json.load(f)
+      except json.JSONDecodeError as e:
+        raise ValueError(f"Invalid environment.json: {e}") from e
+
+      deps = data.get("dependencies") or {}
+      if not isinstance(deps, dict):
+        raise ValueError("environment.json 'dependencies' field must be an object")
+
+      current_version = deps.get(env_name)
+      if not isinstance(current_version, str) or not current_version:
+        raise ValueError(
+          f"Environment '{env_name}' not found in environment.json; nothing to upgrade."
+        )
+
+      dry_run = is_dry_run()
 
-    data = response.json()
+      if dry_run:
+        print(
+          f"[INFO] (dry-run) Would check latest version for '{env_name}', "
+          f"current version is '{current_version}'."
+        )
+        print("[INFO] (dry-run) Skipping upgrade and sync (no network calls).")
+        return 0
 
-    # Error response format: {"error": "name is required"}
-    if "error" in data:
+      # Real upgrade: require hub configuration
+      if not Hub.url:
         raise RuntimeError(
-            f"Failed to fetch latest version for '{env_name}': {data['error']}"
+          "Missing VUER_HUB_URL. Please set the VUER_HUB_URL environment variable "
+          "or pass --hub.url on the command line."
+        )
+      # Try to get token from credentials file if not in environment
+      auth_token = Hub.get_auth_token()
+      if not auth_token:
+        raise RuntimeError(
+          "Missing VUER_AUTH_TOKEN. Please run 'vuer login' to authenticate, "
+          "or set the VUER_AUTH_TOKEN environment variable."
         )
 
-    payload = data.get("data")
-    if not isinstance(payload, dict):
-        raise ValueError(
-            "Invalid response format: 'data' field must be an object")
+      latest_version = _fetch_latest_version(env_name)
 
-    version_id = payload.get("versionId")
-    if not version_id:
-        raise ValueError(
-            "Invalid response format: 'data.versionId' field is required"
+      if latest_version == current_version:
+        print(
+          f"[INFO] Environment '{env_name}' is already at latest version "
+          f"({current_version})."
         )
+        return 0
+
+      # Update environment.json with the new version and run sync
+      deps[env_name] = latest_version
+      data["dependencies"] = deps
+      with env_json_path.open("w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+        f.write("\n")
+
+      print(
+        f"[INFO] Upgraded {env_name} from {current_version} to {latest_version} "
+        "in environment.json. Running sync..."
+      )
+      return Sync().run()
 
-    return str(version_id)
+    except (FileNotFoundError, ValueError, RuntimeError) as e:
+      print_error(str(e))
+      return 1
+    except Exception as e:
+      print_error(f"Unexpected error: {e}")
+      return 1
+
+
+def _fetch_latest_version(env_name: str) -> str:
+  """Call backend /environments/latest-by-name to get latest versionId for env_name."""
+  import requests  # Lazy import
+
+  params = {"name": env_name}
+  url = f"{Hub.url.rstrip('/')}/environments/latest-by-name"
+  auth_token = Hub.get_auth_token()
+  headers = {"Authorization": f"Bearer {auth_token}"} if auth_token else {}
+
+  try:
+    response = requests.get(url, params=params, headers=headers, timeout=300)
+    response.raise_for_status()
+  except requests.exceptions.HTTPError as e:
+    resp = getattr(e, "response", None)
+    status = resp.status_code if resp is not None else "unknown"
+    detail = _extract_backend_error(resp)
+    raise RuntimeError(
+      f"Failed to fetch latest version for '{env_name}' ({status}): {detail}"
+    ) from e
+  except requests.exceptions.RequestException as e:
+    raise RuntimeError(f"Failed to fetch latest version for '{env_name}': {e}") from e
+
+  data = response.json()
+
+  # Error response format: {"error": "name is required"}
+  if "error" in data:
+    raise RuntimeError(
+      f"Failed to fetch latest version for '{env_name}': {data['error']}"
+    )
+
+  payload = data.get("data")
+  if not isinstance(payload, dict):
+    raise ValueError("Invalid response format: 'data' field must be an object")
+
+  version_id = payload.get("versionId")
+  if not version_id:
+    raise ValueError("Invalid response format: 'data.versionId' field is required")
+
+  return str(version_id)

vuer_cli/utils.py

@@ -1,51 +1,24 @@
 """Shared utilities for Vuer CLI."""
 
 import itertools
+import os
 import threading
 import time
 
-from params_proto import EnvVar, proto
-
-
-@proto.prefix
-class Config:
-    """CLI configuration settings."""
-
-    def _get_dry_run(self) -> bool:
-        """Whether to run in dry-run mode (no real network calls).
-
-        Controlled by VUER_CLI_DRY_RUN environment variable:
-            - unset  -> False (real API calls, default)
-            - "0"    -> False (real API calls)
-            - "false"/"False" -> False
-            - anything else   -> True (dry-run)
-        """
-        # Use EnvVar with default=None to detect if it's actually set
-        dry_run_env = EnvVar("VUER_CLI_DRY_RUN", default=None)
-        value = dry_run_env.get()
-        if value is not None:
-            # Environment variable is set, check its value
-            return value not in ("0", "false", "False")
-
-        # Default to real execution when nothing is set
-        return False
-
-    # Use a property to compute dry_run dynamically
-    @property
-    def dry_run(self) -> bool:
-        return self._get_dry_run()
-
-
-# Create singleton instance
-_config = Config()
-
 
 def is_dry_run() -> bool:
     """Whether to run in dry-run mode (no real network calls).
-    
-    This is a convenience function that uses the Config singleton.
+
+    Controlled by VUER_CLI_DRY_RUN environment variable:
+        - unset  -> False (real API calls, default)
+        - "0"    -> False (real API calls)
+        - "false"/"False" -> False
+        - anything else   -> True (dry-run)
     """
-    return _config.dry_run
+    value = os.environ.get("VUER_CLI_DRY_RUN")
+    if value is not None:
+        return value not in ("0", "false", "False")
+    return False
 
 
 def print_error(message: str) -> None:

{vuer_cli-0.0.3.dist-info → vuer_cli-0.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vuer-cli
-Version: 0.0.3
+Version: 0.0.5
 Summary: A Python CLI for Vuer, a real-time 3D visualization library
 Project-URL: Homepage, https://github.com/vuer-ai/vuer-cli
 Project-URL: Repository, https://github.com/vuer-ai/vuer-cli
@@ -18,10 +18,16 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.8
-Requires-Dist: params-proto>=3.0.0rc9
+Requires-Dist: params-proto>=3.2.3
 Requires-Dist: requests>=2.31.0
 Requires-Dist: tqdm>=4.66.0
 Provides-Extra: all
+Requires-Dist: mcap-ros2-support>=0.5.0; extra == 'all'
+Requires-Dist: mcap>=1.1.0; extra == 'all'
+Requires-Dist: numpy>=1.24.0; extra == 'all'
+Requires-Dist: opencv-python>=4.8.0; extra == 'all'
+Requires-Dist: pandas>=2.0.0; extra == 'all'
+Requires-Dist: vuer>=0.0.81; extra == 'all'
 Provides-Extra: docs
 Requires-Dist: furo; extra == 'docs'
 Requires-Dist: myst-parser; extra == 'docs'
@@ -30,6 +36,17 @@ Requires-Dist: sphinx-copybutton; extra == 'docs'
 Requires-Dist: sphinx>=4.0; extra == 'docs'
 Requires-Dist: tomli>=1.1.0; (python_version < '3.11') and extra == 'docs'
 Provides-Extra: example
+Provides-Extra: mcap
+Requires-Dist: mcap-ros2-support>=0.5.0; extra == 'mcap'
+Requires-Dist: mcap>=1.1.0; extra == 'mcap'
+Requires-Dist: numpy>=1.24.0; extra == 'mcap'
+Requires-Dist: opencv-python>=4.8.0; extra == 'mcap'
+Requires-Dist: pandas>=2.0.0; extra == 'mcap'
+Provides-Extra: viz
+Requires-Dist: numpy>=1.24.0; extra == 'viz'
+Requires-Dist: opencv-python>=4.8.0; extra == 'viz'
+Requires-Dist: pandas>=2.0.0; extra == 'viz'
+Requires-Dist: vuer>=0.0.81; extra == 'viz'
 Description-Content-Type: text/markdown
 
 # Vuer Hub Environment Manager
@@ -41,7 +58,13 @@ software packages.
 ## Installation
 
 ```bash
-pip install vuer-cli
+pip install vuer-cli==0.0.4
+```
+
+or with uv:
+
+```bash
+uv add vuer-cli==0.0.4
 ```
 
 ## Environment Variables
@@ -57,6 +80,7 @@ pip install vuer-cli
 |----------------|-----------------------------------------------------------------------|
 | `vuer`         | Show top-level help and list available commands                       |
 | `vuer --help`  | Show detailed CLI help                                                 |
+| `login`        | Authenticate with Vuer Hub using OAuth Device Flow                    |
 | `sync`         | Sync all environments from environment.json dependencies (like npm install) |
 | `add`          | Add an environment dependency to environment.json                     |
 | `remove`       | Remove an environment dependency from environment.json                |
@@ -66,18 +90,47 @@ pip install vuer-cli
 
 ## Usage
 
-Quick start — configure environment variables
+### Authentication
 
-`VUER_HUB_URL` is required and has no default. Set it to the base URL of your Vuer Hub API.
+The easiest way to authenticate is using the `login` command:
+
+```bash
+# Set the Hub URL first
+export VUER_HUB_URL="https://hub.vuer.ai/api"
+
+# Login with dev environment (default)
+vuer login
+
+# Or login with production environment
+vuer login --env production
+```
+
+**After successful authentication:**
+- ✅ Credentials are automatically saved and configured
+- ✅ **Vuer CLI will automatically use the saved credentials** - no manual setup needed!
+- ✅ Works immediately in the current terminal
+- ✅ Works in all new terminals (auto-configured)
+- ✅ Cross-platform support (Windows, macOS, Linux)
+
+**How it works:**
+1. Saves credentials to `~/.vuer/credentials` (used automatically by CLI)
+2. Creates shell script at `~/.vuer/env.sh` (for manual use if needed)
+3. **Windows**: Sets user environment variables via `setx`
+4. **macOS/Linux**: Automatically adds to your shell config (~/.zshrc or ~/.bashrc)
+
+**Manual setup (optional):**
+
+If you prefer to set environment variables manually:
 
 ```bash
 export VUER_HUB_URL="https://hub.vuer.ai/api"
-# Optional: token for private hubs or authenticated operations
 export VUER_AUTH_TOKEN="eyJhbGci..."
 # Optional: enable dry-run mode to simulate operations (no network changes)
 export VUER_CLI_DRY_RUN="1"
 ```
 
+### Basic Commands
+
 ```bash
 # Sync all environments from environment.json dependencies
 # Reads environment.json in current directory, validates dependencies,

vuer_cli-0.0.5.dist-info/RECORD

@@ -0,0 +1,22 @@
+vuer_cli/__init__.py,sha256=IyB44__IHu_PHuviTe8EULikOAJ45k-52kWbNpF8Lo0,387
+vuer_cli/add.py,sha256=yEjyRhZOgDCndiNEw7qo-rvfshnQNckY1dQbs1MMbkk,2298
+vuer_cli/envs_publish.py,sha256=XyI8nz6xZcadMjggz8BpLky8d9K_2v0ZafDPPIMq0w8,12159
+vuer_cli/envs_pull.py,sha256=9DHxMcqUc88SD6SSAZL_LMAeACmaGmpQNkgw2furSnw,6700
+vuer_cli/login.py,sha256=TrcBoI2kMMNDJnH8bkWMJBExtzW9n4-6JqZ2mePUsyg,15230
+vuer_cli/main.py,sha256=wdaa_VVtlPNdLSC-Rge5QYqzdWhUBgoEB1p5-T_uKUQ,2559
+vuer_cli/mcap_extractor.py,sha256=zQEaiWhmfEDSf0Tej7J0arkAxTHjCDaW73fb_OjHwNA,35529
+vuer_cli/remove.py,sha256=GmvX9pxNCY8fj3jRxWzACF1jWDhxs4Ec7Pf75P7Y3M0,3310
+vuer_cli/sync.py,sha256=d9x8E9woORHL94Qm3CGzFyxZT_XEugpwIj_YHHuUvqo,12776
+vuer_cli/upgrade.py,sha256=eDV3V-Z6M4HBJCy-ppSN2r41AIHJv1fjtEAur9whVBM,4685
+vuer_cli/utils.py,sha256=L7r1Lm-j6n7NqVjUJm5n8id7ZKuPrkOH3x-tP6BNx74,2670
+vuer_cli/scripts/demcap.py,sha256=eLRWXg7lRRLKfYEdg3LtoDyROq0IbQP46bljcZmvQJQ,5415
+vuer_cli/scripts/mcap_playback.py,sha256=7xv8NZcGP3XHwBzcy8AzAKk74kZCN4CztqmKvlmez0o,22329
+vuer_cli/scripts/minimap.py,sha256=51xur7LsWx39ar0VseiqpxuChk8KybcGmI8LWf35xTI,11100
+vuer_cli/scripts/ptc_utils.py,sha256=T55BY3plXwxtZTvbpesThYvE6vZB6aBT_iklwWjXg2Y,15018
+vuer_cli/scripts/viz_ptc_cams.py,sha256=H0QdYuW-sHT9qj06pdpum_jTdHJmajUw0ZDCjUjmNjo,21062
+vuer_cli/scripts/viz_ptc_proxie.py,sha256=inp-o6U2LkgwKa35OCaEz7LpLWMTw0qgzftKnb19oIE,14405
+vuer_cli-0.0.5.dist-info/METADATA,sha256=3V9ocrPDLPyX7qDGPZXO8pkc8Pk7YEPBt_2OvQ2Ok9g,10501
+vuer_cli-0.0.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+vuer_cli-0.0.5.dist-info/entry_points.txt,sha256=pH846erbxBfJpIj151Ps_UzgWIYPeIjl5gxZyTZn_7E,45
+vuer_cli-0.0.5.dist-info/licenses/LICENSE,sha256=MGF-inVBUaGe2mEjqT0g6XsHIXwoNXgNHqD7Z1MzR0k,1063
+vuer_cli-0.0.5.dist-info/RECORD,,

vuer_cli-0.0.3.dist-info/RECORD

@@ -1,14 +0,0 @@
-vuer_cli/__init__.py,sha256=IyB44__IHu_PHuviTe8EULikOAJ45k-52kWbNpF8Lo0,387
-vuer_cli/add.py,sha256=b6v1z8xHlphg-nY-KQ-Oly8MdRWs7qBh4Cn1TKqlmOM,3348
-vuer_cli/envs_publish.py,sha256=6RSPaWQ7_VxwD9UcQDBdoz9HGreyqKJWVGAbtJOW7Uw,12798
-vuer_cli/envs_pull.py,sha256=IfxcKjft8VA2OtE-6wRYBBD4RNKyZBfINnYf5tBq1Lk,7214
-vuer_cli/main.py,sha256=dOOqfGCR-Ls9dxqgZr6df_n2cp29Uu24rL4eiUuVQoI,3549
-vuer_cli/remove.py,sha256=HJQ98evnSF-5Fe1HVH_nAJWMbTZm5iQaZL_L4ViPD5Q,4125
-vuer_cli/sync.py,sha256=AKe5xupfGzHJfsJKriVcIOh2iakMhegfrncDZP-kkk4,13976
-vuer_cli/upgrade.py,sha256=lM5sxHwvo25Ojr8FpyXz4paVPnmHXFLWQZjV1ebxsFs,5677
-vuer_cli/utils.py,sha256=zdt_3daFLVzp_9Rsrv5xm-a2YpLecyYyHiHqrbzxnrg,3433
-vuer_cli-0.0.3.dist-info/METADATA,sha256=Xg4CjuY13258vnUvONZsK5JOwQyBkGJlaeLSCsDA020,8771
-vuer_cli-0.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-vuer_cli-0.0.3.dist-info/entry_points.txt,sha256=pH846erbxBfJpIj151Ps_UzgWIYPeIjl5gxZyTZn_7E,45
-vuer_cli-0.0.3.dist-info/licenses/LICENSE,sha256=MGF-inVBUaGe2mEjqT0g6XsHIXwoNXgNHqD7Z1MzR0k,1063
-vuer_cli-0.0.3.dist-info/RECORD,,