DM-28958: Allow the butler tools to sanitize file names

[SimonKrughoff]

The key used for the job dictionary was allowed to use unsafe characters for a filename. Use butler utilities to sanitize the key so it is safe to use as the filename to write to disk.

---

• Passes Jenkins CI.
• Documentation is up-to-date.

Preview the docs at: https://pipelines.lsst.io/v/DM-FIXME

[kfindeisen]

Thanks for catching this. I do think we want to keep the sort from the old code; otherwise just style comments.

[timj]

I can't comment on the line above but you do not need to create a list from the return value of queryDatasets if you are immediately going to loop over it. It's an iterator itself so the list is overhead you don't want.