esp-idf/tools/idf_py_actions
Alexey Lapshin c605620073 Merge branch 'fix/keep-got-sections-for-riscv' into 'master'
feat(esp_system): drop .got* sections and add hint

See merge request espressif/esp-idf!32969
2024-09-06 19:21:06 +08:00
..
hint_modules fix: harden input parsing in component_requirements hint module 2024-01-23 18:22:08 +01:00
__init__.py Add idf.py extensions and move core actions to separate files 2019-10-30 10:34:17 +01:00
constants.py doc(jtag): update esp32p4 jtag debugging guide 2024-04-04 21:37:56 +03:00
core_ext.py feat: add diff option support to idf.py size commands 2024-05-24 15:19:37 +08:00
create_ext.py fix(tools): python3.12 support 2024-09-04 18:00:56 +02:00
debug_ext.py fix(tools): Use GDGBUI arguments based on its version 2024-05-23 07:33:11 +02:00
dfu_ext.py dfu: add esp32s3 to supported DFU targets for idf.py 2022-07-11 15:58:21 +08:00
errors.py tools: Add python types hints 2022-06-15 14:33:29 +02:00
global_options.py idf.py: Change copyright in tools dir 2022-05-24 14:01:50 +02:00
hints.yml feat(esp_system): drop .got* sections and add hint 2024-09-05 15:47:01 +07:00
qemu_ext.py feat(idf.py): allow running idf.py efuse-* commands with QEMU 2024-08-15 16:57:08 +02:00
README.md Fix typo and naming format for extensions 2019-10-30 10:34:17 +01:00
roms_schema.json tools: fixed elf symbols load if gdbinit specified 2022-09-21 22:39:03 +04:00
roms.json feat(idf.py): add ESP32-P4 ROM info 2024-03-25 14:39:36 +01:00
serial_ext.py docs(secure_boot_v2): Mention idf.py and openssl commands to generate and verify signatures 2024-08-27 15:44:05 +05:30
tools.py change(port_detection): Filter out BT and WLAN debug serial ports on MacOS 2024-07-04 20:40:10 +08:00
uf2_ext.py feat(tools): move uf2 generation to esptool 2023-10-09 15:38:30 +02:00

idf.py extensions

Python modules (subdirectories and files) in this directory named [your_extension]_ext will be loaded as idf.py extensions. If you want to provide extra extensions just provide ; separated list of directories with extensions in IDF_EXTRA_ACTIONS_PATH. Extensions will be loaded in alphanumeric order. Command line arguments parsing and extension mechanism is implemented on top of Click (versions >=5.0 are supported).

They should define a function action_extensions(base_actions, project_path) where:

  • base_actions - dictionary with actions that are already available for idf.py
  • project_path - working dir, may be defaulted to os.getcwd()

This function have to return a dict with 3 possible keys:

{
    # Additional options that will be available from id
    "global_options": [{
        "names": ["--option-name"],
        "help": "Help for option --option-name.",
    }],
    # List of functions that will have access to full app context, and can mangle with arguments
    "global_action_callbacks": [global_callback],
    # Additional subcommands for idf.py
    "actions": {
        "subcommand_name": {
            "callback": subcommand_callback,
            "help": "Help for subcommand.",
        },
    },
}

Where function global_callback(ctx, global_args, tasks) accepts 3 arguments:

  • ctx - Click context
  • global_args - dictionary of all available global arguments
  • tasks - list of Task objects

And subcommand_callback(subcommand_name, ctx, args) accepts 3 arguments:

  • subcommand_name - name of subcommand
  • ctx - Click context
  • args - list of command's arguments