Fabio Iocco / ctools

Browse Code »

Commit aeaaea034e8ef18bae002c4e317f91d2b751814c

Authored by Jürgen Knödlseder 2016-07-25 21:50:38 +0200

1 parent cc01022c

Add ctools release manager

Inline Side-by-side

Showing 2 changed files with 722 additions and 302 deletions

dev/release.py 0 → 100755

View file @aeaaea0

	1	+#! /usr/bin/env python
	2	+# ==========================================================================
	3	+# ctools release manager
	4	+#
	5	+# Copyright (C) 2016 Juergen Knoedlseder
	6	+#
	7	+# This program is free software: you can redistribute it and/or modify
	8	+# it under the terms of the GNU General Public License as published by
	9	+# the Free Software Foundation, either version 3 of the License, or
	10	+# (at your option) any later version.
	11	+#
	12	+# This program is distributed in the hope that it will be useful,
	13	+# but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	+# GNU General Public License for more details.
	16	+#
	17	+# You should have received a copy of the GNU General Public License
	18	+# along with this program. If not, see <http://www.gnu.org/licenses/>.
	19	+#
	20	+# ==========================================================================
	21	+import os
	22	+import sys
	23	+import commands
	24	+
	25	+
	26	+# ================= #
	27	+# Confirm something #
	28	+# ================= #
	29	+def confirm(text):
	30	+ """
	31	+ Confirm something
	32	+
	33	+ Parameters
	34	+ ----------
	35	+ text : str
	36	+ Thing to confirm
	37	+
	38	+ Returns
	39	+ -------
	40	+ flag : bool
	41	+ True if something is confirmed
	42	+ """
	43	+ # Confirmation loop
	44	+ waiting = True
	45	+ while waiting:
	46	+ confirmation = str(raw_input(text+' (y/n): '))
	47	+ if confirmation == 'q':
	48	+ sys.exit()
	49	+ elif confirmation == 'y':
	50	+ flag = True
	51	+ waiting = False
	52	+ elif confirmation == 'n':
	53	+ flag = False
	54	+ waiting = False
	55	+
	56	+ # Return confirmation flag
	57	+ return flag
	58	+
	59	+
	60	+# ============== #
	61	+# Commit changes #
	62	+# ============== #
	63	+def commit(message):
	64	+ """
	65	+ Commit changes into git repo
	66	+
	67	+ Parameters
	68	+ ----------
	69	+ message : str
	70	+ Commit message
	71	+ """
	72	+ # Show changes
	73	+ print("The following files have been changed:")
	74	+ os.system('git status -s')
	75	+
	76	+ # Ask again whether the changes should be committed
	77	+ if confirm("Commit all changes?"):
	78	+
	79	+ # Optionally enter a commit message
	80	+ if len(message) == 0:
	81	+ message = str(raw_input("Please enter a commit message: "))
	82	+
	83	+ # Stage all files
	84	+ os.system('git add -u')
	85	+
	86	+ # Commit all changes
	87	+ os.system('git commit -m "%s"' % message)
	88	+
	89	+ # Return
	90	+ return
	91	+
	92	+
	93	+# ========================== #
	94	+# Check if git branch exists #
	95	+# ========================== #
	96	+def git_branch_exists(branch):
	97	+ """
	98	+ Check if git branch exists
	99	+
	100	+ Parameters
	101	+ ----------
	102	+ branch : str
	103	+ Branch name
	104	+
	105	+ Returns
	106	+ -------
	107	+ exists : bool
	108	+ True if git branch exists
	109	+ """
	110	+ # Check if git branch exists
	111	+ rc = os.system('git rev-parse --verify %s >/dev/null 2>&1' % branch)
	112	+
	113	+ # Set exists flag
	114	+ if rc == 0:
	115	+ exists = True
	116	+ else:
	117	+ exists = False
	118	+
	119	+ # Return flag
	120	+ return exists
	121	+
	122	+
	123	+# ================= #
	124	+# Create git branch #
	125	+# ================= #
	126	+def create_git_branch(branch):
	127	+ """
	128	+ Create a git branch
	129	+
	130	+ Parameters
	131	+ ----------
	132	+ branch : str
	133	+ Branch name
	134	+ """
	135	+ # If branch exists already then ask whether it should be deleted
	136	+ if git_branch_exists(branch):
	137	+ if confirm("Git branch '%s' exists already, do you want to delete "
	138	+ "it?" % branch):
	139	+ os.system('git branch -D %s' % branch)
	140	+
	141	+ # If branch exists already then switch to the new branch, otherwise create
	142	+ # new branch and switch to it
	143	+ if git_branch_exists(branch):
	144	+ os.system('git checkout %s' % branch)
	145	+ else:
	146	+ print("Created new branch '%s'" % branch)
	147	+ os.system('git checkout -b %s' % branch)
	148	+
	149	+ # Return
	150	+ return
	151	+
	152	+
	153	+# ======================================= #
	154	+# Check whether version string is correct #
	155	+# ======================================= #
	156	+def check_version(version):
	157	+ """
	158	+ Check whether version string is correct
	159	+
	160	+ Parameters
	161	+ ----------
	162	+ version : str
	163	+ Version number
	164	+
	165	+ Returns
	166	+ -------
	167	+ check : bool
	168	+ True if version string is correct
	169	+ """
	170	+ # Initialise check with False
	171	+ check = False
	172	+
	173	+ # Split version string
	174	+ split = version.split('.')
	175	+
	176	+ # If there are three elements or four elements we may have a valid version
	177	+ # string
	178	+ if len(split) == 3 or len(split) == 4:
	179	+
	180	+ # If the three first elements are integers we may have a valid version
	181	+ # string
	182	+ if split[0].isdigit() and split[1].isdigit() and split[2].isdigit():
	183	+
	184	+ # If we have three elements the version is valid and we are done
	185	+ if len(split) == 3:
	186	+ check = True
	187	+
	188	+ # Otherwise check if the 4th element is of format devn, where n
	189	+ # is an integer number
	190	+ elif split[3][0:3] == 'dev':
	191	+ if split[3][3:].isdigit():
	192	+ check = True
	193	+
	194	+ # Return check
	195	+ return check
	196	+
	197	+
	198	+# ========================== #
	199	+# Get current version number #
	200	+# ========================== #
	201	+def get_current_version():
	202	+ """
	203	+ Get current version number
	204	+
	205	+ Returns
	206	+ -------
	207	+ version : str
	208	+ Version number
	209	+ """
	210	+ # Initialse version number of empty string
	211	+ version = ''
	212	+
	213	+ # Open configure.ac file
	214	+ f = open('configure.ac', 'r')
	215	+
	216	+ # Read all lines
	217	+ for line in f:
	218	+
	219	+ # Search for pattern
	220	+ if line.startswith('AC_INIT('):
	221	+
	222	+ # Extract version number
	223	+ start = line.find(',')+1
	224	+ stop = line.find(',', start)
	225	+ version = line[start:stop].strip().lstrip('[').rstrip(']')
	226	+
	227	+ # Close file
	228	+ f.close()
	229	+
	230	+ # Return version
	231	+ return version
	232	+
	233	+
	234	+# ========================== #
	235	+# Get libtool version number #
	236	+# ========================== #
	237	+def get_libtool_version():
	238	+ """
	239	+ Get libtools version number
	240	+
	241	+ Returns
	242	+ -------
	243	+ version : str
	244	+ Version number
	245	+ """
	246	+ # Initialse version number of empty string
	247	+ version = ''
	248	+
	249	+ # Open configure.ac file
	250	+ f = open('configure.ac', 'r')
	251	+
	252	+ # Read all lines
	253	+ for line in f:
	254	+
	255	+ # Search for pattern
	256	+ if line.startswith('CTOOLS_LT_VERSION='):
	257	+
	258	+ # Extract version number
	259	+ start = line.find('"')+1
	260	+ stop = line.find('"', start)
	261	+ version = line[start:stop].strip()
	262	+
	263	+ # Close file
	264	+ f.close()
	265	+
	266	+ # Return version
	267	+ return version
	268	+
	269	+
	270	+# =============================================== #
	271	+# Set libtool version number in configure.ac file #
	272	+# =============================================== #
	273	+def set_libtool_version(library=False, added=False, removed=False, changed=False):
	274	+ """
	275	+ Set special version numbers in configure.ac file
	276	+
	277	+ Parameters
	278	+ ----------
	279	+ library : bool, optional
	280	+ Library source code changed
	281	+ added : bool, optional
	282	+ Interfaces added
	283	+ removed : bool, optional
	284	+ Interfaces removed
	285	+ changed : bool, optional
	286	+ Interfaces changed
	287	+ """
	288	+ # Get libtool version number
	289	+ old = get_libtool_version()
	290	+ split = old.split(':')
	291	+
	292	+ # Decompose libtool version number
	293	+ current = int(split[0])
	294	+ revision = int(split[1])
	295	+ age = int(split[2])
	296	+
	297	+ # If the library source code has changed at all since the last update, then
	298	+ # increment revision
	299	+ if library:
	300	+ revision += 1
	301	+
	302	+ # If any interfaces have been added, removed, or changed since the last
	303	+ # update, increment current, and set revision to 0
	304	+ if added or removed or changed:
	305	+ current += 1
	306	+ revision = 0
	307	+
	308	+ # If any interfaces have been added since the last public release, then
	309	+ # increment age
	310	+ if added:
	311	+ age += 1
	312	+
	313	+ # If any interfaces have been removed or changed since the last public
	314	+ # release, then set age to 0
	315	+ if removed or changed:
	316	+ age = 0
	317	+
	318	+ # Build new libtool version number
	319	+ version = '%d:%d:%d' % (current, revision, age)
	320	+
	321	+ # Set libtool version number
	322	+ set_version_in_file('configure.ac', version, old)
	323	+
	324	+ # Return
	325	+ return
	326	+
	327	+
	328	+# ============================== #
	329	+# Set version number in one file #
	330	+# ============================== #
	331	+def set_version_in_file(filename, version, current):
	332	+ """
	333	+ Set version number in one file
	334	+
	335	+ The function replaces all current version numbers in a file by a new
	336	+ version number.
	337	+
	338	+ Parameters
	339	+ ----------
	340	+ filename : str
	341	+ File name
	342	+ version : str
	343	+ New version number
	344	+ current : str
	345	+ Current version number
	346	+ """
	347	+ # Open file in read mode
	348	+ f = open(filename, 'r')
	349	+
	350	+ # Read file content
	351	+ content = f.read()
	352	+
	353	+ # Close file
	354	+ f.close()
	355	+
	356	+ # Replace version number
	357	+ new_content = content.replace(current, version)
	358	+
	359	+ # Open file in write mode
	360	+ f = open(filename, 'w')
	361	+
	362	+ # Write file content
	363	+ f.write(new_content)
	364	+
	365	+ # Close file
	366	+ f.close()
	367	+
	368	+ # Return
	369	+ return
	370	+
	371	+
	372	+# ======================= #
	373	+# Set the package version #
	374	+# ======================= #
	375	+def set_package_version(version):
	376	+ """
	377	+ Set the package version
	378	+
	379	+ Parameters
	380	+ ----------
	381	+ version : str
	382	+ Version number
	383	+ """
	384	+ # List of all files in which the version numbers should be changed. The
	385	+ # file name should include their access paths with respect to the source
	386	+ # directory
	387	+ filenames = ['configure.ac',
	388	+ 'ctools.pc.in',
	389	+ 'README.md',
	390	+ 'sonar-project.properties',
	391	+ 'doc/Doxyfile',
	392	+ 'doc/source/conf.py']
	393	+
	394	+
	395	+ # Get the current package version
	396	+ current = get_current_version()
	397	+
	398	+ # Set versions by loop over all files
	399	+ for filename in filenames:
	400	+ set_version_in_file(filename, version, current)
	401	+
	402	+ # Generate current version number
	403	+ split = current.split('.')
	404	+ cur = '%s.%s' % (split[0], split[1])
	405	+
	406	+ # Generate new version number
	407	+ split = version.split('.')
	408	+ ver = '%s.%s' % (split[0], split[1])
	409	+
	410	+ # Set version number in doc/source/conf.py file
	411	+ set_version_in_file('doc/source/conf.py', ver, cur)
	412	+
	413	+ # Return
	414	+ return
	415	+
	416	+
	417	+# ============= #
	418	+# Build tarball #
	419	+# ============= #
	420	+def build_tarball():
	421	+ """
	422	+ Build tarball using 'make dist'
	423	+ """
	424	+ # Set base path
	425	+ base_path = os.getcwd()
	426	+
	427	+ # Enable/disable logging
	428	+ if confirm("Log actions in logfile?"):
	429	+ verbosity = ' >> %s/make_dist.log 2>&1' % (base_path)
	430	+ os.system('rm -rf make_dist.log >/dev/null 2>&1')
	431	+ else:
	432	+ verbosity = ' >/dev/null 2>&1'
	433	+
	434	+ # Configure package
	435	+ print("Configure package")
	436	+ rc = os.system('./configure%s' % verbosity)
	437	+ if rc == 0:
	438	+ print("Package configuration successful")
	439	+ else:
	440	+ print("*** Failure in package configuration")
	441	+
	442	+ # Check package
	443	+ print("Create tarball")
	444	+ rc = os.system('make dist%s' % verbosity)
	445	+ if rc == 0:
	446	+ print("Tarball creation successful")
	447	+ else:
	448	+ print("*** Failure in creation of tarball")
	449	+
	450	+ # Return
	451	+ return
	452	+
	453	+
	454	+# ============= #
	455	+# Check tarball #
	456	+# ============= #
	457	+def check_tarball():
	458	+ """
	459	+ Check tarball using 'make distcheck'
	460	+
	461	+ Parameters
	462	+ ----------
	463	+ filename : str
	464	+ Tarball file name
	465	+ """
	466	+ # Set base path
	467	+ base_path = os.getcwd()
	468	+
	469	+ # Enable/disable logging
	470	+ if confirm("Log check in logfile?"):
	471	+ verbosity = ' >> %s/make_distcheck.log 2>&1' % (base_path)
	472	+ os.system('rm -rf make_distcheck.log >/dev/null 2>&1')
	473	+ else:
	474	+ verbosity = ' >/dev/null 2>&1'
	475	+
	476	+ # Configure package
	477	+ print("Configure package")
	478	+ rc = os.system('./configure%s' % verbosity)
	479	+ if rc == 0:
	480	+ print("Package configuration successful")
	481	+ else:
	482	+ print("*** Failure in package configuration")
	483	+
	484	+ # Check tarball
	485	+ print("Check tarball")
	486	+ rc = os.system('make distcheck%s' % verbosity)
	487	+ if rc == 0:
	488	+ print("Tarball checking successful")
	489	+ else:
	490	+ print("*** Failure in checking of tarball")
	491	+
	492	+ # Return
	493	+ return
	494	+
	495	+
	496	+# ================ #
	497	+# Manage main menu #
	498	+# ================ #
	499	+def main_menu():
	500	+ """
	501	+ Manage main menu
	502	+ """
	503	+ # Print main menu
	504	+ print('[1] Make a new release')
	505	+ print('[2] Set the package version in current branch')
	506	+ print('[3] Set the libtool version in current branch')
	507	+ print('[4] Commit changes in current branch')
	508	+ print('[5] Create tarball from current branch')
	509	+ print('[6] Check tarball')
	510	+ print('[q] Quit')
	511	+
	512	+ # Wait for the input
	513	+ waiting = True
	514	+ while waiting:
	515	+ choice = str(raw_input('Enter your choice: '))
	516	+ if choice == '1' or choice == '2' or choice == '3' or choice == '4' or \
	517	+ choice == '5' or choice == '6' or choice == 'q':
	518	+ waiting = False
	519	+
	520	+ # Return choice
	521	+ return choice
	522	+
	523	+
	524	+# ====================== #
	525	+# Manage package release #
	526	+# ====================== #
	527	+def release_menu(branch='release'):
	528	+ """
	529	+ Manage package release
	530	+
	531	+ Parameters
	532	+ ----------
	533	+ branch : str, optional
	534	+ Release branch name
	535	+ """
	536	+ # Annonce actions
	537	+ print("")
	538	+ print("Make a new release")
	539	+ print("------------------")
	540	+
	541	+ # Step 1: Create a release branch
	542	+ if confirm("Step 1: Do you want to create a '%s' branch?" % branch):
	543	+ create_git_branch(branch)
	544	+ else:
	545	+ if git_branch_exists(branch):
	546	+ os.system('git checkout %s' % branch)
	547	+ else:
	548	+ requested = branch
	549	+ branch = commands.getoutput('git rev-parse --abbrev-ref HEAD')
	550	+ print("WARNING: No '%s' branch found, continue working on "
	551	+ "current branch '%s'" % (requested, branch))
	552	+
	553	+ # Get current package version
	554	+ current = get_current_version()
	555	+
	556	+ # Step 2: Set package version
	557	+ print("")
	558	+ if confirm("Step 2: Current ctools version is '%s'. Do you want to "
	559	+ "change the package version?" % current):
	560	+ package_version_menu()
	561	+
	562	+ # Get current libtool version
	563	+ current = get_libtool_version()
	564	+
	565	+ # Step 3: Set libtool version
	566	+ print("")
	567	+ if confirm("Step 3: Current Libtool version is '%s'. Do you want to "
	568	+ "change the libtool version?" % current):
	569	+ libtool_version_menu()
	570	+
	571	+ # Step 4: Commit changes
	572	+ print("")
	573	+ if confirm("Step 4: Commit changes?"):
	574	+ package = get_current_version()
	575	+ libtool = get_libtool_version()
	576	+ message = "ctools package version set to '%s' and libtool version "\
	577	+ "set to '%s'" % (package, libtool)
	578	+ commit(message)
	579	+
	580	+ # Step 5: Push branch into git
	581	+ print("")
	582	+ if confirm("Step 5: Push changes?"):
	583	+ os.system('git push origin %s' % branch)
	584	+
	585	+ # Step 6: Build tarball
	586	+ print("")
	587	+ if confirm("Step 6: Build tarball?"):
	588	+ build_tarball()
	589	+
	590	+ # Step 7: Check tarball
	591	+ print("")
	592	+ if confirm("Step 7: Check tarball?"):
	593	+ check_tarball()
	594	+
	595	+ # Print separator
	596	+ print("")
	597	+
	598	+ # Return
	599	+ return
	600	+
	601	+
	602	+# ============================== #
	603	+# Manage package version setting #
	604	+# ============================== #
	605	+def package_version_menu():
	606	+ """
	607	+ Manage package version setting
	608	+ """
	609	+ # Get the current package version
	610	+ current = get_current_version()
	611	+
	612	+ # Looping until the version change is accepted
	613	+ looping = True
	614	+ while looping:
	615	+
	616	+ # Get package version from input
	617	+ waiting = True
	618	+ while waiting:
	619	+ version = str(raw_input("Current ctools version is '%s'. Please "
	620	+ "enter new ctools version: " % current))
	621	+ if version == "q":
	622	+ sys.exit()
	623	+ if check_version(version) == False:
	624	+ print("*** Invalid ctools version. "
	625	+ "Please enter the version in the format x.y.z[.devn]")
	626	+ else:
	627	+ waiting = False
	628	+
	629	+ # If the version number change is confirmed then do the change
	630	+ if confirm("Change version to '%s'?" % version):
	631	+
	632	+ # Set package version
	633	+ set_package_version(version)
	634	+
	635	+ # Get new package and libtool versions
	636	+ version = get_current_version()
	637	+
	638	+ # Inform about version change
	639	+ print("ctools version changed to '%s'" % (version))
	640	+
	641	+ # Signal that we can exit looping
	642	+ looping = False
	643	+
	644	+ # Return
	645	+ return
	646	+
	647	+
	648	+# ============================== #
	649	+# Manage libtool version setting #
	650	+# ============================== #
	651	+def libtool_version_menu():
	652	+ """
	653	+ Manage libtool version setting
	654	+ """
	655	+ # Get current libtool version
	656	+ current = get_libtool_version()
	657	+
	658	+ # Continue only if libtool version should be changed
	659	+ if confirm("Current libtool version is '%s'. Do you want to change the "
	660	+ "version?" % current):
	661	+
	662	+ # Determine package changes
	663	+ library = confirm(" Has the source code changed since last release?")
	664	+ added = confirm(" Have interfaces been added since last release?")
	665	+ removed = confirm(" Have interfaces been removed since last release?")
	666	+ changed = confirm(" Have interfaces changed since last release?")
	667	+
	668	+ # Set libtool version
	669	+ set_libtool_version(library=library, added=added, removed=removed,
	670	+ changed=changed)
	671	+
	672	+ # Get new libtool version
	673	+ version = get_libtool_version()
	674	+
	675	+ # Print new libtool version
	676	+ print("Libtool version changed to '%s'" % version)
	677	+
	678	+ # Return
	679	+ return
	680	+
	681	+
	682	+# ======================== #
	683	+# Main routine entry point #
	684	+# ======================== #
	685	+if __name__ == '__main__':
	686	+
	687	+ # Clear console
	688	+ os.system('clear')
	689	+
	690	+ # Print header
	691	+ print('ctools release manager')
	692	+ print('======================')
	693	+ print('')
	694	+
	695	+ # Enter endless loop
	696	+ while True:
	697	+
	698	+ # Show main menu
	699	+ choice = main_menu()
	700	+
	701	+ # Dispatch according to choice
	702	+ if choice == '1':
	703	+ release_menu()
	704	+ print('')
	705	+ elif choice == '2':
	706	+ package_version_menu()
	707	+ print('')
	708	+ elif choice == '3':
	709	+ libtool_version_menu()
	710	+ print('')
	711	+ elif choice == '4':
	712	+ commit('')
	713	+ print('')
	714	+ elif choice == '5':
	715	+ build_tarball()
	716	+ print('')
	717	+ elif choice == '6':
	718	+ check_tarball()
	719	+ print('')
	720	+ elif choice == 'q':
	721	+ break
	722	+
...	...

dev/set_version.py deleted

View file @cc01022

1		-#! /usr/bin/env python
2		-# ==========================================================================
3		-# Set the version number of the software
4		-#
5		-# Copyright (C) 2016 Juergen Knoedlseder
6		-#
7		-# This program is free software: you can redistribute it and/or modify
8		-# it under the terms of the GNU General Public License as published by
9		-# the Free Software Foundation, either version 3 of the License, or
10		-# (at your option) any later version.
11		-#
12		-# This program is distributed in the hope that it will be useful,
13		-# but WITHOUT ANY WARRANTY; without even the implied warranty of
14		-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15		-# GNU General Public License for more details.
16		-#
17		-# You should have received a copy of the GNU General Public License
18		-# along with this program. If not, see <http://www.gnu.org/licenses/>.
19		-#
20		-# ==========================================================================
21		-import sys
22		-
23		-
24		-# ========================== #
25		-# Get current version number #
26		-# ========================== #
27		-def get_current():
28		- """
29		- Get current version number
30		-
31		- Returns
32		- -------
33		- version : str
34		- Version number
35		- """
36		- # Initialse version number of empty string
37		- version = ''
38		-
39		- # Open configure.ac file
40		- f = open('configure.ac', 'r')
41		-
42		- # Read all lines
43		- for line in f:
44		-
45		- # Search for pattern
46		- if line.startswith('AC_INIT('):
47		-
48		- # Extract version number
49		- start = line.find(',')+1
50		- stop = line.find(',', start)
51		- version = line[start:stop].strip().lstrip('[').rstrip(']')
52		-
53		- # Close file
54		- f.close()
55		-
56		- # Return version
57		- return version
58		-
59		-
60		-# ========================== #
61		-# Get libtool version number #
62		-# ========================== #
63		-def get_libtool():
64		- """
65		- Get libtools version number
66		-
67		- Returns
68		- -------
69		- version : str
70		- Version number
71		- """
72		- # Initialse version number of empty string
73		- version = ''
74		-
75		- # Open configure.ac file
76		- f = open('configure.ac', 'r')
77		-
78		- # Read all lines
79		- for line in f:
80		-
81		- # Search for pattern
82		- if line.startswith('CTOOLS_LT_VERSION='):
83		-
84		- # Extract version number
85		- start = line.find('"')+1
86		- stop = line.find('"', start)
87		- version = line[start:stop].strip()
88		-
89		- # Close file
90		- f.close()
91		-
92		- # Return version
93		- return version
94		-
95		-
96		-# ============================== #
97		-# Set version number in one file #
98		-# ============================== #
99		-def set_version(filename, version, current):
100		- """
101		- Set version number
102		-
103		- Parameters
104		- ----------
105		- filename : str
106		- File name
107		- version : str
108		- Version number
109		- current : str
110		- Current version number
111		- """
112		- # Open file in read mode
113		- f = open(filename, 'r')
114		-
115		- # Read file content
116		- content = f.read()
117		-
118		- # Close file
119		- f.close()
120		-
121		- # Replace version number
122		- new_content = content.replace(current, version)
123		-
124		- # Open file in write mode
125		- f = open(filename, 'w')
126		-
127		- # Write file content
128		- f.write(new_content)
129		-
130		- # Close file
131		- f.close()
132		-
133		- # Return
134		- return
135		-
136		-
137		-# =============================== #
138		-# Set version number in all files #
139		-# =============================== #
140		-def set_versions(version, current):
141		- """
142		- Set version numbers in all files
143		-
144		- Parameters
145		- ----------
146		- version : str
147		- Version number
148		- current : str
149		- Current version number
150		- """
151		- # List of all relevant files, including their access paths from the
152		- # source directory
153		- filenames = ['configure.ac',
154		- 'ctools.pc.in',
155		- 'README.md',
156		- 'sonar-project.properties',
157		- 'doc/Doxyfile',
158		- 'doc/source/conf.py']
159		-
160		- # Set versions by loop over all files
161		- for filename in filenames:
162		- set_version(filename, version, current)
163		-
164		- # Return
165		- return
166		-
167		-
168		-# =============================================== #
169		-# Set libtool version number in configure.ac file #
170		-# =============================================== #
171		-def set_libtool_version(library=False, added=False, removed=False, changed=False):
172		- """
173		- Set special version numbers in configure.ac file
174		-
175		- Parameters
176		- ----------
177		- library : bool, optional
178		- Library source code changed
179		- added : bool, optional
180		- Interfaces added
181		- removed : bool, optional
182		- Interfaces removed
183		- changed : bool, optional
184		- Interfaces changed
185		- """
186		- # Get libtool version number
187		- old = get_libtool()
188		- split = old.split(':')
189		-
190		- # Decompose libtool version number
191		- current = int(split[0])
192		- revision = int(split[1])
193		- age = int(split[2])
194		-
195		- # If the library source code has changed at all since the last update, then
196		- # increment revision
197		- if library:
198		- revision += 1
199		-
200		- # If any interfaces have been added, removed, or changed since the last
201		- # update, increment current, and set revision to 0
202		- if added or removed or changed:
203		- current += 1
204		- revision = 0
205		-
206		- # If any interfaces have been added since the last public release, then
207		- # increment age
208		- if added:
209		- age += 1
210		-
211		- # If any interfaces have been removed or changed since the last public
212		- # release, then set age to 0
213		- if removed or changed:
214		- age = 0
215		-
216		- # Build new libtool version number
217		- version = '%d:%d:%d' % (current, revision, age)
218		-
219		- # Set libtool version number
220		- set_version('configure.ac', version, old)
221		-
222		- # Return
223		- return
224		-
225		-
226		-# ===================================================== #
227		-# Set special version number in doc/source/conf.py file #
228		-# ===================================================== #
229		-def set_special_conf(version, current):
230		- """
231		- Set special version numbers in doc/source/conf.py file
232		-
233		- Parameters
234		- ----------
235		- version : str
236		- Version number
237		- current : str
238		- Current version number
239		- """
240		- # Generate current version number
241		- split = current.split('.')
242		- cur = '%s.%s' % (split[0], split[1])
243		-
244		- # Generate new version number
245		- split = version.split('.')
246		- ver = '%s.%s' % (split[0], split[1])
247		-
248		- # Set version number
249		- set_version('doc/source/conf.py', ver, cur)
250		-
251		- # Return
252		- return
253		-
254		-
255		-# ======================== #
256		-# Main routine entry point #
257		-# ======================== #
258		-if __name__ == '__main__':
259		-
260		- # Check for version number
261		- if len(sys.argv) < 3:
262		- print('Usage: set_version.py version [larc]')
263		- print(' l : source code changed')
264		- print(' a : interface(s) added')
265		- print(' r : interface(s) removed')
266		- print(' c : interface(s) changed')
267		- sys.exit()
268		-
269		- # Extract version number
270		- version = sys.argv[1]
271		-
272		- # Extract code change flags
273		- if len(sys.argv) == 3:
274		- flags = sys.argv[2]
275		-
276		- # Set change flags
277		- library = False
278		- added = False
279		- removed = False
280		- changed = False
281		- if flags.find('l') != -1:
282		- library = True
283		- if flags.find('a') != -1:
284		- added = True
285		- if flags.find('r') != -1:
286		- removed = True
287		- if flags.find('c') != -1:
288		- changed = True
289		-
290		- # Get the current version
291		- current = get_current()
292		-
293		- # Set versions
294		- set_versions(version, current)
295		-
296		- # Set libtool version
297		- set_libtool_version(library=library, added=added, removed=removed,
298		- changed=changed)
299		-
300		- # Set special version number in doc/source/conf.py file
301		- set_special_conf(version, current)
302		-