pygount 1.0.0

其他信息

要获取所有可用命令行选项的说明，请运行：

$ pygount --help

要获取版本号，请运行：

$ pygount --version

持续集成

pygount可以生成输出，这些输出可以由 sloccount插件 对于持续集成服务器。

建议在构建的第一步中运行pygount 在任何不需要的文件（如编译器目标或生成的源）之前处理 代码已生成。

jenkins的"execute shell"构建步骤示例如下：

pygount --format=cloc-xml --out cloc.xml --suffix=py --verbose

然后添加生成后操作"发布sloccount分析结果"并设置 "sloccount report"到"cloc.xml"。

pygount如何计算代码pygount基本上计算源代码的物理行数。

首先，它使用分配给它的lexers pygments 来解析代码。如果 pygments 找不到合适的lexer，pygount还有一些额外的 至少可以区分代码和注释的内部词汇表：

• m4、vbscript和webfocus使用了能够区分 介于注释和代码之间。
• omg idl重新调整现有java lexer的用途。

此外，纯文本还有一个单独的lexer，它将所有行都计算为注释。

仅包含注释标记和空白的行将计为注释。 只包含空格的行不被考虑在内。一切 否则算作代码。

如果一行只包含"白色字符"，则不考虑 可能是因为代码的格式只是为了使 读。当前白色字符为：

(),:;[]{}

因此，pygount报告说，对于c-like，sloc减少了10%到20% 与其他类似工具相比的语言。

对于某些语言，检测不到"任何操作"并将其视为空白。 例如python的 pass 或transact-sql的 begin 和 end

例如，请考虑以下python代码：

class SomeError(Exception):
    """
    Some error caused by some issue.
    """
    pass

这包括1行代码和3行注释。带 通过的行 被视为"无操作"，因此不予考虑。

与其他工具比较

pygount可以分析比其他常用工具（如sloccount）更多的语言 或者cloc，因为它构建在 pygments 之上，后者提供数百个lexer 关于语言。这也使得支持另一种语言变得容易：简单地 编写自己的lexer

对于某些角落的情况，脓肿会给出更准确的结果，因为 实际上，与其他主要查找注释的工具不同，它会对代码进行词法分析 标记，当它们出现在字符串中时可能会混淆。在实践中 不过，这应该没什么区别。

pygount比大多数其他工具都慢。部分原因是 而不是扫描代码。部分其他工具可以使用 静态编译语言，如java或c，通常速度更快 而不是动态语言。对于许多应用，尽管pygount应该 "足够快"，尤其是在夜间构建时调用。

API

pygount提供了一个简单的api来将其集成到其他工具中。然而，这是 目前仍在进行中，可能会有更改。

下面是一个关于如何分析pygount自己的源代码的示例：

$ pip install pygount

版本历史记录

版本1.0.0，2017-07-04

• 修正了sax解析器导致的xml文件 <；unknown>； 的混淆警告。 作为解决方法， <；unknown>； 现在被 无法分析的XML文件。
• 将Python3.6添加到受支持版本列表中（问题 14 ）。

版本0.92017-05-04

• 修正了在指定选项时断言错误的问题。
• 已更改警告消息"未指定回退编码，使用<；编码>；" 因为它没有添加任何有趣的信息 实际使用的编码在每个文件的信息消息中都可见。
• 添加了对二进制文件的检测并将其排除在分析之外。在 特定的django模型对象（ *.mo ）不被视为modelica 源代码不再（问题 11 ）。
• 通过dtd增加了docbook xml的检测（问题 10 ）。
• 添加了对足以根据 有关文件扩展名的Oracle常见问题解答条目 （问题 12 ）。
• 添加了为编码"chardet"指定回退编码的可能性。使用 例如， --encoding=chardet；cp1252

版本0.8，2016-10-07

• 固定选项。现在每个分析过的源代码至少 日志中有一条信息性消息。
• 添加了使用大小和MD5代码作为标准检测重复项（问题 2 ）。使用选项 --重复 以仍然计算重复源代码。
• 改进了对编程语言的厌恶，它现在更加一致 在python调用之间产生相同的语言。

版本0.7，2016-09-28

• 修正了忽略生成的选项。
• 添加了对 pygments不支持的两种语言的支持：
  • m4、vbscript和webfocus使用了能够区分 介于注释和代码之间。
  • omg idl重新调整现有java lexer的用途。
• 将某些XML方言作为独立语言添加检测（问题 8 ）。