mpy-repl-tool 0.1

====================
REPL Transfer Tool
====================

Transfer files via Python REPL (Read Eval Print Loop). This tool was developed
to transfer files from and to MicroPython boards.

This is yet an other tool, there are now several similar tools but not all have
the same features.

Usage
=====

Here is the output of ``python3 -m there --help``:

usage: __main__.py [-h] [-p PORT] [-b BAUDRATE] [-c COMMAND] [-i] [-v]
{detect,run,ls,cat,put,rm,mount} ...

Do stuff via the MicroPython REPL

positional arguments:
{detect,run,ls,cat,put,rm,mount}
sub-command help
detect help locating a board
run execute file contents on target
ls list files
cat print content of one file
put file(s) to copy onto target
rm remove files on target
mount Make target files accessible via FUSE

optional arguments:
-h, --help show this help message and exit
-p PORT, --port PORT set the serial port
-b BAUDRATE, --baudrate BAUDRATE
set the baud rate
-c COMMAND, --command COMMAND
execute given code on target
-i, --interactive drop to interactive shell at the end
-v, --verbose show diagnostic messages

The ``-c`` option executes the given string after running all the actions.
The ``-i`` option enters a miniterm sesstion at the end of all other actions.

The tool automatically selects a USB port for communication, it may take the
wrong one if multiple USB serial devices are connected. In that case, use
``there detect`` to list all devices and then ``-p PORT`` to specify the
port to use on the other calls.

.. note::

Currently the escape handling in miniterm is disabled which makes editing
on the MicroPython REPL a bit inconvenient.

Use ``python3 -m there <action> --help`` to get help on sub-commands.