Add an example plugin project to source tree

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',
+)

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')

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