testing/mozbase/mozprofile/tests/test_webapps.py

changeset 0
6474c204b198
equal deleted inserted replaced
-1:000000000000 0:53737872a3a2
1 #!/usr/bin/env python
2
3 """
4 test installing and managing webapps in a profile
5 """
6
7 import os
8 import shutil
9 import unittest
10 from tempfile import mkdtemp
11
12 from mozprofile.webapps import WebappCollection, Webapp, WebappFormatException
13
14 here = os.path.dirname(os.path.abspath(__file__))
15
16 class WebappTest(unittest.TestCase):
17 """Tests reading, installing and cleaning webapps
18 from a profile.
19 """
20 manifest_path_1 = os.path.join(here, 'files', 'webapps1.json')
21 manifest_path_2 = os.path.join(here, 'files', 'webapps2.json')
22
23 def setUp(self):
24 self.profile = mkdtemp(prefix='test_webapp')
25 self.webapps_dir = os.path.join(self.profile, 'webapps')
26 self.webapps_json_path = os.path.join(self.webapps_dir, 'webapps.json')
27
28 def tearDown(self):
29 shutil.rmtree(self.profile)
30
31 def test_read_json_manifest(self):
32 """Tests WebappCollection.read_json"""
33 # Parse a list of webapp objects and verify it worked
34 manifest_json_1 = WebappCollection.read_json(self.manifest_path_1)
35 self.assertEqual(len(manifest_json_1), 7)
36 for app in manifest_json_1:
37 self.assertIsInstance(app, Webapp)
38 for key in Webapp.required_keys:
39 self.assertIn(key, app)
40
41 # Parse a dictionary of webapp objects and verify it worked
42 manifest_json_2 = WebappCollection.read_json(self.manifest_path_2)
43 self.assertEqual(len(manifest_json_2), 5)
44 for app in manifest_json_2:
45 self.assertIsInstance(app, Webapp)
46 for key in Webapp.required_keys:
47 self.assertIn(key, app)
48
49 def test_invalid_webapp(self):
50 """Tests a webapp with a missing required key"""
51 webapps = WebappCollection(self.profile)
52 # Missing the required key "description", exception should be raised
53 self.assertRaises(WebappFormatException, webapps.append, { 'name': 'foo' })
54
55 def test_webapp_collection(self):
56 """Tests the methods of the WebappCollection object"""
57 webapp_1 = { 'name': 'test_app_1',
58 'description': 'a description',
59 'manifestURL': 'http://example.com/1/manifest.webapp',
60 'appStatus': 1 }
61
62 webapp_2 = { 'name': 'test_app_2',
63 'description': 'another description',
64 'manifestURL': 'http://example.com/2/manifest.webapp',
65 'appStatus': 2 }
66
67 webapp_3 = { 'name': 'test_app_2',
68 'description': 'a third description',
69 'manifestURL': 'http://example.com/3/manifest.webapp',
70 'appStatus': 3 }
71
72 webapps = WebappCollection(self.profile)
73 self.assertEqual(len(webapps), 0)
74
75 # WebappCollection should behave like a list
76 def invalid_index():
77 webapps[0]
78 self.assertRaises(IndexError, invalid_index)
79
80 # Append a webapp object
81 webapps.append(webapp_1)
82 self.assertTrue(len(webapps), 1)
83 self.assertIsInstance(webapps[0], Webapp)
84 self.assertEqual(len(webapps[0]), len(webapp_1))
85 self.assertEqual(len(set(webapps[0].items()) & set(webapp_1.items())), len(webapp_1))
86
87 # Remove a webapp object
88 webapps.remove(webapp_1)
89 self.assertEqual(len(webapps), 0)
90
91 # Extend a list of webapp objects
92 webapps.extend([webapp_1, webapp_2])
93 self.assertEqual(len(webapps), 2)
94 self.assertTrue(webapp_1 in webapps)
95 self.assertTrue(webapp_2 in webapps)
96 self.assertNotEquals(webapps[0], webapps[1])
97
98 # Insert a webapp object
99 webapps.insert(1, webapp_3)
100 self.assertEqual(len(webapps), 3)
101 self.assertEqual(webapps[1], webapps[2])
102 for app in webapps:
103 self.assertIsInstance(app, Webapp)
104
105 # Assigning an invalid type (must be accepted by the dict() constructor) should throw
106 def invalid_type():
107 webapps[2] = 1
108 self.assertRaises(WebappFormatException, invalid_type)
109
110 def test_install_webapps(self):
111 """Test installing webapps into a profile that has no prior webapps"""
112 webapps = WebappCollection(self.profile, apps=self.manifest_path_1)
113 self.assertFalse(os.path.exists(self.webapps_dir))
114
115 # update the webapp manifests for the first time
116 webapps.update_manifests()
117 self.assertFalse(os.path.isdir(os.path.join(self.profile, webapps.backup_dir)))
118 self.assertTrue(os.path.isfile(self.webapps_json_path))
119
120 webapps_json = webapps.read_json(self.webapps_json_path, description="fake description")
121 self.assertEqual(len(webapps_json), 7)
122 for app in webapps_json:
123 self.assertIsInstance(app, Webapp)
124
125 manifest_json_1 = webapps.read_json(self.manifest_path_1)
126 manifest_json_2 = webapps.read_json(self.manifest_path_2)
127 self.assertEqual(len(webapps_json), len(manifest_json_1))
128 for app in webapps_json:
129 self.assertTrue(app in manifest_json_1)
130
131 # Remove one of the webapps from WebappCollection after it got installed
132 removed_app = manifest_json_1[2]
133 webapps.remove(removed_app)
134 # Add new webapps to the collection
135 webapps.extend(manifest_json_2)
136
137 # update the webapp manifests a second time
138 webapps.update_manifests()
139 self.assertFalse(os.path.isdir(os.path.join(self.profile, webapps.backup_dir)))
140 self.assertTrue(os.path.isfile(self.webapps_json_path))
141
142 webapps_json = webapps.read_json(self.webapps_json_path, description="a description")
143 self.assertEqual(len(webapps_json), 11)
144
145 # The new apps should be added
146 for app in webapps_json:
147 self.assertIsInstance(app, Webapp)
148 self.assertTrue(os.path.isfile(os.path.join(self.webapps_dir, app['name'], 'manifest.webapp')))
149 # The removed app should not exist in the manifest
150 self.assertNotIn(removed_app, webapps_json)
151 self.assertFalse(os.path.exists(os.path.join(self.webapps_dir, removed_app['name'])))
152
153 # Cleaning should delete the webapps directory entirely since there was nothing there before
154 webapps.clean()
155 self.assertFalse(os.path.isdir(self.webapps_dir))
156
157 def test_install_webapps_preexisting(self):
158 """Tests installing webapps when the webapps directory already exists"""
159 manifest_json_2 = WebappCollection.read_json(self.manifest_path_2)
160
161 # Synthesize a pre-existing webapps directory
162 os.mkdir(self.webapps_dir)
163 shutil.copyfile(self.manifest_path_2, self.webapps_json_path)
164 for app in manifest_json_2:
165 app_path = os.path.join(self.webapps_dir, app['name'])
166 os.mkdir(app_path)
167 f = open(os.path.join(app_path, 'manifest.webapp'), 'w')
168 f.close()
169
170 webapps = WebappCollection(self.profile, apps=self.manifest_path_1)
171 self.assertTrue(os.path.exists(self.webapps_dir))
172
173 # update webapp manifests for the first time
174 webapps.update_manifests()
175 # A backup should be created
176 self.assertTrue(os.path.isdir(os.path.join(self.profile, webapps.backup_dir)))
177
178 # Both manifests should remain installed
179 webapps_json = webapps.read_json(self.webapps_json_path, description='a fake description')
180 self.assertEqual(len(webapps_json), 12)
181 for app in webapps_json:
182 self.assertIsInstance(app, Webapp)
183 self.assertTrue(os.path.isfile(os.path.join(self.webapps_dir, app['name'], 'manifest.webapp')))
184
185 # Upon cleaning the backup should be restored
186 webapps.clean()
187 self.assertFalse(os.path.isdir(os.path.join(self.profile, webapps.backup_dir)))
188
189 # The original webapps should still be installed
190 webapps_json = webapps.read_json(self.webapps_json_path)
191 for app in webapps_json:
192 self.assertIsInstance(app, Webapp)
193 self.assertTrue(os.path.isfile(os.path.join(self.webapps_dir, app['name'], 'manifest.webapp')))
194 self.assertEqual(webapps_json, manifest_json_2)
195
196 if __name__ == '__main__':
197 unittest.main()

mercurial