153
116
# remove the plugin 'plugin'
154
117
del self.activeattributes[tempattribute]
155
if getattr(bzrlib.plugins, 'pluginone', None):
156
del bzrlib.plugins.pluginone
157
if getattr(bzrlib.plugins, 'plugintwo', None):
158
del bzrlib.plugins.plugintwo
159
self.failIf(getattr(bzrlib.plugins, 'pluginone', None))
160
self.failIf(getattr(bzrlib.plugins, 'plugintwo', None))
162
def test_plugins_can_load_from_directory_with_trailing_slash(self):
163
# This test tests that a plugin can load from a directory when the
164
# directory in the path has a trailing slash.
165
# check the plugin is not loaded already
166
self.failIf(getattr(bzrlib.plugins, 'ts_plugin', None))
167
tempattribute = "trailing-slash"
168
self.failIf(tempattribute in self.activeattributes)
169
# set a place for the plugin to record its loading, and at the same
170
# time validate that the location the plugin should record to is
172
bzrlib.tests.test_plugins.TestLoadingPlugins.activeattributes \
174
self.failUnless(tempattribute in self.activeattributes)
175
# create a directory for the plugin
176
os.mkdir('plugin_test')
177
# write a plugin that will record when its loaded in the
178
# tempattribute list.
179
template = ("from bzrlib.tests.test_plugins import TestLoadingPlugins\n"
180
"TestLoadingPlugins.activeattributes[%r].append('%s')\n")
182
outfile = open(os.path.join('plugin_test', 'ts_plugin.py'), 'w')
184
outfile.write(template % (tempattribute, 'plugin'))
190
bzrlib.plugin.load_from_path(['plugin_test'+os.sep])
191
self.assertEqual(['plugin'], self.activeattributes[tempattribute])
193
# remove the plugin 'plugin'
194
del self.activeattributes[tempattribute]
195
if getattr(bzrlib.plugins, 'ts_plugin', None):
196
del bzrlib.plugins.ts_plugin
197
self.failIf(getattr(bzrlib.plugins, 'ts_plugin', None))
199
def load_and_capture(self, name):
200
"""Load plugins from '.' capturing the output.
202
:param name: The name of the plugin.
203
:return: A string with the log from the plugin loading call.
208
handler = logging.StreamHandler(stream)
209
log = logging.getLogger('bzr')
210
log.addHandler(handler)
213
bzrlib.plugin.load_from_path(['.'])
215
if 'bzrlib.plugins.%s' % name in sys.modules:
216
del sys.modules['bzrlib.plugins.%s' % name]
217
if getattr(bzrlib.plugins, name, None):
218
delattr(bzrlib.plugins, name)
220
# Stop capturing output
223
log.removeHandler(handler)
224
return stream.getvalue()
228
def test_plugin_with_bad_api_version_reports(self):
229
# This plugin asks for bzrlib api version 1.0.0, which is not supported
234
f.write("import bzrlib.api\n"
235
"bzrlib.api.require_any_api(bzrlib, [(1, 0, 0)])\n")
239
log = self.load_and_capture(name)
240
self.assertContainsRe(log,
241
r"It requested API version")
243
def test_plugin_with_bad_name_does_not_load(self):
244
# The file name here invalid for a python module.
245
name = 'bzr-bad plugin-name..py'
246
file(name, 'w').close()
247
log = self.load_and_capture(name)
248
self.assertContainsRe(log,
249
r"Unable to load 'bzr-bad plugin-name\.' in '\.' as a plugin "
250
"because the file path isn't a valid module name; try renaming "
251
"it to 'bad_plugin_name_'\.")
254
class TestPlugins(TestCaseInTempDir):
256
def setup_plugin(self, source=""):
257
# This test tests a new plugin appears in bzrlib.plugin.plugins().
118
if getattr(bzrlib.plugins, 'plugin', None):
119
del bzrlib.plugins.plugin
120
self.failIf(getattr(bzrlib.plugins, 'plugin', None))
123
class TestAllPlugins(TestCaseInTempDir):
125
def test_plugin_appears_in_all_plugins(self):
126
# This test tests a new plugin appears in bzrlib.plugin.all_plugins().
258
127
# check the plugin is not loaded already
259
128
self.failIf(getattr(bzrlib.plugins, 'plugin', None))
260
129
# write a plugin that _cannot_ fail to load.
261
file('plugin.py', 'w').write(source + '\n')
262
self.addCleanup(self.teardown_plugin)
263
bzrlib.plugin.load_from_path(['.'])
265
def teardown_plugin(self):
266
# remove the plugin 'plugin'
267
if 'bzrlib.plugins.plugin' in sys.modules:
268
del sys.modules['bzrlib.plugins.plugin']
269
if getattr(bzrlib.plugins, 'plugin', None):
270
del bzrlib.plugins.plugin
130
print >> file('plugin.py', 'w'), ""
132
bzrlib.plugin.load_from_path(['.'])
133
self.failUnless('plugin' in bzrlib.plugin.all_plugins())
134
self.failUnless(getattr(bzrlib.plugins, 'plugin', None))
135
self.assertEqual(bzrlib.plugin.all_plugins()['plugin'],
136
bzrlib.plugins.plugin)
138
# remove the plugin 'plugin'
139
if 'bzrlib.plugins.plugin' in sys.modules:
140
del sys.modules['bzrlib.plugins.plugin']
141
if getattr(bzrlib.plugins, 'plugin', None):
142
del bzrlib.plugins.plugin
271
143
self.failIf(getattr(bzrlib.plugins, 'plugin', None))
273
def test_plugin_appears_in_plugins(self):
275
self.failUnless('plugin' in bzrlib.plugin.plugins())
276
self.failUnless(getattr(bzrlib.plugins, 'plugin', None))
277
plugins = bzrlib.plugin.plugins()
278
plugin = plugins['plugin']
279
self.assertIsInstance(plugin, bzrlib.plugin.PlugIn)
280
self.assertEqual(bzrlib.plugins.plugin, plugin.module)
282
def test_trivial_plugin_get_path(self):
284
plugins = bzrlib.plugin.plugins()
285
plugin = plugins['plugin']
286
plugin_path = self.test_dir + '/plugin.py'
287
self.assertIsSameRealPath(plugin_path, normpath(plugin.path()))
289
def test_plugin_get_path_py_not_pyc(self):
290
self.setup_plugin() # after first import there will be plugin.pyc
291
self.teardown_plugin()
292
bzrlib.plugin.load_from_path(['.']) # import plugin.pyc
293
plugins = bzrlib.plugin.plugins()
294
plugin = plugins['plugin']
295
plugin_path = self.test_dir + '/plugin.py'
296
self.assertIsSameRealPath(plugin_path, normpath(plugin.path()))
298
def test_plugin_get_path_pyc_only(self):
299
self.setup_plugin() # after first import there will be plugin.pyc
300
self.teardown_plugin()
301
os.unlink(self.test_dir + '/plugin.py')
302
bzrlib.plugin.load_from_path(['.']) # import plugin.pyc
303
plugins = bzrlib.plugin.plugins()
304
plugin = plugins['plugin']
306
plugin_path = self.test_dir + '/plugin.pyc'
308
plugin_path = self.test_dir + '/plugin.pyo'
309
self.assertIsSameRealPath(plugin_path, normpath(plugin.path()))
311
def test_no_test_suite_gives_None_for_test_suite(self):
313
plugin = bzrlib.plugin.plugins()['plugin']
314
self.assertEqual(None, plugin.test_suite())
316
def test_test_suite_gives_test_suite_result(self):
317
source = """def test_suite(): return 'foo'"""
318
self.setup_plugin(source)
319
plugin = bzrlib.plugin.plugins()['plugin']
320
self.assertEqual('foo', plugin.test_suite())
322
def test_no_load_plugin_tests_gives_None_for_load_plugin_tests(self):
324
loader = TestUtil.TestLoader()
325
plugin = bzrlib.plugin.plugins()['plugin']
326
self.assertEqual(None, plugin.load_plugin_tests(loader))
328
def test_load_plugin_tests_gives_load_plugin_tests_result(self):
330
def load_tests(standard_tests, module, loader):
332
self.setup_plugin(source)
333
loader = TestUtil.TestLoader()
334
plugin = bzrlib.plugin.plugins()['plugin']
335
self.assertEqual('foo', plugin.load_plugin_tests(loader))
337
def test_no_version_info(self):
339
plugin = bzrlib.plugin.plugins()['plugin']
340
self.assertEqual(None, plugin.version_info())
342
def test_with_version_info(self):
343
self.setup_plugin("version_info = (1, 2, 3, 'dev', 4)")
344
plugin = bzrlib.plugin.plugins()['plugin']
345
self.assertEqual((1, 2, 3, 'dev', 4), plugin.version_info())
347
def test_short_version_info_gets_padded(self):
348
# the gtk plugin has version_info = (1,2,3) rather than the 5-tuple.
350
self.setup_plugin("version_info = (1, 2, 3)")
351
plugin = bzrlib.plugin.plugins()['plugin']
352
self.assertEqual((1, 2, 3, 'final', 0), plugin.version_info())
354
def test_no_version_info___version__(self):
356
plugin = bzrlib.plugin.plugins()['plugin']
357
self.assertEqual("unknown", plugin.__version__)
359
def test_str__version__with_version_info(self):
360
self.setup_plugin("version_info = '1.2.3'")
361
plugin = bzrlib.plugin.plugins()['plugin']
362
self.assertEqual("1.2.3", plugin.__version__)
364
def test_noniterable__version__with_version_info(self):
365
self.setup_plugin("version_info = (1)")
366
plugin = bzrlib.plugin.plugins()['plugin']
367
self.assertEqual("1", plugin.__version__)
369
def test_1__version__with_version_info(self):
370
self.setup_plugin("version_info = (1,)")
371
plugin = bzrlib.plugin.plugins()['plugin']
372
self.assertEqual("1", plugin.__version__)
374
def test_1_2__version__with_version_info(self):
375
self.setup_plugin("version_info = (1, 2)")
376
plugin = bzrlib.plugin.plugins()['plugin']
377
self.assertEqual("1.2", plugin.__version__)
379
def test_1_2_3__version__with_version_info(self):
380
self.setup_plugin("version_info = (1, 2, 3)")
381
plugin = bzrlib.plugin.plugins()['plugin']
382
self.assertEqual("1.2.3", plugin.__version__)
384
def test_candidate__version__with_version_info(self):
385
self.setup_plugin("version_info = (1, 2, 3, 'candidate', 1)")
386
plugin = bzrlib.plugin.plugins()['plugin']
387
self.assertEqual("1.2.3rc1", plugin.__version__)
389
def test_dev__version__with_version_info(self):
390
self.setup_plugin("version_info = (1, 2, 3, 'dev', 0)")
391
plugin = bzrlib.plugin.plugins()['plugin']
392
self.assertEqual("1.2.3dev", plugin.__version__)
394
def test_dev_fallback__version__with_version_info(self):
395
self.setup_plugin("version_info = (1, 2, 3, 'dev', 4)")
396
plugin = bzrlib.plugin.plugins()['plugin']
397
self.assertEqual("1.2.3dev4", plugin.__version__)
399
def test_final__version__with_version_info(self):
400
self.setup_plugin("version_info = (1, 2, 3, 'final', 0)")
401
plugin = bzrlib.plugin.plugins()['plugin']
402
self.assertEqual("1.2.3", plugin.__version__)
404
def test_final_fallback__version__with_version_info(self):
405
self.setup_plugin("version_info = (1, 2, 3, 'final', 2)")
406
plugin = bzrlib.plugin.plugins()['plugin']
407
self.assertEqual("1.2.3.final.2", plugin.__version__)
410
146
class TestPluginHelp(TestCaseInTempDir):
412
148
def split_help_commands(self):
415
out, err = self.run_bzr('--no-plugins help commands')
416
for line in out.splitlines():
151
for line in self.run_bzr('help commands')[0].splitlines():
417
152
if not line.startswith(' '):
418
153
current = line.split()[0]
419
154
help[current] = help.get(current, '') + line
451
186
bzrlib.plugin.load_from_path(['plugin_test'])
452
187
bzrlib.commands.register_command( bzrlib.plugins.myplug.cmd_myplug)
453
188
help = self.run_bzr('help myplug')[0]
454
self.assertContainsRe(help, 'plugin "myplug"')
189
self.assertContainsRe(help, 'From plugin "myplug"')
455
190
help = self.split_help_commands()['myplug']
456
191
self.assertContainsRe(help, '\[myplug\]')
458
193
# unregister command
459
if 'myplug' in bzrlib.commands.plugin_cmds:
460
bzrlib.commands.plugin_cmds.remove('myplug')
194
if bzrlib.commands.plugin_cmds.get('myplug', None):
195
del bzrlib.commands.plugin_cmds['myplug']
461
196
# remove the plugin 'myplug'
462
197
if getattr(bzrlib.plugins, 'myplug', None):
463
198
delattr(bzrlib.plugins, 'myplug')
201
class TestPluginFromZip(TestCaseInTempDir):
203
def make_zipped_plugin(self, zip_name, filename):
204
z = zipfile.ZipFile(zip_name, 'w')
205
z.writestr(filename, PLUGIN_TEXT)
208
def check_plugin_load(self, zip_name, plugin_name):
209
self.assertFalse(plugin_name in dir(bzrlib.plugins),
210
'Plugin already loaded')
211
old_path = bzrlib.plugins.__path__
213
# this is normally done by load_plugins -> set_plugins_path
214
bzrlib.plugins.__path__ = [zip_name]
215
bzrlib.plugin.load_from_zip(zip_name)
216
self.assertTrue(plugin_name in dir(bzrlib.plugins),
217
'Plugin is not loaded')
220
if getattr(bzrlib.plugins, plugin_name, None):
221
delattr(bzrlib.plugins, plugin_name)
222
del sys.modules['bzrlib.plugins.' + plugin_name]
223
bzrlib.plugins.__path__ = old_path
225
def test_load_module(self):
226
self.make_zipped_plugin('./test.zip', 'ziplug.py')
227
self.check_plugin_load('./test.zip', 'ziplug')
229
def test_load_package(self):
230
self.make_zipped_plugin('./test.zip', 'ziplug/__init__.py')
231
self.check_plugin_load('./test.zip', 'ziplug')
234
class TestSetPluginsPath(TestCase):
236
def test_set_plugins_path(self):
237
"""set_plugins_path should set the module __path__ correctly."""
238
old_path = bzrlib.plugins.__path__
240
bzrlib.plugins.__path__ = []
241
expected_path = bzrlib.plugin.set_plugins_path()
242
self.assertEqual(expected_path, bzrlib.plugins.__path__)
244
bzrlib.plugins.__path__ = old_path
466
247
class TestHelpIndex(tests.TestCase):
467
248
"""Tests for the PluginsHelpIndex class."""
569
350
mod = FakeModule('two lines of help\nand more', 'bzrlib.plugins.foo_bar')
570
351
topic = plugin.ModuleHelpTopic(mod)
571
352
self.assertEqual('foo_bar', topic.get_help_topic())
574
class TestLoadFromPath(tests.TestCaseInTempDir):
577
super(TestLoadFromPath, self).setUp()
578
# Change bzrlib.plugin to think no plugins have been loaded yet.
579
self.overrideAttr(bzrlib.plugins, '__path__', [])
580
self.overrideAttr(plugin, '_loaded', False)
582
# Monkey-patch load_from_path to stop it from actually loading anything.
583
self.overrideAttr(plugin, 'load_from_path', lambda dirs: None)
585
def test_set_plugins_path_with_args(self):
586
plugin.set_plugins_path(['a', 'b'])
587
self.assertEqual(['a', 'b'], bzrlib.plugins.__path__)
589
def test_set_plugins_path_defaults(self):
590
plugin.set_plugins_path()
591
self.assertEqual(plugin.get_standard_plugins_path(),
592
bzrlib.plugins.__path__)
594
def test_get_standard_plugins_path(self):
595
path = plugin.get_standard_plugins_path()
596
for directory in path:
597
self.assertNotContainsRe(directory, r'\\/$')
599
from distutils.sysconfig import get_python_lib
603
if sys.platform != 'win32':
604
python_lib = get_python_lib()
605
for directory in path:
606
if directory.startswith(python_lib):
609
self.fail('No path to global plugins')
611
def test_get_standard_plugins_path_env(self):
612
os.environ['BZR_PLUGIN_PATH'] = 'foo/'
613
path = plugin.get_standard_plugins_path()
614
for directory in path:
615
self.assertNotContainsRe(directory, r'\\/$')
617
def test_load_plugins(self):
618
plugin.load_plugins(['.'])
619
self.assertEqual(bzrlib.plugins.__path__, ['.'])
620
# subsequent loads are no-ops
621
plugin.load_plugins(['foo'])
622
self.assertEqual(bzrlib.plugins.__path__, ['.'])
624
def test_load_plugins_default(self):
625
plugin.load_plugins()
626
path = plugin.get_standard_plugins_path()
627
self.assertEqual(path, bzrlib.plugins.__path__)
630
class TestEnvPluginPath(tests.TestCaseInTempDir):
633
super(TestEnvPluginPath, self).setUp()
634
self.overrideAttr(plugin, 'DEFAULT_PLUGIN_PATH', None)
636
self.user = plugin.get_user_plugin_path()
637
self.site = plugin.get_site_plugin_path()
638
self.core = plugin.get_core_plugin_path()
640
def _list2paths(self, *args):
643
plugin._append_new_path(paths, p)
646
def _set_path(self, *args):
647
path = os.pathsep.join(self._list2paths(*args))
648
osutils.set_or_unset_env('BZR_PLUGIN_PATH', path)
650
def check_path(self, expected_dirs, setting_dirs):
652
self._set_path(*setting_dirs)
653
actual = plugin.get_standard_plugins_path()
654
self.assertEquals(self._list2paths(*expected_dirs), actual)
656
def test_default(self):
657
self.check_path([self.user, self.core, self.site],
660
def test_adhoc_policy(self):
661
self.check_path([self.user, self.core, self.site],
662
['+user', '+core', '+site'])
664
def test_fallback_policy(self):
665
self.check_path([self.core, self.site, self.user],
666
['+core', '+site', '+user'])
668
def test_override_policy(self):
669
self.check_path([self.user, self.site, self.core],
670
['+user', '+site', '+core'])
672
def test_disable_user(self):
673
self.check_path([self.core, self.site], ['-user'])
675
def test_disable_user_twice(self):
676
# Ensures multiple removals don't left cruft
677
self.check_path([self.core, self.site], ['-user', '-user'])
679
def test_duplicates_are_removed(self):
680
self.check_path([self.user, self.core, self.site],
682
# And only the first reference is kept (since the later references will
683
# onnly produce <plugin> already loaded mutters)
684
self.check_path([self.user, self.core, self.site],
685
['+user', '+user', '+core',
686
'+user', '+site', '+site',
689
def test_disable_overrides_disable(self):
690
self.check_path([self.core, self.site], ['-user', '+user'])
692
def test_disable_core(self):
693
self.check_path([self.site], ['-core'])
694
self.check_path([self.user, self.site], ['+user', '-core'])
696
def test_disable_site(self):
697
self.check_path([self.core], ['-site'])
698
self.check_path([self.user, self.core], ['-site', '+user'])
700
def test_override_site(self):
701
self.check_path(['mysite', self.user, self.core],
702
['mysite', '-site', '+user'])
703
self.check_path(['mysite', self.core],
706
def test_override_core(self):
707
self.check_path(['mycore', self.user, self.site],
708
['mycore', '-core', '+user', '+site'])
709
self.check_path(['mycore', self.site],
712
def test_my_plugin_only(self):
713
self.check_path(['myplugin'], ['myplugin', '-user', '-core', '-site'])
715
def test_my_plugin_first(self):
716
self.check_path(['myplugin', self.core, self.site, self.user],
717
['myplugin', '+core', '+site', '+user'])
719
def test_bogus_references(self):
720
self.check_path(['+foo', '-bar', self.core, self.site],