Change to all-numeric version entry format and add collection

The version is now specified with a new collection variable which
shall be "stable" or "development" and an all-numeric version. The
"~dev" (and the .<commiter date>) suffix will be added by the script.

diff --git a/gen_version.py b/gen_version.py
index 201af59c0521ba373eaf9c647c7305ff2041e49b..35679bfb8cb2790ef22eed3c8eb993022b0616fa 100644 (file)
--- a/gen_version.py
+++ b/gen_version.py
@@ -2,25 +2,27 @@
 
 # Generate version
 #
-# Stable release entry format     : <major>.<minor>.>patch>
-# Development release entry format: <major>.<minor>.<patch>~dev
+# Release version entry format : <major>.<minor>.<patch>
 #
-# Stable release output format     : <major>.<minor>.<patch>
-# Development release output format: <major>.<minor>.<patch>~dev.<YYYYmmdd.HHMM>
+# Stable release version output format     : <major>.<minor>.<patch>
+# Development release version output format: <major>.<minor>.<patch>~dev.<YYYYmmdd.HHMM>
 
-# The patch version of a development release should be the next stable
-# release patch number followed by "~dev". The committer date will be
-# added with a period separator.
+# The patch version of a development release should be the same as the
+# next stable release patch number. The string "~dev." and the
+# committer date will be added.
 #
 # Example sequence:
 #
-# Entry          Output
-# 2.44.1      => 2.44.1
-# 2.44.2~dev  => 2.44.2~dev.20200704.1652
-# 2.44.2      => 2.44.2
-# 2.44.3~dev  => 2.44.3~dev.20200824.1337
+# Entry version   Entry collection          Output
+# 2.44.1          stable                 => 2.44.1
+# 2.44.2          development            => 2.44.2~dev.20200704.1652
+# 2.44.2          stable                 => 2.44.2
+# 2.44.3          development            => 2.44.3~dev.20200824.1337
 
-version = '2.44.2~dev'
+#collection = 'stable'
+collection = 'development'
+
+version = '2.44.2'
 
 import os
 import sys
@@ -51,6 +53,15 @@ args = parser.parse_args()
 
 date_format = args.date_format or graphviz_date_format
 
+assert collection in ('stable', 'development'), \
+    'The collection is not "stable" or "development"'
+assert len(version.split('.')) == 3, 'Wrong number of version elements'
+assert all(part.isnumeric() for part in version.split('.')), \
+    'All version elements are not numeric'
+
+if collection == 'development':
+    version += '~dev'
+
 major_version, minor_version, patch_version = version.split('.')
 
 if not patch_version.isnumeric() or args.date_format: