insolita/yii2-codestat

Statistic of code usage inspired by Laravel Stats

Yii2 Code Statistic

, _(*1)

, _(*2)

Based on phploc/phploc, _(*3)

Installation

Either run, _(*4)

composer require --dev insolita/yii2-codestat:~2.0

or add, _(*5)

"insolita/yii2-codestat": "~2.0"

in require-dev section of your composer.json file., _(*6)

Basic Usage

Add in console configuration file, in section modules, _(*7)

php
'modules'=>[
 ....
        'codestat'=>[
            'class'=>\insolita\codestat\CodeStatModule::class,
            'scanTargets' => ['@backend/','@common/','@frontend/','@console/'],
            'exceptTargets' => ['*config*','vendor*','*web/','*runtime/','*views/','*tests/'],
        ]
    ],

scanTargets - array of path, or path aliases that will be scanned recursively exceptTargets - array of path patterns for excluding, _(*8)

For checking whole list of files that will be processed, run, _(*9)

./yii codestat/default/list-files

For statistic summary output run, _(*10)

./yii codestat

For statistic summary output with show bad resolved files, _(*11)

./yii codestat 1

Show full phploc report per each defined group, _(*12)

./yii codestat/default/advanced 
./yii codestat/default/advanced WebControllers
./yii codestat/default/advanced WebControllers,RestControllers,ConsoleControllers

Show full phploc report for all matched files, _(*13)

./yii codestat/default/common

Show full phploc report for custom directory, _(*14)

./yii codestat/default/directory @common/models

Show full phploc report for custom file, _(*15)

./yii codestat/default/file @common/lib/MySuperClass.php

List available metrics with codes, _(*16)

./yii codestat/default/list-metrics

Advanced Usage

Custom Class Grouping Rules

You can extend or overwrite property 'groupRules', with supported formats, _(*17)

'Group Name' => 'BaseParentClass', _(*18)

where 'BaseParentClass' should by verified with (\ReflectionClass)->isSubclassOf(), _(*19)

or, _(*20)

'Group Name' => function(\ReflectionClass $reflection){
       //Should return true if class valid for this group, otherwise false;
  }

Final example, _(*21)

php
'modules'=>[
 ....
        'codestat'=>[
            'class'=>\insolita\codestat\CodeStatModule::class,
             'groupRules' => [
                                'Jobs' => 'yii\queue\JobInterface',
                                'Handlers' => 'trntv\bus\interfaces\Handler::class',
                                'DTO' => function (\ReflectionClass $reflection) {
                                     return mb_strpos($reflection->getFileName(), 'Dto')!==false;
                                },
                                'All Tests' => function (\ReflectionClass $reflection) {
                                    return $reflection->isSubclassOf('\Codeception\Test\Unit')
                                        || StringHelper::endsWith($reflection->getName(), 'Cest');
                                },
                            ] + CodeStatModule::defaultRules(),
                    ],
        ]
    ],

Important! The order of the rules in the list matters, the base classes (\yii\base\Component and \yii\base\Object) should be at the end of the list!, _(*22)

Custom code metrics

Code metrics provided by https://github.com/sebastianbergmann/phploc, has lot of variants, you can define own combination, _(*23)

For actions advanced/common/directory/file you should set metrics property with array of necessary metric names, _(*24)

php
'modules'=>[
 ....
        'codestat'=>[
            'class'=>\insolita\codestat\CodeStatModule::class,
            'metrics'=>['loc','lloc','classCcnAvg', 'classLlocAvg', 'methodCcnAvg']
            ]
 ]

For summary action you should provide property 'analyseCallback' in module like as, _(*25)

    'analyseCallback = function($group){
               /**@var insolita\codestat\lib\collection\Group $group **/
               $metrics=$customAnalyzer->analyze($group->getFiles());
               return ['totalFiles'=>count($group->getFiles()),  'metric1'=>$metrics[some], ...etc];
     }

It should return associative array with 'metric name' => 'metric value' data and will replace internal https://github .com/Insolita/yii2-codestat/blob/7d0fc3351718b2052624ea091ff8f154fe471aeb/src/lib/CodestatService.php#L154, _(*26)

And also table summary convention - if metric name contains slash "/", for summary row will be counted average value, otherwise sum, _(*27)