Code review fixes.

Author: Nurdok

src/pydocstyle/parser.py

@@ -224,21 +224,26 @@ def __init__(self, message):
 
 
 class TokenStream(object):
-    NEWLINES = {tk.NEWLINE, tk.INDENT, tk.DEDENT}
+    # A logical newline is where a new expression or statement begins. When
+    # there is a physical new line, but not a logical one, for example:
+    # (x +
+    #  y)
+    # The token will be tk.NL, not tk.NEWLINE.
+    LOGICAL_NEWLINES = {tk.NEWLINE, tk.INDENT, tk.DEDENT}
 
     def __init__(self, filelike):
         self._generator = tk.generate_tokens(filelike.readline)
         self.current = Token(*next(self._generator, None))
         self.line = self.current.start[0]
         self.log = log
-        self.got_newline = True
+        self.got_logical_newline = True
 
     def move(self):
         previous = self.current
         current = self._next_from_generator()
         self.current = None if current is None else Token(*current)
         self.line = self.current.start[0] if self.current else self.line
-        self.got_newline = (previous.kind in self.NEWLINES)
+        self.got_logical_newline = (previous.kind in self.LOGICAL_NEWLINES)
         return previous
 
     def _next_from_generator(self):
@@ -275,7 +280,6 @@ class Parser(object):
 
     def parse(self, filelike, filename):
         """Parse the given file-like object and return its Module object."""
-        # TODO: fix log
         self.log = log
         self.source = filelike.readlines()
         src = ''.join(self.source)
@@ -380,12 +384,12 @@ def parse_definitions(self, class_, all=False):
         while self.current is not None:
             self.log.debug("parsing definition list, current token is %r (%s)",
                            self.current.kind, self.current.value)
-            self.log.debug('got_newline: %s', self.stream.got_newline)
+            self.log.debug('got_newline: %s', self.stream.got_logical_newline)
             if all and self.current.value == '__all__':
                 self.parse_all()
             elif (self.current.kind == tk.OP and
                   self.current.value == '@' and
-                  self.stream.got_newline):
+                  self.stream.got_logical_newline):
                 self.consume(tk.OP)
                 self.parse_decorators()
             elif self.current.value in ['def', 'class']: