support for PyCharm test debugging, and add tox environment setup

.gitignore

@@ -19,6 +19,7 @@ dmypy.json
 # Packages
 *.egg
 *.egg-info
+*.eggs
 
 # IDEs
 .idea
@@ -33,3 +34,5 @@ htmlcov
 
 # pytest cache
 .pytest_cache/
+
+.tox

mypy/test/testcmdline.py

@@ -58,6 +58,13 @@ def test_python_cmdline(testcase: DataDrivenTestCase) -> None:
     outb = process.stdout.read()
     # Split output into lines.
     out = [s.rstrip('\n\r') for s in str(outb, 'utf8').splitlines()]
+
+    if "PYCHARM_HOSTED" in os.environ:
+        pos = next((p for p, i in enumerate(out) if i.startswith('pydev debugger: ')), None)
+        if pos is not None:
+            del out[pos]  # the attaching debugger message itself
+            del out[pos]  # plus the extra new line added
+
     result = process.wait()
     # Remove temp file.
     os.remove(program_path)

pytest.ini

@@ -20,4 +20,5 @@ python_classes =
 python_functions =
 
 # always run in parallel (requires pytest-xdist, see test-requirements.txt)
-addopts = -nauto --cov-append --cov-report=
+addopts = -nauto
+

setup.cfg

@@ -25,7 +25,8 @@ exclude =
   typeshed/*,
   # during runtests.py flake8 might be started when there's still examples in the temp dir
   tmp-test-dirs/*
-
+  .tox
+  .eggs
 
 # Things to ignore:
 #   E251: spaces around default arg value (against our style)

tox.ini

@@ -0,0 +1,40 @@
+[tox]
+minversion = 2.9.1
+skip_missing_interpreters = true
+envlist = py34,
+          py35,
+          py36,
+          py37,
+          lint,
+          type,
+          docs
+
+[testenv]
+description = run the test driver with {basepython}
+deps = -rtest-requirements.txt
+commands = python runtests.py -x lint -x self-check {posargs}
+
+[testenv:lint]
+description = check the code style
+basepython = python3.6
+commands = python runtests.py lint {posargs}
+
+[testenv:type]
+description = type check ourselves
+basepython = python3.6
+commands = python runtests.py self-check -p '-n0' -p '-v'
+
+[testenv:docs]
+description = invoke sphinx-build to build the HTML docs
+basepython = python3.6
+deps = -rdocs/requirements-docs.txt
+commands = sphinx-build -d "{toxworkdir}/docs_doctree" docs/source "{toxworkdir}/docs_out" --color -W -bhtml {posargs}
+
+[testenv:dev]
+description = generate a DEV environment, that has all project libraries
+usedevelop = True
+basepython = python3.6
+deps = -rtest-requirements.txt
+       -rdocs/requirements-docs.txt
+commands = python -m pip list --format=columns
+           python -c 'import sys; print(sys.executable)'