base on Remove "final" keywords from classes and methods in vendor packages. <h1 align="center">Unfinalize</h1> <p align="center"> Unleash the freedom lost with open source PHP packages marking classes and methods as <code>final</code>. </p> <p align="center"> <a href="https://github.com/stevebauman/unfinalize/actions" target="_blank"><img src="https://img.shields.io/github/actions/workflow/status/stevebauman/unfinalize/run-tests.yml?branch=master&style=flat-square"/></a> <a href="https://packagist.org/packages/stevebauman/unfinalize" target="_blank"><img src="https://img.shields.io/packagist/v/stevebauman/unfinalize.svg?style=flat-square"/></a> <a href="https://packagist.org/packages/stevebauman/unfinalize" target="_blank"><img src="https://img.shields.io/packagist/dt/stevebauman/unfinalize.svg?style=flat-square"/></a> <a href="https://packagist.org/packages/stevebauman/unfinalize" target="_blank"><img src="https://img.shields.io/packagist/l/stevebauman/unfinalize.svg?style=flat-square"/></a> </p> --- Unfinalize uses [PHP CS Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer) to permanently remove `final` keywords from composer vendor packages: ```diff - final class Foo + class Foo { - final public function bar() + public function bar() { // ... } } ``` - Updates to PHP files are done safely, quickly, and performant. - Changes are stored permanently. There is no performance impact using Unfinalize. - No additional dependencies to your application. Unfinalize and its dependencies are [compiled into a single phar file](https://github.com/stevebauman/unfinalize/blob/master/builds). ## Installation ```bash composer require stevebauman/unfinalize ``` ## Usage You may unfinalize files using two different methods: [file paths](#file-paths), or [package paths](#package-paths). ### File Paths Using files paths allow you to unfinalize specific files or directories by specifying them in the command: ```bash php vendor/bin/unfinalize run vendor/package/src/File.php ``` You may unfinalize multiple files or directories by separating them by a space: ```bash php vendor/bin/unfinalize run vendor/package/src/Foo/ vendor/package/src/Bar/File.php ``` To make sure this is always done on your project's dependencies, add the command to your `composer.json` file in the `scripts` property: ```json { "scripts": { "post-update-cmd": [ "@php vendor/bin/unfinalize run vendor/package/src/Foo/ vendor/package/src/Bar/File.php" ] } } ``` Then run `composer update`. ### Package Paths Using package paths allow you to unfinalize entire packages by specifying them in your `composer.json` file. Add the vendor packages you want to remove the final keywords from inside an `unfinalize` property: ```json { "unfinalize": [ "vendor/package" ] } ``` Add the unfinalize command to your `composer.json` so it runs on `composer update`: ```json { "scripts": { "post-update-cmd": [ "@php vendor/bin/unfinalize run" ] } } ``` Then, run `composer update`. ### Options #### `--annotate={annotation}` If you would like final classes and methods to be marked with an annotation (`@{annotation}`) doc block after unfinalizing, you may add the `--annotate` option to the unfinalize command: > If an annotation already exists in a doc block then it will be left untouched. ```json { "scripts": { "post-update-cmd": [ "@php vendor/bin/unfinalize run --annotate=internal" ] } } ``` Which will produce: **Before**: ```php final class Foo { final public function bar() { // ... } } ``` **After**: ```php /** * @internal */ class Foo { /** * @internal */ public function bar() { // ... } } ``` #### `--properties={protected/public}` If you would like to change the visibility of `private` properties to `protected` or `public`, you may add the `--properties` option to the unfinalize command with the new visibility to assign: ```json { "scripts": { "post-update-cmd": [ "@php vendor/bin/unfinalize run --properties=protected" ] } } ``` Which will produce: **Before**: ```php class Foo { private $bar; } ``` **After**: ```php class Foo { protected $bar; } ``` #### `--methods={protected/public}` If you would like to change the visibility of `private` methods to `protected` or `public`, you may add the `--methods` option to the unfinalize command with the new visibility to assign: ```json { "scripts": { "post-update-cmd": [ "@php vendor/bin/unfinalize run --methods=public" ] } } ``` Which will produce: **Before**: ```php class Foo { private function bar() { } } ``` **After**: ```php class Foo { public function bar() { } } ``` #### `--dry` Execute a dry run to see what files will be modified by Unfinalize: ```bash vendor/bin/unfinalize run --dry ``` ", Assign "at most 3 tags" to the expected json: {"id":"2723","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"