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 81.28%. Comparing base (f992f36) to head (748e3a3).

✅ All tests successful. No failed tests found.

Files with missing lines	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   82.40%   81.28%   -1.13%     
==========================================
  Files         107      108       +1     
  Lines       12844    13021     +177     
  Branches     1650     1664      +14     
==========================================
  Hits        10584    10584              
- Misses       1821     1998     +177     
  Partials      439      439              

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