wicd-gtk 1.7.4+tb2-1 / usr / share / wicd / gtk / wicd-client.py

#!/usr/bin/env python

""" wicd - wireless connection daemon frontend implementation

This module implements a usermode frontend for wicd.  It updates connection
information, provides an (optional) tray icon, and allows for launching of
the wicd GUI and Wired Profile Chooser.

class TrayIcon() -- Parent class of TrayIconGUI and IconConnectionInfo.
    class TrayConnectionInfo() -- Child class of TrayIcon which provides
        and updates connection status.
    class TrayIconGUI() -- Child class of TrayIcon which implements the tray.
        icon itself.  Parent class of StatusTrayIconGUI and EggTrayIconGUI.
    class IndicatorTrayIconGUI() -- Implements the tray icon using appindicator.Indicator.
    class StatusTrayIconGUI() -- Implements the tray icon using a
                                 gtk.StatusIcon.
    class EggTrayIconGUI() -- Implements the tray icon using egg.trayicon.
    def usage() -- Prints usage information.
    def main() -- Runs the wicd frontend main loop.

"""

#
#   Copyright (C) 2007 - 2009 Adam Blackburn
#   Copyright (C) 2007 - 2009 Dan O'Reilly
#
#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License Version 2 as
#   published by the Free Software Foundation.
#
#   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, see <http://www.gnu.org/licenses/>.
#

import sys
import gtk
import gobject
import getopt
import os
import pango
import atexit
from dbus import DBusException

import pygtk
pygtk.require('2.0')

USE_APP_INDICATOR = True
try:
    import appindicator
except ImportError:
    USE_APP_INDICATOR = False

HAS_NOTIFY = True
try:
    import pynotify
    if not pynotify.init("Wicd"):
        HAS_NOTIFY = False
except ImportError:
    HAS_NOTIFY = False

# Wicd specific imports
from wicd import wpath
from wicd import misc
from wicd import dbusmanager
import gui
from guiutil import error, can_use_notify

from wicd.translations import _

ICON_AVAIL = True
USE_EGG = False
# Import egg.trayicon if we're using an older gtk version
if not hasattr(gtk, "StatusIcon"):
    try:
        import egg.trayicon
        USE_EGG = True
    except ImportError:
        print 'Unable to load tray icon: Missing both egg.trayicon and ' + \
            'gtk.StatusIcon modules.'
        ICON_AVAIL = False

misc.RenameProcess("wicd-client")

if __name__ == '__main__':
    wpath.chdir(__file__)

daemon = wireless = wired = lost_dbus_id = None
DBUS_AVAIL = False

theme = gtk.icon_theme_get_default()
theme.append_search_path(wpath.images)


def catchdbus(func):
    """ Decorator to catch DBus exceptions. """
    def wrapper(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except DBusException, e:
            if e.get_dbus_name() is not None and \
              "DBus.Error.AccessDenied" in e.get_dbus_name():
                error(
                    None,
                    _('Unable to contact the Wicd daemon due to an access '
                    'denied error from DBus. Please check that your user is '
                    'in the $A group.').
                    replace("$A", "<b>" + wpath.wicd_group + "</b>")
                )
                #raise
                raise DBusException(e)
            else:
                print "warning: ignoring exception %s" % e
            return None
    wrapper.__name__ = func.__name__
    wrapper.__module__ = func.__module__
    wrapper.__dict__ = func.__dict__
    wrapper.__doc__ = func.__doc__
    return wrapper


class NetworkMenuItem(gtk.ImageMenuItem):
    """ Network menu item. """
    def __init__(self, lbl, is_active=False):
        gtk.ImageMenuItem.__init__(self)
        self.label = gtk.Label(lbl)
        if is_active:
            atrlist = pango.AttrList()
            atrlist.insert(pango.AttrWeight(pango.WEIGHT_BOLD, 0, 50))
            self.label.set_attributes(atrlist)
        self.label.set_justify(gtk.JUSTIFY_LEFT)
        self.label.set_alignment(0, 0)
        self.add(self.label)
        self.label.show()


class TrayIcon(object):
    """ Base Tray Icon class.

    Base Class for implementing a tray icon to display network status.

    """
    def __init__(self, animate, displaytray=True, displayapp=False):
        self.cur_sndbytes = -1
        self.cur_rcvbytes = -1
        self.last_sndbytes = -1
        self.last_rcvbytes = -1
        self.max_snd_gain = 10000
        self.max_rcv_gain = 10000

        if USE_APP_INDICATOR:
            self.tr = self.IndicatorTrayIconGUI(self)
        elif USE_EGG:
            self.tr = self.EggTrayIconGUI(self)
        else:
            self.tr = self.StatusTrayIconGUI(self)
        if displayapp:
            self.tr.toggle_wicd_gui()
        self.icon_info = self.TrayConnectionInfo(self, self.tr, animate)
        self.tr.icon_info = self.icon_info
        print 'displaytray %s' % displaytray
        self.tr.visible(displaytray)

    def is_embedded(self):
        if USE_EGG:
            raise NotImplementedError()
        else:
            return self.tr.is_embedded()  # pylint: disable-msg=E1103

    def get_bandwidth_bytes(self):
        """ Gets the amount of byte sent sine the last time I checked """
        dev_dir = '/sys/class/net/'
        iface = daemon.GetCurrentInterface()

        for fldr in os.listdir(dev_dir):
            if fldr == iface:
                dev_dir = dev_dir + fldr + "/statistics/"
                break

        try:
            self.cur_rcvbytes = int(
                open(dev_dir + "rx_bytes", "r").read().strip())
            self.cur_sndbytes = int(
                open(dev_dir + "tx_bytes", "r").read().strip())
        except (IOError, OSError, ValueError):
            self.cur_sndbytes = -1
            self.cur_rcvbytes = -1

    class TrayConnectionInfo(object):
        """ Class for updating the tray icon status. """
        def __init__(self, parent, tr, animate=True):
            """ Initialize variables needed for the icon status methods. """
            self.last_strength = -2
            self.still_wired = False
            self.network = ''
            self.tried_reconnect = False
            self.connection_lost_counter = 0
            self.tr = tr
            self.last_sndbytes = -1
            self.last_rcvbytes = -1
            self.max_snd_gain = 10000
            self.max_rcv_gain = 10000
            self.animate = animate

            self.parent = parent

            self.network_name = ''          # SSID
            self.network_type = 'none'      # Wired/Wireless/None
            self.network_str = ''           # Signal Strength
            self.network_addr = '0.0.0.0'   # IP Address
            self.network_br = ''            # Bitrate

            # keep track of the last state to provide appropriate
            # notifications
            self._last_bubble = None
            self.last_state = None
            self.should_notify = True

            if DBUS_AVAIL:
                self.update_tray_icon()
            else:
                handle_no_dbus()
                self.set_not_connected_state()

            # Initial update of the tooltip
            self.update_tooltip()

        def update_tooltip(self):
            """
            Updates the trayicon tooltip based on current connection status
            """
            if (self.network_type == "none"):
                self.tr.set_tooltip(_('Not connected'))
            elif (self.network_type == "wireless"):
                self.tr.set_tooltip(_('Connected to $A at $B (IP: $C)')
                        .replace('$A', self.network_name)
                        .replace('$B', self.network_str)
                        .replace('$C', self.network_addr))
            elif (self.network_type == "wired"):
                self.tr.set_tooltip(_('Connected to wired network (IP: $A)')
                        .replace('$A', self.network_addr))
            elif (self.network_type == "killswitch"):
                self.tr.set_tooltip(_('Not connected') + "(" +
                        _('Wireless Kill Switch Enabled') + ")")
            elif (self.network_type == "no_daemon"):
                self.tr.set_tooltip(_('Wicd daemon unreachable'))

            return True

        def _show_notification(self, title, details, image=None):
            if self.should_notify:
                try:
                    if not self._last_bubble:
                        self._last_bubble = pynotify.Notification(
                            title, details, image)
                        self._last_bubble.show()
                    else:
                        self._last_bubble.clear_actions()
                        self._last_bubble.clear_hints()
                        self._last_bubble.update(title, details, image)
                        self._last_bubble.show()
                except Exception, e:
                    if hasattr(e, 'message') and e.message != '':
                        msg = e.message
                    elif hasattr(e, 'args') and len(e.args) > 0:
                        msg = e.args[-1]
                    else:
                        msg = str(e)
                    print "Exception during notification: %s" % msg

                self.should_notify = False

        @catchdbus
        def wired_profile_chooser(self):
            """ Launch the wired profile chooser. """
            gui.WiredProfileChooser()
            daemon.SetNeedWiredProfileChooser(False)

        def set_wired_state(self, info):
            """ Sets the icon info for a wired state. """
            wired_ip = info[0]
            self.network_addr = str(info[0])
            self.network_type = "wired"
            self.tr.set_from_name('wired')
            #status_string = _('Connected to wired network (IP: $A)'). \
            #    replace('$A',wired_ip)
            #self.tr.set_tooltip(status_string)
            self._show_notification(_('Wired Network'),
                                    _('Connection established'),
                                    'network-wired')

            self.update_tooltip()

        @catchdbus
        def set_wireless_state(self, info):
            """ Sets the icon info for a wireless state. """
            lock = ''
            wireless_ip = info[0]
            self.network = info[1]
            strength = info[2]
            cur_net_id = int(info[3])
            sig_string = daemon.FormatSignalForPrinting(str(strength))
            self.network_type = "wireless"
            self.network_addr = str(info[0])
            self.network_name = info[1]
            self.network_str = sig_string
            self.network_br = info[4]
            self.set_signal_image(int(info[2]), lock)

            if wireless.GetWirelessProperty(cur_net_id, "encryption"):
                lock = "-lock"
            # status_string = (_('Connected to $A at $B (IP: $C)')
            #.replace('$A', self.network)
            #                    .replace('$B', sig_string)
            #                    .replace('$C', str(wireless_ip)))
            #self.tr.set_tooltip(status_string)
            self.set_signal_image(int(strength), lock)
            self._show_notification(self.network,
                                    _('Connection established'),
                                    'network-wireless')

            self.update_tooltip()

        def set_connecting_state(self, info):
            """ Sets the icon info for a connecting state. """
            wired = False
            if info[0] == 'wired' and len(info) == 1:
                cur_network = _('Wired Network')
                wired = True
            else:
                cur_network = info[1]
            status_string = _('Connecting') + " to " + \
                                cur_network + "..."
            self.update_tooltip()
            # self.tr.set_tooltip(status_string)
            self.tr.set_from_name('no-signal')
            if wired:
                self._show_notification(cur_network,
                                        _('Establishing connection...'),
                                        'network-wired')
            else:
                self._show_notification(cur_network,
                                        _('Establishing connection...'),
                                        'network-wireless')

        @catchdbus
        def set_not_connected_state(self, info=None):
            """ Set the icon info for the not connected state. """
            self.tr.set_from_name('no-signal')
            if not DBUS_AVAIL:
                status = _('Wicd daemon unreachable')
            elif wireless.GetKillSwitchEnabled():
                status = (_('Not connected') + " (" +
                         _('Wireless Kill Switch Enabled') + ")")
            else:
                status = _('Not connected')
            # self.tr.set_tooltip(status)
            self._show_notification(_('Disconnected'), None, 'stop')
            self.update_tooltip()

        @catchdbus
        def update_tray_icon(self, state=None, info=None):
            """ Updates the tray icon and current connection status. """
            if not DBUS_AVAIL:
                return False

            if not state or not info:
                [state, info] = daemon.GetConnectionStatus()

            # should this state change display a notification?
            self.should_notify = (can_use_notify() and
                                  self.last_state != state)

            self.last_state = state

            if state == misc.WIRED:
                self.set_wired_state(info)
            elif state == misc.WIRELESS:
                self.set_wireless_state(info)
            elif state == misc.CONNECTING:
                self.set_connecting_state(info)
            elif state in (misc.SUSPENDED, misc.NOT_CONNECTED):
                self.set_not_connected_state(info)
            else:
                print 'Invalid state returned!!!'
                return False
            return True

        @catchdbus
        def set_signal_image(self, wireless_signal, lock):
            """ Sets the tray icon image for an active wireless connection. """
            if self.animate:
                TrayIcon.get_bandwidth_bytes(self.parent)
                prefix = self.get_bandwidth_activity()
            else:
                prefix = 'idle-'
            if daemon.GetSignalDisplayType() == 0:
                if wireless_signal > 75:
                    signal_img = "high-signal"
                elif wireless_signal > 50:
                    signal_img = "good-signal"
                elif wireless_signal > 25:
                    signal_img = "low-signal"
                else:
                    signal_img = "bad-signal"
            else:
                if wireless_signal >= -60:
                    signal_img = "high-signal"
                elif wireless_signal >= -70:
                    signal_img = "good-signal"
                elif wireless_signal >= -80:
                    signal_img = "low-signal"
                else:
                    signal_img = "bad-signal"
            img_name = ''.join([prefix, signal_img, lock])
            self.tr.set_from_name(img_name)

        @catchdbus
        def get_bandwidth_activity(self):
            """ Determines what network activity state we are in. """
            transmitting = False
            receiving = False

            dev_dir = '/sys/class/net/'
            wiface = daemon.GetWirelessInterface()
            for fldr in os.listdir(dev_dir):
                if fldr == wiface:
                    dev_dir = dev_dir + fldr + "/statistics/"
                    break
            try:
                rcvbytes = int(open(dev_dir + "rx_bytes", "r").read().strip())
                sndbytes = int(open(dev_dir + "tx_bytes", "r").read().strip())
            except IOError:
                sndbytes = None
                rcvbytes = None

            if not rcvbytes or not sndbytes:
                return 'idle-'

            # Figure out receiving data info.
            activity = self.is_network_active(self.parent.cur_rcvbytes,
                                              self.parent.max_rcv_gain,
                                              self.parent.last_rcvbytes)
            receiving = activity[0]
            self.parent.max_rcv_gain = activity[1]
            self.parent.last_rcvbytes = activity[2]

            # Figure out out transmitting data info.
            activity = self.is_network_active(self.parent.cur_sndbytes,
                                              self.parent.max_snd_gain,
                                              self.parent.last_sndbytes)
            transmitting = activity[0]
            self.parent.max_snd_gain = activity[1]
            self.parent.last_sndbytes = activity[2]

            if transmitting and receiving:
                return 'both-'
            elif transmitting:
                return 'transmitting-'
            elif receiving:
                return 'receiving-'
            else:
                return 'idle-'

        def is_network_active(self, bytes, max_gain, last_bytes):
            """ Determines if a network is active.

            Determines if a network is active by looking at the
            number of bytes sent since the previous check.  This method
            is generic, and can be used to determine activity in both
            the sending and receiving directions.

            Returns:
            A tuple containing three elements:
            1) a boolean specifying if the network is active.
            2) an int specifying the maximum gain the network has had.
            3) an int specifying the last recorded number of bytes sent.

            """
            active = False
            if last_bytes == -1:
                last_bytes = bytes
            elif bytes > (last_bytes + float(max_gain / 20.0)):
                last_bytes = bytes
                active = True

                gain = bytes - last_bytes
                if gain > max_gain:
                    max_gain = gain
            return (active, max_gain, last_bytes)

    class TrayIconGUI(object):
        """ Base Tray Icon UI class.

        Implements methods and variables used by both egg/StatusIcon
        tray icons.

        """
        def __init__(self, parent):
            self.list = []
            self.label = None
            self.data = None

            menu = """
                    <ui>
                        <menubar name="Menubar">
                            <menu action="Menu">
                                <menu action="Connect">
                                </menu>
                                <separator/>
                                <menuitem action="Info"/>
                                <menuitem action="Quit"/>
                            </menu>
                        </menubar>
                    </ui>
            """
            actions = [
                    ('Menu', None, 'Menu'),
                    ('Connect', gtk.STOCK_CONNECT, _('Connect')),
                    ('Info', gtk.STOCK_INFO, _('_Connection Info'), None,
                        _('Information about the current connection'),
                        self.on_conn_info),
                    ('Quit', gtk.STOCK_QUIT, _('_Quit'), None,
                        _('Quit wicd-tray-icon'), self.on_quit),
                    ]
            actg = gtk.ActionGroup('Actions')
            actg.add_actions(actions)
            self.manager = gtk.UIManager()
            self.manager.insert_action_group(actg, 0)
            self.manager.add_ui_from_string(menu)
            self.menu = (self.manager.get_widget('/Menubar/Menu/Quit').
                                                                  props.parent)
            self.gui_win = None
            self.current_icon_name = None
            self._is_scanning = False
            net_menuitem = self.manager.get_widget("/Menubar/Menu/Connect/")
            if not USE_APP_INDICATOR:
                net_menuitem.connect("activate", self.on_net_menu_activate)

            self.parent = parent
            self.time = 2           # Time between updates
            self.cont = 'Stop'
            self.conn_info_txt = ''

        def tray_scan_started(self):
            """ Callback for when a wireless scan is started. """
            if not DBUS_AVAIL:
                return
            self._is_scanning = True
            self.init_network_menu()

        def tray_scan_ended(self):
            """ Callback for when a wireless scan finishes. """
            if not DBUS_AVAIL:
                return
            self._is_scanning = False
            self.populate_network_menu()

        def on_activate(self, data=None):
            """ Opens the wicd GUI. """
            if DBUS_AVAIL:
                self.toggle_wicd_gui()
            else:
                #error(None,
                    #_('The wicd daemon is unavailable, so your request '
                    # 'cannot be completed'))
                pass

        def on_quit(self, widget=None):
            """ Closes the tray icon. """
            sys.exit(0)

        def on_about(self, data=None):
            """ Opens the About Dialog. """
            dialog = gtk.AboutDialog()
            dialog.set_name('Wicd Tray Icon')
            dialog.set_version('2.0')
            dialog.set_comments('An icon that shows your network connectivity')
            dialog.set_website('http://launchpad.net/wicd')
            dialog.run()
            dialog.destroy()

        def on_conn_info(self, data=None):
            """ Opens the Connection Information Dialog """
            window = gtk.Dialog(
                "Wicd Connection Info",
                None,
                0,
                (gtk.STOCK_OK, gtk.RESPONSE_CLOSE)
            )

            # Create labels
            self.label = gtk.Label()
            self.data = gtk.Label()
            self.data.set_selectable(True)
            self.label.show()
            self.data.show()
            self.list = []
            self.list.append(self.data)
            self.list.append(self.label)

            # Setup table
            table = gtk.Table(1, 2)
            table.set_col_spacings(12)
            table.attach(self.label, 0, 1, 0, 1)
            table.attach(self.data, 1, 2, 0, 1)

            # Setup Window
            content = window.get_content_area()
            content.pack_start(table, True, True, 0)
            content.show_all()

            # Start updates
            self.cont = 'Go'
            gobject.timeout_add(5000, self.update_conn_info_win, self.list)
            self.update_conn_info_win(self.list)

            window.run()

            # Destroy window and stop updates
            window.destroy()
            self.cont = 'Stop'

        def update_conn_info_win(self, l):
            """ Updates the information in the connection summary window """
            if (self.cont == "Stop"):
                return False

            [state, info] = daemon.GetConnectionStatus()
            [rx, tx] = self.get_current_bandwidth()

            # Choose info for the data
            if state == misc.WIRED:
                text = (_('''$A
$B KB/s
$C KB/s''')
                        .replace('$A', str(info[0]))    # IP
                        .replace('$B', str(rx))         # RX
                        .replace('$C', str(tx)))        # TX
            elif state == misc.WIRELESS:
                text = (_('''$A
$B
$C
$D
$E KB/s
$F KB/s''')
                        .replace('$A', str(info[1]))    # SSID
                        .replace('$B', str(info[4]))    # Speed
                        .replace('$C', str(info[0]))    # IP
                        .replace('$D',
                                daemon.FormatSignalForPrinting(str(info[2])))
                        .replace('$E', str(rx))
                        .replace('$F', str(tx)))
            else:
                text = ''

            # Choose info for the labels
            self.list[0].set_text('\n' + text)
            if state == misc.WIRED:
                self.list[1].set_text(_('''Wired
IP:
RX:
TX:'''))
            elif state == misc.WIRELESS:
                self.list[1].set_text(_('''Wireless
SSID:
Speed:
IP:
Strength:
RX:
TX:'''))
            elif state == misc.CONNECTING:
                self.list[1].set_text(_('Connecting'))
            elif state in (misc.SUSPENDED, misc.NOT_CONNECTED):
                self.list[1].set_text(_('Disconnected'))

            return True

        def get_current_bandwidth(self):
            """
            Calculates the current bandwidth based on sent/received bytes
            divided over time. Unit is in KB/s
            """
            self.parent.get_bandwidth_bytes()
            rxb = self.parent.cur_rcvbytes - self.parent.last_rcvbytes
            txb = self.parent.cur_sndbytes - self.parent.last_sndbytes

            self.parent.last_rcvbytes = self.parent.cur_rcvbytes
            self.parent.last_sndbytes = self.parent.cur_sndbytes

            rx_rate = float(rxb / (self.time * 1024))
            tx_rate = float(txb / (self.time * 1024))

            return (rx_rate, tx_rate)

        def _add_item_to_menu(self, net_menu, lbl, type_, n_id, is_connecting,
                              is_active):
            """ Add an item to the network list submenu. """
            def network_selected(widget, net_type, net_id):
                """ Callback method for a menu item selection. """
                if net_type == "__wired__":
                    wired.ConnectWired()
                else:
                    wireless.ConnectWireless(net_id)

            item = NetworkMenuItem(lbl, is_active)
            image = gtk.Image()

            if type_ == "__wired__":
                image.set_from_icon_name("network-wired",
                    gtk.ICON_SIZE_SMALL_TOOLBAR)
            else:
                image.set_from_icon_name(self._get_img(n_id),
                    gtk.ICON_SIZE_SMALL_TOOLBAR)
            item.set_image(image)
            del image
            item.connect("activate", network_selected, type_, n_id)
            net_menu.append(item)
            item.show()
            if is_connecting:
                item.set_sensitive(False)
            del item

        @catchdbus
        def _get_img(self, net_id):
            """ Determines which image to use for the wireless entries. """
            def fix_strength(val, default):
                """ Assigns given strength to a default value if needed. """
                return val and int(val) or default

            def get_prop(prop):
                return wireless.GetWirelessProperty(net_id, prop)

            strength = fix_strength(get_prop("quality"), -1)
            dbm_strength = fix_strength(get_prop('strength'), -100)

            if daemon.GetWPADriver() == 'ralink legacy' or \
               daemon.GetSignalDisplayType() == 1:
                if dbm_strength >= -60:
                    signal_img = 'signal-100'
                elif dbm_strength >= -70:
                    signal_img = 'signal-75'
                elif dbm_strength >= -80:
                    signal_img = 'signal-50'
                else:
                    signal_img = 'signal-25'
            else:
                if strength > 75:
                    signal_img = 'signal-100'
                elif strength > 50:
                    signal_img = 'signal-75'
                elif strength > 25:
                    signal_img = 'signal-50'
                else:
                    signal_img = 'signal-25'
            return signal_img

        @catchdbus
        def on_net_menu_activate(self, item):
            """ Trigger a background scan to populate the network menu.

            Called when the network submenu is moused over.  We
            sleep briefly, clear pending gtk events, and if
            we're still being moused over we trigger a scan.
            This is to prevent scans when the user is just
            mousing past the menu to select another menu item.

            """
            def dummy(x=None):
                pass

            if self._is_scanning:
                return True

            self.init_network_menu()
            gobject.timeout_add(800, self._trigger_scan_if_needed, item)

        @catchdbus
        def _trigger_scan_if_needed(self, item):
            """ Trigger a scan if the network menu is being hovered over. """
            while gtk.events_pending():
                gtk.main_iteration()
            if item.state != gtk.STATE_PRELIGHT:
                return True
            wireless.Scan(False)
            return False

        @catchdbus
        def populate_network_menu(self, data=None):
            """ Populates the network list submenu. """
            def get_prop(net_id, prop):
                return wireless.GetWirelessProperty(net_id, prop)

            net_menuitem = self.manager.get_widget("/Menubar/Menu/Connect/")
            submenu = net_menuitem.get_submenu()
            self._clear_menu(submenu)
            if not DBUS_AVAIL:
                net_menuitem.show()
                return

            is_connecting = daemon.CheckIfConnecting()
            num_networks = wireless.GetNumberOfNetworks()
            [status, info] = daemon.GetConnectionStatus()

            if daemon.GetAlwaysShowWiredInterface() or \
               wired.CheckPluggedIn():
                if status == misc.WIRED:
                    is_active = True
                else:
                    is_active = False
                self._add_item_to_menu(submenu, "Wired Network", "__wired__", 0,
                                       is_connecting, is_active)
                sep = gtk.SeparatorMenuItem()
                submenu.append(sep)
                sep.show()

            if num_networks > 0:
                skip_never_connect = not daemon.GetShowNeverConnect()
                for x in xrange(0, num_networks):
                    if skip_never_connect and \
                      misc.to_bool(get_prop(x,"never")):
                        continue
                    essid = get_prop(x, "essid")
                    if status == misc.WIRELESS and info[1] == essid:
                        is_active = True
                    else:
                        is_active = False
                    self._add_item_to_menu(submenu, essid, "wifi", x,
                                           is_connecting, is_active)
            else:
                no_nets_item = gtk.MenuItem(_('No wireless networks found.'))
                no_nets_item.set_sensitive(False)
                no_nets_item.show()
                submenu.append(no_nets_item)

            submenu.reposition()
            net_menuitem.show()

        def init_network_menu(self):
            """ Set the right-click network menu to the scanning state. """
            net_menuitem = self.manager.get_widget("/Menubar/Menu/Connect/")
            submenu = net_menuitem.get_submenu()
            self._clear_menu(submenu)

            loading_item = gtk.MenuItem(_('Scanning') + "...")
            loading_item.set_sensitive(False)
            loading_item.show()
            submenu.append(loading_item)
            net_menuitem.show()

        def _clear_menu(self, menu):
            """ Clear the right-click menu. """
            for item in menu.get_children():
                menu.remove(item)
                item.destroy()

        def toggle_wicd_gui(self):
            """ Toggles the wicd GUI. """
            if not self.gui_win:
                self.gui_win = gui.appGui(tray=self)
            elif not self.gui_win.is_visible:
                self.gui_win.show_win()
            else:
                self.gui_win.exit()
                return True

    if USE_EGG:
        class EggTrayIconGUI(TrayIconGUI):
            """ Tray Icon for gtk < 2.10.

            Uses the deprecated egg.trayicon module to implement the tray icon.
            Since it relies on a deprecated module, this class is only used
            for machines running versions of GTK < 2.10.

            """
            def __init__(self, parent):
                """Initializes the tray icon"""
                TrayIcon.TrayIconGUI.__init__(self, parent)
                self.tooltip = gtk.Tooltips()
                self.eb = gtk.EventBox()
                self.tray = egg.trayicon.TrayIcon("WicdTrayIcon")
                self.pic = gtk.Image()
                self.tooltip.set_tip(self.eb, "Initializing wicd...")
                self.pic.set_from_name('no-signal')

                self.eb.connect('button_press_event', self.tray_clicked)
                self.eb.add(self.pic)
                self.tray.add(self.eb)
                self.tray.show_all()

            def tray_clicked(self, widget, event):
                """ Handles tray mouse click events. """
                if event.button == 1:
                    self.toggle_wicd_gui()
                elif event.button == 3:
                    self.init_network_menu()
                    self.menu.popup(None, None, None, event.button, event.time)

            def set_from_file(self, val=None):
                """ Calls set_from_file on the gtk.Image for the tray icon. """
                self.pic.set_from_file(
                    os.path.join(
                        wpath.images, 'hicolor/22x22/status/%s.png' % val
                    )
                )

            def set_tooltip(self, val):
                """ Set the tooltip for this tray icon.

                Sets the tooltip for the gtk.ToolTips associated with this
                tray icon.

                """
                self.tooltip.set_tip(self.eb, val)

            def visible(self, val):
                """ Set if the icon is visible or not.

                If val is True, makes the icon visible, if val is False,
                hides the tray icon.

                """
                if val:
                    self.tray.show_all()
                else:
                    self.tray.hide_all()

    if hasattr(gtk, "StatusIcon"):
        class StatusTrayIconGUI(gtk.StatusIcon, TrayIconGUI):
            """ Class for creating the wicd tray icon on gtk > 2.10.

            Uses gtk.StatusIcon to implement a tray icon.

            """
            def __init__(self, parent):
                TrayIcon.TrayIconGUI.__init__(self, parent)
                gtk.StatusIcon.__init__(self)

                self.current_icon_name = ''
                self.set_visible(True)
                self.connect('activate', self.on_activate)
                self.connect('popup-menu', self.on_popup_menu)
                self.set_from_name('no-signal')
                self.set_tooltip("Initializing wicd...")

            def on_popup_menu(self, status, button, timestamp):
                """ Opens the right click menu for the tray icon. """
                self.init_network_menu()
                self.menu.popup(None, None, gtk.status_icon_position_menu,
                    button, timestamp, self)

            def set_from_name(self, name=None):
                """ Sets a new tray icon picture. """
                if name != self.current_icon_name:
                    self.current_icon_name = name
                    gtk.StatusIcon.set_from_icon_name(self, name)

            def visible(self, val):
                """ Set if the icon is visible or not.

                If val is True, makes the icon visible, if val is False,
                hides the tray icon.

                """
                self.set_visible(val)

    if USE_APP_INDICATOR:
        class IndicatorTrayIconGUI(gtk.StatusIcon, TrayIconGUI):
            """ Class for creating the wicd AppIndicator.
            This is required on recent versions of Unity (>=13.04).
            
            Uses appindicator.Indicator to implement a tray icon.
            
            """
            def __init__(self, parent):
                TrayIcon.TrayIconGUI.__init__(self, parent)
                self.ind = appindicator.Indicator(
                    "wicd", "wicd-gtk", appindicator.CATEGORY_SYSTEM_SERVICES, wpath.images)
                self.current_icon_name = ''

                # Rescaning when hovering over the net_menu doesn't work.
                # (AFAICT, AppIndicator menus don't report PRELIGHT status.)
                # We use a separate menu item instead.
                rescan = gtk.MenuItem("Rescan")
                self.menu.prepend(rescan)
                rescan.connect("activate", self.on_rescan)
                rescan.show()

                sep = gtk.SeparatorMenuItem()
                self.menu.prepend(sep)
                sep.show()

                # AppIndicator does not support tooltips so we use a
                # menu item to contain what was the tooltip.
                #
                # Also, since AppIndicator does not support actions on
                # clicking the tray icon, we use this tooltip menu
                # item to toggle the GUI
                self.tooltip_item = gtk.MenuItem("Initializing wicd...")
                self.menu.prepend(self.tooltip_item)
                self.tooltip_item.connect("activate", self.on_activate)
                self.tooltip_item.show()

                self.ind.set_menu(self.menu)

            def on_rescan(self, *data):
                """ Triggers a network rescan that updates the 'Connect' menu when the 'Rescan' menu item is selected. """
                self.init_network_menu()
                wireless.Scan(False)

            def set_from_file(self, path=None):
                """ Sets a new tray icon picture. """
                if path != self.current_icon_path:
                    self.current_icon_path = path
                    self.ind.set_icon(path)
                    
            def set_from_name(self, name=None):
                """ Sets a new tray icon picture. """
                if name != self.current_icon_name:
                    self.current_icon_name = name
                    self.ind.set_icon(name)

            def visible(self, val):
                """ Set if the icon is visible or not.

                If val is True, makes the icon visible, if val is False,
                hides the tray icon.

                """
                self.ind.set_status(val and appindicator.STATUS_ACTIVE or appindicator.STATUS_PASSIVE)

            def set_tooltip(self, str):
                """ Set the tooltip for this tray icon.
                
                Since AppIndicators do not support tooltips, actually
                sets the label for the top menu item associated with
                this tray icon.

                """
                self.tooltip_item.set_label(str)


def usage():
    """ Print usage information. """
    print """
wicd %s
wireless (and wired) connection daemon front-end.

Arguments:
\t-t\t--tray\tRun the wicd tray icon only.
\t-n\t--no-tray\tRun wicd without the tray icon.
\t-h\t--help\t\tPrint this help information.
\t-a\t--no-animate\tRun the tray without network traffic tray animations.
\t-o\t--only-notifications\tDon't display anything except notifications.
""" % wpath.version


def setup_dbus(force=True):
    """ Initialize DBus. """
    global daemon, wireless, wired, DBUS_AVAIL, lost_dbus_id
    print "Connecting to daemon..."
    try:
        dbusmanager.connect_to_dbus()
    except DBusException:
        if force:
            print "Can't connect to the daemon, trying to start it " + \
                "automatically..."
            misc.PromptToStartDaemon()
            try:
                dbusmanager.connect_to_dbus()
            except DBusException:
                error(None,
                    _("Could not connect to wicd's D-Bus interface. Check "
                    "the wicd log for error messages.")
                )
                return False
        else:
            return False

    if lost_dbus_id:
        gobject.source_remove(lost_dbus_id)
        lost_dbus_id = None
    dbus_ifaces = dbusmanager.get_dbus_ifaces()
    daemon = dbus_ifaces['daemon']
    wireless = dbus_ifaces['wireless']
    wired = dbus_ifaces['wired']
    DBUS_AVAIL = True
    print "Connected."
    return True


def on_exit():
    """ Handle GUI exit. """
    if DBUS_AVAIL:
        try:
            daemon.SetGUIOpen(False)
        except DBusException:
            pass


def handle_no_dbus():
    """ Called when dbus announces its shutting down. """
    global DBUS_AVAIL, lost_dbus_id
    DBUS_AVAIL = False
    gui.handle_no_dbus(from_tray=True)
    print "Wicd daemon is shutting down!"
    lost_dbus_id = misc.timeout_add(5,
        lambda: error(None,
            _('The wicd daemon has shut down. The UI will not function '
            'properly until it is restarted.'),
            block=False
        )
    )
    return False


@catchdbus
def main(argv):
    """ The main frontend program.

    Keyword arguments:
    argv -- The arguments passed to the script.

    """
    try:
        opts, args = getopt.getopt(
            sys.argv[1:],
            'tnhao',
            ['help', 'no-tray', 'tray', 'no-animate', 'only-notifications']
        )
    except getopt.GetoptError:
        # Print help information and exit
        usage()
        sys.exit(2)

    use_tray = True
    animate = True
    display_app = True
    for opt, a in opts:
        if opt in ('-h', '--help'):
            usage()
            sys.exit(0)
        elif opt in ('-t', '--tray'):
            display_app = False
        elif opt in ('-n', '--no-tray'):
            use_tray = False
        elif opt in ('-a', '--no-animate'):
            animate = False
        elif opt in ('-o', '--only-notifications'):
            print "only displaying notifications"
            use_tray = False
            display_app = False
        else:
            usage()
            sys.exit(2)

    print 'Loading...'
    setup_dbus()
    atexit.register(on_exit)

    if display_app and not use_tray or not ICON_AVAIL:
        gui.appGui(standalone=True)
        mainloop = gobject.MainLoop()
        mainloop.run()
        sys.exit(0)

    # Set up the tray icon GUI and backend
    tray_icon = TrayIcon(animate, displaytray=use_tray, displayapp=display_app)

    # Check to see if wired profile chooser was called before icon
    # was launched (typically happens on startup or daemon restart).
    if DBUS_AVAIL and daemon.GetNeedWiredProfileChooser():
        daemon.SetNeedWiredProfileChooser(False)
        tray_icon.icon_info.wired_profile_chooser()

    bus = dbusmanager.get_bus()
    bus.add_signal_receiver(tray_icon.icon_info.wired_profile_chooser,
                            'LaunchChooser', 'org.wicd.daemon')
    bus.add_signal_receiver(tray_icon.icon_info.update_tray_icon,
                            'StatusChanged', 'org.wicd.daemon')
    bus.add_signal_receiver(tray_icon.tr.tray_scan_ended, 'SendEndScanSignal',
                            'org.wicd.daemon.wireless')
    bus.add_signal_receiver(tray_icon.tr.tray_scan_started,
                            'SendStartScanSignal', 'org.wicd.daemon.wireless')
    bus.add_signal_receiver(
        lambda: (
            handle_no_dbus() or tray_icon.icon_info.set_not_connected_state()
        ),
        "DaemonClosing",
        'org.wicd.daemon'
    )
    bus.add_signal_receiver(lambda: setup_dbus(force=False), "DaemonStarting",
                            "org.wicd.daemon")
    print 'Done loading.'
    mainloop = gobject.MainLoop()
    mainloop.run()


if __name__ == '__main__':
    main(sys.argv)