src\wily\operators\maintainability.py
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
-- -- --- --- --- --- --- --- ------- ------- ------- | """

-- -- --- --- --- --- --- --- ------- ------- ------- | Maintainability operator.

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- -- --- --- --- --- --- --- ------- ------- ------- | Measures the "maintainability" using the Halstead index.

-- -- --- --- --- --- --- --- ------- ------- ------- | """

-- -- --- --- --- --- --- --- ------- ------- ------- | import statistics

-- -- --- --- --- --- --- --- ------- ------- ------- | from collections import Counter

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- -- --- --- --- --- --- --- ------- ------- ------- | import radon.cli.harvest as harvesters

-- -- --- --- --- --- --- --- ------- ------- ------- | from radon.cli import Config

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- -- --- --- --- --- --- --- ------- ------- ------- | from wily import logger

-- -- --- --- --- --- --- --- ------- ------- ------- | from wily.lang import _

-- -- --- --- --- --- --- --- ------- ------- ------- | from wily.operators import BaseOperator, Metric, MetricType

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 | def mode(data):

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     """

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     Return the modal value of an iterable with discrete values.

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     If there is more than 1 modal value, arbitrarily return the first top n.

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     """

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     c = Counter(data)

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     mode, freq = c.most_common(1)[0]

-- 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     return mode

-- -- --- --- --- --- --- --- ------- ------- ------- | 

-- -- --- --- --- --- --- --- ------- ------- ------- | 

03 -- --- --- --- --- --- --- ------- ------- ------- | class MaintainabilityIndexOperator(BaseOperator):

03 -- --- --- --- --- --- --- ------- ------- ------- |     """MI Operator."""

03 -- --- --- --- --- --- --- ------- ------- ------- | 

03 -- --- --- --- --- --- --- ------- ------- ------- |     name = "maintainability"

03 -- --- --- --- --- --- --- ------- ------- ------- |     defaults = {

03 -- --- --- --- --- --- --- ------- ------- ------- |         "exclude": None,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "ignore": None,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "min": "A",

03 -- --- --- --- --- --- --- ------- ------- ------- |         "max": "C",

03 -- --- --- --- --- --- --- ------- ------- ------- |         "multi": True,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "show": False,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "sort": False,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "include_ipynb": True,

03 -- --- --- --- --- --- --- ------- ------- ------- |         "ipynb_cells": True,

03 -- --- --- --- --- --- --- ------- ------- ------- |     }

03 -- --- --- --- --- --- --- ------- ------- ------- | 

03 -- --- --- --- --- --- --- ------- ------- ------- |     metrics = (

03 -- --- --- --- --- --- --- ------- ------- ------- |         Metric(

03 -- --- --- --- --- --- --- ------- ------- ------- |             "rank", _("Maintainability Ranking"), str, MetricType.Informational, mode

03 -- --- --- --- --- --- --- ------- ------- ------- |         ),

03 -- --- --- --- --- --- --- ------- ------- ------- |         Metric(

03 -- --- --- --- --- --- --- ------- ------- ------- |             "mi", _("Maintainability Index"), float, MetricType.AimHigh, statistics.mean

03 -- --- --- --- --- --- --- ------- ------- ------- |         ),

03 -- --- --- --- --- --- --- ------- ------- ------- |     )

03 -- --- --- --- --- --- --- ------- ------- ------- | 

03 -- --- --- --- --- --- --- ------- ------- ------- |     default_metric_index = 1  # MI

03 -- --- --- --- --- --- --- ------- ------- ------- | 

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     def __init__(self, config, targets):

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         """

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         Instantiate a new MI operator.

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :param config: The wily configuration.

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :type  config: :class:`WilyConfig`

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         """

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         # TODO : Import config from wily.cfg

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         logger.debug(f"Using {targets} with {self.defaults} for MI metrics")

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

03 01 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         self.harvester = harvesters.MIHarvester(targets, config=Config(**self.defaults))

03 -- --- --- --- --- --- --- ------- ------- ------- | 

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |     def run(self, module, options):

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         """

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         Run the operator.

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :param module: The target module path.

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :type  module: ``str``

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :param options: Any runtime options.

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :type  options: ``dict``

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 | 

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :return: The operator results.

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         :rtype: ``dict``

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         """

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         logger.debug("Running maintainability harvester")

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         results = {}

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         for filename, metrics in dict(self.harvester.results).items():

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |             results[filename] = {"total": metrics}

03 02 000 000 000 000 000 000 0000.00 0000.00 0000.00 |         return results