source: rtems-tools/rtemstoolkit/version.py @ 53dd5e6

5
Last change on this file since 53dd5e6 was 3bc12bb, checked in by Chris Johns <chrisj@…>, on 11/28/18 at 22:18:48

rtemstoolkit/version: Remove the tailing - with a clean git repo

  • Property mode set to 100644
File size: 8.4 KB
Line 
1#
2# RTEMS Tools Project (http://www.rtems.org/)
3# Copyright 2010-2018 Chris Johns (chrisj@rtems.org)
4# All rights reserved.
5#
6# This file is part of the RTEMS Tools package in 'rtems-tools'.
7#
8# Redistribution and use in source and binary forms, with or without
9# modification, are permitted provided that the following conditions are met:
10#
11# 1. Redistributions of source code must retain the above copyright notice,
12# this list of conditions and the following disclaimer.
13#
14# 2. Redistributions in binary form must reproduce the above copyright notice,
15# this list of conditions and the following disclaimer in the documentation
16# and/or other materials provided with the distribution.
17#
18# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28# POSSIBILITY OF SUCH DAMAGE.
29#
30
31#
32# Releasing RTEMS Tools
33# ---------------------
34#
35# Format:
36#
37#  The format is INI. The file requires a `[version`] section and a `revision`
38#  option:
39#
40#   [version]
41#   revision = <version-string>
42#
43#  The `<version-string>` has the `version` and `revision` delimited by a
44#  single `.`. An example file is:
45#
46#   [version]
47#   revision = 5.0.not_released
48#
49#  where the `version` is `5` and the revision is `0` and the package is not
50#  released. The label `not_released` is reversed to mean the package is not
51#  released. A revision string can contain extra characters after the
52#  `revision` number for example `5.0-rc1` or is deploying a package
53#  `5.0-nasa-cfs`
54#
55#  Packages can optionally add specialised sections to a version configuration
56#  files. These can be accessed via the:
57#
58#   load_release_settings: Return the items in a section
59#   load_release_setting: Return an item from a section
60#
61# User deployment:
62#
63#  Create a git archive and then add a suitable VERSION file to the top
64#  directory of the package. The package assumes your python executable is
65#  location in `bin` directory which is one below the top of the package's
66#  install prefix.
67#
68# RTEMS Release:
69#
70#  Set the values in the `rtems-version.ini` file. This is a shared file so
71#  packages and encouraged to add specific settings to other configuration
72#  files.
73#
74# Notes:
75#
76#  This module uses os.apth for paths and assumes all paths are in the host
77#  format.
78#
79
80from __future__ import print_function
81
82import itertools
83import os
84import sys
85
86try:
87    import configparser
88except ImportError:
89    import ConfigParser as configparser
90
91from rtemstoolkit import error
92from rtemstoolkit import git
93from rtemstoolkit import path
94from rtemstoolkit import rtems
95
96#
97# Default to an internal string.
98#
99_version = 'undefined'
100_revision = 'not_released'
101_version_str = '%s.%s' % (_version, _revision)
102_released = False
103_git = False
104_is_loaded = False
105
106def _top():
107    top = os.path.dirname(sys.argv[0])
108    if len(top) == 0:
109        top = '.'
110    return top
111
112def _load_released_version_config():
113    '''Local worker to load a configuration file.'''
114    top = _top()
115    for ver in [os.path.join(top, 'VERSION'),
116                os.path.join('..', 'VERSION'),
117                rtems.configuration_file('rtems-version.ini')]:
118        if path.exists(path.join(ver)):
119            v = configparser.SafeConfigParser()
120            try:
121                v.read(path.host(ver))
122            except Exception as e:
123                raise error.general('Invalid version config format: %s: %s' % (ver,
124                                                                               e))
125            return ver, v
126    return None, None
127
128def _load_released_version():
129    '''Load the release data if present. If not found the package is not released.
130
131    A release can be made by adding a file called `VERSION` to the top level
132    directory of a package. This is useful for user deploying a package and
133    making custom releases.
134
135    The RTEMS project reserves the `rtems-version.ini` file for it's
136    releases. This is the base release and should not be touched by users
137    deploying a package.
138
139    '''
140    global _version
141    global _revision
142    global _released
143    global _version_str
144    global _is_loaded
145
146    if not _is_loaded:
147        vc, v = _load_released_version_config()
148        if v is not None:
149            try:
150                ver_str = v.get('version', 'revision')
151            except Exception as e:
152                raise error.general('Invalid version file: %s: %s' % (vc, e))
153            ver_split = ver_str.split('.')
154            if len(ver_split) < 2:
155                raise error.general('Invalid version release value: %s: %s' % (vc,
156                                                                               ver_str))
157            ver = ver_split[0]
158            rev = '.'.join(ver_split[1:])
159            try:
160                _version = int(ver)
161            except:
162                raise error.general('Invalid version config value: %s: %s' % (vc,
163                                                                              ver))
164            try:
165                _revision = int(''.join(itertools.takewhile(str.isdigit, str(rev))))
166            except Exception as e:
167                raise error.general('Invalid revision config value: %s: %s: %s' % (vc,
168                                                                                   rev,
169                                                                                   e))
170            if not 'not_released' in ver:
171                _released = True
172            _version_str = ver_str
173            _is_loaded = True
174    return _released
175
176def _load_git_version():
177    global _version
178    global _revision
179    global _git
180    global _version_str
181    repo = git.repo(_top())
182    if repo.valid():
183        head = repo.head()
184        if repo.dirty():
185            modified = 'modified'
186            revision_sep = '-'
187            sep = ' '
188        else:
189            modified = ''
190            revision_sep = ''
191            sep = ''
192        _revision = '%s%s%s' % (head[0:12], revision_sep, modified)
193        _version_str = '%s (%s%s%s)' % (_version, head[0:12], sep, modified)
194        _git = True
195    return _git
196
197def load_release_settings(section, error = False):
198    vc, v = _load_released_version_config()
199    items = []
200    if v is not None:
201        try:
202            items = v.items(section)
203        except Exception as e:
204            if not isinstance(error, bool):
205                error(e)
206            elif error:
207                raise error.general('Invalid config section: %s: %s: %s' % (vc,
208                                                                            section,
209                                                                            e))
210    return items
211
212def load_release_setting(section, option, raw = False, error = False):
213    vc, v = _load_released_version_config()
214    value = None
215    if v is not None:
216        try:
217            value = v.get(section, option, raw = raw)
218        except Exception as e:
219            if not isinstance(error, bool):
220                error(e)
221            elif error:
222                raise error.general('Invalid config section: %s: %s: %s.%s' % (vc,
223                                                                               section,
224                                                                               option,
225                                                                               e))
226    return value
227
228def released():
229    return _load_released_version()
230
231def version_control():
232    return _load_git_version()
233
234def string():
235    _load_released_version()
236    _load_git_version()
237    return _version_str
238
239def version():
240    _load_released_version()
241    _load_git_version()
242    return _version
243
244def revision():
245    _load_released_version()
246    _load_git_version()
247    return _revision
248
249if __name__ == '__main__':
250    print('Version: %s' % (str(version())))
251    print('Revision: %s' % (str(revision())))
252    print('String: %s' % (string()))
253    if version() == 'undefined':
254        raise Exception('version is undefined')
Note: See TracBrowser for help on using the repository browser.