Fix phpdoc, update README.md, clean tests, and update styleci.yml configuration. (#15)

Author: terabytesoftw

.github/workflows/ecs.yml

@@ -0,0 +1,34 @@
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - 'README.md'
+      - 'CHANGELOG.md'
+      - '.gitignore'
+      - '.gitattributes'
+      - 'infection.json.dist'
+      - 'phpunit.xml.dist'
+
+  push:
+    branches: ['main']
+    paths-ignore:
+      - 'docs/**'
+      - 'README.md'
+      - 'CHANGELOG.md'
+      - '.gitignore'
+      - '.gitattributes'
+      - 'infection.json.dist'
+      - 'phpunit.xml.dist'
+
+name: ecs
+
+jobs:
+  easy-coding-standard:
+    uses: php-forge/actions/.github/workflows/ecs.yml@main
+    secrets:
+      AUTH_TOKEN: ${{ secrets.AUTH_TOKEN }}
+    with:
+      os: >-
+        ['ubuntu-latest']
+      php: >-
+        ['8.1']

.styleci.yml

@@ -17,9 +17,11 @@ enabled:
   - combine_nested_dirname
   - declare_strict_types
   - dir_constant
+  - empty_loop_body_braces
   - fully_qualified_strict_types
   - function_to_constant
   - hash_to_slash_comment
+  - integer_literal_case
   - is_null
   - logical_operators
   - magic_constant_casing
@@ -56,7 +58,6 @@ enabled:
   - phpdoc_order
   - phpdoc_property
   - phpdoc_scalar
-  - phpdoc_separation
   - phpdoc_singular_inheritdoc
   - phpdoc_trim
   - phpdoc_trim_consecutive_blank_line_separation
@@ -78,9 +79,9 @@ enabled:
   - trailing_comma_in_multiline_array
   - unalign_double_arrow
   - unalign_equals
-  - empty_loop_body_braces
-  - integer_literal_case
   - union_type_without_spaces
 
 disabled:
   - function_declaration
+  - psr12_braces
+  - psr12_class_definition

README.md

@@ -86,6 +86,10 @@ use Yii2\Asset\BootstrapPluginCdnAsset;
 BootstrapPluginCdnAsset::register($this);
 ```
 
+## Testing
+
+[Check the documentation testing](/docs/testing.md) to learn about testing.
+
 ## Quality code
 
 [![static-analysis](https://github.com/yii2-extensions/asset-bootstrap5/actions/workflows/static.yml/badge.svg)](https://github.com/yii2-extensions/asset-bootstrap5/actions/workflows/static.yml)
@@ -97,10 +101,6 @@ BootstrapPluginCdnAsset::register($this);
 [![Yii20](https://img.shields.io/badge/Yii2%20version-2.0-blue)](https://github.com/yiisoft/yii2/tree/2.0.49.3)
 [![Yii22](https://img.shields.io/badge/Yii2%20version-2.2-blue)](https://github.com/yiisoft/yii2/tree/2.2)
 
-## Testing
-
-[Check the documentation testing](/docs/testing.md) to learn about testing.
-
 ## Our social networks
 
 [![Twitter](https://img.shields.io/badge/twitter-follow-1DA1F2?logo=twitter&logoColor=1DA1F2&labelColor=555555?style=flat)](https://twitter.com/Terabytesoftw)

composer.json

@@ -16,8 +16,9 @@
     "require-dev": {
         "maglnet/composer-require-checker": "^4.7",
         "php-forge/support": "^0.1",
-        "phpunit/phpunit": "^10.5.7",
+        "phpunit/phpunit": "^10.5",
         "roave/infection-static-analysis-plugin": "^1.34",
+        "symplify/easy-coding-standard": "^12.1",
         "yii2-extensions/phpstan": "dev-main"
     },
     "autoload": {
@@ -36,16 +37,21 @@
         }
     },
     "config": {
-        "sort-packages": true,
         "allow-plugins": {
             "yiisoft/yii2-composer": true,
             "infection/extension-installer": true
-        }
+        },
+        "sort-packages": true
     },
     "scripts": {
+
         "check-dependencies": "composer-require-checker",
-        "mutation": "roave-infection-static-analysis-plugin",
-        "phpstan": "phpstan",
+        "easy-coding-standard": "ecs check",
+        "mutation": [
+            "Composer\\Config::disableProcessTimeout",
+            "roave-infection-static-analysis-plugin"
+        ],
+        "psalm": "psalm",
         "test": "phpunit"
     },
     "repositories": [

docs/testing.md

@@ -10,6 +10,11 @@ To run the checker, execute the following command:
 composer run check-dependencies
 ```
 
+## Easy coding standard
+
+The code is checked with [Easy Coding Standard](https://github.com/easy-coding-standard/easy-coding-standard) and
+[PHP CS Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer). To run it:
+
 ## Static analysis
 
 The code is statically analyzed with [Phpstan](https://phpstan.org/). To run static analysis:

ecs.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+use PhpCsFixer\Fixer\ClassNotation\ClassDefinitionFixer;
+use PhpCsFixer\Fixer\ClassNotation\OrderedClassElementsFixer;
+use PhpCsFixer\Fixer\ClassNotation\OrderedTraitsFixer;
+use PhpCsFixer\Fixer\Import\NoUnusedImportsFixer;
+use Symplify\EasyCodingStandard\Config\ECSConfig;
+
+return ECSConfig::configure()
+    ->withConfiguredRule(
+        ClassDefinitionFixer::class,
+        [
+            'space_before_parenthesis' => true,
+        ],
+    )
+    ->withFileExtensions(['php'])
+    ->withPaths(
+        [
+            __DIR__ . '/src',
+            __DIR__ . '/tests',
+        ],
+    )
+    ->withPhpCsFixerSets(perCS20: true)
+    ->withPreparedSets(
+        arrays: true,
+        cleanCode: true,
+        comments:true,
+        docblocks: true,
+        namespaces: true,
+        psr12: true,
+        strict: true
+    )
+    ->withRules(
+        [
+            NoUnusedImportsFixer::class,
+            OrderedClassElementsFixer::class,
+            OrderedTraitsFixer::class,
+        ]
+    );

src/BootstrapAsset.php

@@ -6,22 +6,23 @@
 
 use yii\web\AssetBundle;
 
+use function defined;
+
 /**
- * Twitter Bootstrap 5 CSS bundle.
+ * Twitter Bootstrap5 CSS bundle.
  */
 final class BootstrapAsset extends AssetBundle
 {
-    /**
-     * @inheritDoc
-     */
     public $sourcePath = '@npm/bootstrap/dist/css';
 
     public function __construct()
     {
+        parent::__construct();
+
         $environment = defined('YII_ENV') ? YII_ENV : 'prod';
         $cssFiles = $environment === 'prod' ? 'bootstrap.min.css' : 'bootstrap.css';
 
         $this->css = [$cssFiles];
-        $this->publishOptions['only'] = [$cssFiles, "{$cssFiles}.map"];
+        $this->publishOptions['only'] = [$cssFiles, "$cssFiles.map"];
     }
 }

src/BootstrapCdnAsset.php

@@ -7,22 +7,18 @@
 use yii\web\AssetBundle;
 
 /**
- * Twitter Bootstrap 5 CDN CSS bundle.
+ * Twitter Bootstrap5 CDN CSS bundle.
  */
 final class BootstrapCdnAsset extends AssetBundle
 {
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $css = [
         'https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css',
     ];
 
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $cssOptions = [

src/BootstrapPluginAsset.php

@@ -6,19 +6,16 @@
 
 use yii\web\AssetBundle;
 
+use function defined;
+
 /**
- * Twitter Bootstrap 5 JavaScript bundle.
+ * Twitter Bootstrap5 JavaScript bundle.
  */
 final class BootstrapPluginAsset extends AssetBundle
 {
-    /**
-     * @inheritDoc
-     */
     public $sourcePath = '@npm/bootstrap/dist/js';
 
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $depends = [
@@ -27,10 +24,12 @@ final class BootstrapPluginAsset extends AssetBundle
 
     public function __construct()
     {
+        parent::__construct();
+
         $environment = defined('YII_ENV') ? YII_ENV : 'prod';
         $jsFiles = $environment === 'prod' ? 'bootstrap.bundle.min.js' : 'bootstrap.bundle.js';
 
         $this->js = [$jsFiles];
-        $this->publishOptions['only'] = [$jsFiles, "{$jsFiles}.map"];
+        $this->publishOptions['only'] = [$jsFiles, "$jsFiles.map"];
     }
 }

src/BootstrapPluginCdnAsset.php

@@ -7,22 +7,18 @@
 use yii\web\AssetBundle;
 
 /**
- * Twitter Bootstrap 5 CDN JavaScript bundle.
+ * Twitter Bootstrap5 CDN JavaScript bundle.
  */
 final class BootstrapPluginCdnAsset extends AssetBundle
 {
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $js = [
         'https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js',
     ];
 
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $jsOptions = [
@@ -31,8 +27,6 @@ final class BootstrapPluginCdnAsset extends AssetBundle
     ];
 
     /**
-     * @inheritDoc
-     *
      * @phpstan-var array<array-key, mixed>
      */
     public $depends = [

tests/BootstrapAssetTest.php

@@ -31,7 +31,6 @@ public function testRegister(): void
         $result = $view->renderFile(__DIR__ . '/Support/main.php');
 
         $this->assertStringContainsString('bootstrap.css', $result);
-
         $this->assertSame(['bootstrap.css'], Yii::$app->assetManager->bundles[BootstrapAsset::class]->css);
         $this->assertFileExists(__DIR__ . '/Support/runtime/55145ba9/bootstrap.css');
         $this->assertFileExists(__DIR__ . '/Support/runtime/55145ba9/bootstrap.css.map');
@@ -42,7 +41,7 @@ public function testRegister(): void
     #[RequiresPhp('8.1')]
     public function testRegisterWithEnvironmentProd(): void
     {
-        runkit_constant_redefine('YII_ENV', 'prod');
+        @runkit_constant_redefine('YII_ENV', 'prod');
 
         $view = new View();
 
@@ -63,6 +62,6 @@ public function testRegisterWithEnvironmentProd(): void
         $this->assertFileDoesNotExist(__DIR__ . '/Support/runtime/55145ba9/bootstrap.css');
         $this->assertFileDoesNotExist(__DIR__ . '/Support/runtime/55145ba9/bootstrap.css.map');
 
-        runkit_constant_redefine('YII_ENV', 'dev');
+        @runkit_constant_redefine('YII_ENV', 'dev');
     }
 }

tests/BootstrapPluginAssetTest.php

@@ -33,7 +33,6 @@ public function testRegister(): void
         $result = $view->renderFile(__DIR__ . '/Support/main.php');
 
         $this->assertStringContainsString('bootstrap.bundle.js', $result);
-
         $this->assertSame(['bootstrap.bundle.js'], Yii::$app->assetManager->bundles[BootstrapPluginAsset::class]->js);
         $this->assertFileExists(__DIR__ . '/Support/runtime/16b8de20/bootstrap.bundle.js');
         $this->assertFileExists(__DIR__ . '/Support/runtime/16b8de20/bootstrap.bundle.js.map');
@@ -59,7 +58,6 @@ public function testRegisterWithEnvironmentProd(): void
         $result = $view->renderFile(__DIR__ . '/Support/main.php');
 
         $this->assertStringContainsString('bootstrap.bundle.min.js', $result);
-
         $this->assertSame(['bootstrap.bundle.min.js'], Yii::$app->assetManager->bundles[BootstrapPluginAsset::class]->js);
         $this->assertFileExists(__DIR__ . '/Support/runtime/16b8de20/bootstrap.bundle.min.js');
         $this->assertFileExists(__DIR__ . '/Support/runtime/16b8de20/bootstrap.bundle.min.js.map');

tests/Support/main.php

@@ -1,4 +1,4 @@
-<?php
-/* @var $this \yii\web\View */
+<?php declare(strict_types=1);
+/** @var \yii\web\View $this */
 ?>
 <?php $this->beginPage();?>1<?php $this->head();?>2<?php $this->beginBody();?>3<?php $this->endBody();?>4<?php $this->endPage();