Add an example plugin project to source tree

3 files changed, 41 insertions, 0 deletions

diff --git a/example-plugin/src/flake8_example_plugin/__init__.py b/example-plugin/src/flake8_example_plugin/__init__.py
new file mode 100644
index 0000000..33d76f3
--- /dev/null
+++ b/example-plugin/src/flake8_example_plugin/__init__.py
@@ -0,0 +1,9 @@
+"""Module for an example Flake8 plugin."""
+
+from .on_by_default import ExampleOne
+from .off_by_default import ExampleTwo
+
+__all__ = (
+    'ExampleOne',
+    'ExampleTwo',
+)
diff --git a/example-plugin/src/flake8_example_plugin/off_by_default.py b/example-plugin/src/flake8_example_plugin/off_by_default.py
new file mode 100644
index 0000000..d768328
--- /dev/null
+++ b/example-plugin/src/flake8_example_plugin/off_by_default.py
@@ -0,0 +1,17 @@
+"""Our first example plugin."""
+
+
+class ExampleTwo(object):
+    """Second Example Plugin."""
+    name = 'off-by-default-example-plugin'
+    version = '1.0.0'
+
+    off_by_default = True
+
+    def __init__(self, tree):
+        self.tree = tree
+
+    def run(self):
+        """Do nothing."""
+        yield (1, 0, 'X200 The off-by-default plugin was enabled',
+               'OffByDefaultPlugin')
diff --git a/example-plugin/src/flake8_example_plugin/on_by_default.py b/example-plugin/src/flake8_example_plugin/on_by_default.py
new file mode 100644
index 0000000..a324297
--- /dev/null
+++ b/example-plugin/src/flake8_example_plugin/on_by_default.py
@@ -0,0 +1,15 @@
+"""Our first example plugin."""
+
+
+class ExampleOne(object):
+    """First Example Plugin."""
+    name = 'on-by-default-example-plugin'
+    version = '1.0.0'
+
+    def __init__(self, tree):
+        self.tree = tree
+
+    def run(self):
+        """Do nothing."""
+        for message in []:
+            yield message