Query version and release values that sphinx will use

[timhoffm]

I'd like to get the version and release for a sphinx project without a full build.

My quick one-off solution is

cd docs && python -c "import conf; print(conf.version); print(conf.release)"

Of course this has a number of implicit assumptions.

Questions:

• Is there a better out-of-the-box way of doing this?
• Would it be reasonable to implement a sphinx config command in the context of Provide sphinx command and integrate sphinx commands #5618? Then one could do sphinx config release - somewhat in analogy to git config user.name, but limited to read-only and for a start only for a predefined set of values.

[AA-Turner]

What's the use case?

A

[AA-Turner]

What's the use case?

A

[timhoffm]

On a doc build infrastructure for multiple projects I want to eventually release the built projects under a url .../{project}/{version}. So it would be nice to have easy access to the version number. Since users may do fancy stuff to set version in conf.py, I figure any approach to static parsing will fail and the only reliable way is to get the value from sphinx. Also parsing the built docs is not an option because I don't have control over the built sources, so don't know where the version may be in the built docs.