vuer-cli 0.0.3__tar.gz → 0.0.4__tar.gz

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/.gitignore

@@ -4,6 +4,13 @@
 .idea
 # since this is public
 .run
+
+# remove the env file.
+.env
+
+# test foldders
+downloads
+
 # IDE files
 .eggs
 .tox
@@ -38,4 +45,10 @@ uv.lock
 output
 pcds
 
-.pytest_cache
+.pytest_cache
+
+# Assets folder (contains GLB models)
+assets/
+
+# MCAP output data
+mcap_outputs/

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vuer-cli
-Version: 0.0.3
+Version: 0.0.4
 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.79; 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.79; 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

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/README.md

@@ -7,7 +7,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

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vuer-cli"
-version = "0.0.3"
+version = "0.0.4"
 description = "A Python CLI for Vuer, a real-time 3D visualization library"
 readme = { file = "README.md", "content-type" = "text/markdown" }
 license = { text = "MIT" }
@@ -24,7 +24,7 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "params-proto>=3.0.0rc9",
+    "params-proto>=3.2.3",
     "requests>=2.31.0",
     "tqdm>=4.66.0",
 ]
@@ -35,7 +35,22 @@ Repository = "https://github.com/vuer-ai/vuer-cli"
 Issues = "https://github.com/vuer-ai/vuer-cli/issues"
 
 [project.optional-dependencies]
+mcap = [
+    "mcap>=1.1.0",
+    "mcap-ros2-support>=0.5.0",
+    "pandas>=2.0.0",
+    "numpy>=1.24.0",
+    "opencv-python>=4.8.0",
+]
+viz = [
+    "vuer>=0.0.79",
+    "pandas>=2.0.0",
+    "numpy>=1.24.0",
+    "opencv-python>=4.8.0",
+]
 all = [
+    "vuer-cli[mcap]",
+    "vuer-cli[viz]",
 ]
 example = [
 ]

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/src/vuer_cli/add.py

@@ -1,19 +1,15 @@
 """Add command - add an environment spec to environment.json then sync."""
 
-from dataclasses import dataclass
+import json
 from pathlib import Path
-from typing import Optional
 
-import json
+from params_proto import proto
 
 from .sync import Sync, read_environments_lock
 from .utils import print_error, parse_env_spec, normalize_env_spec
 
 
-# Use shared parser from utils; legacy '@' syntax is not supported anymore.
-
-
-@dataclass
+@proto
 class Add:
     """Add an environment to environment.json and run `vuer sync`.
 
@@ -21,22 +17,13 @@ class Add:
         vuer add some-environment/v1.2.3
     """
 
-    # NOTE: We keep these fields for params-proto compatibility, but the primary
-    # way to call this command is positional: `vuer add name@version`.
-    env: str = ""  # Environment spec to add, e.g. "some-environment/v1.2.3"
-    name: Optional[str] = None  # Unused in current workflow
-    version: str = "latest"  # Unused in current workflow
+    # Required positional arg: environment spec, e.g. "some-environment/v1.2.3"
+    env: str
 
-    def __call__(self) -> int:
+    def run(self) -> int:
         """Execute add command."""
         try:
             env_spec = self.env
-            if not env_spec:
-                # If env is empty, params-proto likely didn't map the positional arg;
-                # treat this as a usage error.
-                raise ValueError(
-                    "Missing environment spec. Usage: vuer add some-environment/v1.2.3"
-                )
 
             name, version = parse_env_spec(env_spec)
             env_spec_normalized = normalize_env_spec(f"{name}/{version}")
@@ -83,7 +70,7 @@ class Add:
             print(
                 f"[INFO] Added {env_spec_normalized} to environment.json dependencies. Running sync..."
             )
-            return Sync()()
+            return Sync().run()
 
         except (FileNotFoundError, ValueError, RuntimeError) as e:
             print_error(str(e))

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/src/vuer_cli/envs_publish.py

@@ -38,7 +38,7 @@ class EnvsPublish:
     tag: str = "latest"  # Version tag
     dry_run: bool = False  # Simulate without uploading
 
-    def __call__(self) -> int:
+    def run(self) -> int:
         """Execute envs-publish command."""
         try:
             dry_run = self.dry_run or is_dry_run()

{vuer_cli-0.0.3 → vuer_cli-0.0.4}/src/vuer_cli/envs_pull.py

@@ -24,7 +24,7 @@ class EnvsPull:
     timeout: int = 300  # Request timeout in seconds
     skip_progress: bool = False  # Disable progress bar
 
-    def __call__(self) -> int:
+    def run(self) -> int:
         """Execute envs-pull command."""
         try:
             if not is_dry_run():

vuer_cli-0.0.4/src/vuer_cli/main.py

@@ -0,0 +1,65 @@
+"""Vuer CLI - Environment Manager for Vuer Hub."""
+
+from params_proto import proto
+
+from .add import Add
+from .envs_publish import EnvsPublish
+from .envs_pull import EnvsPull
+from .remove import Remove
+from .scripts.demcap import Demcap
+from .scripts.minimap import Minimap
+from .scripts.viz_ptc_cams import VizPtcCams
+from .scripts.viz_ptc_proxie import VizPtcProxie
+from .sync import Sync
+from .upgrade import Upgrade
+
+
+def entrypoint() -> int:
+  """Console script entry point."""
+  return _cli_entrypoint() or 0
+
+
+@proto.cli(prog="vuer")
+def _cli_entrypoint(
+  command: Sync
+  | Add
+  | Remove
+  | Upgrade
+  | EnvsPublish
+  | EnvsPull
+  | Demcap
+  | Minimap
+  | VizPtcCams
+  | VizPtcProxie,
+):
+  """Vuer Hub Environment Manager.
+
+  Available commands:
+    sync          - Sync environments from environment.json dependencies (like npm install)
+    add           - Add an environment to environment.json and run sync
+    remove        - Remove an environment from environment.json and run sync
+    upgrade       - Upgrade an environment to the latest version
+    envs-publish  - Publish an environment to the Vuer Hub
+    envs-pull     - Pull/download an environment from the Vuer Hub
+    demcap        - Extract data from MCAP files to readable formats
+    minimap       - Visualize robot trajectory with depth point clouds
+    viz_ptc_cams  - Visualize point clouds from multiple cameras
+    viz_ptc_proxie - Visualize GLB robot model with point cloud
+
+  Examples:
+    vuer sync                    Sync all dependencies from environment.json
+    vuer add my-env/1.2.3        Add an environment and sync
+    vuer remove my-env/1.2.3     Remove an environment and sync
+    vuer upgrade my-env          Upgrade an environment to latest version
+    vuer envs-publish            Publish current environment to hub
+    vuer envs-pull my-env/1.2.3  Pull an environment from hub
+    vuer demcap --mcap-path /path/to/file.mcap  Extract data from MCAP file
+    vuer minimap --data-dir /path/to/data --cmap turbo
+    vuer viz_ptc_cams --data-dir /path/to/data --cameras nav_front_d455,nav_right_d455
+    vuer viz_ptc_proxie --data-dir /path/to/data
+
+  Environment variables:
+    VUER_HUB_URL     - Base URL of the Vuer Hub API
+    VUER_AUTH_TOKEN  - JWT token for API authentication
+  """
+  return command.run()