aws-cloudformation / aws-cloudformation/cloudformation-cli-python-plugin
Improve docstrings for Hooks
- Langage dominant
- Python
- Étoiles
- 107
- Forks
- 46
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Description
Hi there :wave:,
It would be nice to have Python docstrings included on the public interfaces when developing hooks.
Would pull requests for docstrings be welcome?
For example, after `cfn init` for hooks, we have a `../handlers.py` that looks similar to this:

In Visual Studio Code, when I hover over `cloudformation_cli_python_lib` specific classes/properties I don't get any information for what they are, or what to expect.
I couldn't find out what all the `request.hookContext` properties mean, and what `dict` keys are available on `request.hookContext.targetModel` from the [Implement Hook handlers (Python)](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-model.html#model-hook-project-code-handler-python) documentation.
In the case of `HookContext` some docstrings like this would be welcome:

Cheers,
Neil
Guide de contribution
Ouvrir le guide de contribution
Évaluation
Cette issue n'a pas encore été évaluée.