dragon-code / codestyler
A tool to automatically fix Coding Style Standards issues by The Dragon Code.
Fund package maintenance!
Boosty
Yoomoney
Donationalerts
Installs: 1 268 437
Dependents: 0
Suggesters: 0
Security: 0
Stars: 25
Watchers: 2
Forks: 0
Open Issues: 0
Type:project
Requires
- php: ^8.1
- ext-dom: *
- ext-json: *
- ext-libxml: *
- ext-mbstring: *
- ext-tokenizer: *
- ext-xml: *
Requires (Dev)
- archtechx/enums: ^1.0
- dragon-code/pretty-array: ^4.1
- dragon-code/support: ^6.12.0
- friendsofphp/php-cs-fixer: ^3.49.0
- illuminate/view: ^10.44.0
- kubawerlos/php-cs-fixer-custom-fixers: ^3.20.0
- laravel-zero/framework: ^10.3.0
- mockery/mockery: ^1.6.7
- nunomaduro/termwind: ^1.15.1
- pedrotroller/php-cs-custom-fixer: ^2.33.0
- pestphp/pest: ^2.33.6
- seld/jsonlint: ^1.10.2
- symfony/yaml: ^6.4.3 || ^7.0
- dev-main
- 4.x-dev
- 4.2.0
- 4.1.0
- 4.0.5
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- v4
- 3.x-dev
- v3.15.1
- 3.15.0
- v3.14.1
- 3.14.0
- 3.13.0
- v3.12.2
- v3.12.1
- 3.12.0
- 3.11.0
- v3.10.1
- v3.10.0
- v3.9.0
- v3.8.1
- v3.8.0
- v3.7.2
- v3.7.1
- v3.7.0
- v3.6.18
- v3.6.17
- v3.6.16
- v3.6.15
- v3.6.14
- v3.6.13
- v3.6.12
- v3.6.11
- v3.6.8
- v3.6.7
- v3.6.6
- v3.6.5
- v3.6.4
- v3.6.3
- v3.6.2
- v3.6.1
- v3.6.0
- v3.5.1
- v3.5.0
- v3.4.3
- v3.4.2
- v3.4.1
- v3.4.0
- v3.3.4
- v3.3.3
- v3.3.2
- v3.3.1
- v3.3.0
- v3.2.1
- v3.2.0
- v3.1.5
- v3.1.4
- v3.1.3
- v3.1.2
- v3.1.1
- v3.1.0
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- 2.x-dev
- v2.6.24
- v2.6.23
- v2.6.22
- v2.6.21
- v2.6.20
- v2.6.19
- v2.6.18
- v2.6.17
- v2.6.16
- v2.6.15
- v2.6.14
- v2.6.13
- v2.6.12
- v2.6.11
- v2.6.10
- v2.6.9
- v2.6.8
- v2.6.7
- v2.6.6
- v2.6.5
- v2.6.4
- v2.6.3
- v2.6.2
- v2.6.1
- v2.6.0
- v2.5.0
- v2.4.0
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.0
- v2.1.0
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- 1.x-dev
- v1.13.1
- v1.13.0
- v1.12.4
- v1.12.3
- v1.12.2
- v1.12.1
- v1.12.0
- 1.12-rc.1
- v1.11.1
- v1.11.0
- v1.10.8
- v1.10.7
- v1.10.6
- v1.10.5
- v1.10.4
- v1.10.3
- v1.10.2
- v1.10.1
- v1.10.0
- v1.9.0
- v1.8.7
- v1.8.6
- v1.8.5
- v1.8.4
- v1.8.3
- v1.8.2
- v1.8.1
- v1.8.0
- v1.7.0
- v1.6.2
- v1.6.1
- v1.6.0
- dev-dependabot/composer/symfony/http-foundation-6.4.14
- dev-dependabot/composer/symfony/process-6.4.14
This package is auto-updated.
Last update: 2024-11-06 18:10:36 UTC
README
Introduction
The Dragon Code Styler
is an opinionated PHP code style fixer for minimalists.
Codestyler
is built on top of Laravel Pint
and PHP-CS-Fixer, and makes it simple to ensure that your code style
stays clean and consistent.
By default, Codestyler
does not require any configuration and will fix code style issues in your code by following
the opinionated coding style of The Dragon Code
based on the PER
rule
set.
The easiest and free way to say “thank you” to the developers whose packages you use is to “star” the GitHub repository.
See more at https://github.com/symfony/thanks
Installation
Required
- PHP: ^8.1
- Composer: ^2.0
Locally
composer global require dragon-code/codestyler
Usage
When you run the commands in the base path of the project, the composer.json
file will be automatically read, from
which the minimum PHP version for your project will be taken.
This is necessary to draw up rules for applying the Codestyler.
For example, if your project supports PHP 8.0 and above, and you use the mkdir($path, 0755)
function in it, then
applying the rules for PHP 8.0 will break your code because it
will replace 0755
with 0o755
(mkdir($path, 0o755)
).
To prevent this from happening, we check the minimum PHP version.
Please note that the composer.json
file is only read if the script execution is started in the folder with it.
CLI
# Check code-style codestyle --test # Fix code-style codestyle # Update `.editorconfig` codestyle editorconfig # Update Dependabot rules codestyle dependabot # Publishes code-style settings for the phpStorm IDE codestyle phpstorm # Show list of available commands codestyle list
Options
Path
The path to fix
codestyle foo/bar
Test
Test for code style errors without fixing them
codestyle --test
Config
The configuration that should be used. The target directory will read the pint.json
file
from Laravel Pint, minus the style set.
codestyle --config=foo/bar
Risky
Allows to set whether risky rules may run:
codestyle --risky --test codestyle --risky
Dirty
Only fix files that have uncommitted changes.
codestyle --dirty
Bail
Test for code style errors without fixing them and stop on first error
codestyle --bail
Output Format
The output format that should be used.
codestyle --format
List of available formats:
- checkstyle
- gitlab
- json
- junit
- txt
- xml
Help Commands
To view the list of available commands, you can call the console command:
codestyle list
To view extended information on a command, you can use the help
option. For example,
codestyle --help codestyle dependabot --help codestyle editorconfig --help
GitHub Action
ATTENTION
Starting with code styler version 4.2.0, we will no longer support a container for GitHub Actions.
Instead, use direct dependency installation using the examples below.
Create a new .github/workflows/code-style.yml
file and add the content to it:
name: Code Style on: [ push, pull_request ] permissions: write-all jobs: check: runs-on: ubuntu-latest if: ${{ github.event_name != 'push' || github.ref != 'refs/heads/main' }} steps: - name: Checkout code uses: actions/checkout@v4 - name: Setup PHP uses: shivammathur/setup-php@v2 with: extensions: curl, mbstring, zip, pcntl, pdo, pdo_sqlite, iconv, json coverage: none - name: Install dependency run: composer global require dragon-code/codestyler - name: Check the code-style run: codestyle --test fix: runs-on: ubuntu-latest if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }} steps: - name: Checkout code uses: actions/checkout@v4 - name: Setup PHP uses: shivammathur/setup-php@v2 with: extensions: curl, mbstring, zip, pcntl, pdo, pdo_sqlite, iconv, json coverage: none - name: Setup Composer run: | composer global config --no-plugins allow-plugins.dragon-code/codestyler true composer global config --no-plugins allow-plugins.ergebnis/composer-normalize true composer config --no-plugins allow-plugins.dragon-code/codestyler true composer config --no-plugins allow-plugins.ergebnis/composer-normalize true - name: Install dependencies run: | composer global require dragon-code/codestyler composer global require ergebnis/composer-normalize - name: Fix the code-style run: | # Copies the `.editorconfig` file to the folder from which the command is run. # The file contains a complete set of instructions for the IDE that supports EditorConfig. codestyle editorconfig # Copies the `The_Dragon_Code_phpStorm.xml` file to the folder from which the command is run. # The file contains a complete set of instructions for JetBrains PhpStorm. codestyle phpstorm # Creates or updates the `dependabot.yml` file for GitHub Actions. codestyle dependabot # The main script for fixing the project code style codestyle # Provides a composer plugin for normalizing `composer.json`. composer normalize - name: Create a Pull Request uses: peter-evans/create-pull-request@v6 with: branch: code-style branch-suffix: random delete-branch: true title: "🦋 The code style has been fixed" commit-message: 🦋 The code style has been fixed body: The code style has been fixed labels: code-style
You can also use a simplified version of the configuration by linking to our settings.
In this case, the following settings will be applied:
- Always checks if the event is not equal to
push
or the branch is not equal tomain
- Correcting the code style will take the following steps:
- Will add the following plugins to the list
of allowed plugins
in your
composer.json
file:dragon-code/codestyler
ergebnis/composer-normalize
- Updates the
.github/dependabot.yml
file - Updates the
.editorconfig
file - Will correct the order of elements in the
composer.json
file to match the official schema. - Corrects the code style of your project.
- Will add the following plugins to the list
of allowed plugins
in your
name: Code Style on: [ push, pull_request ] permissions: write-all jobs: style: name: Code Style uses: TheDragonCode/.github/.github/workflows/code-style.yml@main
Other CI/CD
composer global require dragon-code/codestyler codestyle <command>
IDE
After executing the codestyle editorconfig
console command, a .editorconfig
file will be added to your application.
If the file already exists, it will be replaced.
In order for your IDE to read the code style settings from it, make sure its support is enabled in the settings.
For example, in phpStorm
the setting is in
the File | Settings | Editor | Code Style:
You can also use the codestyle phpstorm
console command to publish the schema xml file to phpStorm.
You can import this file into the IDE.
License
This package is licensed under the MIT License.