Merge lp:~ahayzen/music-app/add-url-dispatcher-tests into lp:music-app/trusty

[Andrew Hayzen]

* Add tests for url-dispatcher
* Fix for depends and allow autopkg support
* Fix for recent item added even with a bad url

* Add tests for url-dispatcher
* Fix for depends and allow autopkg support
* Fix for recent item added even with a bad url

TESTING:
This should be tested on device in the following way...

Install the new click package:
$ bzr branch lp:~andrew-hayzen/music-app/add-url-dispatcher-tests /tmp/add-dispatcher-tests
$ cd /tmp/add-dispatcher-tests
$ click-buddy --dir . --provision

To just run the changed tests:
$ ADT_AUTOPILOT_MODULE="-v music_app.tests.test_music.TestMainWindow.test_url_dispatcher_album_play" adt-run /tmp/add-dispatcher-tests --click com.ubuntu.music --- ssh -s adb
$ ADT_AUTOPILOT_MODULE="-v music_app.tests.test_music.TestMainWindow.test_url_dispatcher_music_play" adt-run /tmp/add-dispatcher-tests --click com.ubuntu.music --- ssh -s adb

To run all tests:
$ adt-run /tmp/add-dispatcher-tests --click com.ubuntu.music --- ssh -s adb

Note you need a newer adt if you are on trusty see instructions for install of autopkgtest here [0]

0 - http://www.theorangenotebook.com/2014/09/autopilot-test-runners.html

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:619
http://91.189.93.70:8080/job/music-app-ci/1111/
Executed test runs:
    FAILURE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/257/console
    FAILURE: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/335/console

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1111/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

620. By Andrew Hayzen on 2014-09-09

* Move dispatcher to helper

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:620
http://91.189.93.70:8080/job/music-app-ci/1112/
Executed test runs:
    FAILURE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/261/console
    FAILURE: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/336/console

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1112/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

621. By Andrew Hayzen on 2014-09-09

* Merge of trunk

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:621
http://91.189.93.70:8080/job/music-app-ci/1113/
Executed test runs:
    FAILURE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/262/console
    FAILURE: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/337/console

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1113/rebuild

review: Needs Fixing (continuous-integration)

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:621
http://91.189.93.70:8080/job/music-app-ci/1114/
Executed test runs:
    UNSTABLE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/269
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/269/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/338

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1114/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

622. By Andrew Hayzen on 2014-09-09

* Fix for use of old artistName

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:622
http://91.189.93.70:8080/job/music-app-ci/1115/
Executed test runs:
    UNSTABLE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/271
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/271/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/339

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1115/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

623. By Andrew Hayzen on 2014-09-09

* Fix for unicode errors
* Jenkins debug

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:623
http://91.189.93.70:8080/job/music-app-ci/1116/
Executed test runs:
    UNSTABLE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/272
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/272/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/340

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1116/rebuild

review: Needs Fixing (continuous-integration)

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:623
http://91.189.93.70:8080/job/music-app-ci/1117/
Executed test runs:
    UNSTABLE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/273
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/273/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/341

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1117/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

624. By Andrew Hayzen on 2014-09-09

* Ensure url-dispatcher has started before calling it

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:624
http://91.189.93.70:8080/job/music-app-ci/1118/
Executed test runs:
    FAILURE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/274/console
    FAILURE: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/342/console

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1118/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

625. By Andrew Hayzen on 2014-09-09

* Pep8 fix

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:625
http://91.189.93.70:8080/job/music-app-ci/1119/
Executed test runs:
    UNSTABLE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/275
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/275/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/343

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1119/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

626. By Andrew Hayzen on 2014-09-10

* Only run tests when in click environment

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:626
http://91.189.93.70:8080/job/music-app-ci/1121/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/278
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/278/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/345

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1121/rebuild

review: Approve (continuous-integration)

[Leo Arias (elopio)]

Some inline comments.

[Andrew Hayzen (ahayzen)]

#blocked as you cannot test due to bug 1370800

I've started resolving the comments, but we really need to fix ^^ bug first, otherwise you can't test if these works.

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

627. By Andrew Hayzen on 2014-09-16

* Various fixes for url-dispatcher

628. By Andrew Hayzen on 2014-09-23

* Merge of trunk

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

FAILED: Continuous integration, rev:628
http://91.189.93.70:8080/job/music-app-ci/1135/
Executed test runs:
    FAILURE: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/503/console
    FAILURE: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/359/console

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1135/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

629. By Andrew Hayzen on 2014-09-23

* Fixes for pep8

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:629
http://91.189.93.70:8080/job/music-app-ci/1136/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/504
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/504/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/360

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1136/rebuild

review: Approve (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

630. By Andrew Hayzen on 2014-09-23

* Remove code comments

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:630
http://91.189.93.70:8080/job/music-app-ci/1137/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/505
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/505/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/361

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1137/rebuild

review: Approve (continuous-integration)

[Leo Arias (elopio)]

Some pita comments inline. This is pretty good, thanks Andrew.

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

631. By Andrew Hayzen on 2014-09-24

* Various fixes

[Andrew Hayzen (ahayzen)]

I would like to land this after this [0] has landed so blocking myself for a bit.

0 - https://code.launchpad.net/~andrew-hayzen/music-app/ap-mocking-fixes/+merge/235821

review: Needs Fixing

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:631
http://91.189.93.70:8080/job/music-app-ci/1139/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/524
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/524/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/363

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1139/rebuild

review: Approve (continuous-integration)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

632. By Andrew Hayzen on 2014-09-25

* Merge of trunk

[Andrew Hayzen (ahayzen)]

Unblocking myself as the other mp has landed.

review: Abstain

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:632
http://91.189.93.70:8080/job/music-app-ci/1142/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/538
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/538/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/366

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1142/rebuild

review: Approve (continuous-integration)

[Leo Arias (elopio)]

ahayzen_: as you added the decorator to the url dispatcher call, you don't need
235 + logger.debug("Calling URL Dispatcher - " + path)
elopio, ah yes good spot ;)
ahayzen_: and last pita comment, pep8 recommends to capitalize all the letter of an abbreviation.
so URLDispatcher instead of UrlDispatcher.
elopio, ah yes ok i'll do that
ahayzen_: I'm really happy with your python code. I don't know much about the QML code, so it would be safer if you get somebody to review that part.

review: Approve (code review of the autopilot code)

[lp:~ahayzen/music-app/add-url-dispatcher-tests]

633. By Andrew Hayzen on 2014-09-25

* Removal of extra debugging
* Rename UrlDispatcher to URLDispatcher

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:633
http://91.189.93.70:8080/job/music-app-ci/1143/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/539
        deb: http://91.189.93.70:8080/job/generic-mediumtests-utopic-python3/539/artifact/work/output/*zip*/output.zip
    SUCCESS: http://91.189.93.70:8080/job/music-app-utopic-amd64-ci/367

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/music-app-ci/1143/rebuild

review: Approve (continuous-integration)

[Nicholas Skaggs (nskaggs)]

What's up with this mp?

[Victor Thompson (vthompson)]

In my opinion we could do either of the following:

1. Finish review and merge this into trunk, then merge the change into the remix branch. Benefit being that the 2 added tests get some usage early on, negative being that this is extra work if something isn't quite right.
2. Create a new MP for this once remix is trunk. Benefit being we can still focus on our redesign without possible distraction.

#2 might be the safest, but #1 might be preferable if we want these tests in as early as possible.

[Nicholas Skaggs (nskaggs)]

I'd vote to go with the second; heads down on remix. Thanks.

[Victor Thompson (vthompson)]

I'll put this as a WIP as it will probably be resubmitted.

Unmerged revisions

633. By Andrew Hayzen on 2014-09-25

* Removal of extra debugging
* Rename UrlDispatcher to URLDispatcher

632. By Andrew Hayzen on 2014-09-25

* Merge of trunk

631. By Andrew Hayzen on 2014-09-24

* Various fixes

630. By Andrew Hayzen on 2014-09-23

* Remove code comments

629. By Andrew Hayzen on 2014-09-23

* Fixes for pep8

628. By Andrew Hayzen on 2014-09-23

* Merge of trunk

627. By Andrew Hayzen on 2014-09-16

* Various fixes for url-dispatcher

626. By Andrew Hayzen on 2014-09-10

* Only run tests when in click environment

625. By Andrew Hayzen on 2014-09-09

* Pep8 fix

624. By Andrew Hayzen on 2014-09-09

* Ensure url-dispatcher has started before calling it

=== modified file 'click/manifest.json.in'
--- click/manifest.json.in	2014-09-08 08:08:13 +0000
+++ click/manifest.json.in	2014-09-25 16:56:36 +0000
@@ -20,6 +20,12 @@
         "vcs-bzr-revno": "@BZR_REVNO@"
     },
     "x-test": {
-        "autopilot": "@AUTOPILOT_DIR@"
+        "autopilot": {
+            "autopilot_module": "@AUTOPILOT_DIR@",
+            "depends": [
+                "python3-fixtures",
+                "url-dispatcher-tools"
+            ]
+        }
     }
 }

=== modified file 'debian/control'
--- debian/control	2014-09-08 13:24:22 +0000
+++ debian/control	2014-09-25 16:56:36 +0000
@@ -39,7 +39,9 @@
 Depends: libautopilot-qt (>= 1.4),
          libqt5test5,
          music-app (= ${source:Version}),
+         python3-fixtures,
          ubuntu-ui-toolkit-autopilot,
+         url-dispatcher-tools,
          ${misc:Depends},
 Description: Autopilot tests for Music App
  This package contains the autopilot tests for the Music App

=== modified file 'music-app.qml'
--- music-app.qml	2014-09-23 15:59:28 +0000
+++ music-app.qml	2014-09-25 16:56:36 +0000
@@ -204,22 +204,17 @@
         target: UriHandler
 
         function processAlbum(uri) {
-            selectedAlbum = true;
             var split = uri.split("/");
 
             if (split.length < 2) {
                 console.debug("Unknown artist-album " + uri + ", skipping")
-                return;
+            } else {
+                selectedAlbum = true;
+
+                // Filter by artist and album
+                songsAlbumArtistModel.artist = decodeURIComponent(split[0]);
+                songsAlbumArtistModel.album = decodeURIComponent(split[1]);
             }
-
-            // Filter by artist and album
-            songsAlbumArtistModel.artist = decodeURIComponent(split[0]);
-            songsAlbumArtistModel.album = decodeURIComponent(split[1]);
-
-            // Add album to recent list
-            Library.addRecent(songsAlbumArtistModel.album, songsAlbumArtistModel.artist, songsAlbumArtistModel.art, songsAlbumArtistModel.album, "album")
-            mainView.hasRecent = true
-            recentModel.filterRecent()
         }
 
         function processFile(uri, play) {
@@ -230,20 +225,19 @@
 
             if (!track) {
                 console.debug("Unknown file " + uri + ", skipping")
-                return;
-            }
-
-            if (play) {
-                // clear play queue
-                trackQueue.model.clear()
-            }
-
-            // enqueue
-            trackQueue.append(makeDict(track));
-
-            // play first URI
-            if (play) {
-                trackQueueClick(trackQueue.model.count - 1);
+            } else {
+                if (play) {
+                    // clear play queue
+                    trackQueue.model.clear()
+                }
+
+                // enqueue
+                trackQueue.append(makeDict(track));
+
+                // play first URI
+                if (play) {
+                    trackQueueClick(trackQueue.model.count - 1);
+                }
             }
         }
 
@@ -257,7 +251,6 @@
             else if (uri.indexOf("music://") === 0) {
                 uriHandler.processFile(uri.substring(8), play);
             }
-
             else {
                 console.debug("Unsupported URI " + uri + ", skipping")
             }
@@ -735,6 +728,11 @@
                 // Play album it tracks exist
                 if (rowCount > 0 && selectedAlbum) {
                     trackClicked(songsAlbumArtistModel, 0, true, true);
+
+                    // Add album to recent list
+                    Library.addRecent(songsAlbumArtistModel.album, songsAlbumArtistModel.artist, null, songsAlbumArtistModel.album, "album")
+                    mainView.hasRecent = true
+                    recentModel.filterRecent()
                 } else if (selectedAlbum) {
                     console.debug("Unknown artist-album " + artist + "/" + album + ", skipping")
                 }

=== modified file 'tests/autopilot/music_app/__init__.py'
--- tests/autopilot/music_app/__init__.py	2014-09-05 22:20:29 +0000
+++ tests/autopilot/music_app/__init__.py	2014-09-25 16:56:36 +0000
@@ -6,6 +6,7 @@
 # by the Free Software Foundation.
 
 """music-app tests and emulators - top level package."""
+from music_app.url_dispatcher import URLDispatcher
 from ubuntuuitoolkit import MainView, UbuntuUIToolkitCustomProxyObjectBase
 
 
@@ -32,7 +33,7 @@
     return func_wrapper
 
 
-class MusicApp(object):
+class MusicApp():
     """Autopilot helper object for the Music application."""
 
     def __init__(self, app_proxy):
@@ -40,6 +41,10 @@
         self.main_view = self.app.wait_select_single(MainView)
         self.player = self.app.select_single(Player, objectName='player')
 
+    def call_url_dispatcher(self, protocol, path):
+        dispatcher = URLDispatcher()
+        dispatcher.call_dispatcher(protocol, path)
+
     def get_add_to_playlist_page(self):
         return self.app.wait_select_single(Page11,
                                            objectName="addToPlaylistPage")

=== modified file 'tests/autopilot/music_app/tests/__init__.py'
--- tests/autopilot/music_app/tests/__init__.py	2014-09-25 00:39:47 +0000
+++ tests/autopilot/music_app/tests/__init__.py	2014-09-25 16:56:36 +0000
@@ -62,10 +62,10 @@
 
     def setUp(self):
         super(BaseTestCaseWithPatchedHome, self).setUp()
-        _, test_type = self.get_launcher_method_and_type()
-        self.home_dir = self._patch_home(test_type)
+        launcher_method, self.test_type = self.get_launcher_method_and_type()
+        self.home_dir = self._patch_home(self.test_type)
 
-        self._create_music_library(test_type)
+        self._create_music_library(self.test_type)
 
     @autopilot_logging.log_action(logger.info)
     def launch_test_local(self):

=== modified file 'tests/autopilot/music_app/tests/test_music.py'
--- tests/autopilot/music_app/tests/test_music.py	2014-09-23 20:45:41 +0000
+++ tests/autopilot/music_app/tests/test_music.py	2014-09-25 16:56:36 +0000
@@ -11,6 +11,7 @@
 
 import logging
 from autopilot.matchers import Eventually
+import os
 from testtools.matchers import Equals, GreaterThan, LessThan, NotEquals
 
 
@@ -47,6 +48,9 @@
             }
         ]
 
+    def is_click(self):
+        return self.test_type == "click"
+
     @property
     def player(self):
         return self.app.player
@@ -627,6 +631,62 @@
                         Eventually(Equals(self.tracks[-1]["title"])))
         self.assertThat(self.player.isPlaying, Eventually(Equals(True)))
 
+    def test_launch_album_from_url_dispatcher_must_play_it(self):
+        """Test that the album:// url plays the correct album/artist"""
+
+        # Url dispatcher only works in a click-based env for now
+        if not self.is_click():
+            self.skipTest("URL dispatcher works only for installed click "
+                          "packages.")
+
+        # create path for album://
+        album_artist = os.path.join(os.path.sep, self.tracks[1]["artist"],
+                                    self.tracks[1]["album"])
+
+        # Run url-dispatcher call
+        self.app.call_url_dispatcher("album://", album_artist)
+
+        self.player.isPlaying.wait_for(True)  # ensure track is playing
+
+        # Check that the album and artist are correct
+        self.assertThat(self.player.currentMetaArtist,
+                        Eventually(Equals(self.tracks[1]["artist"])))
+        self.assertThat(self.player.currentMetaAlbum,
+                        Eventually(Equals(self.tracks[1]["album"])))
+
+        # Check now playing page is shown
+        now_playing_page = self.app.get_now_playing_page()
+        now_playing_page.visible.wait_for(True)
+
+        # Check that the play queue count is correct
+        self.assertThat(now_playing_page.get_count(), Eventually(Equals(1)))
+
+    def test_launch_music_from_url_dispatcher_must_play_it(self):
+        """Test that the music:// url plays the correct file"""
+
+        # Url dispatcher only works in a click-based env for now
+        if not self.is_click():
+            self.skipTest("URL dispatcher works only for installed click "
+                          "packages.")
+
+        path = os.path.join(self.home_dir, "Music", self.tracks[0]["source"])
+
+        # Run url-dispatcher call
+        self.app.call_url_dispatcher("music://", path)
+
+        self.player.isPlaying.wait_for(True)  # ensure track is playing
+
+        # Check that the source of the file is correct
+        self.assertThat(self.player.source,
+                        Eventually(Equals("file://" + path)))
+
+        # Check now playing page is shown
+        now_playing_page = self.app.get_now_playing_page()
+        now_playing_page.visible.wait_for(True)
+
+        # Check that the play queue count is correct
+        self.assertThat(now_playing_page.get_count(), Eventually(Equals(1)))
+
     def test_pressing_prev_after_5_seconds(self):
         """Pressing previous after 5s jumps to the start of current song"""
 

=== added file 'tests/autopilot/music_app/url_dispatcher.py'
--- tests/autopilot/music_app/url_dispatcher.py	1970-01-01 00:00:00 +0000
+++ tests/autopilot/music_app/url_dispatcher.py	2014-09-25 16:56:36 +0000
@@ -0,0 +1,22 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+# Copyright 2014 Canonical
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License version 3, as published
+# by the Free Software Foundation.
+
+import autopilot.logging as autopilot_logging
+import logging
+import subprocess
+
+logger = logging.getLogger(__name__)
+
+
+class URLDispatcher(object):
+
+    """Helper for the URLDispatcher"""
+
+    @autopilot_logging.log_action(logger.info)
+    def call_dispatcher(self, protocol, path):
+        # Run call to url-dispatcher
+        return subprocess.check_call(["url-dispatcher", protocol + path])