sphinx-contrib/datatemplates

Select loading mode via option

janbrohl opened this issue · 4 comments

janbrohl commented

Add new option (eg :mode:) for sellect how the file should be loaded instead of guessing based on analyzing the path from :source:.

Where this would help:

  • There are many XML based formats and some of them cannot easily be guessed from the filename.
  • YAML files can contain multiple documents.
  • No extra option needed for selecting CSV reader.
  • Adds extensible mechanism to add more loaders (eg glob, url)
janbrohl commented

Now I think, adding separate options to change how data is loaded is easier to understand and easier to document.

  • 👍1
dhellmann commented

I think the separate directives probably resolves this one? Unless you want to reframe it to be about the extension mechanism?

dhellmann commented

Is this related to #40 as well?

janbrohl commented

More to #49 but I'll open a new issue for the extension mechanism.