It is probably correct to include Python docstrings in a "lines of code" count. Normally a comment would be discarded by the compiler, but docstrings are parsed:
A docstring is a string literal that occurs as the first statement in a module, function, class, or method definition. Such a docstring becomes the __doc__ special attribute of that object.
...
String literals occurring elsewhere in Python code may also act as documentation. They are not recognized by the Python bytecode compiler and are not accessible as runtime object attributes..
In other words, docstrings are compiled and constitute, in a very real way, the code of the program. Additionally, they're commonly used by the doctest module for unit testing, as usage strings for command line utilities, and so on.
def count_loc(lines):
nb_lines = 0
docstring = False
for line in lines:
line = line.strip()
if line == "" \
or line.startswith("#") \
or docstring and not (line.startswith('"""') or line.startswith("'''"))\
or (line.startswith("'''") and line.endswith("'''") and len(line) >3) \
or (line.startswith('"""') and line.endswith('"""') and len(line) >3) :
continue
# this is either a starting or ending docstring
elif line.startswith('"""') or line.startswith("'''"):
docstring = not docstring
continue
else:
nb_lines += 1
return nb_lines
Tahar doesn't count the docstrings. Here's its count_loc function :
def count_loc(lines):
nb_lines = 0
docstring = False
for line in lines:
line = line.strip()
if line == "" \
or line.startswith("#") \
or docstring and not (line.startswith('"""') or line.startswith("'''"))\
or (line.startswith("'''") and line.endswith("'''") and len(line) >3) \
or (line.startswith('"""') and line.endswith('"""') and len(line) >3) :
continue
# this is either a starting or ending docstring
elif line.startswith('"""') or line.startswith("'''"):
docstring = not docstring
continue
else:
nb_lines += 1
return nb_lines
发布评论
评论（4）
将 Python 文档字符串包含在“代码行”计数中可能是正确的。通常，编译器会丢弃注释，但会解析文档字符串：
请参阅 PEP 257 - 文档字符串约定：
换句话说，文档字符串以非常真实的方式编译并构成程序的代码。此外，它们通常被
doctest 模块用于单元测试，如用法命令行实用程序的字符串等。It is probably correct to include Python docstrings in a "lines of code" count. Normally a comment would be discarded by the compiler, but docstrings are parsed:
See PEP 257 - Docstring Conventions:
In other words, docstrings are compiled and constitute, in a very real way, the code of the program. Additionally, they're commonly used by the
doctest modulefor unit testing, as usage strings for command line utilities, and so on.注释行可以是 python 中的代码行。例如，请参阅
doctest。此外，您将很难找到一种明智/可靠的方法来将这样的情况视为注释或代码：
也只需计算注释行，我认为大多数程序员都会同意这对于您来说是一个很好的衡量标准实际上正在尝试测量。
Comment lines can be lines of code in python. See
doctestfor example.Moreover, you will have trouble to find a sensible/reliable way to consider a case like this as being a comment or code:
Just count the comment lines as well, I think most programmers will agree it is as good a measure for whatever you are actually trying to measure.
Tahar 不计算文档字符串。这是它的 count_loc 函数：
Tahar doesn't count the docstrings. Here's its count_loc function :
你有没有看过http://www.ohloh.net/p/ohcount - 总是很漂亮对我来说钱 - 虽然我不使用 python
Have you looked at http://www.ohloh.net/p/ohcount - always been pretty on the money for me - although I do not use python