Merge pull request #63 from codders/feat/upgrade-mediawiki-codesniffe…

…r-20241206

Upgrade mediawiki-codesniffer to latest version (45.0.0)

.github/workflows/php.yml

@@ -13,8 +13,6 @@ jobs:
       fail-fast: false
       matrix:
         php:
-          - '7.2'
-          - '7.3'
           - '7.4'
           - '8.0'
 

composer.json

@@ -20,11 +20,11 @@
 		}
 	],
 	"require": {
-		"php": ">=7.2"
+		"php": ">=7.4"
 	},
 	"require-dev": {
 		"phpunit/phpunit": "~8.5",
-		"mediawiki/mediawiki-codesniffer": "^34",
+		"mediawiki/mediawiki-codesniffer": "^45",
 		"ockcyp/covers-validator": "~1.0",
 		"phpstan/phpstan": "^0.12.68",
 		"phpmd/phpmd": "^2.9.1"
@@ -51,5 +51,10 @@
 			"@test",
 			"@cs"
 		]
+	},
+	"config": {
+		"allow-plugins": {
+			"dealerdirect/phpcodesniffer-composer-installer": true
+		}
 	}
 }

phpcs.xml

@@ -12,4 +12,5 @@
 	<rule ref="Generic.Metrics.CyclomaticComplexity" />
 	<rule ref="Generic.Metrics.NestingLevel" />
 	<rule ref="Squiz.Operators.ValidLogicalOperators" />
+	<rule ref="./vendor/mediawiki/mediawiki-codesniffer/MediaWiki"/>
 </ruleset>

src/ValueFormatters/FormatterOptions.php

@@ -9,7 +9,7 @@
 use RuntimeException;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 final class FormatterOptions {

src/ValueFormatters/FormattingException.php

@@ -7,7 +7,7 @@
 use RuntimeException;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class FormattingException extends RuntimeException {

src/ValueFormatters/ValueFormatter.php

@@ -8,7 +8,7 @@
  * Interface for value formatters, typically (but not limited to) expecting a DataValue object and
  * returning a string.
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 interface ValueFormatter {
@@ -17,7 +17,7 @@ interface ValueFormatter {
 	 * Identifier for the option that holds the code of the language in which the formatter should
 	 * operate.
 	 */
-	const OPT_LANG = 'lang';
+	public const OPT_LANG = 'lang';
 
 	/**
 	 * @param mixed $value

src/ValueParsers/ParseException.php

@@ -7,7 +7,7 @@
 use RuntimeException;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class ParseException extends RuntimeException {
@@ -23,11 +23,11 @@ class ParseException extends RuntimeException {
 	private $rawValue;
 
 	/**
-	 * @param string $message        A plain english message describing the error
+	 * @param string $message A plain english message describing the error
 	 * @param string|null $rawValue The raw value that failed to be parsed.
 	 * @param string|null $expectedFormat An identifier for the format the raw value did not match
 	 */
-	public function __construct( string $message, string $rawValue = null, string $expectedFormat = null ) {
+	public function __construct( string $message, ?string $rawValue = null, ?string $expectedFormat = null ) {
 		parent::__construct( $message );
 		$this->expectedFormat = $expectedFormat;
 		$this->rawValue = $rawValue;

src/ValueParsers/ParserOptions.php

@@ -8,7 +8,7 @@
 use RuntimeException;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 final class ParserOptions {

src/ValueParsers/ValueParser.php

@@ -8,7 +8,7 @@
  * Interface for value parsers, typically (but not limited to) expecting a string and returning a
  * DataValue object.
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 interface ValueParser {

src/ValueValidators/Error.php

@@ -5,22 +5,21 @@
 namespace ValueValidators;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class Error {
 
 	public const SEVERITY_ERROR = 9;
 	public const SEVERITY_WARNING = 4;
 
-	private $text;
-	private $severity;
-	private $property;
+	private string $text;
+	private int $severity;
+	private ?string $property;
+	private string $code;
+	private array $params;
 
-	private $code;
-	private $params;
-
-	public static function newError( string $text = '', string $property = null, string $code = 'invalid', array $params = [] ): self {
+	public static function newError( string $text = '', ?string $property = null, string $code = 'invalid', array $params = [] ): self {
 		return new self( $text, self::SEVERITY_ERROR, $property, $code, $params );
 	}
 
@@ -37,7 +36,7 @@ public function getText(): string {
 	}
 
 	/**
-	 * @return integer, element of the ValueValidatorError::SEVERITY_ enum
+	 * @return int element of the ValueValidatorError::SEVERITY_ enum
 	 */
 	public function getSeverity(): int {
 		return $this->severity;

src/ValueValidators/Result.php

@@ -5,13 +5,13 @@
 namespace ValueValidators;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 final class Result {
 
-	private $isValid;
-	private $errors;
+	private bool $isValid;
+	private array $errors;
 
 	/**
 	 * @return self

src/ValueValidators/ValueValidator.php

@@ -5,7 +5,7 @@
 namespace ValueValidators;
 
 /**
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 interface ValueValidator {

tests/ValueFormatters/FormatterOptionsTest.php

@@ -13,7 +13,7 @@
  * @group ValueFormatters
  * @group DataValueExtensions
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class FormatterOptionsTest extends TestCase {

tests/ValueParsers/ParserOptionsTest.php

@@ -13,7 +13,7 @@
  * @group ValueParsers
  * @group DataValueExtensions
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class ParserOptionsTest extends TestCase {

tests/ValueValidators/ErrorTest.php

@@ -13,7 +13,7 @@
  * @group ValueValidators
  * @group DataValueExtensions
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Jeroen De Dauw < [email protected] >
  */
 class ErrorTest extends TestCase {
@@ -49,7 +49,7 @@ public function testNewError() {
 		 */
 		$this->assertInstanceOf( 'ValueValidators\Error', $error );
 
-		$this->assertTrue( is_string( $error->getProperty() ) || is_null( $error->getProperty() ) );
+		$this->assertTrue( is_string( $error->getProperty() ) || $error->getProperty() === null );
 
 		if ( count( $args ) > 0 ) {
 			$this->assertSame( $args[0], $error->getText() );

tests/ValueValidators/ResultTest.php

@@ -14,7 +14,7 @@
  * @group ValueValidators
  * @group DataValueExtensions
  *
- * @license GPL-2.0+
+ * @license GPL-2.0-or-later
  * @author Daniel Kinzler
  */
 class ResultTest extends TestCase {
@@ -23,7 +23,7 @@ public function testNewSuccess() {
 		$result = Result::newSuccess();
 
 		$this->assertTrue( $result->isValid() );
-		$this->assertEmpty( $result->getErrors() );
+		$this->assertCount( 0, $result->getErrors() );
 	}
 
 	public function testNewError() {