Merge branch 'local-plugins-updates' into 'master'

Local plugins updates

See merge request !207

2 files changed, 60 insertions, 0 deletions

diff --git a/docs/source/release-notes/3.5.0.rst b/docs/source/release-notes/3.5.0.rst
index c4b6f4e..f234dbe 100644
--- a/docs/source/release-notes/3.5.0.rst
+++ b/docs/source/release-notes/3.5.0.rst
@@ -3,13 +3,23 @@
 
 You can view the `3.5.0 milestone`_ on GitLab for more details.
 
+New Dependency Information
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 - Allow for PyFlakes 1.6.0 (See also `GitLab#359`_)
 
 - Start using new PyCodestyle checks for bare excepts and ambiguous identifier
   (See also `GitLab#361`_)
 
+Features
+~~~~~~~~
+
 - Print out information about configuring VCS hooks (See also `GitLab#335`_)
 
+- Allow users to develop plugins "local" to a repository without using
+  setuptools. See our documentation on local plugins for more information.
+  (See also `GitLab#357`_)
+
 
 .. all links
 .. _3.5.0 milestone:
@@ -18,6 +28,8 @@ You can view the `3.5.0 milestone`_ on GitLab for more details.
 .. issue links
 .. _GitLab#335:
     https://gitlab.com/pycqa/flake8/issues/335
+.. _GitLab#357:
+    https://gitlab.com/pycqa/flake8/issues/357
 .. _GitLab#359:
     https://gitlab.com/pycqa/flake8/issues/359
 .. _GitLab#361:
diff --git a/docs/source/user/configuration.rst b/docs/source/user/configuration.rst
index 5e81807..eacacef 100644
--- a/docs/source/user/configuration.rst
+++ b/docs/source/user/configuration.rst
@@ -222,3 +222,51 @@ They use the comments to describe the check but they could also write this as:
 Or they could use each comment to describe **why** they've ignored the check.
 |Flake8| knows how to parse these lists and will appropriately handle
 these situations.
+
+
+Using Local Plugins
+-------------------
+
+.. versionadded:: 3.5.0
+
+|Flake8| allows users to write plugins that live locally in a project. These
+plugins do not need to use setuptools or any of the other overhead associated
+with plugins distributed on PyPI. To use these plugins, users must specify
+them in their configuration file (i.e., ``.flake8``, ``setup.cfg``, or
+``tox.ini``). This must be configured in a separate INI section named
+``flake8:local-plugins``.
+
+Users may configure plugins that check source code, i.e., ``extension``
+plugins, and plugins that report errors, i.e., ``report`` plugins.
+
+An example configuration might look like:
+
+.. code-block:: ini
+
+    [flake8:local-plugins]
+    extension =
+        MC1 = project.flake8.checkers:MyChecker1
+        MC2 = project.flake8.checkers:MyChecker2
+    report =
+        MR1 = project.flake8.reporters:MyReporter1
+        MR2 = project.flake8.reporters:MyReporter2
+
+|Flake8| will also, however, allow for commas to separate the plugins for
+example:
+
+.. code-block:: ini
+
+    [flake8:local-plugins]
+    extension =
+        MC1 = project.flake8.checkers:MyChecker1,
+        MC2 = project.flake8.checkers:MyChecker2
+    report =
+        MR1 = project.flake8.reporters:MyReporter1,
+        MR2 = project.flake8.reporters:MyReporter2
+
+These configurations will allow you to select your own custom reporter plugin
+that you've designed or will utilize your new check classes.
+
+.. note::
+
+    These plugins otherwise follow the same guidelines as regular plugins.