Full explanation of how data files get generated in docs

[dbarnett]

Looking at the usage examples at https://setuptools-generate.readthedocs.io/en/latest/, I can see what files are produced and kinda how those correspond to the config, but it's hard to understand exactly where the file contents originate from and how the inputs get hooked up to the outputs. Specifically...

• Semantics of tool.setuptools.data-files are a little hard to interpret, especially since the data-files key seems to be semi-deprecated and not explicitly covered in a lot of setuptools docs
• Is the project.scripts thing an example of a static file to get copied or a script run to dynamically produce generated output?
• Is e.g. the bash completion script a file produced by setuptools-generated code, automatically detected and generated based on other source files because setuptools-generated detects argparse/shtab usage specifically? Or are there some other script files implied in the example to take an ArgumentParser object and probe it for its completion script outputs? Is setuptools-generated a general-purpose tool or specialized to integrate with shtab, man pages, and other specific cases the author identified?

I'm gonna dig through some code and can probably find the answers to those questions but still worth mentioning the documentation fail, that I can't understand how this works without going past the docs to read the code.

[dbarnett]

And if it's helpful, a little more context about the specific problem I'm trying to solve when I got stuck on these questions: I'm using pydantic and want to generate a json schema data file, ideally checked in as part of the source tree so that I can link to it in directives like #:schema https://raw.githubusercontent.com/insanum/gcalcli/HEAD/data/config-schema.json. I remembered setuptools-scm had a mechanism to dump a ./_version.py file and wanted to do something similar, found this project through some web searches, but am having trouble figuring out if it can handle my case and if so exactly how I'd need to configure it for my use case.