examples: add SMS sender in python

configure.ac

@@ -375,6 +375,7 @@ cli/Makefile
 examples/Makefile
 examples/modem-watcher-python/Makefile
 examples/modem-watcher-javascript/Makefile
+examples/sms-python/Makefile
 ])
 AC_OUTPUT
 

examples/Makefile.am

@@ -1 +1 @@
-SUBDIRS = modem-watcher-python modem-watcher-javascript
+SUBDIRS = modem-watcher-python modem-watcher-javascript sms-python

examples/sms-python/Makefile.am

@@ -0,0 +1,4 @@
+
+EXTRA_DIST = \
+	sms-python \
+	$(NULL)

examples/sms-python/README

@@ -0,0 +1,20 @@
+
+The sms-python program makes use of the 'libmm-glib' library through
+GObject Introspection to talk to ModemManager.
+
+The program will:
+ * Detect whether ModemManager is found in the bus
+ * Prepare SMS properties object with the provided Number and Text.
+ * Loop through each modem found in the system, and for each:
+   ** Create a SMS
+   ** Send the SMS
+
+The output will look like this:
+
+$ ./sms-python "+1234567890" "hello there, how are you?"
+/org/freedesktop/ModemManager1/Modem/0: sms sent
+
+Note that the program requires ModemManager and libmm-glib to be installed in
+the system and the introspection typelibs available in the standard paths.
+
+Have fun!

examples/sms-python/sms-python

@@ -0,0 +1,51 @@
+#!/usr/bin/env python
+# -*- Mode: python; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
+#
+# This program is free software; you can redistribute it and/or modify it under
+# the terms of the GNU Lesser 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 Lesser General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Lesser 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 (C) 2016 Aleksander Morgado <aleksander@aleksander.es>
+#
+
+import sys, signal, gi
+
+gi.require_version('ModemManager', '1.0')
+from gi.repository import GLib, GObject, Gio, ModemManager
+
+if __name__ == "__main__":
+
+    # Process input arguments
+    if len(sys.argv) != 3:
+        sys.stderr.write('error: wrong number of arguments\n')
+        sys.stdout.write('usage: sms-python <NUMBER> <TEXT>\n')
+        sys.exit(1)
+
+    # Prepare SMS properties
+    sms_properties = ModemManager.SmsProperties.new ()
+    sms_properties.set_number(sys.argv[1])
+    sms_properties.set_text(sys.argv[2])
+
+    # Connection to ModemManager
+    connection = Gio.bus_get_sync (Gio.BusType.SYSTEM, None)
+    manager = ModemManager.Manager.new_sync (connection, Gio.DBusObjectManagerClientFlags.DO_NOT_AUTO_START, None)
+    if manager.get_name_owner() is None:
+        sys.stderr.write('ModemManager not found in bus')
+        sys.exit(2)
+
+    # Iterate modems and send SMS with each
+    for obj in manager.get_objects():
+        messaging = obj.get_modem_messaging()
+        sms = messaging.create_sync(sms_properties)
+        sms.send_sync()
+        print('%s: sms sent' % messaging.get_object_path())