add functions to menu buttons, move table code, change gps method to make more acturate
[gigfinder] / gig_finder.py
index 9557319..e49f0ea 100644 (file)
@@ -5,7 +5,7 @@
 Intended for use on the N900, uses the devices gps to find local gigs.
 """
 
-__author__ = "Jon Staley"
+__authors__ = ["Jon Staley"]
 __copyright__ = "Copyright 2010 Jon Staley"
 __license__ = "MIT"
 __version__ = "0.0.1"
@@ -19,6 +19,8 @@ import hildon
 import location
 import time
 import gobject
+from threading import Thread
+import thread
 
 gtk.gdk.threads_init()
 
@@ -97,7 +99,7 @@ class LocationUpdater:
         self.loop = gobject.MainLoop()
 
         self.control = location.GPSDControl.get_default()
-        self.control.set_properties(preferred_method=location.METHOD_USER_SELECTED,
+        self.control.set_properties(preferred_method=location.METHOD_GNSS,
                                preferred_interval=location.INTERVAL_DEFAULT)
         self.control.connect("error-verbose", self.on_error, self.loop)
         self.control.connect("gpsd-stopped", self.on_stop, self.loop)
@@ -107,30 +109,41 @@ class LocationUpdater:
 
     def update_location(self):
         """ Run the loop and update lat and long """
-        self.device.reset_last_known()
+        self.reset()
         gobject.idle_add(self.start_location, self.control)
         self.loop.run()
 
     def on_error(self, control, error, data):
+        """ Handle errors """
         print "location error: %d... quitting" % error
         data.quit()
 
     def on_changed(self, device, data):
+        """ Set long and lat """
         if not device:
             return
         if device.fix:
+            # once fix is found and long, lat available set long lat
             if device.fix[1] & location.GPS_DEVICE_LATLONG_SET:
                 self.lat, self.long = device.fix[4:6]
                 data.stop()
 
     def on_stop(self, control, data):
+        """ Stop the location service """
         print "quitting"
         data.quit()
 
     def start_location(self, data):
+        """ Start the location service """
         data.start()
         return False
 
+    def reset(self):
+        """ Reset coordinates """
+        self.lat = None
+        self.long = None
+        self.device.reset_last_known()
+
 class GigFinder:
 
     def __init__(self):
@@ -139,50 +152,95 @@ class GigFinder:
         self.url_base = "http://ws.audioscrobbler.com/2.0/"
         self.api_key = "1928a14bdf51369505530949d8b7e1ee"
         self.distance = '10'
-
-        program = hildon.Program.get_instance()
+        self.banner = None
+        self.parser = GigParser()
+        self.location = LocationUpdater()
         self.win = hildon.StackableWindow()
-        self.win.set_title('Gig Finder')
-        self.win.connect("destroy", gtk.main_quit, None)
+        self.app_title = "Gig Finder"
+        # TODO: Add preferences for distance, refactor gui code, maybe do km
+        # to mile conversions
 
-        pannable_area = hildon.PannableArea()
-
-        self.table = gtk.Table(columns=1)
-        self.table.set_row_spacings(10)
-        self.table.set_col_spacings(10)
-
-        pannable_area.add_with_viewport(self.table)
+    def main(self):
+        """ Build the gui and start the update thread """
+        program = hildon.Program.get_instance()
+        menu = self.create_menu()
 
-        self.win.add(pannable_area)
+        self.win.set_title(self.app_title)
+        self.win.connect("destroy", gtk.main_quit, None)
+        self.win.set_app_menu(menu)
 
-        # TODO: threaded??
-        self.location_updater = LocationUpdater()
-        self.location_updater.update_location()
-        gobject.idle_add(self.update_gigs)
+        Thread(target=self.update_gigs).start()
 
-    def main(self):
         self.win.show_all()
         gtk.main()
 
+    def show_about(self, widget, data):
+        """ Show about dialog """
+        dialog = gtk.AboutDialog()
+        dialog.set_name('Gig Finder')
+        dialog.set_version(__version__)
+        dialog.set_authors(__authors__)
+        dialog.set_comments('Display gigs close by.\nUsing the http://www.last.fm api.')
+        dialog.set_license('Distributed under the MIT license.\nhttp://www.opensource.org/licenses/mit-license.php')
+        dialog.set_copyright(__copyright__)
+        dialog.show_all()
+
+    def update(self, widget, data):
+        """ Start update process """
+        self.win.set_title(self.app_title)
+        self.location.reset()
+        self.win.remove(self.pannable_area)
+        Thread(target=self.update_gigs).start()
+
     def update_gigs(self):
         """ Get gig info """
-        hildon.hildon_gtk_window_set_progress_indicator(self.win, 1)
+        gobject.idle_add(self.show_message, "Getting events")
+        gobject.idle_add(self.location.update_location)
 
         # if no gps fix wait
-        while not location.GPS_DEVICE_LATLONG_SET:
+        while not self.location.lat or not self.location.long:
             time.sleep(1)
 
-        xml = self.get_xml()
-        parser = GigParser()
-        events = parser.parse_xml(xml, self.location_updater.lat,
-                self.location_updater.long)
-        events = self.sort_gigs(events)
-        self.win.set_title('Gig Finder (%s)' % len(events))
-        self.add_events(events)
+        events = self.get_events(self.location.lat, self.location.long)
+        gobject.idle_add(self.hide_message)
+        gobject.idle_add(self.show_events, events)
+        thread.exit()
+
+    def show_message(self, message):
+        """ Set window progress indicator and show message """
+        hildon.hildon_gtk_window_set_progress_indicator(self.win, 1)
+        self.banner = hildon.hildon_banner_show_information(self.win,
+                                                            '', 
+                                                            message)
+
+    def hide_message(self):
+        """ Hide banner and sete progress indicator """
+        self.banner.hide()
         hildon.hildon_gtk_window_set_progress_indicator(self.win, 0)
 
+    def get_events(self, lat, long):
+        """ Retrieve xml and parse into events list """
+        xml = self.get_xml(lat, long)
+        events = self.parser.parse_xml(xml, 
+                                       lat,
+                                       long)
+        return events
+
+    def show_events(self, events):
+        """ Sort events, set new window title and add events to table """
+        if events:
+            events = self.sort_gigs(events)
+            self.win.set_title('%s (%s)' % (self.app_title, len(events)))
+            self.add_events(events)
+        else:
+            label = gtk.Label('No events available')
+            vbox = gtk.VBox(False, 0)
+            vbox.pack_start(label, True, True, 0)
+            vbox.show_all()
+            self.win.add(vbox)
+
     def distance_cmp(self, x, y):
-        """ compare distances for list sort """
+        """ Compare distances for list sort """
         if x > y:
             return 1
         elif x == y:
@@ -191,21 +249,40 @@ class GigFinder:
             return -1
 
     def sort_gigs(self, events):
-        """ sort gig by distance """
+        """ Sort gig by distance """
         events.sort(cmp=self.distance_cmp, key=lambda x: x['distance'])
         return events
         
-    def get_xml(self):
+    def get_xml(self, lat, long):
         """ Return xml from lastfm """
         method = "geo.getevents"
         params = urllib.urlencode({'method': method,
                                    'api_key': self.api_key,
                                    'distance': self.distance,
-                                   'long': self.location_updater.long,
-                                   'lat': self.location_updater.lat})
+                                   'long': long,
+                                   'lat': lat})
         response = urllib.urlopen(self.url_base, params)
         return response.read()
 
+    def create_menu(self):
+        """ Build application menu """
+        update_button = hildon.GtkButton(gtk.HILDON_SIZE_AUTO)
+        update_button.set_label('Update')
+        update_button.connect('clicked',
+                              self.update,
+                              None)
+
+        about_button = hildon.GtkButton(gtk.HILDON_SIZE_AUTO)
+        about_button.set_label('About')
+        about_button.connect('clicked',
+                             self.show_about,
+                             None)
+
+        menu = hildon.AppMenu()
+        menu.append(update_button)
+        menu.append(about_button)
+        menu.show_all()
+        return menu
 
     def show_details(self, widget, data):
         """ Open new window showing gig details """
@@ -233,9 +310,21 @@ class GigFinder:
         scroll.add_with_viewport(view)
 
         win.show_all()
+
+    def add_table(self):
+        """ Add table for events """
+        self.table = gtk.Table(columns=1)
+        self.table.set_row_spacings(10)
+        self.table.set_col_spacings(10)
+
+        self.pannable_area = hildon.PannableArea()
+        self.pannable_area.add_with_viewport(self.table)
+        self.pannable_area.show_all()
+        self.win.add(self.pannable_area)
         
     def add_events(self, events):
-        """ Return table of buttons """
+        """ Add a table of buttons """
+        self.add_table()
         pos = 0
         for event in events:
             button = hildon.Button(gtk.HILDON_SIZE_AUTO_WIDTH | gtk.HILDON_SIZE_FINGER_HEIGHT, 
@@ -245,10 +334,6 @@ class GigFinder:
             self.table.attach(button, 0, 1, pos, pos+1)
             pos += 1
         self.table.show_all()
-
-    #banner = hildon.hildon_banner_show_information(win,
-    #                                               "Updating", 
-    #                                               "Retrieving gig info")
    
 if __name__ == "__main__":
     finder = GigFinder()