Added CONTRIBUTING.rst.

tests/test_docs.py

@@ -1,4 +1,5 @@
 import os
+import fnmatch
 import subprocess
 from unittest import TestCase
 
@@ -11,26 +12,34 @@ def has_docutils():
     try:
         #noinspection PyUnresolvedReferences
         import docutils
+
         return True
     except ImportError:
         return False
 
 
-def get_readme_errors():
-    p = subprocess.Popen([
-        'rst2pseudoxml.py',
-        '--report=1',
-        '--exit-status=1',
-        os.path.join(TESTS_ROOT, '..', 'README.rst')
-    ], stderr=subprocess.PIPE, stdout=subprocess.PIPE)
+def validate_rst(filename):
+    p = subprocess.Popen(
+        ['rst2pseudoxml.py', '--report=1', '--exit-status=1', filename],
+         stderr=subprocess.PIPE,
+         stdout=subprocess.PIPE
+    )
     err = p.communicate()[1]
-    if p.returncode:
-        return err
+    assert p.returncode == 0, err
 
 
-class READMETest(TestCase):
+def rst_files():
+    for root, dirnames, filenames in os.walk(os.path.dirname(TESTS_ROOT)):
+        if '.tox' not in root:
+            for filename in fnmatch.filter(filenames, '*.rst'):
+                yield os.path.join(root, filename)
 
-    @pytest.mark.skipif(not has_docutils(), reason='docutils not installed')
-    def test_README_reStructuredText_valid(self):
-        errors = get_readme_errors()
-        assert not errors, errors
+
+@pytest.mark.skipif(not has_docutils(), reason='docutils not installed')
+class RSTTest(TestCase):
+
+    def test_rst_files_syntax(self):
+        paths = list(rst_files())
+        assert paths, 'no .rst files found, which is weird'
+        for path in paths:
+            validate_rst(path)