René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add type annotations for the arguments of the CLI entry point","articleBody":"### Description\n\nIn the CLI entry point (`cli.py`), all properties inside `args` are unknown to the IDE, which makes it harder for new developers to read and understand the code.\n\nThis is especially problematic when trying to quickly identify which function `args.func` actually refers to.\n\n### Possible Solution\n\nI suggest adding type hints to clarify which attributes correspond to which functions. Since this change only involves adding type annotations, it will not affect the end-user's runtime behavior. In theory, such a change is safe.\n\n\n### Additional context\n\nI suggest adding the following content.\n\n```py\nclass Args(argparse.Namespace):\n    config: str | None = None\n    debug: bool = False\n    name: str | None = None\n    no_raise: str | None = None\n    report: bool = False\n    project: bool = False\n    commitizen: bool = False\n    verbose: bool = False\n    func: type[\n        commands.Init  # init\n        | commands.Commit  # commit (c)\n        | commands.ListCz  # ls\n        | commands.Example  # example\n        | commands.Info  # info\n        | commands.Schema  # schema\n        | commands.Bump  # bump\n        | commands.Changelog  # changelog (ch)\n        | commands.Check  # check\n        | commands.Version  # version\n    ]\n```\n\n### Additional context\n\n_No response_","author":{"url":"https://github.com/gbaian10","@type":"Person","name":"gbaian10"},"datePublished":"2025-05-31T02:55:29.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1477/commitizen/issues/1477"}