# Collect metrics about inheritance usage
module inheritance_metrics
-import model
+import metrics_base
import mmodules_metrics
import mclasses_metrics
-import phase
-import frontend
redef class ToolContext
- var inheritance_metrics_phase = new InheritanceMetricsPhase(self, null)
+ var inheritance_metrics_phase: Phase = new InheritanceMetricsPhase(self, null)
end
# Extract metrics about inheritance from model.
private class InheritanceMetricsPhase
super Phase
- redef fun process_mainmodule(mainmodule)
+ redef fun process_mainmodule(mainmodule, given_mmodules)
do
if not toolcontext.opt_inheritance.value and not toolcontext.opt_all.value then return
-
- print "\n# Inheritance metrics".yellow.bold
-
- var hmetrics = new InheritanceMetricSet
- hmetrics.register(new MDUI, new MDUIC, new MDUII, new MIF, new MIFC, new MIFI)
-
- var cmetrics = new MClassMetricSet
- cmetrics.register(new CNOA, new CNOP, new CNOC, new CNODC)
- cmetrics.register(new CNOA, new CNOP, new CNOC, new CNODI)
- cmetrics.register(new CDIT, new CDITI)
+ var csv = toolcontext.opt_csv.value
+ var out = "{toolcontext.opt_dir.value or else "metrics"}/inheritance"
+ out.mkdir
+
+ print toolcontext.format_h1("\n# Inheritance metrics")
+
+ var hmetrics = new MetricSet
+ hmetrics.register(new MDUI(mainmodule))
+ hmetrics.register(new MDUIC(mainmodule))
+ hmetrics.register(new MDUII(mainmodule))
+ hmetrics.register(new MIF(mainmodule))
+ hmetrics.register(new MIFC(mainmodule))
+ hmetrics.register(new MIFI(mainmodule))
+
+ var cmetrics = new MetricSet
+ cmetrics.register(new CNOAC(mainmodule))
+ cmetrics.register(new CNOPC(mainmodule))
+ cmetrics.register(new CNOCC(mainmodule))
+ cmetrics.register(new CNODC(mainmodule))
+ cmetrics.register(new CNOPI(mainmodule))
+ cmetrics.register(new CNOCI(mainmodule))
+ cmetrics.register(new CNODI(mainmodule))
+ cmetrics.register(new CDITC(mainmodule))
+ cmetrics.register(new CDITI(mainmodule))
var model = toolcontext.modelbuilder.model
var mmodules = new HashSet[MModule]
var mclasses = new HashSet[MClass]
- for mproject in model.mprojects do
+ for mpackage in model.mpackages do
- print "\n ## project {mproject}".bold
+ print toolcontext.format_h2("\n ## package {mpackage}")
- for mgroup in mproject.mgroups do
+ for mgroup in mpackage.mgroups do
if mgroup.mmodules.is_empty then continue
# Scalar metrics
- print " `- group {mgroup.full_name}"
+ print toolcontext.format_h3(" `- group {mgroup.full_name}")
var mod_mclasses = new HashSet[MClass]
for mmodule in mgroup.mmodules do mod_mclasses.add_all(mmodule.intro_mclasses)
if mod_mclasses.is_empty then continue
mmodules.add_all(mgroup.mmodules)
mclasses.add_all(mod_mclasses)
- cmetrics.collect(new HashSet[MClass].from(mod_mclasses), mainmodule)
- for name, metric in cmetrics.metrics do
- print "\t{name}: {metric.desc}".green
- print "\t avg: {metric.avg}".light_gray
- var max = metric.max
- print "\t max: {max.first} ({max.second})".light_gray
- var min = metric.min
- print "\t min: {min.first} ({min.second})".light_gray
- end
- hmetrics.collect(new HashSet[MModule].from(mgroup.mmodules), mainmodule)
- for name, metric in hmetrics.metrics do
- print "\t{name}: {metric.desc}".green
- print "\t avg: {metric.avg}".light_gray
- var max = metric.max
- print "\t max: {max.first} ({max.second})".light_gray
- var min = metric.min
- print "\t min: {min.first} ({min.second})".light_gray
- end
+ cmetrics.clear
+ cmetrics.collect(new HashSet[MClass].from(mod_mclasses))
+ cmetrics.to_console(1, not toolcontext.opt_nocolors.value)
+ if csv then cmetrics.to_csv.write_to_file("{out}/{mgroup}_classes.csv")
+ hmetrics.clear
+ hmetrics.collect(new HashSet[MModule].from(mgroup.mmodules))
+ hmetrics.to_console(1, not toolcontext.opt_nocolors.value)
+ if csv then hmetrics.to_csv.write_to_file("{out}/{mgroup}_inheritance.csv")
end
end
if not mclasses.is_empty then
# Global metrics
- print "\n ## global metrics".bold
- cmetrics.collect(mclasses, mainmodule)
- for name, metric in cmetrics.metrics do
- print "\t{name}: {metric.desc}".green
- print "\t avg: {metric.avg}".light_gray
- var max = metric.max
- print "\t max: {max.first} ({max.second})".light_gray
- var min = metric.min
- print "\t min: {min.first} ({min.second})".light_gray
- end
- hmetrics.collect(mmodules, mainmodule)
- for name, metric in hmetrics.metrics do
- print "\t{name}: {metric.desc}".green
- print "\t avg: {metric.avg}".light_gray
- var max = metric.max
- print "\t max: {max.first} ({max.second})".light_gray
- var min = metric.min
- print "\t min: {min.first} ({min.second})".light_gray
- end
+ print toolcontext.format_h2("\n ## global metrics")
+ cmetrics.clear
+ cmetrics.collect(mclasses)
+ cmetrics.to_console(1, not toolcontext.opt_nocolors.value)
+ if csv then cmetrics.to_csv.write_to_file("{out}/summary_classes.csv")
+ hmetrics.clear
+ hmetrics.collect(mmodules)
+ hmetrics.to_console(1, not toolcontext.opt_nocolors.value)
+ if csv then hmetrics.to_csv.write_to_file("{out}/summary_inheritance.csv")
end
end
end
-# Metric Set used to collect data about inheritance in each module
-class InheritanceMetricSet
- super MetricSet
- redef type METRIC: InheritanceMetric
- fun collect(mmodules: Set[MModule], mainmodule: MModule) do
- clear
- for metric in metrics.values do
- for mmodule in mmodules do
- metric.collect(mmodule, mainmodule)
- end
- end
- end
-end
-
-# An abstract metric used to collect data about inheritance usage
-#
-# The metric is based on a module
-abstract class InheritanceMetric
- super FloatMetric[MModule]
- fun collect(mmodule: MModule, mainmodule: MModule) is abstract
-end
-
# Module metric: proportion of MClasses Defined Using Inheritance
#
# Count MClasses that have another parents than Object
class MDUI
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mdui"
redef fun desc do return "proportion of mclass defined using inheritance (has other parent than Object)"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / mmodule.intro_mclasses.length.to_f
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / mmodule.intro_mclasses.length.to_f
+ end
end
end
end
#
# Count classes that have another parents than Object
class MDUIC
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mduic"
redef fun desc do return "proportion of class_kind defined using inheritance"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- var nb = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.kind == abstract_kind or mclass.kind == concrete_kind or mclass.kind == extern_kind then
- if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ var nb = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.kind == abstract_kind or mclass.kind == concrete_kind or mclass.kind == extern_kind then
+ if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
+ end
+ nb += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / nb.to_f
end
- nb += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / nb.to_f
end
end
end
#
# Count interface that have another parents than Object
class MDUII
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mduii"
redef fun desc do return "proportion of interface_kind defined using inheritance"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- var nb = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.kind == interface_kind then
- if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ var nb = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.kind == interface_kind then
+ if mclass.in_hierarchy(mainmodule).greaters.length > 2 then count += 1
+ end
+ nb += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / nb.to_f
end
- nb += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / nb.to_f
end
end
end
#
# Count classes that have at least a child
class MIF
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mif"
redef fun desc do return "proportion of mclass inherited from"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / mmodule.intro_mclasses.length.to_f
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / mmodule.intro_mclasses.length.to_f
+ end
end
end
end
#
# Count classes that have at least a child
class MIFC
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mifc"
redef fun desc do return "proportion of class_kind inherited from"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- var nb = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.kind == abstract_kind or mclass.kind == concrete_kind or mclass.kind == extern_kind then
- if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ var nb = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.kind == abstract_kind or mclass.kind == concrete_kind or mclass.kind == extern_kind then
+ if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
+ end
+ nb += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / nb.to_f
end
- nb += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / nb.to_f
end
end
end
#
# Count interfaces that have at least a child
class MIFI
- super InheritanceMetric
+ super MModuleMetric
+ super FloatMetric
redef fun name do return "mifi"
redef fun desc do return "proportion of interface_kind inherited from"
- redef fun collect(mmodule, mainmodule) do
- var count = 0
- var nb = 0
- for mclass in mmodule.intro_mclasses do
- if mclass.kind == interface_kind then
- if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mmodules) do
+ for mmodule in mmodules do
+ var count = 0
+ var nb = 0
+ for mclass in mmodule.intro_mclasses do
+ if mclass.kind == interface_kind then
+ if mclass.in_hierarchy(mainmodule).direct_smallers.length > 0 then count += 1
+ end
+ nb += 1
+ end
+ if mmodule.intro_mclasses.is_empty then
+ values[mmodule] = 0.0
+ else
+ values[mmodule] = count.to_f / nb.to_f
end
- nb += 1
- end
- if mmodule.intro_mclasses.is_empty then
- values[mmodule] = 0.0
- else
- values[mmodule] = count.to_f / nb.to_f
end
end
end
# Count only absrtract, concrete and extern classes
class CNOAC
super MClassMetric
+ super IntMetric
redef fun name do return "cnoac"
redef fun desc do return "number of class_kind ancestor"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).greaters do
- if parent == mclass then continue
- if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).greaters do
+ if parent == mclass then continue
+ if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only absrtract, concrete and extern classes
class CNOPC
super MClassMetric
+ super IntMetric
redef fun name do return "cnopc"
redef fun desc do return "number of class_kind parent"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).direct_greaters do
- if parent == mclass then continue
- if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).direct_greaters do
+ if parent == mclass then continue
+ if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only absrtract, concrete and extern classes
class CNOCC
super MClassMetric
+ super IntMetric
redef fun name do return "cnocc"
redef fun desc do return "number of class_kind children"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).direct_smallers do
- if parent == mclass then continue
- if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).direct_smallers do
+ if parent == mclass then continue
+ if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only absrtract, concrete and extern classes
class CNODC
super MClassMetric
+ super IntMetric
redef fun name do return "cnodc"
redef fun desc do return "number of class_kind descendants"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).smallers do
- if parent == mclass then continue
- if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).smallers do
+ if parent == mclass then continue
+ if parent.kind == abstract_kind or parent.kind == concrete_kind or parent.kind == extern_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only interfaces
class CNOAI
super MClassMetric
+ super IntMetric
redef fun name do return "cnoai"
redef fun desc do return "number of interface_kind ancestor"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).greaters do
- if parent == mclass then continue
- if parent.kind == interface_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).greaters do
+ if parent == mclass then continue
+ if parent.kind == interface_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only interfaces
class CNOPI
super MClassMetric
+ super IntMetric
redef fun name do return "cnopi"
redef fun desc do return "number of interface_kind parent"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).direct_greaters do
- if parent == mclass then continue
- if parent.kind == interface_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).direct_greaters do
+ if parent == mclass then continue
+ if parent.kind == interface_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only interfaces
class CNOCI
super MClassMetric
+ super IntMetric
redef fun name do return "cnoci"
redef fun desc do return "number of interface_kind children"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).direct_smallers do
- if parent == mclass then continue
- if parent.kind == interface_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).direct_smallers do
+ if parent == mclass then continue
+ if parent.kind == interface_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Count only interfaces
class CNODI
super MClassMetric
+ super IntMetric
redef fun name do return "cnodi"
redef fun desc do return "number of interface_kind descendants"
- redef fun collect(mclass, mainmodule) do
- var count = 0
- for parent in mclass.in_hierarchy(mainmodule).smallers do
- if parent == mclass then continue
- if parent.kind == interface_kind then
- count += 1
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ var count = 0
+ for parent in mclass.in_hierarchy(mainmodule).smallers do
+ if parent == mclass then continue
+ if parent.kind == interface_kind then
+ count += 1
+ end
end
+ values[mclass] = count
end
- values[mclass] = count
end
end
# Following the longest path composed only of extends edges from self to Object
class CDITC
super MClassMetric
+ super IntMetric
redef fun name do return "cditc"
redef fun desc do return "depth in class tree following only class, abstract, extern kind"
- redef fun collect(mclass, mainmodule) do
- values[mclass] = mclass.ditc(mainmodule)
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ values[mclass] = mclass.ditc(mainmodule)
+ end
end
end
# Following the longest path composed only of implements edges from self to Object
class CDITI
super MClassMetric
+ super IntMetric
redef fun name do return "cditi"
redef fun desc do return "depth in class tree following only interface_kind"
- redef fun collect(mclass, mainmodule) do
- values[mclass] = mclass.diti(mainmodule)
+ var mainmodule: MModule
+ init(mainmodule: MModule) do self.mainmodule = mainmodule
+
+ redef fun collect(mclasses) do
+ for mclass in mclasses do
+ values[mclass] = mclass.diti(mainmodule)
+ end
end
end