sima-cli 2.1.9__tar.gz → 2.1.10__tar.gz

sima_cli-2.1.10/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: sima-cli
+Version: 2.1.10
+Summary: CLI tool for SiMa Developer Portal to download models, firmware, and apps.
+Home-page: https://developer.sima.ai/
+Author: SiMa.ai
+Author-email: "Sima.ai" <support@sima.ai>
+License: MIT
+Project-URL: Homepage, https://developer.sima.ai/
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: requests<3.0,>=2.32.4
+Requires-Dist: tqdm>=4.64
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: paramiko>=3.5.1
+Requires-Dist: plotext==5.3.2
+Requires-Dist: rich==14.0.0
+Requires-Dist: InquirerPy==0.3.4
+Requires-Dist: tftpy==0.8.6
+Requires-Dist: psutil==7.0.0
+Requires-Dist: huggingface-hub<1.0,>=0.34.0
+Requires-Dist: tabulate==0.9.0
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# sima-cli - SiMa Developer Portal CLI Tool
+
+[![Python 3.8](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.8&label=python%203.8)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.9](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.9&label=python%203.9)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.10](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.10&label=python%203.10)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.11](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.11&label=python%203.11)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.12](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.12&label=python%203.12)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.13](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.13&label=python%203.13)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.14](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.14&label=python%203.14)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS%20CLI%20only)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Windows](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Windows)&label=e2e%20Windows&logo=windows&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Ubuntu x86](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20x86)&label=e2e%20Ubuntu%20x86&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Ubuntu ARM64](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20ARM64)&label=e2e%20Ubuntu%20ARM64&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+
+`sima-cli` is the command-line interface for SiMa developer workflows. It handles authentication, SDK container setup, DevKit updates, package installation, artifact downloads, Model Zoo/App Zoo access, and related development utilities.
+
+## Documentation
+
+The full command reference is generated as Markdown under [docs/sima-cli](docs/sima-cli/index.md).
+
+Use the generated docs for detailed options, arguments, subcommands, and full help text:
+
+- [Complete command reference](docs/sima-cli/index.md)
+- [Top-level command help](docs/sima-cli/commands/sima-cli.md)
+
+## Installation
+
+Install the latest `main` build:
+
+```bash
+curl -fsSL https://artifacts.sima-neat.com/tools/sima-cli-install.py -o sima-cli-install.py
+python3 sima-cli-install.py main latest
+```
+
+Install interactively:
+
+```bash
+python3 sima-cli-install.py
+```
+
+Install a specific branch or release:
+
+```bash
+python3 sima-cli-install.py feature/my-branch latest
+python3 sima-cli-install.py v2.1.6 latest
+```
+
+On Windows PowerShell:
+
+```powershell
+Invoke-WebRequest https://artifacts.sima-neat.com/tools/sima-cli-install.py -OutFile sima-cli-install.py
+python .\sima-cli-install.py main latest
+```
+
+Public PyPI releases can also be installed directly:
+
+```bash
+pip install sima-cli
+```
+
+## Quick Start
+
+```bash
+sima-cli --help
+sima-cli login
+sima-cli version
+```
+
+Use `--internal` or `SIMA_CLI_INTERNAL=1` when internal Artifactory resources are required:
+
+```bash
+sima-cli --internal login
+SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.1 sdk-extensions/model
+```
+
+## Common Workflows
+
+Set up SDK containers:
+
+```bash
+sima-cli sdk setup
+sima-cli sdk neat
+```
+
+Install a package from metadata:
+
+```bash
+sima-cli install -v 2.1.1 sdk-extensions/model
+```
+
+Download or install Neat artifacts:
+
+```bash
+sima-cli neat download core main
+sima-cli install --neat core main
+```
+
+Update a DevKit:
+
+```bash
+sima-cli update -v 2.1.1 -y
+```
+
+Explore Model Zoo and App Zoo content:
+
+```bash
+sima-cli modelzoo list
+sima-cli appzoo list
+```
+
+## Top-Level Commands
+
+| Command | Description | Docs |
+| --- | --- | --- |
+| `sima-cli appzoo` | Access sample apps from the App Zoo. | [docs](docs/sima-cli/commands/sima-cli-appzoo.md) |
+| `sima-cli bootimg` | Prepare a bootable image for the SiMa DevKit. | [docs](docs/sima-cli/commands/sima-cli-bootimg.md) |
+| `sima-cli device` | Discover nearby SiMa.ai devices on the local network. | [docs](docs/sima-cli/commands/sima-cli-device.md) |
+| `sima-cli download` | Download a file or folder from a URL. | [docs](docs/sima-cli/commands/sima-cli-download.md) |
+| `sima-cli install` | Install SiMa packages from metadata. | [docs](docs/sima-cli/commands/sima-cli-install.md) |
+| `sima-cli login` | Authenticate with the SiMa Developer Portal. | [docs](docs/sima-cli/commands/sima-cli-login.md) |
+| `sima-cli logout` | Remove cached credentials and config files. | [docs](docs/sima-cli/commands/sima-cli-logout.md) |
+| `sima-cli mla` | Machine Learning Accelerator utilities. | [docs](docs/sima-cli/commands/sima-cli-mla.md) |
+| `sima-cli modelzoo` | Access models from the Model Zoo. | [docs](docs/sima-cli/commands/sima-cli-modelzoo.md) |
+| `sima-cli neat` | Discover, download, and install Neat build artifacts. | [docs](docs/sima-cli/commands/sima-cli-neat.md) |
+| `sima-cli network` | Configure DevKit network settings. | [docs](docs/sima-cli/commands/sima-cli-network.md) |
+| `sima-cli nvme` | Perform NVMe operations on the Modalix DevKit. | [docs](docs/sima-cli/commands/sima-cli-nvme.md) |
+| `sima-cli packages` | Manage the local sima-cli package registry. | [docs](docs/sima-cli/commands/sima-cli-packages.md) |
+| `sima-cli playbooks` | Install and manage coding-agent playbooks. | [docs](docs/sima-cli/commands/sima-cli-playbooks.md) |
+| `sima-cli sdcard` | Prepare SD card storage. | [docs](docs/sima-cli/commands/sima-cli-sdcard.md) |
+| `sima-cli sdk` | Manage and launch SDK container environments. | [docs](docs/sima-cli/commands/sima-cli-sdk.md) |
+| `sima-cli selfupdate` | Update sima-cli manually. | [docs](docs/sima-cli/commands/sima-cli-selfupdate.md) |
+| `sima-cli serial` | Connect to the UART serial console of a DevKit. | [docs](docs/sima-cli/commands/sima-cli-serial.md) |
+| `sima-cli update` | Update a SiMa DevKit or remote device. | [docs](docs/sima-cli/commands/sima-cli-update.md) |
+| `sima-cli version` | Show the installed CLI version. | [docs](docs/sima-cli/commands/sima-cli-version.md) |
+
+## Development
+
+Install development dependencies and run tests:
+
+```bash
+pip install -e ".[dev]"
+python -m pytest tests/unit
+```
+
+Regenerate CLI documentation:
+
+```bash
+python scripts/generate_cli_markdown_docs.py
+```
+
+`build.sh` also regenerates the command docs before building the package.
+
+## Requirements
+
+- Python 3.8 or newer
+- Docker for SDK container workflows
+- DevKit connectivity for device update, serial, network, and boot-image workflows
+
+For command-specific prerequisites, see the generated [command reference](docs/sima-cli/index.md).
+
+## Support
+
+For issues and feature requests, use the sima-cli GitHub repository or contact the SiMa.ai development team.

sima_cli-2.1.10/README.md

@@ -0,0 +1,163 @@
+# sima-cli - SiMa Developer Portal CLI Tool
+
+[![Python 3.8](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.8&label=python%203.8)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.9](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.9&label=python%203.9)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.10](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.10&label=python%203.10)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.11](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.11&label=python%203.11)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.12](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.12&label=python%203.12)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.13](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.13&label=python%203.13)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![Python 3.14](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.14&label=python%203.14)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS%20CLI%20only)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Windows](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Windows)&label=e2e%20Windows&logo=windows&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Ubuntu x86](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20x86)&label=e2e%20Ubuntu%20x86&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E Ubuntu ARM64](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20ARM64)&label=e2e%20Ubuntu%20ARM64&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+
+`sima-cli` is the command-line interface for SiMa developer workflows. It handles authentication, SDK container setup, DevKit updates, package installation, artifact downloads, Model Zoo/App Zoo access, and related development utilities.
+
+## Documentation
+
+The full command reference is generated as Markdown under [docs/sima-cli](docs/sima-cli/index.md).
+
+Use the generated docs for detailed options, arguments, subcommands, and full help text:
+
+- [Complete command reference](docs/sima-cli/index.md)
+- [Top-level command help](docs/sima-cli/commands/sima-cli.md)
+
+## Installation
+
+Install the latest `main` build:
+
+```bash
+curl -fsSL https://artifacts.sima-neat.com/tools/sima-cli-install.py -o sima-cli-install.py
+python3 sima-cli-install.py main latest
+```
+
+Install interactively:
+
+```bash
+python3 sima-cli-install.py
+```
+
+Install a specific branch or release:
+
+```bash
+python3 sima-cli-install.py feature/my-branch latest
+python3 sima-cli-install.py v2.1.6 latest
+```
+
+On Windows PowerShell:
+
+```powershell
+Invoke-WebRequest https://artifacts.sima-neat.com/tools/sima-cli-install.py -OutFile sima-cli-install.py
+python .\sima-cli-install.py main latest
+```
+
+Public PyPI releases can also be installed directly:
+
+```bash
+pip install sima-cli
+```
+
+## Quick Start
+
+```bash
+sima-cli --help
+sima-cli login
+sima-cli version
+```
+
+Use `--internal` or `SIMA_CLI_INTERNAL=1` when internal Artifactory resources are required:
+
+```bash
+sima-cli --internal login
+SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.1 sdk-extensions/model
+```
+
+## Common Workflows
+
+Set up SDK containers:
+
+```bash
+sima-cli sdk setup
+sima-cli sdk neat
+```
+
+Install a package from metadata:
+
+```bash
+sima-cli install -v 2.1.1 sdk-extensions/model
+```
+
+Download or install Neat artifacts:
+
+```bash
+sima-cli neat download core main
+sima-cli install --neat core main
+```
+
+Update a DevKit:
+
+```bash
+sima-cli update -v 2.1.1 -y
+```
+
+Explore Model Zoo and App Zoo content:
+
+```bash
+sima-cli modelzoo list
+sima-cli appzoo list
+```
+
+## Top-Level Commands
+
+| Command | Description | Docs |
+| --- | --- | --- |
+| `sima-cli appzoo` | Access sample apps from the App Zoo. | [docs](docs/sima-cli/commands/sima-cli-appzoo.md) |
+| `sima-cli bootimg` | Prepare a bootable image for the SiMa DevKit. | [docs](docs/sima-cli/commands/sima-cli-bootimg.md) |
+| `sima-cli device` | Discover nearby SiMa.ai devices on the local network. | [docs](docs/sima-cli/commands/sima-cli-device.md) |
+| `sima-cli download` | Download a file or folder from a URL. | [docs](docs/sima-cli/commands/sima-cli-download.md) |
+| `sima-cli install` | Install SiMa packages from metadata. | [docs](docs/sima-cli/commands/sima-cli-install.md) |
+| `sima-cli login` | Authenticate with the SiMa Developer Portal. | [docs](docs/sima-cli/commands/sima-cli-login.md) |
+| `sima-cli logout` | Remove cached credentials and config files. | [docs](docs/sima-cli/commands/sima-cli-logout.md) |
+| `sima-cli mla` | Machine Learning Accelerator utilities. | [docs](docs/sima-cli/commands/sima-cli-mla.md) |
+| `sima-cli modelzoo` | Access models from the Model Zoo. | [docs](docs/sima-cli/commands/sima-cli-modelzoo.md) |
+| `sima-cli neat` | Discover, download, and install Neat build artifacts. | [docs](docs/sima-cli/commands/sima-cli-neat.md) |
+| `sima-cli network` | Configure DevKit network settings. | [docs](docs/sima-cli/commands/sima-cli-network.md) |
+| `sima-cli nvme` | Perform NVMe operations on the Modalix DevKit. | [docs](docs/sima-cli/commands/sima-cli-nvme.md) |
+| `sima-cli packages` | Manage the local sima-cli package registry. | [docs](docs/sima-cli/commands/sima-cli-packages.md) |
+| `sima-cli playbooks` | Install and manage coding-agent playbooks. | [docs](docs/sima-cli/commands/sima-cli-playbooks.md) |
+| `sima-cli sdcard` | Prepare SD card storage. | [docs](docs/sima-cli/commands/sima-cli-sdcard.md) |
+| `sima-cli sdk` | Manage and launch SDK container environments. | [docs](docs/sima-cli/commands/sima-cli-sdk.md) |
+| `sima-cli selfupdate` | Update sima-cli manually. | [docs](docs/sima-cli/commands/sima-cli-selfupdate.md) |
+| `sima-cli serial` | Connect to the UART serial console of a DevKit. | [docs](docs/sima-cli/commands/sima-cli-serial.md) |
+| `sima-cli update` | Update a SiMa DevKit or remote device. | [docs](docs/sima-cli/commands/sima-cli-update.md) |
+| `sima-cli version` | Show the installed CLI version. | [docs](docs/sima-cli/commands/sima-cli-version.md) |
+
+## Development
+
+Install development dependencies and run tests:
+
+```bash
+pip install -e ".[dev]"
+python -m pytest tests/unit
+```
+
+Regenerate CLI documentation:
+
+```bash
+python scripts/generate_cli_markdown_docs.py
+```
+
+`build.sh` also regenerates the command docs before building the package.
+
+## Requirements
+
+- Python 3.8 or newer
+- Docker for SDK container workflows
+- DevKit connectivity for device update, serial, network, and boot-image workflows
+
+For command-specific prerequisites, see the generated [command reference](docs/sima-cli/index.md).
+
+## Support
+
+For issues and feature requests, use the sima-cli GitHub repository or contact the SiMa.ai development team.

{sima_cli-2.1.9 → sima_cli-2.1.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sima-cli"
-version = "2.1.9"
+version = "2.1.10"
 description = "CLI tool for SiMa Developer Portal to download models, firmware, and apps."
 readme = "README.md"
 requires-python = ">=3.8"

{sima_cli-2.1.9 → sima_cli-2.1.10}/sima_cli/__version__.py

@@ -1,2 +1,2 @@
 # sima_cli/__version__.py
-__version__ = "2.1.9"
+__version__ = "2.1.10"

{sima_cli-2.1.9 → sima_cli-2.1.10}/sima_cli/cli.py

@@ -50,6 +50,35 @@ def _configure_stdio_errors() -> None:
             continue
 
 
+def _command_name_from_argv(argv):
+    for arg in argv[1:]:
+        if arg in ("-i", "--internal"):
+            continue
+        if arg.startswith("-"):
+            continue
+        return arg
+    return None
+
+
+def _should_rerun_after_update(argv):
+    args = argv[1:]
+    if not args:
+        return False
+    if any(arg in ("-h", "--help", "-?") for arg in args):
+        return False
+
+    command_name = _command_name_from_argv(argv)
+    return command_name not in (None, "selfupdate", "version")
+
+
+def _rerun_current_command() -> None:
+    env = os.environ.copy()
+    env["SIMA_CLI_CHECK_FOR_UPDATE"] = "0"
+    cmd = [sys.executable, "-m", "sima_cli", *sys.argv[1:]]
+    click.secho("✅ Update complete. Re-running the original command with the current sima-cli.", fg="green")
+    os.execvpe(sys.executable, cmd, env)
+
+
 # Entry point for the CLI tool using Click's command group decorator
 @click.group(context_settings=dict(help_option_names=["-h", "--help", "-?"], max_content_width=120))
 @click.option('-i', '--internal', is_flag=True, help="Use internal Artifactory resources, Authorized Sima employees only")
@@ -62,7 +91,8 @@ def main(ctx, internal):
       --internal  Use internal Artifactory resources (can also be set via env variable SIMA_CLI_INTERNAL=1)
     """
     _configure_stdio_errors()
-    check_for_update('sima-cli')
+    if check_for_update('sima-cli') and _should_rerun_after_update(sys.argv):
+        _rerun_current_command()
     ctx.ensure_object(dict)
 
     os.makedirs(os.path.dirname(CONFIG_PATH), exist_ok=True)
@@ -228,8 +258,14 @@ def download(ctx, url, dest):
     default=False,
     help="Only update tRoot and not the root file system, compatible with Yocto system only, used for Yocto to eLxr conversion."
 )
+@click.option(
+    "--dryrun",
+    is_flag=True,
+    default=False,
+    help="For ELXR updates only, validate the update path and print the simaai-ota command without running it."
+)
 @click.pass_context
-def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, troot_only):
+def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, troot_only, dryrun):
     """
     Update the software on a SiMa DevKit or remote SiMa device.
 
@@ -287,6 +323,10 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, troot_o
 
         sima-cli update -v 1.7.0 -y
 
+        # Validate ELXR update path without running simaai-ota
+
+        sima-cli update --dryrun
+
         # Provide root password for remote updates
 
         sima-cli update --ip 192.168.6.5 --passwd root
@@ -294,14 +334,18 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, troot_o
     """
     # Prioritize explicit --version option over positional argument
     version_or_url = version_option or version_or_url
+    is_elxr = is_devkit_running_elxr()
+
+    if dryrun and not is_elxr:
+        raise click.ClickException("--dryrun is only supported when running update on an ELXR devkit.")
 
     # Resolve the version or tag (GA/Beta/Alpha/QA) if not on eLxr
     # On eLxr always use latest (no version) or explicit version string
 
-    if not is_devkit_running_elxr():
+    if not is_elxr:
         version_or_url = resolve_version(version_or_url)
     
-    if is_devkit_running_elxr() and troot_only:
+    if is_elxr and troot_only:
         click.secho("⚠️  Running update on eLxr with troot_only flag is not supported, this setting is ignored..", fg='yellow')
 
     click.echo(f"➡️  Updating with {version_or_url}")
@@ -315,7 +359,8 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, troot_o
         passwd=passwd,
         auto_confirm=yes,
         flavor=flavor,
-        troot_only=troot_only
+        troot_only=troot_only,
+        dryrun=dryrun,
     )
 
 # ----------------------
@@ -716,7 +761,7 @@ def network_cmd(ctx):
 # ----------------------
 # NVME Subcommands
 # ----------------------
-NVME_OPERATIONS = {"format", "remount"}
+NVME_OPERATIONS = ("format", "remount")
 @main.command(name="nvme")
 @click.argument("operation", type=click.Choice(NVME_OPERATIONS, case_sensitive=False))
 @click.pass_context
@@ -758,9 +803,9 @@ def nvme_cmd(ctx, operation):
 # ----------------------
 # NVME Subcommands
 # ----------------------
-NVME_OPERATIONS = {"format"}
+SDCARD_OPERATIONS = ("format",)
 @main.command(name="sdcard")
-@click.argument("operation", type=click.Choice(NVME_OPERATIONS, case_sensitive=False))
+@click.argument("operation", type=click.Choice(SDCARD_OPERATIONS, case_sensitive=False))
 @click.pass_context
 def sdcard_cmd(ctx, operation):
     """

{sima_cli-2.1.9 → sima_cli-2.1.10}/sima_cli/sdk/commands.py

@@ -296,8 +296,19 @@ def remove(ctx, sdk, yes):
 @click.argument("cmd", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
 def mpk(ctx, cmd):
-    """Access MPK CLI toolset container for managing and building pipelines along with the device manager.
+    """
+    Access MPK CLI toolset container for managing and building pipelines along with the device manager.
     It also includes the plugins zoo and the Performance Estimator tool.
+
+    If CMD is provided, all remaining tokens are executed inside the matching
+    running container with bash -lc. If CMD is omitted, sima-cli opens an
+    interactive login shell.
+
+    \b
+    Examples:
+        sima-cli sdk mpk
+        sima-cli sdk mpk mpk --help
+        sima-cli sdk mpk "mpk compile --help"
     """
     launch_sdk_tool("mpk", cmd, ctx)
 
@@ -309,7 +320,19 @@ def mpk(ctx, cmd):
 @click.argument("cmd", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
 def model(ctx, cmd):
-    """Launch the Model SDK tool environment."""
+    """
+    Launch the Model SDK tool environment.
+
+    If CMD is provided, all remaining tokens are executed inside the matching
+    running container with bash -lc. If CMD is omitted, sima-cli opens an
+    interactive login shell.
+
+    \b
+    Examples:
+        sima-cli sdk model
+        sima-cli sdk model python --version
+        sima-cli sdk model "python script.py --flag"
+    """
     launch_sdk_tool("model", cmd, ctx)
 
 
@@ -320,7 +343,19 @@ def model(ctx, cmd):
 @click.argument("cmd", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
 def yocto(ctx, cmd):
-    """Launch the Yocto SDK tool environment."""
+    """
+    Launch the Yocto SDK tool environment.
+
+    If CMD is provided, all remaining tokens are executed inside the matching
+    running container with bash -lc. If CMD is omitted, sima-cli opens an
+    interactive login shell.
+
+    \b
+    Examples:
+        sima-cli sdk yocto
+        sima-cli sdk yocto bitbake --version
+        sima-cli sdk yocto "bitbake core-image-minimal"
+    """
     launch_sdk_tool("yocto", cmd, ctx)
 
 
@@ -331,7 +366,19 @@ def yocto(ctx, cmd):
 @click.argument("cmd", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
 def neat(ctx, cmd):
-    """Launch the Neat SDK tool environment."""
+    """
+    Launch the Neat SDK tool environment.
+
+    If CMD is provided, all remaining tokens are executed inside the matching
+    running container with bash -lc. If CMD is omitted, sima-cli opens an
+    interactive login shell.
+
+    \b
+    Examples:
+        sima-cli sdk neat
+        sima-cli sdk neat python --version
+        sima-cli sdk neat "python app.py --config config.json"
+    """
     launch_sdk_tool("neat", cmd, ctx)
 
 
@@ -342,7 +389,19 @@ def neat(ctx, cmd):
 @click.argument("cmd", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
 def elxr(ctx, cmd):
-    """Launch the eLxr SDK tool environment."""
+    """
+    Launch the eLxr SDK tool environment.
+
+    If CMD is provided, all remaining tokens are executed inside the matching
+    running container with bash -lc. If CMD is omitted, sima-cli opens an
+    interactive login shell.
+
+    \b
+    Examples:
+        sima-cli sdk elxr
+        sima-cli sdk elxr uname -a
+        sima-cli sdk elxr "source /opt/bin/simaai-init-build-env modalix && bitbake --version"
+    """
     launch_sdk_tool("elxr", cmd, ctx)