createstub variants

There are two variant of the script available, in 3 levels of optimisation:

variant	full documented script	minified script (no logging)	cross-compiled script
full version	board/createstubs.py	minified/createstubs.py	minified/createstubs.mpy
memory optimized	board/createstubs_mem.py	minified/createstubs_mem.py	minified/createstubs_mem.mpy

In all cases the generation will take a few minutes ( 2-5 minutes) depending on the speed of the board and the number of included modules. As the stubs are generated on the board, and as MicroPython is highly optimized to deal with the scarce resources, this unfortunately does mean that the stubs lacks parameters details. So for these you must still use the documentation provided for that firmware.

board/createstubs.py

this is the core version of the script, and is fully self contained, but includes logging with requires the logging module to be avaialble on your device If your firmware does not include the logging module, you will need to upload this to your board, or use the minified version.

import createstubs

board/createstubs_mem.py

This variant of the createstubs.py script is optimised for use on low-memory devices, and reads the list of modules from a text file, rather than including it in the source file. as a result this requires an additional file ./modulelist.txt, that should be uploaded to the device. If that cannot be found then only a single module (micropython) is stubbed.

import createstubs_mem

Optimisations

In order to run this on low-memory devices two additional steps are recommended:

• Minifification, using python-minifier to reduce overall size, and remove logging overhead. can be used on all devices

• Cross compilation, using mpy-cross, to avoid the compilation step on the micropython device. The cross-compiled version can only run on specific Micropython 1.12 or newer.

Minification

Minified versions, which requires less memory and only very basic logging. this removes the requirement for the logging module on the MCU.

Minifiacation helps reduce the seize of the script, and therefore of the memory usage. As a result the script becomes almost unreadable.

Cross compilation

this is specially suited for low memory devices such as the esp8622