DM-33034: tools for building Sphinx docs from Pipelines

[TallJimbo]

Checklist

• ran Jenkins
• added a release note for user-visible changes to doc/changes

This PR is against a temporary branch, because merging this ticket (but not its review) is blocked by DM-33027. After that lands I'll rebase.

There are two largely mechanical commits here:

• 80c65ab just moves existing code from ctrl_mpexec, with only trivial changes to import statements.

• b014171 is mostly a bulk-rename followup to DM-31723 - I did that here because using ResourcePath in new code while leaving ButlerURI in nearby existing code was getting increasingly awkward.

The bulk of the changes are in 2d13499; everything else is just setup.

[timj]

#347 has merged. I think that unblocks this ticket to allow it to be rebased on main rather than the temporary branch.

[TallJimbo]

Yes, but there will definitely be conflicts as well as other work to get this branch working again. Might be best to just close the PRs and then delete the temporary base branches.

[timj]

I dropped the commits from the base branch on the basis that you have already merged things (the expanded pipeline stuff was dropped?) and then the rebase was pretty straightforward once I also dropped all the ButlerURI renaming.

[TallJimbo]

The expanded pipeline stuff morphed dramatically into PipelineGraph.

[timj]

I've fixed up all the linting problems. @TallJimbo you may want to confirm it looks right for you before you delete your local branch.

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 177 lines in your changes missing coverage. Please review.

Project coverage is 79.94%. Comparing base (9eaaaf2) to head (2a3260b).

Files	Patch %	Lines
...ython/lsst/pipe/base/pipeline_graph/doc_builder.py	0.00%	177 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #222      +/-   ##
==========================================
- Coverage   81.23%   79.94%   -1.30%     
==========================================
  Files          96       97       +1     
  Lines       10922    11099     +177     
  Branches     2085     2127      +42     
==========================================
  Hits         8873     8873              
- Misses       1691     1868     +177     
  Partials      358      358              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.