mpytool 2.4.0__tar.gz → 2.5.0__tar.gz

{mpytool-2.4.0 → mpytool-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpytool
-Version: 2.4.0
+Version: 2.5.0
 Summary: MPY tool - manage files on devices running MicroPython
 Author-email: Pavel Revak <pavelrevak@gmail.com>
 License-Expression: MIT
@@ -33,6 +33,9 @@ It is an alternative to the official [mpremote](https://docs.micropython.org/en/
   bootloader entry
 - **Wipe device** - erase the whole filesystem and machine-reset
   for a clean slate (handy at the start of automated tests)
+- **Deploy projects** - `sync` uploads a whole project to the device
+  using a `.mpyproject` config file (deploy map, excludes, `.mpy`
+  compilation)
 - **General-purpose serial terminal** - `repl` and `monitor` work
   with any serial device
 - **Mount local directory** - VFS mount (read-only or read-write)
@@ -168,6 +171,47 @@ Requires `mpy-cross` in PATH (`pip install mpy-cross`). If mpy-cross version dif
 from device, automatically uses `-b` flag to target the correct bytecode version.
 If `mpy-cross` is not found, falls back to uploading `.py` with a warning.
 
+### Deploy project (sync)
+
+`sync` uploads a whole project to the device based on a `.mpyproject`
+configuration file. It is the command-line counterpart of the deploy feature in
+the [Sublime Text plugin](https://github.com/cortexm/mpytool-sublime) and shares
+the same `.mpyproject` format. Unlike the plugin it is non-interactive: when more
+than one device is connected, pass `-p` to pick the port.
+
+```
+$ mpytool sync                  # deploy project in CWD (.mpyproject searched upward)
+$ mpytool sync ~/projects/blink # deploy a project in another directory
+$ mpytool -p /dev/ttyACM0 sync  # pick port explicitly (multiple devices)
+$ mpytool sync -- reset -- monitor   # deploy, then reset and watch output
+```
+
+The `.mpyproject` file (JSON, trailing commas tolerated) describes what to upload:
+
+```json
+{
+    "name": "blink",
+    "compile": true,
+    "deploy": {
+        "": ["./"],
+        "/lib/": ["../shared/utils.py"],
+        "/main.py": "src/main_dev.py"
+    },
+    "exclude": ["*.bak", "tests"]
+}
+```
+
+- `deploy` maps a device destination to its source(s), relative to the project
+  root. A key of `""` or one ending in `/` is a **directory** (value is a list of
+  sources); any other key is a **rename** (value is a single source file).
+  Defaults to `{"": ["./"]}` (whole project to root) when omitted.
+- `compile: true` compiles `.py` to `.mpy` (same as `cp -m`).
+- `exclude` adds ignore patterns on top of the defaults (`__pycache__`, `*.pyc`,
+  dotfiles). Combined with global `-e` patterns.
+
+The connection fields (`port`, `address`) used by the Sublime plugin are ignored
+by the CLI — use the global `-p` / `-a` options instead.
+
 ### Move/rename on device
 ```
 $ mpytool mv :/old.py :/new.py      # rename file

{mpytool-2.4.0 → mpytool-2.5.0}/README.md

@@ -18,6 +18,9 @@ It is an alternative to the official [mpremote](https://docs.micropython.org/en/
   bootloader entry
 - **Wipe device** - erase the whole filesystem and machine-reset
   for a clean slate (handy at the start of automated tests)
+- **Deploy projects** - `sync` uploads a whole project to the device
+  using a `.mpyproject` config file (deploy map, excludes, `.mpy`
+  compilation)
 - **General-purpose serial terminal** - `repl` and `monitor` work
   with any serial device
 - **Mount local directory** - VFS mount (read-only or read-write)
@@ -153,6 +156,47 @@ Requires `mpy-cross` in PATH (`pip install mpy-cross`). If mpy-cross version dif
 from device, automatically uses `-b` flag to target the correct bytecode version.
 If `mpy-cross` is not found, falls back to uploading `.py` with a warning.
 
+### Deploy project (sync)
+
+`sync` uploads a whole project to the device based on a `.mpyproject`
+configuration file. It is the command-line counterpart of the deploy feature in
+the [Sublime Text plugin](https://github.com/cortexm/mpytool-sublime) and shares
+the same `.mpyproject` format. Unlike the plugin it is non-interactive: when more
+than one device is connected, pass `-p` to pick the port.
+
+```
+$ mpytool sync                  # deploy project in CWD (.mpyproject searched upward)
+$ mpytool sync ~/projects/blink # deploy a project in another directory
+$ mpytool -p /dev/ttyACM0 sync  # pick port explicitly (multiple devices)
+$ mpytool sync -- reset -- monitor   # deploy, then reset and watch output
+```
+
+The `.mpyproject` file (JSON, trailing commas tolerated) describes what to upload:
+
+```json
+{
+    "name": "blink",
+    "compile": true,
+    "deploy": {
+        "": ["./"],
+        "/lib/": ["../shared/utils.py"],
+        "/main.py": "src/main_dev.py"
+    },
+    "exclude": ["*.bak", "tests"]
+}
+```
+
+- `deploy` maps a device destination to its source(s), relative to the project
+  root. A key of `""` or one ending in `/` is a **directory** (value is a list of
+  sources); any other key is a **rename** (value is a single source file).
+  Defaults to `{"": ["./"]}` (whole project to root) when omitted.
+- `compile: true` compiles `.py` to `.mpy` (same as `cp -m`).
+- `exclude` adds ignore patterns on top of the defaults (`__pycache__`, `*.pyc`,
+  dotfiles). Combined with global `-e` patterns.
+
+The connection fields (`port`, `address`) used by the Sublime plugin are ignored
+by the CLI — use the global `-p` / `-a` options instead.
+
 ### Move/rename on device
 ```
 $ mpytool mv :/old.py :/new.py      # rename file

{mpytool-2.4.0 → mpytool-2.5.0}/completions/_mpytool

@@ -269,6 +269,13 @@ _mpytool() {
                         fi
                     fi
                     ;;
+                sync)
+                    # Optional local project directory, -- anytime
+                    if [[ $pos -eq 2 ]]; then
+                        _files -/
+                    fi
+                    compadd -- '--'
+                    ;;
                 exec)
                     # 1 code string, -- after it
                     [[ $nargs -ge 1 ]] && compadd -- '--'

{mpytool-2.4.0 → mpytool-2.5.0}/completions/mpytool.bash

@@ -272,6 +272,13 @@ _mpytool() {
                 fi
             fi
             ;;
+        sync)
+            # Optional local project directory, -- for chaining
+            if [[ $pos -eq 2 ]]; then
+                COMPREPLY=($(compgen -d -- "$cur"))
+            fi
+            [[ -z "$cur" || "--" == "$cur"* ]] && COMPREPLY+=("--")
+            ;;
         exec)
             # 1 code string, -- after it
             [[ $nargs -ge 1 && ( -z "$cur" || "--" == "$cur"* ) ]] && COMPREPLY+=("--")

{mpytool-2.4.0 → mpytool-2.5.0}/mpytool/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.4.0'
-__version_tuple__ = version_tuple = (2, 4, 0)
+__version__ = version = '2.5.0'
+__version_tuple__ = version_tuple = (2, 5, 0)
 
-__commit_id__ = commit_id = 'gf2ecc3ebb'
+__commit_id__ = commit_id = 'ga70fd9bfe'

{mpytool-2.4.0 → mpytool-2.5.0}/mpytool/mpytool.py

@@ -4,7 +4,9 @@ import argparse as _argparse
 import datetime as _datetime
 import fnmatch as _fnmatch
 import importlib.metadata as _metadata
+import json as _json
 import os as _os
+import re as _re
 import shlex as _shlex
 import subprocess as _subprocess
 import sys as _sys
@@ -30,7 +32,7 @@ else:
 
 # Order of commands in help and completion
 _CMD_ORDER = [
-    'ls', 'tree', 'cat', 'cp', 'mv', 'mkdir', 'rm', 'pwd', 'cd', 'path',
+    'ls', 'tree', 'cat', 'cp', 'sync', 'mv', 'mkdir', 'rm', 'pwd', 'cd', 'path',
     'stop', 'reset', 'wipe', 'monitor', 'repl', 'exec', 'run', 'edit', 'info',
     'rtc', 'flash', 'mount', 'ln', 'speedtest', 'sleep', 'ports',
 ]
@@ -57,6 +59,48 @@ def _remote_basename(path):
     return path.rstrip('/').split('/')[-1]
 
 
+def _find_mpyproject(path):
+    """Find .mpyproject searching upward from path (file or directory).
+
+    Mirrors the Sublime plugin: walks parent directories, skipping any
+    .backup directory (which may hold a .mpyproject downloaded from a
+    device). Returns the path to .mpyproject or None.
+    """
+    path = _os.path.abspath(path)
+    directory = path if _os.path.isdir(path) else _os.path.dirname(path)
+    while directory and directory != _os.path.dirname(directory):
+        if _os.path.basename(directory) == '.backup':
+            directory = _os.path.dirname(directory)
+            continue
+        candidate = _os.path.join(directory, '.mpyproject')
+        if _os.path.exists(candidate):
+            return candidate
+        directory = _os.path.dirname(directory)
+    return None
+
+
+def _load_mpyproject(path):
+    """Load .mpyproject JSON config.
+
+    Tolerates trailing commas (common, not strictly valid JSON), like the
+    Sublime plugin. Returns the parsed dict, {} for an empty file, or None
+    on a JSON syntax error.
+    """
+    try:
+        with open(path, 'r', encoding='utf-8') as file:
+            content = file.read().strip()
+    except OSError:
+        return {}
+    if not content:
+        return {}
+    # Remove trailing commas before } or ] (tolerated, not valid JSON)
+    content = _re.sub(r',\s*([}\]])', r'\1', content)
+    try:
+        return _json.loads(content)
+    except _json.JSONDecodeError:
+        return None
+
+
 def _normalize_path_arg(value):
     """Argparse type for path arguments - normalize Windows backslashes"""
     if _sys.platform == 'win32' and value.startswith(':'):
@@ -785,6 +829,77 @@ class MpyTool():
         else:
             self.verbose("  reset", 1)
 
+    def cmd_sync(self, project_dir=None):
+        """Deploy a project to the device per its .mpyproject config.
+
+        Reads the deploy map / exclude / compile settings from .mpyproject
+        (found in project_dir or the current directory, searched upward) and
+        runs the corresponding cp operations. Non-interactive: the connection
+        comes from the global -p / -a options.
+        """
+        start = project_dir if project_dir else '.'
+        if not _os.path.exists(start):
+            raise ParamsError(f"path not found: {start}")
+        mpyproject = _find_mpyproject(start)
+        if not mpyproject:
+            raise ParamsError(
+                f"no .mpyproject found in '{start}' or any parent directory")
+        config = _load_mpyproject(mpyproject)
+        if config is None:
+            raise ParamsError(f"invalid JSON in {mpyproject}")
+        root = _os.path.dirname(mpyproject) or '.'
+        name = config.get('name') or _os.path.basename(_os.path.abspath(root))
+        self.verbose(f"SYNC: {name} ({mpyproject})", 1)
+        # Merge config exclude patterns into the active exclude set
+        for pattern in config.get('exclude', []):
+            self._exclude_dirs.add(pattern)
+        compile_mpy = config.get('compile', False)
+        # deploy map: {"": ["./"], "/lib/": ["../x.py"]}
+        # dir mode (dest is "" or ends with "/"): sources is a list
+        # rename mode (dest does not end with "/"): sources is a single string
+        deploy = config.get('deploy') or {"": ["./"]}
+        cp_jobs = self._build_sync_jobs(deploy, mpyproject)
+        if not cp_jobs:
+            raise ParamsError(
+                f"nothing to deploy, configure 'deploy' in {mpyproject}")
+        # Sources are relative to the project root - run cp from there
+        prev_cwd = _os.getcwd()
+        try:
+            _os.chdir(root)
+            for sources, dest in cp_jobs:
+                cp_args = ['-m'] if compile_mpy else []
+                cp_args.extend(sources)
+                cp_args.append(dest)
+                self.cmd_cp(cp_args)
+        finally:
+            _os.chdir(prev_cwd)
+
+    @staticmethod
+    def _build_sync_jobs(deploy, mpyproject):
+        """Translate a .mpyproject deploy map into (sources, dest) cp jobs"""
+        jobs = []
+        for dest, sources in deploy.items():
+            if not sources:
+                continue
+            is_dir_mode = dest == "" or dest.endswith("/")
+            if is_dir_mode and not isinstance(sources, list):
+                raise ParamsError(
+                    f"deploy '{dest}' is a directory, sources must be a list "
+                    f"(in {mpyproject})")
+            if not is_dir_mode and not isinstance(sources, str):
+                raise ParamsError(
+                    f"deploy '{dest}' is a rename, sources must be a single "
+                    f"string (in {mpyproject})")
+            if is_dir_mode:
+                # Drop empties, dedupe while preserving order
+                srcs = list(dict.fromkeys(s for s in sources if s))
+            else:
+                srcs = [sources]
+            if not srcs:
+                continue
+            jobs.append((srcs, f":{dest}"))
+        return jobs
+
     @command('ls', 'List files and directories on device.')
     @argument('path', nargs='?', default=':', metavar='remote',
         type=_normalize_path_arg, help='device path (default: CWD)')
@@ -1186,6 +1301,14 @@ class MpyTool():
         self.cmd_cp(commands)
         commands.clear()
 
+    @command('sync', 'Deploy project to device per .mpyproject config.')
+    @argument('dir', nargs='?', metavar='project_dir',
+        help='project directory (default: current, searched upward)')
+    def _dispatch_sync(self, commands, is_last_group):
+        args = _make_parser(self._dispatch_sync).parse_args(commands)
+        commands.clear()
+        self.cmd_sync(args.dir)
+
     @command('mv', 'Move or rename files on device.')
     @argument('paths', nargs='+', metavar='remote',
         type=_normalize_path_arg, help='source(s) and destination (all with : prefix)')
@@ -1469,7 +1592,7 @@ class MpyTool():
     _COMMANDS = frozenset({
         'ls', 'tree', 'cat', 'mkdir', 'rm', 'pwd', 'cd', 'path',
         'reset', 'wipe', 'stop', 'monitor', 'repl', 'exec', 'run', 'edit', 'info',
-        'rtc', 'flash', 'sleep', 'cp', 'mv', 'mount', 'ln', 'speedtest',
+        'rtc', 'flash', 'sleep', 'cp', 'sync', 'mv', 'mount', 'ln', 'speedtest',
         'ports', '_paths', '_commands', '_options', '_args',
     })
 

{mpytool-2.4.0 → mpytool-2.5.0}/mpytool.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpytool
-Version: 2.4.0
+Version: 2.5.0
 Summary: MPY tool - manage files on devices running MicroPython
 Author-email: Pavel Revak <pavelrevak@gmail.com>
 License-Expression: MIT
@@ -33,6 +33,9 @@ It is an alternative to the official [mpremote](https://docs.micropython.org/en/
   bootloader entry
 - **Wipe device** - erase the whole filesystem and machine-reset
   for a clean slate (handy at the start of automated tests)
+- **Deploy projects** - `sync` uploads a whole project to the device
+  using a `.mpyproject` config file (deploy map, excludes, `.mpy`
+  compilation)
 - **General-purpose serial terminal** - `repl` and `monitor` work
   with any serial device
 - **Mount local directory** - VFS mount (read-only or read-write)
@@ -168,6 +171,47 @@ Requires `mpy-cross` in PATH (`pip install mpy-cross`). If mpy-cross version dif
 from device, automatically uses `-b` flag to target the correct bytecode version.
 If `mpy-cross` is not found, falls back to uploading `.py` with a warning.
 
+### Deploy project (sync)
+
+`sync` uploads a whole project to the device based on a `.mpyproject`
+configuration file. It is the command-line counterpart of the deploy feature in
+the [Sublime Text plugin](https://github.com/cortexm/mpytool-sublime) and shares
+the same `.mpyproject` format. Unlike the plugin it is non-interactive: when more
+than one device is connected, pass `-p` to pick the port.
+
+```
+$ mpytool sync                  # deploy project in CWD (.mpyproject searched upward)
+$ mpytool sync ~/projects/blink # deploy a project in another directory
+$ mpytool -p /dev/ttyACM0 sync  # pick port explicitly (multiple devices)
+$ mpytool sync -- reset -- monitor   # deploy, then reset and watch output
+```
+
+The `.mpyproject` file (JSON, trailing commas tolerated) describes what to upload:
+
+```json
+{
+    "name": "blink",
+    "compile": true,
+    "deploy": {
+        "": ["./"],
+        "/lib/": ["../shared/utils.py"],
+        "/main.py": "src/main_dev.py"
+    },
+    "exclude": ["*.bak", "tests"]
+}
+```
+
+- `deploy` maps a device destination to its source(s), relative to the project
+  root. A key of `""` or one ending in `/` is a **directory** (value is a list of
+  sources); any other key is a **rename** (value is a single source file).
+  Defaults to `{"": ["./"]}` (whole project to root) when omitted.
+- `compile: true` compiles `.py` to `.mpy` (same as `cp -m`).
+- `exclude` adds ignore patterns on top of the defaults (`__pycache__`, `*.pyc`,
+  dotfiles). Combined with global `-e` patterns.
+
+The connection fields (`port`, `address`) used by the Sublime plugin are ignored
+by the CLI — use the global `-p` / `-a` options instead.
+
 ### Move/rename on device
 ```
 $ mpytool mv :/old.py :/new.py      # rename file

{mpytool-2.4.0 → mpytool-2.5.0}/mpytool.egg-info/SOURCES.txt

@@ -32,6 +32,8 @@ mpytool.egg-info/SOURCES.txt
 mpytool.egg-info/dependency_links.txt
 mpytool.egg-info/entry_points.txt
 mpytool.egg-info/requires.txt
+mpytool.egg-info/scm_file_list.json
+mpytool.egg-info/scm_version.json
 mpytool.egg-info/top_level.txt
 tests/__init__.py
 tests/test_cli.py

mpytool-2.5.0/mpytool.egg-info/scm_file_list.json

@@ -0,0 +1,43 @@
+{
+  "files": [
+    ".github/workflows/integration.yml",
+    ".github/workflows/publish.yml",
+    ".github/workflows/tests.yml",
+    ".gitignore",
+    "LICENSE",
+    "README.md",
+    "README_API.md",
+    "README_bench.md",
+    "README_mpremote.md",
+    "completions/_mpytool",
+    "completions/mpytool.bash",
+    "mpytool/__init__.py",
+    "mpytool/cmd_cp.py",
+    "mpytool/conn.py",
+    "mpytool/conn_serial.py",
+    "mpytool/conn_socket.py",
+    "mpytool/logger.py",
+    "mpytool/mount.py",
+    "mpytool/mpy.py",
+    "mpytool/mpy_comm.py",
+    "mpytool/mpy_cross.py",
+    "mpytool/mpytool.py",
+    "mpytool/speedtest.py",
+    "mpytool/terminal.py",
+    "mpytool/terminal_unix.py",
+    "mpytool/terminal_win.py",
+    "mpytool/utils.py",
+    "pyproject.toml",
+    "tests/__init__.py",
+    "tests/test_cli.py",
+    "tests/test_cmd_cp.py",
+    "tests/test_conn_socket.py",
+    "tests/test_errors.py",
+    "tests/test_helpers.py",
+    "tests/test_integration.py",
+    "tests/test_mount.py",
+    "tests/test_mpy.py",
+    "tests/test_mpytool.py",
+    "tests/test_utils.py"
+  ]
+}

mpytool-2.5.0/mpytool.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2.5.0",
+  "distance": 0,
+  "node": "ga70fd9bfe1287f18ee4c15bc39424b0c206920ec",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-06-26"
+}

{mpytool-2.4.0 → mpytool-2.5.0}/tests/test_cli.py

@@ -100,6 +100,19 @@ class TestCliHelp(unittest.TestCase):
         self.assertEqual(result.returncode, 0)
         self.assertIn(':', result.stdout)
 
+    def test_sync_help(self):
+        """mpytool sync --help shows sync usage and project_dir argument"""
+        result = run_mpytool('sync', '--help')
+        self.assertEqual(result.returncode, 0)
+        self.assertIn('project_dir', result.stdout)
+
+    def test_sync_no_mpyproject(self):
+        """mpytool sync in a directory without .mpyproject errors clearly"""
+        with tempfile.TemporaryDirectory() as tmp:
+            result = run_mpytool('sync', tmp)
+            self.assertNotEqual(result.returncode, 0)
+            self.assertIn('.mpyproject', result.stdout + result.stderr)
+
     def test_mv_help(self):
         """mpytool mv --help shows mv usage"""
         result = run_mpytool('mv', '--help')

{mpytool-2.4.0 → mpytool-2.5.0}/tests/test_mpytool.py

@@ -1004,5 +1004,137 @@ class TestRtcCommand(unittest.TestCase):
             mock_dt.datetime.now.assert_called_with(mock_dt.timezone.utc)
 
 
+class TestSyncCommand(unittest.TestCase):
+    """Tests for sync command (deploy project per .mpyproject)"""
+
+    def setUp(self):
+        self.tmpdir = tempfile.mkdtemp()
+        self.tool = MpyTool(Mock(), verbose=None)
+        # Capture cp invocations and the CWD active at call time
+        self.cp_calls = []
+        self.tool.cmd_cp = lambda args: self.cp_calls.append(
+            (os.path.basename(os.getcwd()), list(args)))
+
+    def tearDown(self):
+        shutil.rmtree(self.tmpdir, ignore_errors=True)
+
+    def _write_project(self, content, subdir=''):
+        """Create a .mpyproject with given content, return its directory"""
+        root = os.path.join(self.tmpdir, subdir) if subdir else self.tmpdir
+        os.makedirs(root, exist_ok=True)
+        with open(os.path.join(root, '.mpyproject'), 'w') as file:
+            file.write(content)
+        return root
+
+    def test_default_deploy(self):
+        """Missing deploy key -> default './' to root"""
+        root = self._write_project('{"name": "demo"}')
+        self.tool.cmd_sync(root)
+        self.assertEqual([args for _, args in self.cp_calls], [['./', ':']])
+
+    def test_deploy_dir_and_rename(self):
+        """Dir mode list + rename mode string translate to cp jobs"""
+        root = self._write_project(
+            '{"deploy": {"/lib/": ["a.py", "b.py"], "/main.py": "src/m.py"}}')
+        self.tool.cmd_sync(root)
+        self.assertEqual(
+            [args for _, args in self.cp_calls],
+            [['a.py', 'b.py', ':/lib/'], ['src/m.py', ':/main.py']])
+
+    def test_compile_flag(self):
+        """compile:true prepends -m to every cp job"""
+        root = self._write_project(
+            '{"compile": true, "deploy": {"": ["./"]}}')
+        self.tool.cmd_sync(root)
+        self.assertEqual(self.cp_calls[0][1], ['-m', './', ':'])
+
+    def test_dedupe_sources(self):
+        """Duplicate sources in dir mode are removed, order preserved"""
+        root = self._write_project(
+            '{"deploy": {"": ["./", "./", "x.py"]}}')
+        self.tool.cmd_sync(root)
+        self.assertEqual(self.cp_calls[0][1], ['./', 'x.py', ':'])
+
+    def test_exclude_merged(self):
+        """exclude patterns from config merge into instance excludes"""
+        root = self._write_project(
+            '{"deploy": {"": ["./"]}, "exclude": ["*.bak", "tmp"]}')
+        self.tool.cmd_sync(root)
+        self.assertIn('*.bak', self.tool._exclude_dirs)
+        self.assertIn('tmp', self.tool._exclude_dirs)
+
+    def test_trailing_comma_tolerated(self):
+        """JSON with trailing commas still loads"""
+        root = self._write_project('{"deploy": {"": ["./"],},}')
+        self.tool.cmd_sync(root)
+        self.assertEqual(self.cp_calls[0][1], ['./', ':'])
+
+    def test_runs_from_project_root(self):
+        """cp jobs run with project root as CWD; CWD restored afterwards"""
+        root = self._write_project('{"deploy": {"": ["./"]}}', subdir='myproj')
+        prev = os.getcwd()
+        self.tool.cmd_sync(root)
+        self.assertEqual(self.cp_calls[0][0], 'myproj')
+        self.assertEqual(os.getcwd(), prev)
+
+    def test_search_upward(self):
+        """.mpyproject is found by searching parent directories"""
+        root = self._write_project('{"deploy": {"": ["./"]}}', subdir='app')
+        deep = os.path.join(root, 'pkg', 'mod')
+        os.makedirs(deep)
+        self.tool.cmd_sync(deep)
+        self.assertEqual(self.cp_calls[0][0], 'app')
+
+    def test_no_mpyproject(self):
+        """Missing .mpyproject raises ParamsError"""
+        empty = os.path.join(self.tmpdir, 'empty')
+        os.makedirs(empty)
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(empty)
+        self.assertIn('.mpyproject', str(ctx.exception))
+
+    def test_path_not_found(self):
+        """Nonexistent path raises ParamsError"""
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(os.path.join(self.tmpdir, 'nope'))
+        self.assertIn('not found', str(ctx.exception))
+
+    def test_invalid_json(self):
+        """Malformed JSON raises ParamsError"""
+        root = self._write_project('{ not valid }')
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(root)
+        self.assertIn('invalid JSON', str(ctx.exception))
+
+    def test_dir_mode_string_invalid(self):
+        """Directory dest with string source is a config error"""
+        root = self._write_project('{"deploy": {"/lib/": "single.py"}}')
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(root)
+        self.assertIn('must be a list', str(ctx.exception))
+
+    def test_rename_mode_list_invalid(self):
+        """Rename dest with list source is a config error"""
+        root = self._write_project('{"deploy": {"/main.py": ["a.py"]}}')
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(root)
+        self.assertIn('must be a single string', str(ctx.exception))
+
+    def test_nothing_to_deploy(self):
+        """Deploy entries with only empty sources -> nothing to deploy"""
+        root = self._write_project('{"deploy": {"/lib/": []}}')
+        with self.assertRaises(ParamsError) as ctx:
+            self.tool.cmd_sync(root)
+        self.assertIn('nothing to deploy', str(ctx.exception))
+
+    def test_dispatch_sync(self):
+        """_dispatch_sync parses optional directory and consumes commands"""
+        root = self._write_project('{"deploy": {"": ["./"]}}')
+        commands = [root]
+        self.tool._dispatch_sync(commands, True)
+        self.assertEqual(commands, [])
+        self.assertEqual(self.cp_calls[0][1], ['./', ':'])
+
+
 if __name__ == "__main__":
     unittest.main()