#!/usr/bin/python # vim: set fileencoding=utf-8 : # # (C) 2010 Guido Guenther # 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 3 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # import gettext from gi.repository import GObject import glib from gi.repository import Gtk from gi.repository import Gdk import locale import logging import os import sys import time import ppm from ppm.modemproxy import (ModemManagerProxy, ModemError) from ppm.provider import Provider from ppm.providerdb import ProviderDB from ppm.accountdb import AccountDB # The controller receives input and initiates a response by making calls on model # objects. A controller accepts input from the user and instructs the model and # view to perform actions based on that input. class PPMController(GObject.GObject): """ @ivar providers: the possible providers @ivar imsi: the imsi if we could fetch it from the modem @ivar account: the account associated with the SIM card @ivar provider: current provider """ __gsignals__ = { # Emitted when we got the new account balance from the provider 'balance-info-changed': (GObject.SignalFlags.RUN_FIRST, None, [object]), # Emitted when the provider changed 'provider-changed': (GObject.SignalFlags.RUN_FIRST, None, [object]), } def _connect_mm_signals(self): self.mm.connect('request-started', self.on_mm_request_started) self.mm.connect('request-finished', self.on_mm_request_finished) def __init__(self): self.__gobject_init__() self.mm = None self.imsi = None self.provider = None self.account = None self.view = None self.providerdb = ProviderDB() self.accountdb = AccountDB() self.connect('provider-changed', self.on_provider_changed) self.connect('balance-info-changed', self.on_balance_info_changed) def fetch_balance(self): """Fetch the current account balance from the network""" if not self.provider.fetch_balance(self.mm, reply_func=self.on_balance_info_fetched, error_func=self.on_modem_error): self.view.show_provider_balance_info_missing(self.provider) logging.error("No idea how to fetch account information for " "%s in %s.", self.provider.name, self.provider.country) def top_up_balance(self): code = self.view.get_top_up_code() if not self.provider.top_up(self.mm, code, reply_func=self.on_balance_topped_up, error_func=self.on_modem_error): self.view.show_provider_top_up_info_missing(self.provider) logging.error("No idea how to top up balance for " "%s in %s.", self.provider.name, self.provider.country) def set_provider(self, provider=None, account=None, country_code=None, name=None): """ Change the current provider to provider and inform the view Input can be a provder, an account or, (name, country_code) Once finished we know how to access account balance, top up, etc. """ if account: name = account.props.name country_code = account.props.code if name and country_code: provider = self.providerdb.get_provider(country_code, name) if not provider: raise Exception("No valid account or provider") self.provider = provider self.emit('provider-changed', provider) def _imsi_to_network_id(self, imsi): """Extract mmc and mnc from imsi""" mcc = imsi[0:3] mnc = imsi[3:5] return (mcc, mnc) def _get_provider_interactive(self, imsi): """ Given the imsi, determine the provider based on that information from providerdb, request user input where ncessary """ mcc, mnc = self._imsi_to_network_id(imsi) self.providers = self.providerdb.get_providers(mcc, mnc) if self.providers: if len(self.providers) > 1: # More than one provider matching mcc/mnc, let user select self.view.show_provider_assistant(self.providers) else: self.set_provider(self.providers[0]) else: self.view.show_provider_unknown(mcc, mnc) def _get_account_from_accountdb(self, imsi): """ Based on the imsi check if we already now all the account details """ self.account = self.accountdb.fetch(imsi) if self.account: self.set_provider(account=self.account) return self.account def init_account_and_provider(self): """Fetch the imsi deduce account and provider information""" try: self.imsi = self.mm.get_imsi() except ModemError as me: logging.warning("Can't get imsi: %s", me.msg) if me.is_forbidden(): self.view.show_provider_assistant() return False if not me.is_disabled(): self.view.show_modem_error(me.msg) return False logging.info("modem not enabled") if self.view.show_modem_enable() != Gtk.ResponseType.YES: return False else: self.mm.modem_enable(reply_func=self.init_account_and_provider) return True try: account = self._get_account_from_accountdb(self.imsi) except: # Fetching account from the DB failed, so start over account = None if account: # Since we have the account in the db we can safely fetch the # provider information from the providerdb self.providerdb.get_provider(self.account.name, self.account.code) else: # Account not known yet, get provider interactively self.account = None self._get_provider_interactive(self.imsi) # Everything worked out, disable the timer. return False def setup(self): logging.debug("Setting up") self.mm = ModemManagerProxy() self._connect_mm_signals() modems = self.mm.get_modems() if modems: modem = modems[0] # FIXME: handle multiple modems logging.debug("Using modem %s" % modem) self.mm.set_modem(modem) GObject.timeout_add(500, self.init_account_and_provider) else: self.view.show_error("No modem found.") self.quit() return False def quit(self): """Clean up""" logging.debug("Quitting...") self.view.close() Gtk.main_quit() def get_provider_countries(self): return self.providerdb.get_countries() def get_provider_providers(self, country_code): return self.providerdb.get_providers_by_code(country_code) def on_mm_request_started(self, obj, mm_proxy): logging.debug("Started modem request: %s", mm_proxy.request) self.view.show_modem_response() def on_mm_request_finished(self, obj, mm_proxy): logging.debug("Finished modem request") self.view.close_modem_response() def on_balance_info_fetched(self, var, user_data): """Callback for succesful MM fetch balance info call""" balance = var.unpack()[0] self.emit('balance-info-changed', balance) def on_balance_topped_up(self, var, user_data): """Callback for succesful MM topup balance call""" reply = var.unpack()[0] self.view.update_top_up_information(reply) def on_modem_error(self, e): self.view.show_modem_error(e.msg) logging.error(e.msg) def on_provider_changed(self, obj, provider): """Act on provider-changed signal""" logging.debug("Provider changed to '%s'", provider.name) self.view.update_provider_name(provider.name) if self.imsi and not self.account: # We have an imsi and the user told us what provider to use: self.account = self.accountdb.add(self.imsi, provider) elif self.account: # Update an existing account with the user provided information self.account.update_provider(provider) if self.account.props.timestamp: self.view.update_account_balance_information( self.account.balance, self.account.timestamp) def on_balance_info_changed(self, obj, balance): """Act on balance-info-changed signal""" logging.debug("Balance info changed") timestamp = time.asctime() if self.account: self.account.update_balance(balance, timestamp) self.view.update_account_balance_information(balance, timestamp) GObject.type_register(PPMController) class PPMObject(object): """Dialog or window constructed via a GtkBuilder""" def __init__(self, view, ui): if view: self.controller = view.controller else: self.controller = None self._load_ui(ui) def _load_ui(self, ui): """Load the user interfade description""" self.builder = Gtk.Builder() self.builder.set_translation_domain(ppm.gettext_app) self.builder.add_from_file(os.path.join(ppm.ui_dir, '%s.ui' % ui)) self.builder.connect_signals(self) def _add_elem(self, name): self.__dict__[name] = self.builder.get_object(name) def _add_elements(self, *args): for name in args: self._add_elem(name) # View class PPMDialog(GObject.GObject, PPMObject): def _init_about_dialog(self): self.about_dialog = Gtk.AboutDialog( authors = ["Guido Günther "], website = "https://honk.sigxcpu.org/piki/projects/ppm/", website_label = _("Website"), comments = _("Manage balance of prepaid GSM SIM cards"), wrap_license = True, version = ppm.version, logo_icon_name = 'ppm', license_type = Gtk.License.GPL_3_0) def _init_subdialogs(self): self.provider_info_missing_dialog = PPMProviderInfoMissingDialog(self) self.provider_assistant = PPMProviderAssistant(self) self.modem_response = PPMModemResponse(self) self._init_about_dialog() def _setup_ui(self): self.dialog = self.builder.get_object("ppm_dialog") self._add_elements("label_balance_provider_name", "label_topup_provider_name", "label_balance_info", "label_balance_timestamp", "label_balance_from", "entry_code", "button_top_up", "label_top_up_reply") self._init_subdialogs() def __init__(self, controller): self.__gobject_init__() PPMObject.__init__(self, None, "ppm") self.controller = controller # Register ourself to the controller self.controller.view = self self._setup_ui() self.dialog.show() def close(self): self.dialog.hide() self.dialog.destroy() def get_top_up_code(self): return self.entry_code.get_text().strip() def on_close_clicked(self, dummy): self.controller.quit() def on_delete(self, event, dummy): self.controller.quit() return False def on_balance_top_up_clicked(self, dummy): self.clear_top_up_information() self.controller.top_up_balance() def on_about_activated(self, dummy): self.about_dialog.run() self.about_dialog.hide() def on_balance_info_renew_clicked(self, dummy): self.controller.fetch_balance() def on_provider_change_clicked(self, dummy): # FIXME: allow to select provider # and communicate the change to the controller raise NotImplementedError def on_entry_code_insert(self, *args): if self.entry_code.get_text(): self.button_top_up.set_sensitive(True) else: self.button_top_up.set_sensitive(False) def update_provider_name(self, provider_name): self.label_balance_provider_name.set_text(provider_name) self.label_topup_provider_name.set_text(provider_name) def update_account_balance_information(self, balance_text, timestamp): self.label_balance_info.set_text(balance_text) self.label_balance_timestamp.set_text(timestamp) self.label_balance_timestamp.show() self.label_balance_from.show() def update_top_up_information(self, reply): self.label_top_up_reply.set_text(reply) def clear_top_up_information(self): self.label_top_up_reply.set_text("") def show_provider_balance_info_missing(self, provider): self.provider_info_missing_dialog.balance_info_missing(provider) def show_provider_top_up_info_missing(self, provider): self.provider_info_missing_dialog.top_up_info_missing(provider) def show_provider_unknown(self, mcc, mnc): self.provider_info_missing_dialog.provider_unknown(mcc, mnc) def show_modem_error(self, msg): dialog = Gtk.MessageDialog(parent=self.dialog, flags=Gtk.DialogFlags.MODAL | Gtk.DialogFlags.DESTROY_WITH_PARENT, message_type=Gtk.MessageType.ERROR, buttons=Gtk.ButtonsType.OK) dialog.set_markup("Modem error: %s" % msg) dialog.run() dialog.hide() def show_modem_enable(self): """Show dialog that asks if we should enable the modem""" dialog = Gtk.MessageDialog(parent=self.dialog, flags=Gtk.DialogFlags.MODAL | Gtk.DialogFlags.DESTROY_WITH_PARENT, message_type=Gtk.MessageType.QUESTION, buttons=Gtk.ButtonsType.YES_NO) dialog.set_markup(_("Enable Modem?")) ret = dialog.run() dialog.hide() return ret def show_provider_assistant(self, providers=None): self.provider_assistant.show(providers) def show_error(self, msg): """show generic error""" logging.debug(msg) error = Gtk.MessageDialog(parent=self.dialog, flags=Gtk.DialogFlags.MODAL | Gtk.DialogFlags.DESTROY_WITH_PARENT, message_type=Gtk.MessageType.ERROR, buttons=Gtk.ButtonsType.OK) error.set_markup(msg) error.run() error.hide() def show_modem_response(self): self.modem_response.show() def close_modem_response(self): self.modem_response.close() GObject.type_register(PPMDialog) class PPMProviderAssistant(PPMObject): PAGE_INTRO, PAGE_COUNTRIES, PAGE_PROVIDERS, PAGE_CONFIRM = range(0, 4) def __init__(self, main_dialog): PPMObject.__init__(self, main_dialog, "ppm-provider-assistant") self.assistant = self.builder.get_object("ppm_provider_assistant") self._add_elements("vbox_countries", "treeview_countries", "vbox_providers", "treeview_providers", "liststore_providers", "label_country", "label_provider") self.assistant.set_transient_for(main_dialog.dialog) self.liststore_countries = None self.country_code = None self.provider = None self.possible_providers = None def _get_current_country_from_locale(self): (l, enc) = locale.getlocale() code = l.lower().split('_')[0] logging.debug("Assuming your in country %s" % code) return code def _select_country_row(self, iter): path = self.liststore_countries.get_path(iter) treeselection = self.treeview_countries.get_selection() treeselection.select_path(path) self.treeview_countries.scroll_to_cell(path) self.assistant.set_page_complete(self.vbox_countries, True) def _fill_liststore_countries(self): """Fille the countries liststore with all known countries""" lcode = self._get_current_country_from_locale() if not self.liststore_countries: self.liststore_countries = self.builder.get_object( "liststore_countries") for (country, code) in self.controller.get_provider_countries(): if country is None: country = code iter = self.liststore_countries.append() self.liststore_countries.set_value(iter, 0, country) self.liststore_countries.set_value(iter, 1, code) if code == lcode: self.country_code = code self._select_country_row(iter) def _providers_only_page_func(self, current_page, user_data): if current_page < self.PAGE_PROVIDERS: return self.PAGE_PROVIDERS else: return current_page+1 def _all_pages_func(self, current_page, user_data): return current_page+1 def show(self, providers=None): self.possible_providers = providers self.provider = None if not self.possible_providers: # No list of possible providers so allow to select the country first self._fill_liststore_countries() self.assistant.set_forward_page_func(self._all_pages_func, None) else: # List of possible providers given, all from the same country self.country_code = self.possible_providers[0].country self.assistant.set_forward_page_func(self._providers_only_page_func, None) self.assistant.show() def close(self): self.assistant.hide() def on_ppm_provider_assistant_cancel(self, obj): logging.debug("Assistant canceled.") self.close() def _fill_provider_liststore_by_country_code(self, country_code): self.liststore_providers.clear() for provider in self.controller.get_provider_providers(country_code): iter = self.liststore_providers.append() self.liststore_providers.set_value(iter, 0, provider) def _fill_provider_liststore_by_providers(self): self.liststore_providers.clear() for provider in self.possible_providers: iter = self.liststore_providers.append() self.liststore_providers.set_value(iter, 0, provider.name) def on_ppm_provider_assistant_prepare(self, obj, page): if self.assistant.get_current_page() == self.PAGE_PROVIDERS: if self.possible_providers: self._fill_provider_liststore_by_providers() else: self._fill_provider_liststore_by_country_code(self.country_code) elif self.assistant.get_current_page() == self.PAGE_CONFIRM: self.label_country.set_text(self.country_code) self.label_provider.set_text(self.provider) def on_treeview_countries_changed(self, obj): self.assistant.set_page_complete(self.vbox_countries, True) selection = self.treeview_countries.get_selection() (model, iter) = selection.get_selected() if not iter: return self.country_code = model.get_value(iter, 1) def on_treeview_providers_changed(self, obj): self.assistant.set_page_complete(self.vbox_providers, True) selection = self.treeview_providers.get_selection() (model, iter) = selection.get_selected() if not iter: return self.provider = model.get_value(iter, 0) def on_ppm_provider_assistant_close(self, obj): logging.debug("Selected: %s %s", self.provider, self.country_code) self.close() self.controller.set_provider(name=self.provider, country_code=self.country_code) class PPMProviderInfoMissingDialog(object): """ If information about the provider is missing redirect the user to a webpage that explains howto provide that information """ wiki_url = ('GNOME Wiki') def __init__(self, main_dialog): self.dialog = Gtk.MessageDialog(parent=main_dialog.dialog, flags=Gtk.DialogFlags.MODAL | Gtk.DialogFlags.DESTROY_WITH_PARENT, message_type=Gtk.MessageType.INFO, buttons=Gtk.ButtonsType.OK) self.messages = { 'balance_info_missing': _("We can't find the information on how to query the " "account balance from your provider '%s' in our database."), 'top_up_info_missing': _("We can't find the information on how to top up the " "balance for your provider '%s' in our database."), 'provider_unknown': _("We can't find any information about your provider with " "mcc '%s' and mnc '%s'.") } self.common_msg = _("\n\nYou can go to the %s to learn how to provide that " "information.") def _run(self, msg): msg += self.common_msg % self.wiki_url self.dialog.set_markup(msg) self.dialog.run() self.dialog.hide() def balance_info_missing(self, provider): msg = self.messages['balance_info_missing'] % provider.name self._run(msg) def top_up_info_missing(self, provider): msg = self.messages['top_up_info_missing'] % provider.name self._run(msg) def provider_unknown(self, mcc, mnc): msg = self.messages['provider_unknown'] % (mcc, mnc) self._run(msg) class PPMModemResponse(PPMObject): """Dialog shown while waiting for a response from the modem""" def __init__(self, main_dialog): PPMObject.__init__(self, main_dialog, "ppm-modem-request") self.dialog = self.builder.get_object("ppm_modem_request") self._add_elements("progressbar") self.dialog.set_transient_for(main_dialog.dialog) self.timer = None def show(self): self.timer = GObject.timeout_add(50, self.do_progress, priority=glib.PRIORITY_HIGH) self.dialog.show() def close(self): if self.timer: GObject.source_remove(self.timer) self.timer = None self.dialog.hide() def do_progress(self): self.progressbar.pulse() return True def setup_i18n(): locale.setlocale(locale.LC_ALL, '') gettext.install(ppm.gettext_app, ppm.gettext_dir) gettext.bindtextdomain(ppm.gettext_app, ppm.gettext_dir) locale.bindtextdomain(ppm.gettext_app, ppm.gettext_dir) _ = gettext.gettext logging.debug('Using locale: %s', locale.getlocale()) def setup_schemas(): """If we're running from the source tree add our gsettings schema to the list of schema dirs""" schema_dir = 'data' schema = os.path.join(schema_dir, "%s.gschema.xml" % AccountDB.PPM_GSETTINGS_ID) if os.path.exists(schema): logging.debug("Running from source tree, adding local schema dir '%s'" % schema_dir) os.environ["GSETTINGS_SCHEMA_DIR"] = "data" def setup_prgname(): """Set the prgname since gnome-shell is application based""" glib.set_prgname(ppm.prgname) Gdk.set_program_class(ppm.prgname) glib.set_application_name(_("Prepaid Manager")) def main(args): parser = glib.option.OptionParser() parser.add_option("--debug", "-d", action="store_true", dest="debug", help="enable debugging", default=False) options, args = parser.parse_args() if options.debug: log_level = logging.DEBUG else: log_level = logging.INFO logging.basicConfig(level=log_level, format='ppm: %(levelname)s: %(message)s') setup_i18n() setup_prgname() setup_schemas() controller = PPMController() main_dialog = PPMDialog(controller) GObject.timeout_add(1, controller.setup) Gtk.main() if __name__ == "__main__": try: main(sys.argv) except KeyboardInterrupt: logging.debug("Received KeyboardInterrupt. Exiting application.") except SystemExit: raise