Files
codeql/python/ql/src/Metrics/CommentRatio.ql
2018-11-19 15:10:42 +00:00

19 lines
582 B
Plaintext

/**
* @name Percentage of comments
* @description The percentage of lines in a file that contain comments. Note that docstrings are
* reported by a separate metric.
* @kind treemap
* @id py/comment-ratio-per-file
* @treemap.warnOn lowValues
* @metricType file
* @metricAggregate avg max
* @tags maintainability
* documentation
*/
import python
from Module m, ModuleMetrics mm
where mm = m.getMetrics() and mm.getNumberOfLines() > 0
select m, 100.0 * ((float)mm.getNumberOfLinesOfComments() / (float)mm.getNumberOfLines()) as ratio
order by ratio desc