Metadata-Version: 2.1
Name: microterm
Version: 0.0.2
Summary: CLI tool for interacting with MicroPython devices
Home-page: https://github.com/wybiral/microterm
Author: davy wybiral
Author-email: davy.wybiral@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyserial

# Microterm
CLI tool for interacting with MicroPython devices

## Installation
```
pip install microterm
```

## Getting Started
```
python -m microterm
```

## Usage Examples
Display command list.
```
(Microterm)> help
Commands ("help <command>" for details):
cat  connect  disconnect  get   ls     mv   pwd     reboot  rmdir
cd   devices  exit        help  mkdir  put  python  rm
```
Get help for a specific command.
```
(Microterm)> help connect
Connect to MicroPython device.
Usage: connect DEVICE
```
List serial devices.
```
(Microterm)> devices
COM7 - USB Serial Device (COM7)
```
Connect to device.
```
(Microterm)> connect com7
```
List files on device.
```
(Microterm)> ls
main.py  settings.txt
```
Copy file from host machine (such as a laptop running Microterm) to the connected MicroPython device.
```
(Microterm)> put main.py
```
Copy file from connected MicroPython device to the host machine.
```
(Microterm)> get main.py
```
Read contents of a file.
```
(Microterm)> cat main.py
print('Hello world!')
```
Execute script on MicroPython device.
```
(Microterm)> python main.py
Press CTRL+C to return to Microterm
Hello world!
```
Enter MicroPython REPL.
```
(Microterm)> python
Press CTRL+C to return to Microterm
MicroPython v1.20.0 on 2023-04-26; SparkFun Pro Micro RP2040 with RP2040
Type "help()" for more information.
>>>
```
