Add a dry run mode.

1 files changed, 4 insertions, 1 deletions

diff --git a/dotbot/plugin.py b/dotbot/plugin.py
index 5e2c923..2d12636 100644
--- a/dotbot/plugin.py
+++ b/dotbot/plugin.py
@@ -18,10 +18,13 @@ class Plugin(object):
         '''
         return directive == self._directive
 
-    def handle(self, directive, data):
+    def handle(self, directive, data, dry_run = False):
         '''
         Executes the directive.
 
         Returns true if the Plugin successfully handled the directive.
+
+        When dry_run is True, the plugin will not perform any actions, only
+        return False when there is nothing to do, True otherwise.
         '''
         raise NotImplementedError