Coverage for python/lsst/ctrl/bps/cancel.py: 19%
Shortcuts on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
Shortcuts on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
1# This file is part of ctrl_bps.
2#
3# Developed for the LSST Data Management System.
4# This product includes software developed by the LSST Project
5# (https://www.lsst.org).
6# See the COPYRIGHT file at the top-level directory of this distribution
7# for details of code ownership.
8#
9# This program is free software: you can redistribute it and/or modify
10# it under the terms of the GNU General Public License as published by
11# the Free Software Foundation, either version 3 of the License, or
12# (at your option) any later version.
13#
14# This program is distributed in the hope that it will be useful,
15# but WITHOUT ANY WARRANTY; without even the implied warranty of
16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17# GNU General Public License for more details.
18#
19# You should have received a copy of the GNU General Public License
20# along with this program. If not, see <https://www.gnu.org/licenses/>.
22"""API for cancelling runs submitted to a WMS.
23"""
25import logging
27from lsst.utils import doImport
30_LOG = logging.getLogger(__name__)
33def cancel(wms_service, wms_id=None, user=None, require_bps=True, pass_thru=None, is_global=False):
34 """Cancel submitted workflows.
36 Parameters
37 ----------
38 wms_service : `str` or `lsst.ctrl.bps.BaseWmsService`
39 Name of the Workload Management System service class.
40 wms_id : `str`, optional
41 ID or path of job that should be canceled.
42 user : `str`, optional
43 User whose submitted jobs should be canceled.
44 require_bps : `bool`, optional
45 Whether to require given run_id/user to be a bps submitted job.
46 pass_thru : `str`, optional
47 Information to pass through to WMS.
48 is_global : `bool`, optional
49 If set, all available job queues will be checked for jobs to cancel.
50 Defaults to False which means that only a local job queue will be
51 checked.
53 Only applicable in the context of a WMS using distributed job queues
54 (e.g., HTCondor).
55 """
56 _LOG.debug("Cancel params: wms_id=%s, user=%s, require_bps=%s, pass_thru=%s, is_global=%s",
57 wms_id, user, require_bps, pass_thru, is_global)
59 if isinstance(wms_service, str):
60 wms_service_class = doImport(wms_service)
61 service = wms_service_class({})
62 else:
63 service = wms_service
65 jobs = service.list_submitted_jobs(wms_id, user, require_bps, pass_thru, is_global)
66 if len(jobs) == 0:
67 print("No job matches the search criteria. "
68 "Hints: Double check id, and/or use --global to search all job queues.")
69 else:
70 for job_id in sorted(jobs):
71 results = service.cancel(job_id, pass_thru)
72 if results[0]:
73 print(f"Successfully canceled job with id '{job_id}'")
74 else:
75 print(f"Couldn't cancel job with id '{job_id}' ({results[1]})")