Re-add __main__.py to enable executing as a module

CONTRIBUTING.rst

@@ -7,7 +7,7 @@ All contributions are very welcome! You can contribute in many ways:
 
 * Report bugs on the GitHub `issue tracker`_.
 
-* Submit pull requests on the GitHub `repository`_. Ideally make a pull request to the *develop* branch, as I prefer to keep the master branch the same as the most recent release on PyPI. If you do this, be sure to add yourself to the CONTRIBUTORS.md file too!
+* Submit pull requests on the GitHub `repository`_. Ideally make a pull request to the *develop* branch, as I prefer to keep the master branch the same as the most recent release on PyPI. If you do this, be sure to add yourself to the CONTRIBUTORS.rst file too!
 
 .. _python code quality: https://mail.python.org/mailman/listinfo/code-quality
 .. _issue tracker: https://github.com/PyCQA/prospector/issues

CONTRIBUTORS.rst

@@ -23,6 +23,7 @@ Contributors
 * Kristian Glass (`@doismellburning <https://github.com/doismellburning>`_)
 * Luke Hinds (`@lukehinds <https://github.com/lukehinds>`_)
 * Matt Seymour (`@mattseymour <https://github.com/mattseymour>`_)
+* Michael Tinsley (`@michaeltinsley <https://github.com/michaeltinsley>`_)
 * Phil Frost (`@bitglue <https://github.com/bitglue>`_)
 * Phil Jones (`@pgjones <https://github.com/pgjones>`_)
 * Pierre Sassoulas (`@Pierre-Sassoulas <https://github.com/Pierre-Sassoulas>`_)

docs/usage.rst

@@ -20,6 +20,9 @@ And you can specify a list of python modules::
 
 See below for :ref:`a complete list of options and flags<full_options>`. You can also run ``prospector --help`` for a full list of options and their effects.
 
+Alternatively, prospector can be executed as a module::
+
+    python3 -m prospector <args>
 
 Output Format
 '''''''''''''

prospector/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from prospector.run import main
+
+if __name__ == "__main__":
+    sys.exit(main())