Generator contract - how to write my own generator

[vlcinsky]

Describe the bug/feature
I did not find a description about how to write a generator. The only source of information I have are generators within kapitan-refrence repository.

To Reproduce
Try to find a documentation or tutorial about authoring generator.

Expected behavior
The documentation shall clarify things such as:

• what file(s) to write to create a generator
• how to configure a target to use given generator
• required functions within the generator module (probably main) incl. signature (probably expecting input_params dictionary with function key)
• where the content of input_params comes from
• return value of the main function and how it is used. Does it allow creation of multiple files at once as jsonnet does? (by using keys with filenames).

[MatteoVoges]

Hey @vlcinsky ,
I will work on some improvements to the generators and their documentation soon. I would be happy if you can let me know if my solution meets all of your requirements.

Your listed wishes/questions will be taken into account!

[github-actions]

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment or this will be closed in 7 days.