plugin.py: Add API to allow plugins to raise deprecation warnings

A plugin's deprecation warning may be silenced by a project by adding
the plugin to the list 'supress-deprecation-warnings' in the project's
project.conf