Merge branch 'master' of https://github.com/PyCQA/pydocstyle

Author: Nurdok

README.rst

@@ -50,7 +50,7 @@ Links
     :target: https://readthedocs.org/projects/pydocstyle/?badge=latest
     :alt: Documentation Status
 
-* `Read the full documentation here <http://pydocstyle.readthedocs.org>`_.
+* `Read the full documentation here <https://pydocstyle.readthedocs.io>`_.
 
 * `Fork pydocstyle on GitHub <http://github.com/PyCQA/pydocstyle>`_.
 

docs/release_notes.rst

@@ -13,14 +13,17 @@ New Features
   the summary of a multi-line docstring starts at the first line,
   respectively at the second line (#174).
 
-* Added D404 - First word of the docstring should not be `This`. It is turned
+* Added D404 - First word of the docstring should not be "This". It is turned
   off by default (#183).
 
 Bug Fixes
 
 * The error code D300 is now also being reported if a docstring has
   uppercase literals (``R`` or ``U``) as prefix (#176).
 
+* Fixed a bug where an ``__all__`` error was reported when ``__all__`` was
+  imported from another module with a different name (#182, #187).
+
 1.0.0 - January 30th, 2016
 --------------------------
 

src/pydocstyle.py

@@ -13,6 +13,7 @@
 import ast
 import copy
 import logging
+import textwrap
 import tokenize as tk
 from itertools import takewhile, dropwhile, chain
 from re import compile as re
@@ -487,13 +488,14 @@ def parse_definition(self, class_):
         return definition
 
     def check_current(self, kind=None, value=None):
-        msg = """Error at line {self.line}:
+        msg = textwrap.dedent("""
+        Unexpected token at line {self.line}:
 
         In file: {self.filename}
 
         Got kind {self.current.kind!r}
         Got value {self.current.value}
-        """.format(self=self)
+        """.format(self=self))
         kind_valid = self.current.kind == kind if kind else True
         value_valid = self.current.value == value if value else True
         assert kind_valid and value_valid, msg
@@ -505,6 +507,14 @@ def parse_from_import_statement(self):
 
         """
         log.debug('parsing from/import statement.')
+        is_future_import = self._parse_from_import_source()
+        self._parse_from_import_names(is_future_import)
+
+    def _parse_from_import_source(self):
+        """Parse the 'from x import' part in a 'from x import y' statement.
+
+        Return true iff `x` is __future__.
+        """
         assert self.current.value == 'from', self.current.value
         self.stream.move()
         is_future_import = self.current.value == '__future__'
@@ -515,6 +525,10 @@ def parse_from_import_statement(self):
         self.check_current(value='import')
         assert self.current.value == 'import', self.current.value
         self.stream.move()
+        return is_future_import
+
+    def _parse_from_import_names(self, is_future_import):
+        """Parse the 'y' part in a 'from x import y' statement."""
         if self.current.value == '(':
             self.consume(tk.OP)
             expected_end_kind = tk.OP

src/tests/test_cases/all_import.py

@@ -1,18 +1,17 @@
 """A valid module docstring."""
 
-from .all_import_aux import __all__ as not_dunder_all
+from .all_import_aux import __all__
 from .expected import Expectation
 
 expectation = Expectation()
 expect = expectation.expect
 
-__all__ = ('public_func', )
-
 
 @expect("D103: Missing docstring in public function")
 def public_func():
     pass
 
 
-def private_func():
+@expect("D103: Missing docstring in public function")
+def this():
     pass

src/tests/test_cases/all_import_as.py

@@ -0,0 +1,18 @@
+"""A valid module docstring."""
+
+from .all_import_aux import __all__ as not_dunder_all
+from .expected import Expectation
+
+expectation = Expectation()
+expect = expectation.expect
+
+__all__ = ('public_func', )
+
+
+@expect("D103: Missing docstring in public function")
+def public_func():
+    pass
+
+
+def private_func():
+    pass

src/tests/test_definitions.py

@@ -261,6 +261,7 @@ def test_token_stream():
     'comment_after_def_bug',
     'multi_line_summary_start',
     'all_import',
+    'all_import_as',
 ])
 def test_pep257(test_case):
     """Run domain-specific tests from test.py file."""