createstubs_db

Create stubs for (all) modules on a MicroPython board.

This variant of the createstubs.py script is optimized for use on very-low-memory devices. Note: this version has undergone limited testing.

1. reads the list of modules from a text file ./modulelist.txt that should be uploaded to the device.

2. stored the already processed modules in a text file ./modulelist.done

3. process the modules in the database:

   • stub the module

   • update the modulelist.done file

   • reboots the device if it runs out of memory

4. creates the modules.json

If that cannot be found then only a single module (micropython) is stubbed. In order to run this on low-memory devices two additional steps are recommended: - minification, using python-minifierto reduce overall size, and remove logging overhead. - cross compilation, using mpy-cross, to avoid the compilation step on the micropython device

You should find a cross-compiled version located here: `./minified/createstubs_db.mpy

Module Contents

Classes

Stubber

Generate stubs for modules in firmware

Functions

ensure_folder(path)	Create nested folders if needed
_info()	collect base information on this runtime
get_root(→ str)	Determine the root folder of the device
file_exists(filename)
show_help()
read_path(→ str)	get --path from cmdline. [unix/win]
isMicroPython(→ bool)	runtime test to determine full or micropython
main_esp8266()

Attributes

__version__
ENOENT
_MAX_CLASS_LEVEL
_log

createstubs_db.__version__ = 1.9.11

createstubs_db.ENOENT = 2

createstubs_db._MAX_CLASS_LEVEL = 2

class createstubs_db.Stubber(path: str = None, firmware_id: str = None)

Generate stubs for modules in firmware

Parameters

• path (str) –

• firmware_id (str) –

get_obj_attributes(item_instance: object)

extract information of the objects members and attributes

Parameters

item_instance (object) –

add_modules(modules)

Add additional modules to be exported

create_all_stubs()

Create stubs for all configured modules

create_one_stub(module_name: str)

Parameters

module_name (str) –

create_module_stub(module_name: str, file_name: str = None) → bool

Create a Stub of a single python module

Args: - module_name (str): name of the module to document. This module will be imported. - file_name (Optional[str]): the ‘path/filename.py’ to write to. If omitted will be created based on the module name.

Parameters

• module_name (str) –

• file_name (str) –

Return type

bool

write_object_stub(fp, object_expr: object, obj_name: str, indent: str, in_class: int = 0)

Write a module/object stub to an open file. Can be called recursive.

Parameters

• object_expr (object) –

• obj_name (str) –

• indent (str) –

• in_class (int) –

property flat_fwid

Turn _fwid from ‘v1.2.3’ into ‘1_2_3’ to be used in filename

clean(path: str = None)

Remove all files from the stub folder

Parameters

path (str) –

report(filename: str = 'modules.json')

create json with list of exported modules

Parameters

filename (str) –

createstubs_db.ensure_folder(path: str)

Create nested folders if needed

Parameters

path (str) –

createstubs_db._info()

collect base information on this runtime

createstubs_db.get_root() → str

Determine the root folder of the device

Return type

str

createstubs_db.file_exists(filename: str)

Parameters

filename (str) –

createstubs_db.show_help()

createstubs_db.read_path() → str

get –path from cmdline. [unix/win]

Return type

str

createstubs_db.isMicroPython() → bool

runtime test to determine full or micropython

Return type

bool

createstubs_db.main_esp8266()

createstubs_db._log