src/metrics/static_types_metrics.nit

   1 # This file is part of NIT ( http://www.nitlanguage.org ).
   2 #
   3 # Copyright 2012 Jean Privat <jean@pryen.org>
   4 #
   5 # Licensed under the Apache License, Version 2.0 (the "License");
   6 # you may not use this file except in compliance with the License.
   7 # You may obtain a copy of the License at
   8 #
   9 #     http://www.apache.org/licenses/LICENSE-2.0
  10 #
  11 # Unless required by applicable law or agreed to in writing, software
  12 # distributed under the License is distributed on an "AS IS" BASIS,
  13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 # See the License for the specific language governing permissions and
  15 # limitations under the License.
  16
  17 # Metrics on the usage of explicit static types.
  18 module static_types_metrics
  19
  20 import metrics_base
  21 import modelize
  22
  23 redef class ToolContext
  24         var static_types_metrics_phase: Phase = new StaticTypesMetricsPhase(self, null)
  25 end
  26
  27 private class StaticTypesMetricsPhase
  28         super Phase
  29         redef fun process_mainmodule(mainmodule, given_mmodules)
  30         do
  31                 if not toolcontext.opt_static_types.value and not toolcontext.opt_all.value then return
  32                 compute_static_types_metrics(toolcontext.modelbuilder)
  33         end
  34 end
  35
  36 # The job of this visitor is to resolve all types found
  37 private class ATypeCounterVisitor
  38         super Visitor
  39         var modelbuilder: ModelBuilder
  40         var nclassdef: AClassdef
  41
  42         var typecount: Counter[MType]
  43
  44         redef fun visit(n)
  45         do
  46                 if n isa AAnnotation then return
  47
  48                 if n isa AType then do
  49                         var mclassdef = self.nclassdef.mclassdef
  50                         if mclassdef == null then break
  51                         var mtype = modelbuilder.resolve_mtype(mclassdef, n)
  52                         if mtype != null then
  53                                 self.typecount.inc(mtype)
  54                         end
  55                 end
  56                 n.visit_all(self)
  57         end
  58 end
  59
  60 # Visit the AST and print metrics on the usage of explicit static types.
  61 fun compute_static_types_metrics(modelbuilder: ModelBuilder)
  62 do
  63         # Count each occurence of a specific static type
  64         var typecount = new Counter[MType]
  65
  66         # Visit all the source code to collect data
  67         for nmodule in modelbuilder.nmodules do
  68                 for nclassdef in nmodule.n_classdefs do
  69                         var visitor = new ATypeCounterVisitor(modelbuilder, nclassdef, typecount)
  70                         visitor.enter_visit(nclassdef)
  71                 end
  72         end
  73
  74         # Display data
  75         print "--- Metrics of the explitic static types ---"
  76         print "Total number of explicit static types: {typecount.sum}"
  77         if typecount.sum == 0 then return
  78
  79         print "Statistics of type usage:"
  80         typecount.print_summary
  81         typecount.print_elements(10)
  82 end