Hide keyboard shortcuts

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'] 

22 

23from datetime import datetime, timezone 

24import os 

25 

26 

27def get_jenkins_env(): 

28 """Gather metadata entries from LSST DM Jenkins CI environment. 

29 

30 Returns 

31 ------- 

32 prov : `dict` 

33 Dictionary of metadata items obtained from the Jenkins CI 

34 environment. Fields are: 

35 

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``). 

45 

46 Examples 

47 -------- 

48 This metadata is intended to be inserted into a job's metadata: 

49 

50 >>> from lsst.verify import Job 

51 >>> job = Job() 

52 >>> job.meta.update(get_jenkins_env()) 

53 """ 

54 

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 }