mposcli 0.1.0__tar.gz → 0.2.0__tar.gz

{mposcli-0.1.0 → mposcli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mposcli
-Version: 0.1.0
+Version: 0.2.0
 Summary: CLI helper for MicroPythonOS: https://github.com/MicroPythonOS/MicroPythonOS
 Project-URL: Documentation, https://github.com/jedie/mposcli
 Project-URL: Source, https://github.com/jedie/mposcli
@@ -25,11 +25,29 @@ Experimental CLI helper for MicroPythonOS: https://github.com/MicroPythonOS/Micr
 
 Main Idea: Install it via pipx (see below) and use `mposcli` command in MicroPythonOS repository path.
 
+Install, e.g.:
+
+```
+sudo apt install pipx
+
+pipx install mposcli
+```
+
+To upgrade an existing installation: Just call: `pipx upgrade PyHardLinkBackup`
+
+Usage e.g.:
+
+```
+cd ~/MicroPythonOS
+~/MicroPythonOS$ mposcli run-desktop
+```
+
+
 ## CLI
 
 [comment]: <> (✂✂✂ auto generated main help start ✂✂✂)
 ```
-usage: mposcli [-h] {build,run-desktop,update-submodules,version}
+usage: mposcli [-h] {build,cp,flash,run-desktop,update-submodules,version}
 
 
 
@@ -40,6 +58,12 @@ usage: mposcli [-h] {build,run-desktop,update-submodules,version}
 │ (required)                                                                                                           │
 │   • build              Build MicroPythonOS by calling: ./scripts/build_mpos.sh <target> see:                         │
 │                        https://docs.micropythonos.com/os-development/                                                │
+│   • cp                 Copy/update internal_filesystem/lib/mpos files to the device via "mpremote fs cp". Display a  │
+│                        file chooser to select which files to copy/update. But can also be used to copy/update all    │
+│                        files. see: https://docs.micropythonos.com/os-development/installing-on-esp32/                │
+│   • flash              Flash MicroPythonOS to the device. Display a file chooser to select the image to flash. All   │
+│                        lvgl_micropython/build/*.bin files will be shown in the file chooser. see:                    │
+│                        https://docs.micropythonos.com/os-development/installing-on-esp32/                            │
 │   • run-desktop        Run MicroPythonOS on desktop. see:                                                            │
 │                        https://docs.micropythonos.com/getting-started/running/#running-on-desktop                    │
 │   • update-submodules  Update MicroPythonOS repository and all submodules see:                                       │
@@ -50,6 +74,7 @@ usage: mposcli [-h] {build,run-desktop,update-submodules,version}
 [comment]: <> (✂✂✂ auto generated main help end ✂✂✂)
 
 
+
 ## CLI - build
 
 [comment]: <> (✂✂✂ auto generated build start ✂✂✂)
@@ -69,6 +94,50 @@ Build MicroPythonOS by calling: ./scripts/build_mpos.sh <target> see: https://do
 
 
 
+## CLI - cp
+
+[comment]: <> (✂✂✂ auto generated cp start ✂✂✂)
+```
+usage: mposcli cp [-h] [--new-file-limit INT] [--reset | --no-reset] [--repl | --no-repl] [-v]
+
+Copy/update internal_filesystem/lib/mpos files to the device via "mpremote fs cp". Display a file chooser to select which files to copy/update. But can also be used to copy/update all files. see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+
+╭─ options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ -h, --help            show this help message and exit                                                                │
+│ --new-file-limit INT  How many of the newest files to show in the file chooser? (default: 10)                        │
+│ --reset, --no-reset   Reset the device after copy/update? (default: True)                                            │
+│ --repl, --no-repl     After flashing/verify start REPL with mpremote to see the output of the device? (default:      │
+│                       True)                                                                                          │
+│ -v, --verbosity       Verbosity level; e.g.: -v, -vv, -vvv, etc. (repeatable)                                        │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+[comment]: <> (✂✂✂ auto generated cp end ✂✂✂)
+
+
+
+## CLI - flash
+
+[comment]: <> (✂✂✂ auto generated flash start ✂✂✂)
+```
+usage: mposcli flash [-h] [FLASH OPTIONS]
+
+Flash MicroPythonOS to the device. Display a file chooser to select the image to flash. All lvgl_micropython/build/*.bin files will be shown in the file chooser. see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+
+╭─ options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ -h, --help             show this help message and exit                                                               │
+│ --port STR             Port used for esptool and mpremote (default: /dev/ttyUSB0)                                    │
+│ --address STR          Address (default: 0x0)                                                                        │
+│ --flash-size STR       Flash Size (default: detect)                                                                  │
+│ --verify, --no-verify  Verify after flashing? (default: True)                                                        │
+│ --repl, --no-repl      After flashing/verify start REPL with mpremote to see the output of the device? (default:     │
+│                        True)                                                                                         │
+│ -v, --verbosity        Verbosity level; e.g.: -v, -vv, -vvv, etc. (repeatable)                                       │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+[comment]: <> (✂✂✂ auto generated flash end ✂✂✂)
+
+
+
 ## CLI - run-desktop
 
 
@@ -169,7 +238,11 @@ usage: ./dev-cli.py [-h] {coverage,install,lint,mypy,nox,pip-audit,publish,shell
 
 [comment]: <> (✂✂✂ auto generated history start ✂✂✂)
 
-* [**dev**](https://github.com/jedie/mposcli/compare/1695026...main)
+* [v0.2.0](https://github.com/jedie/mposcli/compare/v0.1.0...v0.2.0)
+  * 2026-02-16 - New CLI command: "cp" with convenience features.
+  * 2026-02-16 - New command: "flash" with file selector
+  * 2026-02-16 - Update README.md
+* [v0.1.0](https://github.com/jedie/mposcli/compare/1695026...v0.1.0)
   * 2026-02-16 - Add "update-submodules" command
   * 2026-02-16 - Add "build" command
   * 2026-02-16 - CLI command: "run-desktop"

{mposcli-0.1.0 → mposcli-0.2.0}/README.md

@@ -10,11 +10,29 @@ Experimental CLI helper for MicroPythonOS: https://github.com/MicroPythonOS/Micr
 
 Main Idea: Install it via pipx (see below) and use `mposcli` command in MicroPythonOS repository path.
 
+Install, e.g.:
+
+```
+sudo apt install pipx
+
+pipx install mposcli
+```
+
+To upgrade an existing installation: Just call: `pipx upgrade PyHardLinkBackup`
+
+Usage e.g.:
+
+```
+cd ~/MicroPythonOS
+~/MicroPythonOS$ mposcli run-desktop
+```
+
+
 ## CLI
 
 [comment]: <> (✂✂✂ auto generated main help start ✂✂✂)
 ```
-usage: mposcli [-h] {build,run-desktop,update-submodules,version}
+usage: mposcli [-h] {build,cp,flash,run-desktop,update-submodules,version}
 
 
 
@@ -25,6 +43,12 @@ usage: mposcli [-h] {build,run-desktop,update-submodules,version}
 │ (required)                                                                                                           │
 │   • build              Build MicroPythonOS by calling: ./scripts/build_mpos.sh <target> see:                         │
 │                        https://docs.micropythonos.com/os-development/                                                │
+│   • cp                 Copy/update internal_filesystem/lib/mpos files to the device via "mpremote fs cp". Display a  │
+│                        file chooser to select which files to copy/update. But can also be used to copy/update all    │
+│                        files. see: https://docs.micropythonos.com/os-development/installing-on-esp32/                │
+│   • flash              Flash MicroPythonOS to the device. Display a file chooser to select the image to flash. All   │
+│                        lvgl_micropython/build/*.bin files will be shown in the file chooser. see:                    │
+│                        https://docs.micropythonos.com/os-development/installing-on-esp32/                            │
 │   • run-desktop        Run MicroPythonOS on desktop. see:                                                            │
 │                        https://docs.micropythonos.com/getting-started/running/#running-on-desktop                    │
 │   • update-submodules  Update MicroPythonOS repository and all submodules see:                                       │
@@ -35,6 +59,7 @@ usage: mposcli [-h] {build,run-desktop,update-submodules,version}
 [comment]: <> (✂✂✂ auto generated main help end ✂✂✂)
 
 
+
 ## CLI - build
 
 [comment]: <> (✂✂✂ auto generated build start ✂✂✂)
@@ -54,6 +79,50 @@ Build MicroPythonOS by calling: ./scripts/build_mpos.sh <target> see: https://do
 
 
 
+## CLI - cp
+
+[comment]: <> (✂✂✂ auto generated cp start ✂✂✂)
+```
+usage: mposcli cp [-h] [--new-file-limit INT] [--reset | --no-reset] [--repl | --no-repl] [-v]
+
+Copy/update internal_filesystem/lib/mpos files to the device via "mpremote fs cp". Display a file chooser to select which files to copy/update. But can also be used to copy/update all files. see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+
+╭─ options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ -h, --help            show this help message and exit                                                                │
+│ --new-file-limit INT  How many of the newest files to show in the file chooser? (default: 10)                        │
+│ --reset, --no-reset   Reset the device after copy/update? (default: True)                                            │
+│ --repl, --no-repl     After flashing/verify start REPL with mpremote to see the output of the device? (default:      │
+│                       True)                                                                                          │
+│ -v, --verbosity       Verbosity level; e.g.: -v, -vv, -vvv, etc. (repeatable)                                        │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+[comment]: <> (✂✂✂ auto generated cp end ✂✂✂)
+
+
+
+## CLI - flash
+
+[comment]: <> (✂✂✂ auto generated flash start ✂✂✂)
+```
+usage: mposcli flash [-h] [FLASH OPTIONS]
+
+Flash MicroPythonOS to the device. Display a file chooser to select the image to flash. All lvgl_micropython/build/*.bin files will be shown in the file chooser. see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+
+╭─ options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ -h, --help             show this help message and exit                                                               │
+│ --port STR             Port used for esptool and mpremote (default: /dev/ttyUSB0)                                    │
+│ --address STR          Address (default: 0x0)                                                                        │
+│ --flash-size STR       Flash Size (default: detect)                                                                  │
+│ --verify, --no-verify  Verify after flashing? (default: True)                                                        │
+│ --repl, --no-repl      After flashing/verify start REPL with mpremote to see the output of the device? (default:     │
+│                        True)                                                                                         │
+│ -v, --verbosity        Verbosity level; e.g.: -v, -vv, -vvv, etc. (repeatable)                                       │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+[comment]: <> (✂✂✂ auto generated flash end ✂✂✂)
+
+
+
 ## CLI - run-desktop
 
 
@@ -154,7 +223,11 @@ usage: ./dev-cli.py [-h] {coverage,install,lint,mypy,nox,pip-audit,publish,shell
 
 [comment]: <> (✂✂✂ auto generated history start ✂✂✂)
 
-* [**dev**](https://github.com/jedie/mposcli/compare/1695026...main)
+* [v0.2.0](https://github.com/jedie/mposcli/compare/v0.1.0...v0.2.0)
+  * 2026-02-16 - New CLI command: "cp" with convenience features.
+  * 2026-02-16 - New command: "flash" with file selector
+  * 2026-02-16 - Update README.md
+* [v0.1.0](https://github.com/jedie/mposcli/compare/1695026...v0.1.0)
   * 2026-02-16 - Add "update-submodules" command
   * 2026-02-16 - Add "build" command
   * 2026-02-16 - CLI command: "run-desktop"

{mposcli-0.1.0 → mposcli-0.2.0}/mposcli/__init__.py

@@ -4,5 +4,5 @@
 """
 
 # See https://packaging.python.org/en/latest/specifications/version-specifiers/
-__version__ = '0.1.0'
+__version__ = '0.2.0'
 __author__ = 'Jens Diemer <cookiecutter_templates@jensdiemer.de>'

mposcli-0.2.0/mposcli/cli_app/copy_mpos.py

@@ -0,0 +1,92 @@
+
+import logging
+from typing import Annotated
+
+import tyro
+from bx_py_utils.path import assert_is_dir
+from cli_base.cli_tools.subprocess_utils import verbose_check_call
+from cli_base.cli_tools.verbosity import setup_logging
+from cli_base.tyro_commands import TyroVerbosityArgType
+from rich import print  # noqa
+
+from mposcli.cli_app import app
+from mposcli.mpos_utils import get_mpos_path
+from mposcli.tools import get_mpremote_bin
+from mposcli.user_input import get_newest_files
+
+
+logger = logging.getLogger(__name__)
+
+
+@app.command
+def cp(
+    new_file_limit: Annotated[
+        int,
+        tyro.conf.arg(help='How many of the newest files to show in the file chooser?'),
+    ] = 10,
+    reset: Annotated[
+        bool,
+        tyro.conf.arg(help='Reset the device after copy/update?'),
+    ] = True,
+    repl: Annotated[
+        bool,
+        tyro.conf.arg(help='After flashing/verify start REPL with mpremote to see the output of the device?'),
+    ] = True,
+    verbosity: TyroVerbosityArgType = 1,
+):
+    """
+    Copy/update internal_filesystem/lib/mpos files to the device via "mpremote fs cp".
+    Display a file chooser to select which files to copy/update.
+    But can also be used to copy/update all files.
+    see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+    """
+    setup_logging(verbosity=verbosity)
+
+    mpos_path = get_mpos_path()
+
+    internal_fs = mpos_path / 'internal_filesystem'
+    lib_mpos = internal_fs / 'lib' / 'mpos'
+    assert_is_dir(lib_mpos)
+
+    mpremote_bin = get_mpremote_bin()
+
+    print('\n')
+
+    local_path = get_newest_files(lib_mpos, limit=new_file_limit)
+
+    popenargs = (mpremote_bin, 'fs', 'cp')
+
+    if not local_path:
+        print('Copy/update all files in lib/mpos to the device')
+        local_path = lib_mpos
+        popenargs += ('-r',)
+
+    local_rel_path = local_path.relative_to(mpos_path)
+    remote_path = f':/{local_path.relative_to(lib_mpos.parent)}'
+
+    print(f'Copying "[bold]{local_rel_path}[/bold]" to device at "[bold]{remote_path}[/bold]" ...')
+
+    popenargs += (local_rel_path, remote_path)
+    verbose_check_call(
+        *popenargs,
+        verbose=True,
+        cwd=mpos_path,
+        text=None,
+    )
+    if reset:
+        verbose_check_call(
+            mpremote_bin,
+            'reset',
+            verbose=True,
+            cwd=mpos_path,
+            text=None,
+        )
+    if repl:
+        verbose_check_call(
+            mpremote_bin,
+            'repl',
+            verbose=True,
+            cwd=mpos_path,
+            timeout=None,
+            text=None,
+        )

mposcli-0.2.0/mposcli/cli_app/flash.py

@@ -0,0 +1,87 @@
+import logging
+from typing import Annotated
+
+import tyro
+from cli_base.cli_tools.subprocess_utils import verbose_check_call
+from cli_base.cli_tools.verbosity import setup_logging
+from cli_base.tyro_commands import TyroVerbosityArgType
+from rich import print  # noqa
+
+from mposcli.cli_app import app
+from mposcli.mpos_utils import get_mpos_path
+from mposcli.tools import get_esptool_bin, get_mpremote_bin
+from mposcli.user_input import file_chooser
+
+
+logger = logging.getLogger(__name__)
+
+
+@app.command
+def flash(
+    port: Annotated[str, tyro.conf.arg(help='Port used for esptool and mpremote')] = '/dev/ttyUSB0',
+    address: Annotated[str, tyro.conf.arg(help='Address')] = '0x0',
+    flash_size: Annotated[str, tyro.conf.arg(help='Flash Size')] = 'detect',
+    verify: Annotated[bool, tyro.conf.arg(help='Verify after flashing?')] = True,
+    repl: Annotated[
+        bool,
+        tyro.conf.arg(help='After flashing/verify start REPL with mpremote to see the output of the device?'),
+    ] = True,
+    verbosity: TyroVerbosityArgType = 1,
+):
+    """
+    Flash MicroPythonOS to the device. Display a file chooser to select the image to flash.
+    All lvgl_micropython/build/*.bin files will be shown in the file chooser.
+    see: https://docs.micropythonos.com/os-development/installing-on-esp32/
+    """
+    setup_logging(verbosity=verbosity)
+
+    mpos_path = get_mpos_path()
+
+    esptool_bin = get_esptool_bin()
+    mpremote_bin = get_mpremote_bin()
+
+    print('\n')
+
+    lvgl_micropython_build_path = mpos_path / 'lvgl_micropython' / 'build'
+    image_files = lvgl_micropython_build_path.glob('*.bin')
+    image_file = file_chooser(image_files)
+
+    verbose_check_call(
+        esptool_bin,
+        '--port',
+        port,
+        'write-flash',
+        '--flash-size',
+        flash_size,
+        address,
+        image_file,
+        verbose=True,
+        cwd=mpos_path,
+        timeout=None,
+        text=None,
+    )
+
+    if verify:
+        verbose_check_call(
+            esptool_bin,
+            '--port',
+            port,
+            'verify-flash',
+            address,
+            image_file,
+            verbose=True,
+            cwd=mpos_path,
+            timeout=None,
+            text=None,
+        )
+
+    if repl:
+        verbose_check_call(
+            mpremote_bin,
+            'repl',
+            port,
+            verbose=True,
+            cwd=mpos_path,
+            timeout=None,
+            text=None,
+        )

{mposcli-0.1.0 → mposcli-0.2.0}/mposcli/tests/test_readme.py

@@ -71,7 +71,7 @@ class ReadmeTestCase(BaseTestCase):
 
         commands.discard('version')  # version is pseudo command, because the version always printed on every CLI call
         commands = sorted(commands)
-        self.assertEqual(commands, ['build', 'run-desktop', 'update-submodules'])
+        self.assertEqual(commands, ['build', 'cp', 'flash', 'run-desktop', 'update-submodules'])
 
         for command in commands:
             with self.subTest(command):

mposcli-0.2.0/mposcli/tools.py

@@ -0,0 +1,27 @@
+import shutil
+import sys
+from pathlib import Path
+
+from cli_base.cli_tools.subprocess_utils import verbose_check_call
+
+
+def get_bin(name: str) -> Path:
+    bin_path = shutil.which(name)
+    if bin_path is None:
+        print(f'[red]Error: {name} is not installed or not found in PATH.[/red]')
+        print('Hint: Install via pipx, e.g.:')
+        print(f'\tpipx install {name}')
+        sys.exit(1)
+    return Path(bin_path)
+
+
+def get_esptool_bin() -> Path:
+    esptool_bin = get_bin('esptool')
+    verbose_check_call(esptool_bin, 'version')
+    return esptool_bin
+
+
+def get_mpremote_bin():
+    mpremote_bin = get_bin('mpremote')
+    verbose_check_call(mpremote_bin, '--version')
+    return mpremote_bin

mposcli-0.2.0/mposcli/user_input.py

@@ -0,0 +1,87 @@
+import datetime
+import os
+import sys
+from pathlib import Path
+
+from rich import print
+
+
+def file_chooser(paths) -> Path | None:
+    """
+    Display a numbered list of files sorted by modification time (newest first).
+    Show mtime and file name. Input number, ENTER = 1. Return selected Path.
+    """
+    print()
+
+    files = [(p, p.stat().st_mtime) for p in paths if p.is_file()]
+    if not files:
+        print('[red]No files found.[/red]')
+        return None
+    files.sort(key=lambda x: x[1], reverse=True)
+
+    print('[bold]Choose a file:[/bold]\n')
+    for idx, (p, mtime) in enumerate(files):
+        dt = datetime.datetime.fromtimestamp(mtime).strftime('%Y-%m-%d %H:%M:%S')
+        print(f'[{idx}] {dt} - {p.name}')
+
+    print()
+
+    number = input('Enter number (ENTER = 0 - the newest file): ').strip() or 0
+    print('Selected:', number)
+    try:
+        number = int(number)
+    except Exception as err:
+        print(f'[red]Invalid input: {err}[/red]')
+        sys.exit(1)
+
+    try:
+        selection = files[number][0]
+    except IndexError:
+        print(f'[red]Invalid selection: {number}[/red]')
+        sys.exit(1)
+
+    print(f'Selected file: {selection}')
+    return selection
+
+
+def get_newest_files(directory, limit=10) -> Path | None:
+    files = []
+
+    def scan(dir_path):
+        with os.scandir(dir_path) as it:
+            for entry in it:
+                if entry.is_file(follow_symlinks=False):
+                    files.append((entry, entry.stat().st_mtime))
+                elif entry.is_dir(follow_symlinks=False):
+                    scan(entry.path)
+
+    scan(directory)
+    files.sort(key=lambda x: x[1], reverse=True)
+
+    print(f'[bold]Choose a file[/bold] (only from the newest {limit}):\n')
+    for idx, (entry, mtime) in enumerate(files[:limit]):
+        dt = datetime.datetime.fromtimestamp(mtime).strftime('%Y-%m-%d %H:%M:%S')
+        rel_path = Path(entry.path).relative_to(directory)
+        print(f'[{idx}] {dt} - {rel_path}')
+
+    print()
+
+    number = input('Enter number (ENTER = 0 - the newest file, "a" for all files): ').strip() or '0'
+    print('Selected:', number)
+    if number.lower() == 'a':
+        return None
+
+    try:
+        number = int(number)
+    except Exception as err:
+        print(f'[red]Invalid input: {err}[/red]')
+        sys.exit(1)
+
+    try:
+        selection = files[number][0]
+    except IndexError:
+        print(f'[red]Invalid selection: {number}[/red]')
+        sys.exit(1)
+
+    print(f'Selected file: {selection}')
+    return Path(selection)

mposcli-0.1.0/mposcli/user_input.py

@@ -1,37 +0,0 @@
-import datetime
-import sys
-
-from rich import print
-
-
-def file_chooser(paths):
-    """
-    Display a numbered list of files sorted by modification time (newest first).
-    Show mtime and file name. Input number, ENTER = 1. Return selected Path.
-    """
-
-    files = [(p, p.stat().st_mtime) for p in paths if p.is_file()]
-    if not files:
-        print('[red]No files found.[/red]')
-        return None
-    files.sort(key=lambda x: x[1], reverse=True)
-
-    print('[bold]Choose a file:[/bold]')
-    for idx, (p, mtime) in enumerate(files):
-        dt = datetime.datetime.fromtimestamp(mtime).strftime('%Y-%m-%d %H:%M:%S')
-        print(f'[{idx}] {dt}  {p.name}')
-
-    number = input('Enter number (ENTER = 0 - the newest file): ').strip() or 0
-    try:
-        number = int(number)
-    except Exception as err:
-        print(f'[red]Invalid input: {err}[/red]')
-        sys.exit(1)
-
-    try:
-        selection = files[number][0]
-    except IndexError:
-        print(f'[red]Invalid selection: {number}[/red]')
-        sys.exit(1)
-
-    return selection