DM-34964: add cancel, restart and ping function in the bps panda plugin

[wguanicedew]

Checklist

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

[timj]

I am assuming @MichelleGower will also take a look from a bps perspective.

I have many comments but I think most of them are easy to deal with.

I do have a concern about the return values from idds APIs being very hard to use. It looks like there are tuples with tuples and the code here would benefit significantly from those APIs returning objects that can be inspected with methods.

Code like this:

if ret[0] == 0 and ret[1][0]

is very hard to follow and would be much easier if ret was an object that could have methods run on it.

[timj]

Looks okay now. Thanks for the changes. Some minor comments and I'll leave the rest for @MichelleGower.

Please consider using pre-commit so that the code is black-compatible before it is committed.

[MichelleGower]

In my tests, report isn't working as expected. Also, the behavior in error cases isn't the same as the expected behavior for all of the new functions. And a heads up that the expected ping method signature will be different than it appears here.

[codecov]

Codecov Report

Merging #11 (be97783) into main (0005c0f) will decrease coverage by 2.62%.
The diff coverage is 10.66%.

@@            Coverage Diff             @@
##             main      #11      +/-   ##
==========================================
- Coverage   35.28%   32.65%   -2.63%     
==========================================
  Files           9        9              
  Lines         479      539      +60     
  Branches       79       91      +12     
==========================================
+ Hits          169      176       +7     
- Misses        307      360      +53     
  Partials        3        3              

Impacted Files	Coverage Δ
python/lsst/ctrl/bps/panda/idds_tasks.py	31.62% <0.00%> (ø)
python/lsst/ctrl/bps/panda/panda_service.py	20.45% <10.95%> (-4.55%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0005c0f...be97783. Read the comment docs.