CompileWithContentArgumentAndRenderStatic::render() - Code Metrics - Inspection of "[FEATURE] Add additional VH assistant Traits" - TYPO3/Fluid - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#214)

by Claus

created 2016-10-31 18:56 UTC

render() A

↳ Parent: CompileWithContentArgumentAndRenderStatic

Complexity

Conditions	3
Paths	2

Size

Total Lines	17
Code Lines	12

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	3
eloc	12
nc	2
nop	0
dl	0
loc	17
rs	9.4285
c	1
b	0
f	0

<?php
namespace TYPO3Fluid\Fluid\Core\ViewHelper\Traits;

use TYPO3Fluid\Fluid\Core\Compiler\TemplateCompiler;
use TYPO3Fluid\Fluid\Core\Compiler\ViewHelperCompiler;
use TYPO3Fluid\Fluid\Core\Exception;
use TYPO3Fluid\Fluid\Core\Parser\SyntaxTree\ViewHelperNode;
use TYPO3Fluid\Fluid\Core\Rendering\RenderingContextInterface;

/**
 * Class CompilableWithContentArgumentAndRenderStatic
 *
 * Provides default methods for rendering and compiling
 * any ViewHelper that conforms to the `renderStatic`
 * method pattern but has the added common use case that
 * an argument value must be checked and used instead of
 * the normal render children closure, if that named
 * argument is specified and not empty.
 */
trait CompileWithContentArgumentAndRenderStatic
{
    /**
     * Name of variable that contains the value to use
     * instead of render children closure, if specified.
     * If no name is provided here, the first variable
     * registered in `initializeArguments` of the ViewHelper
     * will be used.
     *
     * Note: it is significantly better practice to define
     * this property in your ViewHelper class and so fix it
     * to one particular argument instead of resolving,
     * especially when your ViewHelper is called multiple
     * times within an uncompiled template!
     *
     * @var string
     */
    protected $contentArgumentName;

    /**
     * @param string $argumentsName
     * @param string $closureName
     * @param string $initializationPhpCode
     * @param ViewHelperNode $node
     * @param TemplateCompiler $compiler
     * @return string
     */
    public function compile(

        $argumentsName,
        $closureName,
        &$initializationPhpCode,
        ViewHelperNode $node,

        TemplateCompiler $compiler

    ) {
        list ($initialization, $execution) = ViewHelperCompiler::getInstance()->compileWithCallToStaticMethod(
            $this,
            $argumentsName,
            $closureName,
            ViewHelperCompiler::RENDER_STATIC,
            static::class
        );
        $initializationPhpCode .= $initialization;
        return $execution;
    }

    /**
     * Helper which is mostly needed when calling renderStatic() from within
     * render().
     *
     * No public API yet.
     *
     * @return \Closure
     */
    protected function buildRenderChildrenClosure()
    {
        $argumentName = $this->resolveContentArgumentName();
        $arguments = $this->arguments;
class MyClass { }

$x = new MyClass();
$x->foo = true;
        if (!empty($argumentName) && isset($arguments[$argumentName])) {
            $renderChildrenClosure = function () use ($arguments, $argumentName) {
                return $arguments[$argumentName];
            };
        } else {
            $self = clone $this;
            $renderChildrenClosure = function () use ($self) {
                return $self->renderChildren();

            };
        }
        return $renderChildrenClosure;
    }

    /**
     * @return string
     */
    protected function resolveContentArgumentName()
    {
        if (empty($this->contentArgumentName)) {
            $registeredArguments = call_user_func_array([$this, 'prepareArguments'], []);
            foreach ($registeredArguments as $registeredArgument) {
                if (!$registeredArgument->isRequired()) {
                    $this->contentArgumentName = $registeredArgument->getName();
                    return $this->contentArgumentName;
                }
            }
            throw new Exception(
                'Attempting to compile %s failed. Chosen compile method requires that ViewHelper has ' .
                'at least one registered and optional argument'
            );
        }
        return $this->contentArgumentName;
    }
}


1		<?php
2		namespace TYPO3Fluid\Fluid\Core\ViewHelper\Traits;
3
4		use TYPO3Fluid\Fluid\Core\Compiler\TemplateCompiler;
5		use TYPO3Fluid\Fluid\Core\Compiler\ViewHelperCompiler;
6		use TYPO3Fluid\Fluid\Core\Exception;
7		use TYPO3Fluid\Fluid\Core\Parser\SyntaxTree\ViewHelperNode;
8		use TYPO3Fluid\Fluid\Core\Rendering\RenderingContextInterface;
9
10		/**
11		* Class CompilableWithContentArgumentAndRenderStatic
12		*
13		* Provides default methods for rendering and compiling
14		* any ViewHelper that conforms to the `renderStatic`
15		* method pattern but has the added common use case that
16		* an argument value must be checked and used instead of
17		* the normal render children closure, if that named
18		* argument is specified and not empty.
19		*/
20		trait CompileWithContentArgumentAndRenderStatic
21		{
22		/**
23		* Name of variable that contains the value to use
24		* instead of render children closure, if specified.
25		* If no name is provided here, the first variable
26		* registered in `initializeArguments` of the ViewHelper
27		* will be used.
28		*
29		* Note: it is significantly better practice to define
30		* this property in your ViewHelper class and so fix it
31		* to one particular argument instead of resolving,
32		* especially when your ViewHelper is called multiple
33		* times within an uncompiled template!
34		*
35		* @var string
36		*/
37		protected $contentArgumentName;
38
39		/**
40		* @param string $argumentsName
41		* @param string $closureName
42		* @param string $initializationPhpCode
43		* @param ViewHelperNode $node
44		* @param TemplateCompiler $compiler
45		* @return string
46		*/
47	View Code Duplication	public function compile(
		0 ignored issues – show Duplication introduced 2016-10-26 16:04 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
48		$argumentsName,
49		$closureName,
50		&$initializationPhpCode,
51		ViewHelperNode $node,
		0 ignored issues – show Unused Code introduced 2016-10-20 10:20 UTC by Report Bug Copy Issue Report The parameter `$node` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
52		TemplateCompiler $compiler
		0 ignored issues – show Unused Code introduced 2016-10-20 10:20 UTC by Report Bug Copy Issue Report The parameter `$compiler` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
53		) {
54		list ($initialization, $execution) = ViewHelperCompiler::getInstance()->compileWithCallToStaticMethod(
55		$this,
56		$argumentsName,
57		$closureName,
58		ViewHelperCompiler::RENDER_STATIC,
59		static::class
60		);
61		$initializationPhpCode .= $initialization;
62		return $execution;
63		}
64
65		/**
66		* Helper which is mostly needed when calling renderStatic() from within
67		* render().
68		*
69		* No public API yet.
70		*
71		* @return \Closure
72		*/
73		protected function buildRenderChildrenClosure()
74		{
75		$argumentName = $this->resolveContentArgumentName();
76		$arguments = $this->arguments;
		0 ignored issues – show Bug introduced 2016-10-20 10:20 UTC by Report Bug Copy Issue Report The property `arguments` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
77		if (!empty($argumentName) && isset($arguments[$argumentName])) {
78		$renderChildrenClosure = function () use ($arguments, $argumentName) {
79		return $arguments[$argumentName];
80		};
81		} else {
82		$self = clone $this;
83		$renderChildrenClosure = function () use ($self) {
84		return $self->renderChildren();
		0 ignored issues – show Bug introduced 2016-10-31 17:57 UTC by Report Bug Copy Issue Report The method `renderChildren()` does not exist on `TYPO3Fluid\Fluid\Core\Vi...ArgumentAndRenderStatic`. Did you maybe mean `buildRenderChildrenClosure()`? This check marks calls to methods that do not seem to exist on an object. This is most likely the result of a method being renamed without all references to it being renamed likewise. Loading history...
85		};
86		}
87		return $renderChildrenClosure;
88		}
89
90		/**
91		* @return string
92		*/
93		protected function resolveContentArgumentName()
94		{
95		if (empty($this->contentArgumentName)) {
96		$registeredArguments = call_user_func_array([$this, 'prepareArguments'], []);
97		foreach ($registeredArguments as $registeredArgument) {
98		if (!$registeredArgument->isRequired()) {
99		$this->contentArgumentName = $registeredArgument->getName();
100		return $this->contentArgumentName;
101		}
102		}
103		throw new Exception(
104		'Attempting to compile %s failed. Chosen compile method requires that ViewHelper has ' .
105		'at least one registered and optional argument'
106		);
107		}
108		return $this->contentArgumentName;
109		}
110		}
111

TYPO3 / Fluid

Pull Request — master (#214)

render() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like