Passed
Push — master ( 005105...a5b1eb )
by Julius
01:50
created

TocExtension::render()   C

Complexity

Conditions 10
Paths 19

Size

Total Lines 24
Code Lines 17

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 10
eloc 17
nc 19
nop 3
dl 0
loc 24
rs 5.2164
c 0
b 0
f 0

How to fix   Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
/**
3
 * @copyright Copyright (c) 2017 Julius Härtl <[email protected]>
4
 *
5
 * @author Julius Härtl <[email protected]>
6
 *
7
 * @license GNU AGPL version 3 or any later version
8
 *
9
 *  This program is free software: you can redistribute it and/or modify
10
 *  it under the terms of the GNU Affero General Public License as
11
 *  published by the Free Software Foundation, either version 3 of the
12
 *  License, or (at your option) any later version.
13
 *
14
 *  This program is distributed in the hope that it will be useful,
15
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
16
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17
 *  GNU Affero General Public License for more details.
18
 *
19
 *  You should have received a copy of the GNU Affero General Public License
20
 *  along with this program. If not, see <http://www.gnu.org/licenses/>.
21
 *
22
 */
23
24
namespace JuliusHaertl\PHPDocToRst\Extension;
25
26
use JuliusHaertl\PHPDocToRst\Builder\FileBuilder;
27
use JuliusHaertl\PHPDocToRst\Builder\InterfaceFileBuilder;
28
use JuliusHaertl\PHPDocToRst\Builder\PhpDomainBuilder;
29
use JuliusHaertl\PHPDocToRst\Builder\RstBuilder;
30
use phpDocumentor\Reflection\Php\Argument;
31
use phpDocumentor\Reflection\Php\Class_;
32
use phpDocumentor\Reflection\Php\Interface_;
33
use PhpParser\Builder\Trait_;
34
35
/**
36
 * This extension will render a list of methods  for easy access
37
 * at the beginning of classes, interfaces and traits
38
 */
39
40
class TocExtension extends Extension {
41
42
    /**
43
     * @param string $type
44
     * @param FileBuilder $builder
45
     */
46
    public function render($type, &$builder, $element) {
47
        if ($type === PhpDomainBuilder::SECTION_AFTER_TITLE) {
48
            if ($element instanceof Class_ || $element instanceof Interface_ || $element instanceof Trait_) {
49
                $builder->addLine();
50
                $builder->addH2('Summary');
51
52
                /** @var Interface_ $interface */
53
                $interface = $builder->getElement();
54
                $builder->addH3('Methods');
55
                foreach ($interface->getMethods() as $method) {
56
                    $args = '';
57
                    /** @var Argument $argument */
58
                    foreach ($method->getArguments() as $argument) {
59
                        // TODO: defaults, types
60
                        $args .= '$' . $argument->getName() . ', ';
61
                    }
62
                    $args = substr($args, 0, -2);
63
                    $modifiers = $method->getVisibility();
64
                    $modifiers .= $method->isAbstract() ? ' abstract' : '';
65
                    $modifiers .= $method->isFinal() ? ' final' : '';
66
                    $modifiers .= $method->isStatic() ? ' static' : '';
67
                    $signature = $modifiers . ' ' . $method->getName() . '(' . $args . ')';
68
69
                    $builder->addLine('* ' . PhpDomainBuilder::getLink('meth', $method->getFqsen(), $signature));
70
71
                }
72
            }
73
        }
74
75
    }
76
}