examples: add python/gi example nm-connection-update-stable-id.py

The example script touches the stable-id of a connection.
It does so blocking autoconnect, and was originally written
to test that functionality.

Makefile.examples

@@ -173,6 +173,7 @@ EXTRA_DIST += \
 	examples/python/gi/get-active-connections.py \
 	examples/python/gi/get_ips.py \
 	examples/python/gi/list-connections.py \
+	examples/python/gi/nm-connection-update-stable-id.py \
 	examples/python/gi/setting-user-data.py \
 	examples/python/gi/show-wifi-networks.py \
 	examples/python/gi/update-ip4-method.py \

examples/python/gi/nm-connection-update-stable-id.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python
+# -*- Mode: Python; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
+# vim: ft=python ts=4 sts=4 sw=4 et ai
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# Copyright 2017 Red Hat, Inc.
+#
+
+#
+# This example updates a connection's stable-id by appending -#number.
+
+import sys
+import re
+
+import gi
+gi.require_version('NM', '1.0')
+from gi.repository import GLib, NM
+
+def usage():
+    print('Usage: %s [[id] <id>]' % (sys.argv[0]))
+    print('       %s [[uuid] <uuid>]' % (sys.argv[0]))
+    return 1
+
+def find_connection(nm_client, arg_type, arg_id):
+    for c in nm_client.get_connections():
+        if arg_type in [None, 'id'] and c.get_id() == arg_id:
+            return c
+        if arg_type in [None, 'uuid'] and c.get_uuid() == arg_id:
+            return c
+
+def main():
+    if len(sys.argv) < 2 or len(sys.argv) > 3:
+        return usage()
+    if len(sys.argv) == 3:
+        arg_type = sys.argv[1]
+        arg_id = sys.argv[2]
+        if arg_type not in ['id', 'uuid']:
+            return usage()
+    else:
+        arg_type = None
+        arg_id = sys.argv[1]
+    arg_log = '%s"%s"' % ((' with %s ' % (arg_type)) if arg_type else '', arg_id)
+
+    main_loop = GLib.MainLoop()
+
+    nm_client = NM.Client.new(None)
+
+    con = find_connection(nm_client, arg_type, arg_id)
+    if con is None:
+        print('could not find a connection %s' % (arg_log))
+        return 1
+
+    s_con = con.get_setting_connection()
+    if s_con is None:
+        print('connection %s has no [connection] setting' % (arg_log))
+        return 1
+
+    arg_log = '"%s" (%s)' % (s_con.get_id(), s_con.get_uuid())
+
+    stable_id = s_con.get_stable_id()
+    if not stable_id:
+        print('connection %s has no stable-id set' % (arg_log))
+        return 1
+
+    re_match = re.search('\A(.*)-([0-9]+)\Z', stable_id)
+    if not re_match:
+        stable_id = stable_id + '-1'
+    else:
+        stable_id = re_match.group(1) + '-' + str(int(re_match.group(2)) + 1)
+
+    con2 = NM.SimpleConnection.new_clone(con)
+    s_con = con2.get_setting_connection()
+    s_con.set_property(NM.SETTING_CONNECTION_STABLE_ID, stable_id)
+
+    result = {}
+    def _update2_cb(con, async_result, user_data):
+        try:
+            r = con.update2_finish(async_result)
+        except Exception as e:
+            result['error'] = e
+        else:
+            result['result'] = r
+        main_loop.quit()
+
+    con.update2(con2.to_dbus(NM.ConnectionSerializationFlags.ALL),
+                NM.SettingsUpdate2Flags.BLOCK_AUTOCONNECT,
+                None,
+                None,
+                _update2_cb,
+                None)
+
+    main_loop.run()
+
+    if 'error' in result:
+        print('update connection %s failed: %s' % (arg_log, result['error']))
+        return 1
+
+    print('update connection %s succeeded: %s' % (arg_log, result['result']))
+    print('set stable-id to "%s"' % (stable_id))
+    return 0
+
+if __name__ == '__main__':
+    sys.exit(main())