I have a python project under SVN, and I'm wanting to display the version number when it is run. Is there any way of doing this (such as automatically running a short script on commit which could update a version file, or querying an SVN repository in Python?)
11 Answers
I'm not sure about the Python specifics, but if put the string $Revision$ into your file somewhere and you have enable-auto-props=true in your SVN config, it'll get rewritten to something like $Revision: 144$. You could then parse this in your script.
There are a number of property keywords you can use in this way.
This won't have any overhead, e.g. querying the SVN repo, because the string is hard-coded into your file on commit or update.
I'm not sure how you'd parse this in Python but in PHP I'd do:
$revString = '$Revision: 144$';
if(preg_match('/: ([0-9]+)\$/', $revString, $matches) {
echo 'Revision is ' . $matches[1];
}
The file hooks/pre-commit
in your repository is a script or program which will be executed before a successful commit. Simply make this a script which updates your file with the proper version number as it is being committed (the revision number is passed to your script as it's run). Here's a tutorial with an example of writing a pre-commit hook: http://wordaligned.org/articles/a-subversion-pre-commit-hook
There's a snippet of code in Django that allows you to do this, I'd recommend looking at it. http://code.djangoproject.com/browser/django/trunk/django/utils/version.py
I do this by simply running a small script when building my project. The script just calls svn info in combination with sed to get out the bare revision data and injects that number into the revision.txt file.
The Hudson build server makes it even easier as it sets the SVN revision number as an environment variable right before invoking your Build scripts.
I find the when it is run section slightly ambiguous - when it is run from where ? From an SVN checkout or from released code ? All the solutions work on injecting the SVN version somehow into the Python source or somewhere in the repository in a separate version file.
The version file is changed on fresh checkouts, so clean checkouts need to be done before distribution. So my question of where the program is being run remains.
Re-answering because I had trouble finding all the information for python 3. In python 3 you can use the following:
import re
revstring = '$Revision: 123 $'
revnumber = re.sub(r'\D', '', revstring)
For SVN to replace the number, the file-keyword "Revision" has to be set. you achieve this by typing the following command into a terminal:
svn propset svn:keywords Revision YOURFILE.py
Moreover, in the subversion configuration file the property enable-auto-props
has to be set to yes
. This should already be the case. In Tortoise SVN this config file can be accessed by clicking the button "edit" next to "subversion configuration file" in the general settings tab.
You could do this programmatically by parsing the output from 'svn info --xml' to an xml Element:
def get_svn_rev(dir: Union[str, Path]) -> str:
"""Get the svn revision of the given directory"""
dir = str(dir)
svn_info_cmd = ['svn', 'info', '--xml', dir]
print(' '.join(svn_info_cmd))
svn_info_process = subprocess.run(svn_info_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
if svn_info_process.returncode:
eprint(svn_info_process.stderr.decode().strip())
raise subprocess.CalledProcessError(returncode=svn_info_process.returncode, cmd=svn_info_cmd,
output=svn_info_process.stdout,
stderr=svn_info_process.stderr)
else:
info = ElementTree.fromstring(svn_info_process.stdout.decode().strip())
entry = info.find('entry')
revision = entry.get('revision')
return revision