200: Added plugins/override.py with an example of overriding a plugin

ipalib/plugins/__init__.py

@@ -22,3 +22,4 @@ Sub-package containing all internal plugins.
 """
 
 import example
+import override

ipalib/plugins/override.py

@@ -0,0 +1,33 @@
+# Authors:
+#   Jason Gerard DeRose <jderose@redhat.com>
+#
+# Copyright (C) 2008  Red Hat
+# see file 'COPYING' for use and warranty information
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as
+# published by the Free Software Foundation; version 2 only
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+"""
+An example of overriding a plugin.
+
+This example depends upon the order that the plugins/ modules are imported
+in plugins/__init__.py, which will likely change in the near future.
+"""
+
+from ipalib import public
+from ipalib import api
+
+if 'user_mod' in api.register.Method:
+    class user_mod(api.register.Method.user_mod):
+        '(override) Edit existing user'
+    api.register(user_mod, override=True)