esp-idf/tools/test_idf_py/idf_ext.py

def action_extensions(base_actions, project_path=None):
    def echo(name, *args, **kwargs):
        print(name, args, kwargs)

    def verbose(name, ctx, args):
        print("Output from test-verbose")
        if args.verbose:
            print("Verbose mode on")

    # Add global options
    extensions = {
        "global_options": [
            {
                "names": ["--test-0"],
                "help": "Non-deprecated option.",
                "deprecated": False
            },
            {
                "names": ["--test-1"],
                "help": "Deprecated option 1.",
                "deprecated": True
            },
            {
                "names": ["--test-2"],
                "help": "Deprecated option 2.",
                "deprecated": "Please update your parameters."
            },
            {
                "names": ["--test-3"],
                "help": "Deprecated option 3.",
                "deprecated": {
                    "custom_message": "Please update your parameters."
                }
            },
            {
                "names": ["--test-4"],
                "help": "Deprecated option 4.",
                "deprecated": {
                    "since": "v4.0",
                    "removed": "v5.0"
                }
            },
            {
                "names": ["--test-5"],
                "help": "Deprecated option 5.",
                "deprecated": {
                    "since": "v2.0",
                    "removed": "v3.0",
                    "exit_with_error": True
                }
            },
        ],
        "actions": {
            "test-verbose": {
                "callback": verbose,
                "help": "Command that have some verbosity",
            },
            "test-0": {
                "callback": echo,
                "help": "Non-deprecated command 0",
                "options": [
                    {
                        "names": ["--test-sub-0"],
                        "help": "Non-deprecated subcommand option 0",
                        "default": None,
                    },
                    {
                        "names": ["--test-sub-1"],
                        "help": "Deprecated subcommand option 1",
                        "default": None,
                        "deprecated": True
                    },
                ],
                "arguments": [{
                    "names": ["test-arg-0"],
                }],
            },
            "test-1": {
                "callback": echo,
                "help": "Deprecated command 1",
                "deprecated": "Please use alternative command."
            },
            "test-2": {
                "callback": echo,
                "help": "Deprecated command 2",
                "deprecated": {
                    "exit_with_error": True
                }
            },
        },
    }

    return extensions