Enhancement: Add ExplicitRuleSet marker interface

CHANGELOG.md

@@ -8,6 +8,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 For a full diff see [`2.9.0...main`][2.9.0...main].
 
+### Changed
+
+* Added `Config\RuleSet\ExplicitRuleSet` marker interface for rule-sets that should  be configured explicitly ([#311]), by [@localheinz]
+
 ## [`2.9.0`][2.9.0]
 
 For a full diff see [`2.8.0...2.9.0`][2.8.0...2.9.0].
@@ -294,6 +298,7 @@ For a full diff see [`d899e77...1.0.0`][d899e77...1.0.0].
 [#306]: https://github.com/ergebnis/php-cs-fixer-config/pull/306
 [#309]: https://github.com/ergebnis/php-cs-fixer-config/pull/309
 [#310]: https://github.com/ergebnis/php-cs-fixer-config/pull/310
+[#311]: https://github.com/ergebnis/php-cs-fixer-config/pull/311
 
 [@dependabot]: https://github.com/apps/dependabot
 [@linuxjuggler]: https://github.com/linuxjuggler

phpstan-baseline.neon

@@ -25,3 +25,18 @@ parameters:
 			count: 1
 			path: test/Unit/RuleSet/AbstractRuleSetTestCase.php
 
+		-
+			message: "#^Call to static method PHPUnit\\\\Framework\\\\Assert\\:\\:assertInstanceOf\\(\\) with 'Ergebnis\\\\\\\\PhpCsFixer\\\\\\\\Config\\\\\\\\RuleSet\\\\\\\\ExplicitRuleSet' and Ergebnis\\\\PhpCsFixer\\\\Config\\\\RuleSet\\\\Php71 will always evaluate to true\\.$#"
+			count: 1
+			path: test/Unit/RuleSet/Php71Test.php
+
+		-
+			message: "#^Call to static method PHPUnit\\\\Framework\\\\Assert\\:\\:assertInstanceOf\\(\\) with 'Ergebnis\\\\\\\\PhpCsFixer\\\\\\\\Config\\\\\\\\RuleSet\\\\\\\\ExplicitRuleSet' and Ergebnis\\\\PhpCsFixer\\\\Config\\\\RuleSet\\\\Php73 will always evaluate to true\\.$#"
+			count: 1
+			path: test/Unit/RuleSet/Php73Test.php
+
+		-
+			message: "#^Call to static method PHPUnit\\\\Framework\\\\Assert\\:\\:assertInstanceOf\\(\\) with 'Ergebnis\\\\\\\\PhpCsFixer\\\\\\\\Config\\\\\\\\RuleSet\\\\\\\\ExplicitRuleSet' and Ergebnis\\\\PhpCsFixer\\\\Config\\\\RuleSet\\\\Php74 will always evaluate to true\\.$#"
+			count: 1
+			path: test/Unit/RuleSet/Php74Test.php
+

src/RuleSet/ExplicitRuleSet.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Copyright (c) 2019-2020 Andreas Möller
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE.md file that was distributed with this source code.
+ *
+ * @see https://github.com/ergebnis/php-cs-fixer-config
+ */
+
+namespace Ergebnis\PhpCsFixer\Config\RuleSet;
+
+/**
+ * Marker interface for explicit rule sets.
+ */
+interface ExplicitRuleSet
+{
+}

src/RuleSet/Php71.php

@@ -15,7 +15,7 @@
 
 use PhpCsFixer\Fixer;
 
-final class Php71 extends AbstractRuleSet
+final class Php71 extends AbstractRuleSet implements ExplicitRuleSet
 {
     protected $name = 'ergebnis (PHP 7.1)';
 

src/RuleSet/Php73.php

@@ -15,7 +15,7 @@
 
 use PhpCsFixer\Fixer;
 
-final class Php73 extends AbstractRuleSet
+final class Php73 extends AbstractRuleSet implements ExplicitRuleSet
 {
     protected $name = 'ergebnis (PHP 7.3)';
 

src/RuleSet/Php74.php

@@ -15,7 +15,7 @@
 
 use PhpCsFixer\Fixer;
 
-final class Php74 extends AbstractRuleSet
+final class Php74 extends AbstractRuleSet implements ExplicitRuleSet
 {
     protected $name = 'ergebnis (PHP 7.4)';
 

test/Unit/RuleSet/Php71Test.php

@@ -13,6 +13,7 @@
 
 namespace Ergebnis\PhpCsFixer\Config\Test\Unit\RuleSet;
 
+use Ergebnis\PhpCsFixer\Config;
 use PhpCsFixer\Fixer;
 
 /**
@@ -499,4 +500,11 @@ final class Php71Test extends AbstractRuleSetTestCase
     ];
 
     protected $targetPhpVersion = 70100;
+
+    public function testIsExplicitRuleSet(): void
+    {
+        $ruleSet = new Config\RuleSet\Php71();
+
+        self::assertInstanceOf(Config\RuleSet\ExplicitRuleSet::class, $ruleSet);
+    }
 }

test/Unit/RuleSet/Php73Test.php

@@ -13,6 +13,7 @@
 
 namespace Ergebnis\PhpCsFixer\Config\Test\Unit\RuleSet;
 
+use Ergebnis\PhpCsFixer\Config;
 use PhpCsFixer\Fixer;
 
 /**
@@ -499,4 +500,11 @@ final class Php73Test extends AbstractRuleSetTestCase
     ];
 
     protected $targetPhpVersion = 70300;
+
+    public function testIsExplicitRuleSet(): void
+    {
+        $ruleSet = new Config\RuleSet\Php73();
+
+        self::assertInstanceOf(Config\RuleSet\ExplicitRuleSet::class, $ruleSet);
+    }
 }

test/Unit/RuleSet/Php74Test.php

@@ -13,6 +13,7 @@
 
 namespace Ergebnis\PhpCsFixer\Config\Test\Unit\RuleSet;
 
+use Ergebnis\PhpCsFixer\Config;
 use PhpCsFixer\Fixer;
 
 /**
@@ -499,4 +500,11 @@ final class Php74Test extends AbstractRuleSetTestCase
     ];
 
     protected $targetPhpVersion = 70400;
+
+    public function testIsExplicitRuleSet(): void
+    {
+        $ruleSet = new Config\RuleSet\Php74();
+
+        self::assertInstanceOf(Config\RuleSet\ExplicitRuleSet::class, $ruleSet);
+    }
 }