TermboxView - Code Metrics - Inspection of "Merge "Skip implicit description usage with local..." - wikimedia/mediawiki-extensions-Wikibase - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 951284...b5c57e )

unknown

created 2020-11-13 12:17 UTC

TermboxView A

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	97
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	7

Importance

Changes

Metric	Value
wmc	7
lcom	2
cbo	7
dl	0
loc	97
rs	10
c	0
b	0
f	0

5 Methods

Rating	Name	Size	Complexity
A	__construct()	13	1
A	getHtml()	9	1
A	getTitleHtml()	5	1
A	getPlaceholders()	14	1
A	renderTermbox()	20	3

<?php

namespace Wikibase\Repo\ParserOutput;

use Wikibase\DataModel\Entity\EntityDocument;
use Wikibase\DataModel\Entity\EntityId;
use Wikibase\DataModel\Term\AliasGroupList;
use Wikibase\DataModel\Term\TermList;
use Wikibase\Lib\LanguageFallbackChainFactory;
use Wikibase\Lib\Store\EntityRevision;
use Wikibase\View\CacheableEntityTermsView;
use Wikibase\View\EntityTermsView;
use Wikibase\View\LocalizedTextProvider;
use Wikibase\View\SpecialPageLinker;
use Wikibase\View\Termbox\Renderer\TermboxRenderer;
use Wikibase\View\Termbox\Renderer\TermboxRenderingException;
use Wikibase\View\ViewPlaceHolderEmitter;

/**
 * @license GPL-2.0-or-later
 */
class TermboxView implements CacheableEntityTermsView {

	public const TERMBOX_PLACEHOLDER = 'wb-ui';

	public const TERMBOX_MARKUP = 'termbox-markup';

	public const TERMBOX_VERSION = 2;

	public const CACHE_VERSION = 2;

	private $fallbackChainFactory;
	private $renderer;
	private $specialPageLinker;
	private $textInjector;

	/**
	 * @var LocalizedTextProvider
	 */
	private $textProvider;

	public function __construct(
		LanguageFallbackChainFactory $fallbackChainFactory,
		TermboxRenderer $renderer,
		LocalizedTextProvider $textProvider,
		SpecialPageLinker $specialPageLinker,
		TextInjector $textInjector
	) {
		$this->fallbackChainFactory = $fallbackChainFactory;
		$this->renderer = $renderer;
		$this->textProvider = $textProvider;
		$this->specialPageLinker = $specialPageLinker;
		$this->textInjector = $textInjector;
	}

	public function getHtml(
		$mainLanguageCode,
		TermList $labels,
		TermList $descriptions,
		AliasGroupList $aliasGroups = null,
		EntityId $entityId = null
	) {
		return $this->textInjector->newMarker( self::TERMBOX_PLACEHOLDER );
	}

	public function getTitleHtml( EntityId $entityId = null ) {
		return htmlspecialchars(
			$this->textProvider->get( 'parentheses', [ $entityId->getSerialization() ] )
function someFunction(A $objectMaybe = null)
{
    if ($objectMaybe instanceof A) {
        $objectMaybe->doSomething();
    }
}
		);
	}

	/**
	 * @see \Wikibase\View\ViewPlaceHolderEmitter
	 */
	public function getPlaceholders(
		EntityDocument $entity,
		$revision,
		$languageCode
	) {
		return [
			'wikibase-view-chunks' => $this->textInjector->getMarkers(),
			self::TERMBOX_MARKUP => $this->renderTermbox(
				$entity->getId(),
/** @return stdClass|null */
function mayReturnNull() { }

function doesNotAcceptNull(stdClass $x) { }

// With potential error.
function withoutCheck() {
    $x = mayReturnNull();
    doesNotAcceptNull($x); // Potential error here.
}

// Safe - Alternative 1
function withCheck1() {
    $x = mayReturnNull();
    if ( ! $x instanceof stdClass) {
        throw new \LogicException('$x must be defined.');
    }
    doesNotAcceptNull($x);
}

// Safe - Alternative 2
function withCheck2() {
    $x = mayReturnNull();
    if ($x instanceof stdClass) {
        doesNotAcceptNull($x);
    }
}
				$revision,
				$languageCode
			),
		];
	}

	/**
	 * @param EntityId $entityId
	 * @param int $revision
	 * @param string $mainLanguageCode
	 *
	 * @return string|null
	 */
	private function renderTermbox( EntityId $entityId, $revision, $mainLanguageCode ) {
		if ( $revision === EntityRevision::UNSAVED_REVISION ) {
			return ViewPlaceHolderEmitter::ERRONEOUS_PLACEHOLDER_VALUE;
		}

		try {
			return $this->renderer->getContent(
				$entityId,
				$revision,
				$mainLanguageCode,
				$this->specialPageLinker->getLink(
					EntityTermsView::TERMS_EDIT_SPECIAL_PAGE,
					[ $entityId->getSerialization() ]
				),
				$this->fallbackChainFactory->newFromLanguageCode( $mainLanguageCode )
			);
		} catch ( TermboxRenderingException $exception ) {
			return ViewPlaceHolderEmitter::ERRONEOUS_PLACEHOLDER_VALUE;
		}
	}

}


1			<?php
2
3			namespace Wikibase\Repo\ParserOutput;
4
5			use Wikibase\DataModel\Entity\EntityDocument;
6			use Wikibase\DataModel\Entity\EntityId;
7			use Wikibase\DataModel\Term\AliasGroupList;
8			use Wikibase\DataModel\Term\TermList;
9			use Wikibase\Lib\LanguageFallbackChainFactory;
10			use Wikibase\Lib\Store\EntityRevision;
11			use Wikibase\View\CacheableEntityTermsView;
12			use Wikibase\View\EntityTermsView;
13			use Wikibase\View\LocalizedTextProvider;
14			use Wikibase\View\SpecialPageLinker;
15			use Wikibase\View\Termbox\Renderer\TermboxRenderer;
16			use Wikibase\View\Termbox\Renderer\TermboxRenderingException;
17			use Wikibase\View\ViewPlaceHolderEmitter;
18
19			/**
20			* @license GPL-2.0-or-later
21			*/
22			class TermboxView implements CacheableEntityTermsView {
23
24			public const TERMBOX_PLACEHOLDER = 'wb-ui';
25
26			public const TERMBOX_MARKUP = 'termbox-markup';
27
28			public const TERMBOX_VERSION = 2;
29
30			public const CACHE_VERSION = 2;
31
32			private $fallbackChainFactory;
33			private $renderer;
34			private $specialPageLinker;
35			private $textInjector;
36
37			/**
38			* @var LocalizedTextProvider
39			*/
40			private $textProvider;
41
42			public function __construct(
43			LanguageFallbackChainFactory $fallbackChainFactory,
44			TermboxRenderer $renderer,
45			LocalizedTextProvider $textProvider,
46			SpecialPageLinker $specialPageLinker,
47			TextInjector $textInjector
48			) {
49			$this->fallbackChainFactory = $fallbackChainFactory;
50			$this->renderer = $renderer;
51			$this->textProvider = $textProvider;
52			$this->specialPageLinker = $specialPageLinker;
53			$this->textInjector = $textInjector;
54			}
55
56			public function getHtml(
57			$mainLanguageCode,
58			TermList $labels,
59			TermList $descriptions,
60			AliasGroupList $aliasGroups = null,
61			EntityId $entityId = null
62			) {
63			return $this->textInjector->newMarker( self::TERMBOX_PLACEHOLDER );
64			}
65
66			public function getTitleHtml( EntityId $entityId = null ) {
67			return htmlspecialchars(
68			$this->textProvider->get( 'parentheses', [ $entityId->getSerialization() ] )
			0 ignored issues – show Bug introduced 2019-10-08 07:44 UTC by Report Bug Copy Issue Report It seems like `$entityId` is not always an object, but can also be of type `null`. Maybe add an additional type check? If a variable is not always an object, we recommend to add an additional type check to ensure your method call is safe: function someFunction(A $objectMaybe = null) { if ($objectMaybe instanceof A) { $objectMaybe->doSomething(); } } Loading history...
69			);
70			}
71
72			/**
73			* @see \Wikibase\View\ViewPlaceHolderEmitter
74			*/
75			public function getPlaceholders(
76			EntityDocument $entity,
77			$revision,
78			$languageCode
79			) {
80			return [
81			'wikibase-view-chunks' => $this->textInjector->getMarkers(),
82			self::TERMBOX_MARKUP => $this->renderTermbox(
83			$entity->getId(),
			0 ignored issues – show Bug introduced 2019-10-08 07:44 UTC by Report Bug Copy Issue Report It seems like `$entity->getId()` can be `null`; however, `renderTermbox()` does not accept `null`, maybe add an additional type check? Unless you are absolutely sure that the expression can never be null because of other conditions, we strongly recommend to add an additional type check to your code: /** @return stdClass\|null */ function mayReturnNull() { } function doesNotAcceptNull(stdClass $x) { } // With potential error. function withoutCheck() { $x = mayReturnNull(); doesNotAcceptNull($x); // Potential error here. } // Safe - Alternative 1 function withCheck1() { $x = mayReturnNull(); if ( ! $x instanceof stdClass) { throw new \LogicException('$x must be defined.'); } doesNotAcceptNull($x); } // Safe - Alternative 2 function withCheck2() { $x = mayReturnNull(); if ($x instanceof stdClass) { doesNotAcceptNull($x); } } Loading history...
84			$revision,
85			$languageCode
86			),
87			];
88			}
89
90			/**
91			* @param EntityId $entityId
92			* @param int $revision
93			* @param string $mainLanguageCode
94			*
95			* @return string\|null
96			*/
97			private function renderTermbox( EntityId $entityId, $revision, $mainLanguageCode ) {
98			if ( $revision === EntityRevision::UNSAVED_REVISION ) {
99			return ViewPlaceHolderEmitter::ERRONEOUS_PLACEHOLDER_VALUE;
100			}
101
102			try {
103			return $this->renderer->getContent(
104			$entityId,
105			$revision,
106			$mainLanguageCode,
107			$this->specialPageLinker->getLink(
108			EntityTermsView::TERMS_EDIT_SPECIAL_PAGE,
109			[ $entityId->getSerialization() ]
110			),
111			$this->fallbackChainFactory->newFromLanguageCode( $mainLanguageCode )
112			);
113			} catch ( TermboxRenderingException $exception ) {
114			return ViewPlaceHolderEmitter::ERRONEOUS_PLACEHOLDER_VALUE;
115			}
116			}
117
118			}
119

wikimedia / mediawiki-extensions-Wikibase

Push — master ( 951284...b5c57e )

TermboxView A

Complexity

Size/Duplication

Coupling/Cohesion

Importance

5 Methods

Duplication Side-by-Side

Filter issues like