Updated docs.

.customizer.php

@@ -14,7 +14,7 @@ class CustomizerConfig {
   /**
    * Messages used by the command.
    *
-   * @param CustomizeCommand $command
+   * @param CustomizeCommand $customizer
    *   The command instance.
    *
    * @return array<string,string|array<string>>
@@ -23,7 +23,7 @@ class CustomizerConfig {
    *
    * @SuppressWarnings(PHPMD.UnusedFormalParameter)
    */
-  public static function messages(CustomizeCommand $command): array {
+  public static function messages(CustomizeCommand $customizer): array {
     return [
       // This is an example of a custom message that overrides the default
       // message with name `welcome`.
@@ -38,13 +38,12 @@ public static function messages(CustomizeCommand $command): array {
    * in the order they are defined. Questions can use answers from previous
    * questions received so far.
    *
-   * Questions defined here will **fully override** any questions defined in
-   * the Customizer (if any).
-   *
    * Answers will be processed in the order they are defined. Process callbacks
-   * have access to all answers and Customizer classes properties and methods.
+   * have access to all answers and Customizer's class public properties and
+   * methods.
+   *
    * If a question does not have a process callback, a static method prefixed
-   * with 'process' and a camel cased question title will be called. If the
+   * with `process` and a camel-cased question title will be called. If the
    * method does not exist, there will be no processing.
    *
    * @code
@@ -71,7 +70,7 @@ public static function messages(CustomizeCommand $command): array {
    * ];
    * @endcode
    *
-   * @param CustomizeCommand $command
+   * @param CustomizeCommand $customizer
    *   The CustomizeCommand object. Can be used to access the command properties
    *   and methods to prepare questions. Note that the questions callbacks
    *   already receive the command object as an argument, so this argument is
@@ -96,7 +95,7 @@ public static function messages(CustomizeCommand $command): array {
    * @SuppressWarnings(PHPMD.ExcessiveMethodLength)
    * @SuppressWarnings(PHPMD.UnusedFormalParameter)
    */
-  public static function questions(CustomizeCommand $command): array {
+  public static function questions(CustomizeCommand $customizer): array {
     // This an example of questions that can be asked to customize the project.
     // You can adjust this method to ask questions that are relevant to your
     // project.
@@ -108,9 +107,10 @@ public static function questions(CustomizeCommand $command): array {
       'Name' => [
         // The question callback function defines how the question is asked.
         // In this case, we ask the user to provide a package name as a string.
-        'question' => static fn(array $answers, CustomizeCommand $command): mixed => $command->io->ask('Package name', NULL, static function (string $value): string {
+        'question' => static fn(array $answers, CustomizeCommand $customizer): mixed => $customizer->io->ask('Package name', NULL, static function (string $value): string {
           // This is a validation callback that checks if the package name is
-          // valid. If not, an exception is thrown.
+          // valid. If not, an exception is thrown with a message shown to the
+          // user.
           if (!preg_match('/^[a-z0-9_.-]+\/[a-z0-9_.-]+$/', $value)) {
             throw new \InvalidArgumentException(sprintf('The package name "%s" is invalid, it should be lowercase and have a vendor name, a forward slash, and a package name.', $value));
           }
@@ -119,32 +119,34 @@ public static function questions(CustomizeCommand $command): array {
         }),
         // The process callback function defines how the answer is processed.
         // The processing takes place only after all answers are received and
-        // the user confirms the changes.
-        'process' => static function (string $title, string $answer, array $answers, CustomizeCommand $command): void {
+        // the user confirms the intended changes.
+        'process' => static function (string $title, string $answer, array $answers, CustomizeCommand $customizer): void {
+          $name = $customizer->packageData['name'];
           // Update the package data.
-          $command->packageData['name'] = $answer;
+          $customizer->packageData['name'] = $answer;
           // Write the updated composer.json file.
-          $command->writeComposerJson($command->packageData);
-          // Also, replace the package name in the project files.
-          $command->replaceInPath($command->cwd, $answer, $answer);
+          $customizer->writeComposerJson($customizer->packageData);
+          // Replace the package name in the project files.
+          $customizer->replaceInPath($customizer->cwd, $name, $answer);
         },
       ],
       'Description' => [
         // For this question, we are using an answer from the previous question
         // in the title of the question.
-        'question' => static fn(array $answers, CustomizeCommand $command): mixed => $command->io->ask(sprintf('Description for %s', $answers['Name'])),
-        'process' => static function (string $title, string $answer, array $answers, CustomizeCommand $command): void {
-          $command->packageData['description'] = $answer;
-          $command->writeComposerJson($command->packageData);
-          $command->replaceInPath($command->cwd, $answer, $answer);
+        'question' => static fn(array $answers, CustomizeCommand $customizer): mixed => $customizer->io->ask(sprintf('Description for %s', $answers['Name'])),
+        'process' => static function (string $title, string $answer, array $answers, CustomizeCommand $customizer): void {
+          $description = $customizer->packageData['description'];
+          $customizer->packageData['description'] = $answer;
+          $customizer->writeComposerJson($customizer->packageData);
+          $customizer->replaceInPath($customizer->cwd, $description, $answer);
         },
       ],
       'License' => [
-        // For this question, we are using a predefined list of options.
+        // For this question, we are using a pre-defined list of options.
         // For processing, we are using a separate method named 'processLicense'
         // (only for the demonstration purposes; it could have been an
         // anonymous function).
-        'question' => static fn(array $answers, CustomizeCommand $command): mixed => $command->io->choice('License type', [
+        'question' => static fn(array $answers, CustomizeCommand $customizer): mixed => $customizer->io->choice('License type', [
           'MIT',
           'GPL-3.0-or-later',
           'Apache-2.0',
@@ -165,14 +167,14 @@ public static function questions(CustomizeCommand $command): array {
    *   The answer to the question.
    * @param array<string,string> $answers
    *   All answers received so far.
-   * @param CustomizeCommand $command
+   * @param CustomizeCommand $customizer
    *   The command instance.
    *
    * @SuppressWarnings(PHPMD.UnusedFormalParameter)
    */
-  public static function processLicense(string $title, string $answer, array $answers, CustomizeCommand $command): void {
-    $command->packageData['license'] = $answer;
-    $command->writeComposerJson($command->packageData);
+  public static function processLicense(string $title, string $answer, array $answers, CustomizeCommand $customizer): void {
+    $customizer->packageData['license'] = $answer;
+    $customizer->writeComposerJson($customizer->packageData);
   }
 
 }

.gitattributes

@@ -4,8 +4,9 @@
 /.gitattributes  export-ignore
 /.github         export-ignore
 /.gitignore      export-ignore
-/tests           export-ignore
+/logo.png        export-ignore
 /phpcs.xml       export-ignore
 /phpmd.xml       export-ignore
 /phpstan.neon    export-ignore
-/phpunit.xml     export-ignore
+/rector.php      export-ignore
+/renovate.json  export-ignore

CustomizeCommand.php

@@ -422,14 +422,14 @@ protected function message(string $name, array $tokens = []): string {
   /**
    * Run a command.
    *
-   * @param string $command
+   * @param string $cmd
    *   Command to run.
    *
    * @throws \Exception
    *   If the command fails.
    */
-  protected static function passthru(string $command): void {
-    passthru($command, $status);
+  protected static function passthru(string $cmd): void {
+    passthru($cmd, $status);
     if ($status != 0) {
       throw new \Exception('Command failed with exit code ' . $status);
     }
@@ -601,7 +601,7 @@ public static function arrayUnsetDeep(array &$array, array $path, ?string $value
    * class will **recursively replace** the messages defined here. This means
    * that only specific messages may be overridden by the configuration class.
    *
-   * @param CustomizeCommand $command
+   * @param CustomizeCommand $customizer
    *   The command instance.
    *
    * @return array<string,string|array<string>>
@@ -610,7 +610,7 @@ public static function arrayUnsetDeep(array &$array, array $path, ?string $value
    *
    * @SuppressWarnings(PHPMD.UnusedFormalParameter)
    */
-  public static function messages(CustomizeCommand $command): array {
+  public static function messages(CustomizeCommand $customizer): array {
     return [
       'welcome' => 'Welcome to {{ package.name }} project customizer',
       'banner' => [
@@ -656,7 +656,7 @@ public static function messages(CustomizeCommand $command): array {
    *
    * @SuppressWarnings(PHPMD.UnusedFormalParameter)
    */
-  public static function questions(CustomizeCommand $command): array {
+  public static function questions(CustomizeCommand $customizer): array {
     return [];
   }