Composer Normalize

https://github.com/ergebnis/composer-normalize
Admin
Composer Normalize is a composer plugin that automatically normalizes and formats composer.json...
Tokens:20,425
Snippets:143
Trust Score:9.5
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install with Phive

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to install ergebnis/composer-normalize with PHIVE.

```sh
phive install ergebnis/composer-normalize
```

--------------------------------

### Install with Composer

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to install ergebnis/composer-normalize as a Composer plugin.

```sh
composer require --dev ergebnis/composer-normalize
```

--------------------------------

### Example output of the version banner

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Version.md

Example console output produced by the banner. It shows the formatted string with the package name, version, and attribution, including the `<info>` tags for styling.

```text
Running <info>ergebnis/composer-normalize</info> 2.53.0 by <info>Andreas Möller</info> and contributors.
```

--------------------------------

### Install composer-normalize as a Composer plugin

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/README.md

Install the plugin as a dev dependency and allow the plugin to run. Use this before running the normalize command.

```sh
composer require --dev ergebnis/composer-normalize
composer config allow-plugins.ergebnis/composer-normalize true
```

--------------------------------

### Declarative usage: install and run via Composer

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Standard installation path: require the plugin as a dev dependency, allow it in Composer config, then run composer normalize. Composer then activates the plugin and its command.

```sh
composer require --dev ergebnis/composer-normalize
composer config allow-plugins.ergebnis/composer-normalize true
composer normalize
```

--------------------------------

### Require ergebnis/composer-normalize

Source: https://github.com/ergebnis/composer-normalize/blob/main/CHANGELOG.md

Command to install the new package name after removal.

```bash
$ composer require ergebnis/composer-normalize
```

--------------------------------

### Catching the Exception marker interface in consumer code

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Exception.md

Example of catching any exception implementing the `Exception` marker interface in consumer code. It shows a try-catch block that runs the normalize command with `--dry-run` and catches `Exception $error`. The comment notes that `ShouldNotHappen` is caught here, and that in practice the command guards recoverable failures with explicit `RuntimeException`s, so this branch signals an invariant violation.

```php
use Composer\Console\Application;
use Ergebnis\Composer\Normalize\Exception;
use Ergebnis\Composer\Normalize\NormalizePlugin;
use Symfony\Component\Console;

try {
    $plugin = new NormalizePlugin();

    $application = new Application();
    $application->addCommands($plugin->getCommands());
    $application->setAutoExit(false);

    $exitCode = $application->run(
        new Console\Input\ArrayInput(['command' => 'normalize', '--dry-run' => true]),
        new Console\Output\BufferedOutput(),
    );
} catch (Exception $error) {
    // Catches ShouldNotHappen (and any future exception class implementing the marker).
    // Note: a thrown ShouldNotHappen escapes execute() uncaught; in practice the
    // command already guards every recoverable failure with explicit RuntimeExceptions,
    // so this branch signals an invariant violation inside the command itself.
}
```

--------------------------------

### Error handling — a normalizer that throws a runtime failure

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizeCommand.md

Shows how to handle a normalizer that throws a RuntimeException. The example uses a custom failing normalizer, runs the command with --dry-run, and expects exit code 1 with output containing 'simulated failure' and no file modification.

```php
use Ergebnis\Json\Json;
use Ergebnis\Json\Normalizer;

$failingNormalizer = new class('simulated failure') implements Normalizer\Normalizer {
    private string $message;

    public function __construct(string $message)
    {
        $this->message = $message;
    }

    public function normalize(Json $json): Json
    {
        throw new \RuntimeException($this->message);
    }
};

$application = new Application();
$application->add(new Command\NormalizeCommand(
    new Factory(),
    $failingNormalizer,
    new Printer\Printer(),
    new Diff\Differ(new Diff\Output\StrictUnifiedDiffOutputBuilder([
        'fromFile' => 'original',
        'toFile' => 'normalized',
    ])),
));
$application->setAutoExit(false);

$exitCode = $application->run(
    new Console\Input\ArrayInput(['command' => 'normalize', '--dry-run' => true]),
    new Console\Output\BufferedOutput(),
);
// $exitCode === 1; output contains "simulated failure" and no file is modified.
```

--------------------------------

### Remove localheinz/composer-normalize

Source: https://github.com/ergebnis/composer-normalize/blob/main/CHANGELOG.md

Command to remove the old package name before installing the new one.

```bash
$ composer remove localheinz/composer-normalize
```

--------------------------------

### Standalone entry (as used by phar/composer-normalize.php)

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizeCommand.md

Shows how to instantiate NormalizeCommand with a Factory, ComposerJsonNormalizer, Printer, and Differ, then run it via a Symfony Console Application. The schema is passed as a plain filesystem path, which is accepted by ComposerJsonNormalizer.

```php
use Composer\Console\Application;
use Composer\Factory;
use Ergebnis\Composer\Normalize\Command;
use Ergebnis\Json\Normalizer;
use Ergebnis\Json\Printer;
use Localheinz\Diff;
use Symfony\Component\Console;

$command = new Command\NormalizeCommand(
    new Factory(),
    new Normalizer\Vendor\Composer\ComposerJsonNormalizer(__DIR__ . '/../resource/schema.json'),
    new Printer\Printer(),
    new Diff\Differ(new Diff\Output\StrictUnifiedDiffOutputBuilder([
        'fromFile' => 'original',
        'toFile' => 'normalized',
    ])),
);

$application = new Application();
$application->add($command);

if (1 === \count($argv) || 'normalize' !== $argv[1]) {
    \array_splice($argv, 1, 0, ['normalize']);
}

$application->run(new Console\Input\ArgvInput($argv));
```

--------------------------------

### Allow plugin with Composer config

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to allow the plugin to run as a Composer plugin. The allow-plugins setting was added to Composer for security.

```shell
composer config allow-plugins.ergebnis/composer-normalize true
```

--------------------------------

### getCommands() method

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Returns a list containing a single NormalizeCommand wired with production defaults: a new Factory, a ComposerJsonNormalizer using a file:// URI to the bundled schema, a Printer, and a Differ with StrictUnifiedDiffOutputBuilder.

```php
public function getCommands(): array
{
    return [
        new Command\NormalizeCommand(
            new Factory(),
            new Normalizer\Vendor\Composer\ComposerJsonNormalizer(\sprintf(
                'file://%s',
                \realpath(__DIR__ . '/../resource/schema.json'),
            )),
            new Printer\Printer(),
            new Diff\Differ(new Diff\Output\StrictUnifiedDiffOutputBuilder([
                'fromFile' => 'original',
                'toFile' => 'normalized',
            ])),
        ),
    ];
}

```

--------------------------------

### getCapabilities() method

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Returns a capability map with a single entry mapping CommandProvider to the plugin class itself. Composer queries this to determine the plugin's capabilities.

```php
public function getCapabilities(): array
{
    return [
        Plugin\Capability\CommandProvider::class => self::class,
    ];
}

```

--------------------------------

### create() method signature

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Exception.md

Shows the signature of the `create()` static method. It takes no parameters and returns `self`, an instance of `ShouldNotHappen` with the fixed message 'This should not happen.'.

```php
public static function create(): self
```

--------------------------------

### activate() method

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Composer plugin lifecycle hook invoked on activation. The implementation is deliberately empty.

```php
public function activate(
    Composer $composer,
    IO\IOInterface $io
): void {
}

```

--------------------------------

### Version::long() method signature

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Version.md

Public static method that returns a string. It renders the version banner using the package name, version, and attribution. The method is the only meaningful entry point since the class is final and all members are static.

```php
public static function long(): string
```

--------------------------------

### uninstall() method

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Composer plugin lifecycle hook invoked on uninstall. The implementation is deliberately empty.

```php
public function uninstall(
    Composer $composer,
    IO\IOInterface $io
): void {
}

```

--------------------------------

### Make Phar executable

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to make the downloaded composer-normalize.phar executable.

```sh
chmod +x composer-normalize.phar
```

--------------------------------

### Normalize with Composer

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to normalize composer.json in the working directory.

```sh
composer normalize
```

--------------------------------

### Run the standalone PHAR executable

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/README.md

Run the standalone PHAR to normalize composer.json. Use --dry-run to check without modifying, and --no-ansi to disable colored output.

```sh
./composer-normalize.phar
./composer-normalize.phar --dry-run composer.json
./composer-normalize.phar --dry-run --no-ansi composer.json
```

--------------------------------

### Normalize with Phive

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to normalize composer.json in the working directory using the Phive-installed tool.

```sh
./tools/composer-normalize
```

--------------------------------

### Programmatic usage: create plugin and run normalize command

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Instantiates NormalizePlugin, filters its commands to find NormalizeCommand, and runs it with --dry-run using a Symfony Console application. Requires Composer and Symfony Console classes.

```php
use Composer\Console\Application;
use Ergebnis\Composer\Normalize\Command;
use Ergebnis\Composer\Normalize\NormalizePlugin;
use Symfony\Component\Console;

$plugin = new NormalizePlugin();

$commands = \array_filter($plugin->getCommands(), static function ($command): bool {
    return $command instanceof Command\NormalizeCommand;
});

$normalizeCommand = \array_shift($commands);

$application = new Application();
$application->addCommands([$normalizeCommand]);
$application->setAutoExit(false);

$exitCode = $application->run(
    new Console\Input\ArrayInput([
        'command' => 'normalize',
        '--dry-run' => true,
    ]),
    new Console\Output\BufferedOutput(),
);
```

--------------------------------

### Normalize with Phar

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command to normalize composer.json in the working directory using the Phar.

```sh
./composer-normalize.phar
```

--------------------------------

### NormalizeCommand constructor signature

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizeCommand.md

Shows the constructor signature for NormalizeCommand. It accepts four required parameters: Factory, Normalizer, PrinterInterface, and Differ. The constructor is used to inject dependencies for creating the Composer instance, normalizing composer.json, printing JSON, and rendering diffs.

```php
public function __construct(
    Factory $factory,
    Normalizer\Normalizer $normalizer,
    Printer\PrinterInterface $printer,
    Diff\Differ $differ
)
```

--------------------------------

### Run composer normalize with various options

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/README.md

Normalize composer.json in the working directory or a specific file. Use --dry-run to fail (exit 1) if not normalized without modifying files, --diff to show the diff, and --indent-size/--indent-style to control formatting.

```sh
composer normalize                       # normalize composer.json in the working directory
composer normalize path/to/composer.json # normalize a specific file
composer normalize --dry-run             # CI: fail (exit 1) if not normalized, never modify files
composer normalize --diff                # show the diff without modifying files
composer normalize --indent-size 2 --indent-style space
```

--------------------------------

### Version class declaration with constants and placeholder property

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Version.md

Declares the final `Version` class with private constants `NAME` and `ATTRIBUTION`, and a private static `$version` property initialized to the `@git@` placeholder. The placeholder is replaced by `humbug/box` when the PHAR is built from a git tag.

```php
/**
 * @internal
 */
final class Version
{
    private const NAME = 'ergebnis/composer-normalize';
    private const ATTRIBUTION = 'by <info>Andreas Möller</info> and contributors';

    /**
     * @see https://github.com/box-project/box/blob/master/doc/configuration.md#pretty-git-tag-placeholder-git
     */
    private static string $version = '@git@';
```

--------------------------------

### Configure indent-size and indent-style in composer.json extra

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/configuration.md

Use this JSON block in the project's composer.json to override the indent style and size. The configuration always overrides command line options. The indent-size must be an integer greater than 0, and indent-style must be either "space" or "tab".

```json
{
  "extra": {
    "composer-normalize": {
      "indent-size": 2,
      "indent-style": "space"
    }
  }
}
```

--------------------------------

### Run normalize with --dry-run for CI

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Run this command in continuous integration to check if composer.json is normalized. It fails with exit code 1 and shows a diff if not normalized or if composer.lock is not up-to-date.

```sh
composer normalize --dry-run
```

--------------------------------

### PSR-4 autoloading configuration from composer.json

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/README.md

Defines the PSR-4 autoloading for the project, mapping the 'Ergebnis\Composer\Normalize\' namespace to 'src/' and the test namespace to 'test/'. Use this configuration to ensure classes are loaded correctly.

```json
{
  "autoload": {
    "psr-4": {
      "Ergebnis\\Composer\\Normalize\\": "src/"
    }
  },
  "autoload-dev": {
    "psr-4": {
      "Ergebnis\\Composer\\Normalize\\Test\\": "test/"
    }
  }
}
```

--------------------------------

### composer.json plugin registration

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Configures the package as a Composer plugin with type composer-plugin, extra.class pointing to NormalizePlugin, and plugin-optional true. Also includes allow-plugins settings for dependencies.

```json
{
  "type": "composer-plugin",
  "extra": {
    "class": "Ergebnis\\Composer\\Normalize\\NormalizePlugin",
    "plugin-optional": true
  },
  "config": {
    "allow-plugins": {
      "composer/package-versions-deprecated": true,
      "phpstan/extension-installer": true
    }
  }
}
```

--------------------------------

### Delete backup files

Source: https://github.com/ergebnis/composer-normalize/blob/main/CHANGELOG.md

Command to remove the .bak backup files created by the previous sed command.

```bash
$ find -type f -name '*.bak' -delete
```

--------------------------------

### execute() method signature

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizeCommand.md

The protected execute() method signature for the NormalizeCommand. It accepts console input and output interfaces and returns an integer exit code.

```php
protected function execute(
    Console\Input\InputInterface $input,
    Console\Output\OutputInterface $output
): int {
```

--------------------------------

### Usage of Version::long() in NormalizeCommand::execute()

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Version.md

Shows how the banner is printed by `NormalizeCommand::execute()` before any normalization work. The `$io->write()` call uses `Version::long()` to output the version banner.

```php
$io->write([
    \sprintf(
        'Running %s.',
        Version::long(),
    ),
    '',
]);
```

--------------------------------

### Catch exceptions from NormalizeCommand in PHP

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/errors.md

Use this try-catch block when reusing NormalizeCommand in consumer code to handle the package's exception types. ShouldNotHappen indicates an invariant violation with message 'This should not happen.', Exception covers any other future package exception, and RuntimeException catches validation messages #1-#11 when the helpers are reused. Note that when driving the command through a console application, validation failures do not throw but are converted to exit code 1 and <error>-tagged output.

```php
use Ergebnis\Composer\Normalize\Exception;
use Ergebnis\Composer\Normalize\Exception\ShouldNotHappen;

try {
    // run NormalizeCommand via Composer\Console\Application
} catch (ShouldNotHappen $error) {
    // invariant violation; getMessage() === 'This should not happen.'
} catch (Exception $error) {
    // any other future package exception
} catch (\RuntimeException $error) {
    // the validation messages #1-#11 above when the helpers are reused
}
```

--------------------------------

### Class declaration of NormalizePlugin

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Declares the final class implementing Composer's PluginInterface, Capable, and CommandProvider interfaces. No explicit constructor is defined, so the implicit no-argument constructor is used.

```php
final class NormalizePlugin implements
    Plugin\Capability\CommandProvider,
    Plugin\Capable,
    Plugin\PluginInterface
{

```

--------------------------------

### ShouldNotHappen exception class definition

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Exception.md

Defines the `ShouldNotHappen` final class that extends `\LogicException` and implements the `Exception` marker interface. It provides a static factory method `create()` that returns an instance with the fixed message 'This should not happen.'.

```php
final class ShouldNotHappen extends \LogicException implements Exception
{
    public static function create(): self
    {
        return new self('This should not happen.');
    }
}
```

--------------------------------

### NormalizeCommand class declaration

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizeCommand.md

Declares the final NormalizeCommand class extending Composer\Command\BaseCommand. Marked @internal, it is not part of the public package surface. The constructor injects Factory, Normalizer, Printer, and Differ dependencies, and registers the command under the name 'normalize' via the parent constructor.

```php
/**
 * @internal
 */
final class NormalizeCommand extends Command\BaseCommand
{
    private Diff\Differ $differ;
    private Printer\PrinterInterface $printer;
    private Normalizer\Normalizer $normalizer;
    private Factory $factory;

    public function __construct(
        Factory $factory,
        Normalizer\Normalizer $normalizer,
        Printer\PrinterInterface $printer,
        Diff\Differ $differ
    ) {
        $this->factory = $factory;
        $this->normalizer = $normalizer;
        $this->printer = $printer;
        $this->differ = $differ;

        parent::__construct('normalize');
    }
```

--------------------------------

### Diff of composer.json after normalize

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

The diff output produced by running composer normalize against the pestphp/pest project's composer.json. It shows the reordering of sections and addition of scripts.

```diff
diff --git a/composer.json b/composer.json
index 1cfbf1e..204f20f 100644
--- a/composer.json
+++ b/composer.json
@@ -25,6 +25,32 @@
         "pestphp/pest-plugin-init": "^0.3",
         "phpunit/phpunit": ">= 9.3.7 <= 9.5.0"
     },
+    "require-dev": {
+        "illuminate/console": "^7.16.1",
+        "illuminate/support": "^7.16.1",
+        "laravel/dusk": "^6.9.1",
+        "mockery/mockery": "^1.4.1",
+        "pestphp/pest-dev-tools": "dev-master"
+    },
+    "config": {
+        "preferred-install": "dist",
+        "sort-packages": true
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "0.3.x-dev"
+        },
+        "laravel": {
+            "providers": [
+                "Pest\\Laravel\\PestServiceProvider"
+            ]
+        },
+        "pest": {
+            "plugins": [
+                "Pest\\Plugins\\Version"
+            ]
+        }
+    },
     "autoload": {
         "psr-4": {
             "Pest\\": "src/"
@@ -42,49 +68,23 @@
             "tests/Autoload.php"
         ]
     },
-    "require-dev": {
-        "illuminate/console": "^7.16.1",
-        "illuminate/support": "^7.16.1",
-        "laravel/dusk": "^6.9.1",
-        "mockery/mockery": "^1.4.1",
-        "pestphp/pest-dev-tools": "dev-master"
-    },
     "minimum-stability": "dev",
     "prefer-stable": true,
-    "config": {
-        "sort-packages": true,
-        "preferred-install": "dist"
-    },
     "bin": [
         "bin/pest"
     ],
     "scripts": {
         "lint": "php-cs-fixer fix -v",
-        "test:lint": "php-cs-fixer fix -v --dry-run",
-        "test:types": "phpstan analyse --ansi --memory-limit=0",
-        "test:unit": "php bin/pest --colors=always --exclude-group=integration",
-        "test:integration": "php bin/pest --colors=always --group=integration",
-        "update:snapshots": "REBUILD_SNAPSHOTS=true php bin/pest --colors=always",
         "test": [
             "@test:lint",
             "@test:types",
             "@test:unit",
             "@test:integration"
-        ]
-    },
-    "extra": {
-        "branch-alias": {
-            "dev-master": "0.3.x-dev"
-        },
-        "pest": {
-            "plugins": [
-                "Pest\\Plugins\\Version"
-            ]
-        },
-        "laravel": {
-            "providers": [
-                "Pest\\Laravel\\PestServiceProvider"
-            ]
-        }
+        ],
+        "test:integration": "php bin/pest --colors=always --group=integration",
+        "test:lint": "php-cs-fixer fix -v --dry-run",
+        "test:types": "phpstan analyse --ansi --memory-limit=0",
+        "test:unit": "php bin/pest --colors=always --exclude-group=integration",
+        "update:snapshots": "REBUILD_SNAPSHOTS=true php bin/pest --colors=always"
     }
 }
```

--------------------------------

### Catching ShouldNotHappen directly

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Exception.md

Shows how to catch `ShouldNotHappen` separately in consumer code, since it extends `\LogicException`. The comment notes that in this branch, `$error->getMessage() === 'This should not happen.'`.

```php
} catch (ShouldNotHappen $error) {
    // invariant violated; $error->getMessage() === 'This should not happen.'
}
```

--------------------------------

### Replace Localheinz namespace with Ergebnis

Source: https://github.com/ergebnis/composer-normalize/blob/main/CHANGELOG.md

Command to replace occurrences of 'Localheinz\Composer\Normalize' with 'Ergebnis\Composer\Normalize' in all files.

```bash
$ find . -type f -exec sed -i '.bak' 's/Localheinz\Composer\Normalizer/Ergebnis\Composer\Normalize/g' {} \;
```

--------------------------------

### Diff of normalized composer.json

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

Shows the diff produced by running composer normalize against the phpunit/phpunit composer.json (version 9.5.0). The diff reorders fields, moves sections, and adds/removes entries to conform to the normalization rules.

```diff
diff --git a/composer.json b/composer.json
index fd6461fc3..23c3a3596 100644
--- a/composer.json
+++ b/composer.json
@@ -1,7 +1,7 @@
 {
     "name": "phpunit/phpunit",
-    "description": "The PHP Unit Testing framework.",
     "type": "library",
+    "description": "The PHP Unit Testing framework.",
     "keywords": [
         "phpunit",
         "xunit",
@@ -16,10 +16,6 @@
             "role": "lead"
         }
     ],
-    "support": {
-        "issues": "https://github.com/sebastianbergmann/phpunit/issues"
-    },
-    "prefer-stable": true,
     "require": {
         "php": ">=7.3",
         "ext-dom": "*",
@@ -54,20 +50,22 @@
         "ext-PDO": "*",
         "phpspec/prophecy-phpunit": "^2.0.1"
     },
+    "suggest": {
+        "ext-soap": "*",
+        "ext-xdebug": "*"
+    },
     "config": {
+        "optimize-autoloader": true,
         "platform": {
             "php": "7.3.0"
         },
-        "optimize-autoloader": true,
         "sort-packages": true
     },
-    "suggest": {
-        "ext-soap": "*",
-        "ext-xdebug": "*"
+    "extra": {
+        "branch-alias": {
+            "dev-master": "9.5-dev"
+        }
     },
-    "bin": [
-        "phpunit"
-    ],
     "autoload": {
         "classmap": [
             "src/"
@@ -86,9 +84,11 @@
             "tests/_files/NamespaceCoveredFunction.php"
         ]
     },
-    "extra": {
-        "branch-alias": {
-            "dev-master": "9.5-dev"
-        }
+    "prefer-stable": true,
+    "bin": [
+        "phpunit"
+    ],
+    "support": {
+        "issues": "https://github.com/sebastianbergmann/phpunit/issues"
     }
 }
```

--------------------------------

### Diff output from composer normalize on phpspec/phpspec

Source: https://github.com/ergebnis/composer-normalize/blob/main/README.md

The diff generated by running `composer normalize` on the phpspec/phpspec composer.json. It shows the reformatting of the JSON structure and changes to dependency versions and the addition of a conflict section.

```diff
diff --git a/composer.json b/composer.json
index 90150a37..276a2ecd 100644
--- a/composer.json
+++ b/composer.json
@@ -1,72 +1,73 @@
 {
-    "name":         "phpspec/phpspec",
-    "description":  "Specification-oriented BDD framework for PHP 7.1+",
-    "keywords":     ["BDD", "SpecBDD", "TDD", "spec", "specification", "tests", "testing"],
-    "homepage":     "http://phpspec.net/",
-    "type":         "library",
-    "license":      "MIT",
-    "authors":      [
+    "name": "phpspec/phpspec",
+    "type": "library",
+    "description": "Specification-oriented BDD framework for PHP 7.1+",
+    "keywords": [
+        "BDD",
+        "SpecBDD",
+        "TDD",
+        "spec",
+        "specification",
+        "tests",
+        "testing"
+    ],
+    "homepage": "http://phpspec.net/",
+    "license": "MIT",
+    "authors": [
         {
-            "name":      "Konstantin Kudryashov",
-            "email":     "ever.zet@gmail.com",
-            "homepage":  "http://everzet.com"
+            "name": "Konstantin Kudryashov",
+            "email": "ever.zet@gmail.com",
+            "homepage": "http://everzet.com"
         },
         {
-            "name":      "Marcello Duarte",
-            "homepage":  "http://marcelloduarte.net/"
+            "name": "Marcello Duarte",
+            "homepage": "http://marcelloduarte.net/"
         },
         {
-            "name":      "Ciaran McNulty",
-            "homepage":  "https://ciaranmcnulty.com/"
+            "name": "Ciaran McNulty",
+            "homepage": "https://ciaranmcnulty.com/"
         }
     ],
-
     "require": {
-        "php":                      "^7.3 || 8.0.*",
-        "phpspec/prophecy":         "^1.9",
-        "phpspec/php-diff":         "^1.0.0",
-        "sebastian/exporter":       "^3.0 || ^4.0",
-        "symfony/console":          "^3.4 || ^4.4 || ^5.0",
+        "php": "^7.3 || 8.0.*",
+        "ext-tokenizer": "*",
+        "doctrine/instantiator": "^1.0.5",
+        "phpspec/php-diff": "^1.0.0",
+        "phpspec/prophecy": "^1.9",
+        "sebastian/exporter": "^3.0 || ^4.0",
+        "symfony/console": "^3.4 || ^4.4 || ^5.0",
         "symfony/event-dispatcher": "^3.4 || ^4.4 || ^5.0",
-        "symfony/process":          "^3.4 || ^4.4 || ^5.0",
-        "symfony/finder":           "^3.4 || ^4.4 || ^5.0",
-        "symfony/yaml":             "^3.4 || ^4.4 || ^5.0",
-        "doctrine/instantiator":    "^1.0.5",
-        "ext-tokenizer":            "*"
+        "symfony/finder": "^3.4 || ^4.4 || ^5.0",
+        "symfony/process": "^3.4 || ^4.4 || ^5.0",
+        "symfony/yaml": "^3.4 || ^4.4 || ^5.0"
+    },
+    "conflict": {
+        "sebastian/comparator": "<1.2.4"
     },
-
     "require-dev": {
-        "behat/behat":           "^3.3",
-        "symfony/filesystem":    "^3.4 || ^4.0 || ^5.0",
-        "phpunit/phpunit":       "^8.0 || ^9.0"
+        "behat/behat": "^3.3",
+        "phpunit/phpunit": "^8.0 || ^9.0",
+        "symfony/filesystem": "^3.4 || ^4.0 || ^5.0"
     },
-
     "suggest": {
         "phpspec/nyan-formatters": "Adds Nyan formatters"
     },
-
-    "conflict": {
-        "sebastian/comparator" : "<1.2.4"
+    "extra": {
+        "branch-alias": {
+            "dev-main": "7.0.x-dev"
+        }
     },
-
     "autoload": {
         "psr-0": {
             "PhpSpec": "src/"
         }
     },
-
     "autoload-dev": {
         "psr-0": {
             "spec\\PhpSpec": "."
         }
     },
-
-    "bin": ["bin/phpspec"],
-
-    "extra": {
-        "branch-alias": {
-            "dev-main": "7.0.x-dev"
-        }
-    }
-
+    "bin": [
+        "bin/phpspec"
+    ]
 }

```

--------------------------------

### Exception marker interface definition

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/Exception.md

Defines the `Exception` interface that extends `\Throwable`. It is a marker interface with no members, used to tag all exceptions thrown by this package so consumer code can catch them with a single `catch (Exception $error)` clause.

```php
interface Exception extends \Throwable
{
}
```

--------------------------------

### deactivate() method

Source: https://github.com/ergebnis/composer-normalize/blob/main/_autodocs/api-reference/NormalizePlugin.md

Composer plugin lifecycle hook invoked on deactivation. The implementation is deliberately empty.

```php
public function deactivate(
    Composer $composer,
    IO\IOInterface $io
): void {
}

```
Tokens:
Raw