nitc :: ReadmeMetric :: defaultinit
# Readme metrics associated to a Package
class ReadmeMetric
super HashMap[String, Int]
# Package this Readme is about
var mpackage: MPackage
# Render `self` as a CsvDocument record
fun to_csv_record(keys: ArraySet[String]): Array[String] do
var record = new Array[String]
record.add mpackage.full_name
for key in keys do
if key == keys.first then continue
var value = if self.has_key(key) then self[key] else 0
record.add value.to_s
end
return record
end
# Return the value associated with `key` or `0`.
fun value_or_zero(key: String): Int do
return if self.has_key(key) then self[key] else 0
end
# Print `self` on stdout
fun to_console(toolcontext: ToolContext) do
print toolcontext.format_h2("\n ## package {mpackage} ({readme_path or else "no readme"})")
for key, value in self do
print " * {key} {value}"
end
end
# Collect metrics about `mpackage`
fun collect_metrics do
if not has_package_dir then
print "Warning: no source file for `{mpackage}`"
self["has_package"] = 0
return
end
self["has_package"] = 1
if not has_readme then
print "Warning: no readme file for `{mpackage}`"
self["has_readme"] = 0
return
end
self["has_readme"] = 1
self["md_lines"] = md_lines.length
var parser = new MdParser
var node = parser.parse(md_lines.join("\n"))
var v = new MarkdownMetrics
v.enter_visit(node)
for md_node, value in v.nodes_counter do
self[md_node] = value
end
for level, value in v.headings_counter do
self["HL {level}"] = value
end
end
# Path to the package
var package_path: nullable SourceFile is lazy do return mpackage.location.file
# Is `mpackage` in its own directory?
var has_package_dir: Bool is lazy do
var path = package_path
if path == null then return false
return not path.filename.has_suffix(".nit")
end
# Return the path to the `mpackage` Readme file
var readme_path: nullable String is lazy do
var package_path = self.package_path
if package_path == null then return null
return package_path.filename / "README.md"
end
# Does `mpackage` has a Readme file?
var has_readme: Bool is lazy do
var readme_path = self.readme_path
if readme_path == null then return false
return readme_path.to_s.file_exists
end
# Read markdown lines
#
# Returns an empty array if the Readme does not exist.
var md_lines: Array[String] is lazy do
var path = readme_path
if path == null then return new Array[String]
return path.to_path.read_lines
end
end
src/metrics/readme_metrics.nit:112,1--205,3