From 263737ecfea6ec1049ef3aff37913866ebd463e5 Mon Sep 17 00:00:00 2001
From: Jim Mussared <jim.mussared@gmail.com>
Date: Thu, 18 Aug 2022 12:34:15 +1000
Subject: [PATCH] tools/pyboard.py: Add "touch" filesystem command.

Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
---
 docs/reference/mpremote.rst   | 5 +++--
 docs/reference/pyboard.py.rst | 5 +++--
 tools/pyboard.py              | 8 ++++++--
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/docs/reference/mpremote.rst b/docs/reference/mpremote.rst
index 80290657f4..3927c9badf 100644
--- a/docs/reference/mpremote.rst
+++ b/docs/reference/mpremote.rst
@@ -131,6 +131,7 @@ The full list of supported commands are:
   - ``rm <src...>`` to remove files on the device
   - ``mkdir <dirs...>`` to create directories on the device
   - ``rmdir <dirs...>`` to remove directories on the device
+  - ``touch <file..>`` to create the files (if they don't already exist)
 
 - mount the local directory on the remote device:
 
@@ -192,8 +193,8 @@ Shortcuts can be defined using the macro system.  Built-in shortcuts are::
 
 - ``c0``, ``c1``, ``c2``, ``c3``: connect to COM?
 
-- ``cat``, ``ls``, ``cp``, ``rm``, ``mkdir``, ``rmdir``, ``df``: filesystem
-  commands
+- ``cat``, ``ls``, ``cp``, ``rm``, ``mkdir``, ``rmdir``, ``touch``, ``df``:
+  filesystem commands
 
 - ``reset``: reset the device
 
diff --git a/docs/reference/pyboard.py.rst b/docs/reference/pyboard.py.rst
index 4fedbb7aab..a06ffdcd8f 100644
--- a/docs/reference/pyboard.py.rst
+++ b/docs/reference/pyboard.py.rst
@@ -92,12 +92,13 @@ Filesystem access
 
 Using the ``-f`` flag, the following filesystem operations are supported:
 
-* ``cp src [src...] dest`` Copy files to/from the device.
 * ``cat path`` Print the contents of a file on the device.
+* ``cp src [src...] dest`` Copy files to/from the device.
 * ``ls [path]`` List contents of a directory (defaults to current working directory).
-* ``rm path`` Remove a file.
 * ``mkdir path`` Create a directory.
+* ``rm path`` Remove a file.
 * ``rmdir path`` Remove a directory.
+* ``touch path`` Create a file if it doesn't already exist.
 
 The ``cp`` command uses a ``ssh``-like convention for referring to local and
 remote files. Any path starting with a ``:`` will be interpreted as on the
diff --git a/tools/pyboard.py b/tools/pyboard.py
index 7d0ab6bcd7..7525049875 100755
--- a/tools/pyboard.py
+++ b/tools/pyboard.py
@@ -543,6 +543,9 @@ class Pyboard:
     def fs_rm(self, src):
         self.exec_("import uos\nuos.remove('%s')" % src)
 
+    def fs_touch(self, src):
+        self.exec_("f=open('%s','a')\nf.close()" % src)
+
 
 # in Python2 exec is a keyword so one must use "exec_"
 # but for Python3 we want to provide the nicer version "exec"
@@ -595,11 +598,12 @@ def filesystem_command(pyb, args, progress_callback=None, verbose=False):
                 op(src, dest2, progress_callback=progress_callback)
         else:
             op = {
-                "ls": pyb.fs_ls,
                 "cat": pyb.fs_cat,
+                "ls": pyb.fs_ls,
                 "mkdir": pyb.fs_mkdir,
-                "rmdir": pyb.fs_rmdir,
                 "rm": pyb.fs_rm,
+                "rmdir": pyb.fs_rmdir,
+                "touch": pyb.fs_touch,
             }[cmd]
             if cmd == "ls" and not args:
                 args = [""]