Coverage for python/lsst/verify/metadata/jenkinsci.py : 80%

Hot-keys 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 verify.
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/>.
21__all__ = ['get_jenkins_env']
23from datetime import datetime, timezone
24import os
27def get_jenkins_env():
28 """Gather metadata entries from LSST DM Jenkins CI environment.
30 Returns
31 -------
32 prov : `dict`
33 Dictionary of metadata items obtained from the Jenkins CI
34 environment. Fields are:
36 - ``'date'``: ISO8601-formatted current datetime.
37 - ``'ci_id'``: Job ID in Jenkins CI.
38 - ``'ci_name'``: Job name in Jenkins CI.
39 - ``'ci_dataset'``: Name of the dataset being processed.
40 - ``'ci_label'``: Value of ``${label}`` environment variable in
41 Jenkins CI.
42 - ``'ci_url'``: URL to job page in Jenkins CI.
43 - ``'ci_refs'``: whitespace-delimited branch references
44 - ``'status'``: Job return status (always ``0``).
46 Examples
47 --------
48 This metadata is intended to be inserted into a job's metadata:
50 >>> from lsst.verify import Job
51 >>> job = Job()
52 >>> job.meta.update(get_jenkins_env())
53 """
55 return {
56 'date': datetime.now(timezone.utc).isoformat(),
57 'ci_id': os.getenv('BUILD_ID', 'unknown'),
58 'ci_name': os.getenv('PRODUCT', 'unknown'),
59 'ci_dataset': os.getenv('dataset', 'unknown'),
60 'ci_label': os.getenv('label', 'unknown'),
61 'ci_refs': os.getenv('refs', 'unknown'),
62 'ci_url': os.getenv('BUILD_URL', 'https://example.com'),
63 'status': 0,
64 }