VT2040-utils

A collection of small utilites to turn a VT2040 and an ESP8266 running MicroPython into a useful portable computer.

installer.py

Download utilities from this GitHub repository over WiFi. You must have connected to a WiFi access point already.

To bootstrap:

>>> import socket, ssl
>>> a = socket.getaddrinfo("raw.githubusercontent.com", 443)[0][-1]
>>> s = socket.socket()
>>> s.connect(a)
>>> s = ssl.wrap_socket(s)
>>> s.write("GET /ncrawforth/VT2040-utils/main/installer.py HTTP/1.0\r\n")
57
>>> s.write("Host: raw.githubusercontent.com\r\n\r\n")
35
>>> d = s.read()
>>> s.close()
>>> f = open("installer.py", "w")
>>> f.write(d.decode().split("\r\n\r\n")[-1])
395
>>> f.close()

editor.py

Simple text editor. Modeless - i.e. use cursor keys to move cursor, and type to insert text. Ctrl-D saves and quits, ctrl-C quits without saving.

>>> from installer import install
>>> install("editor.py")
>>> from editor import edit
>>> edit(<filename>)

Limitations

No tab support. Tabs are replaced with 2 spaces for now.
Unicode probably doesn't work very well yet.
There might still be file-corrupting bugs, so the original file is always backed up before saving.

github.py

List, download, create, update and delete files in a GitHub repository.

You need a personal access token with the workflow scope. Create a file called github.json with your GitHub username, repository name and personal access token:

{"username": "ncrawforth", "repo": "VT2040-utils", "token": "VGhpcyBpcyBub3QgYSByZWFsIHBlcnNvbmFsIGFjY2VzcyB0b2tlbi4="}

>>> from installer import install
>>> install("github.py")
>>> import github
>>> github.list()
>>> github.get(<filename>)
>>> github.put(<filename>, [<commit message>])
>>> github.delete(<filename>, [<commit message>])

telnets.py

Under development.

Connect to a telnet server over SSL.

>>> from telnets import telnets
>>> telnets(<hostname>, [<port>])

Why not SSH?

There isn't a working SSH client for ESP8266 yet.
SSL allows for virtual hosts, which is a thing I need.

ncrawforth / VT2040-utils