[#92] Replaced remaining 'build' references with 'packaging' terminology.

Author: AlexSkrypnyk

README.md

@@ -201,7 +201,7 @@ This will create an artifact from current directory and will send it to the
 specified remote repository into the same branch as a current one.
 
 Avoid including development dependencies in your artifacts. Instead, configure
-your CI to build with production-only dependencies, export the resulting code,
+your CI to install production-only dependencies, export the resulting code,
 and use that as the artifact source. See our CI examples below.
 
 Call from the CI configuration or deployment script:
@@ -213,7 +213,7 @@ export DEPLOY_BRANCH=<YOUR_CI_PROVIDER_BRANCH_VARIABLE>
   --push
 ```
 
-CI providers may report branches differently when running builds triggered by tags.
+CI providers may report branches differently when packaging is triggered by tags.
 We encourage you to explore our continuously and automatically tested examples:
 
 - [GitHub Actions](.github/workflows/test-php.yml)
@@ -227,15 +227,15 @@ fully-configured [example in the Vortex project](https://github.com/drevops/vort
 
 | Name                   | Default value       | Description                                                                                    |
 |------------------------|---------------------|------------------------------------------------------------------------------------------------|
-| `--mode`               | `force-push`        | Mode of artifact build: `branch`, `force-push`                                                 |
+| `--mode`               | `force-push`        | Mode of artifact packaging: `branch`, `force-push`                                             |
 | `--branch`             | `[branch]`          | Destination branch with optional tokens (see below)                                            |
 | `--gitignore`          |                     | Path to the `.gitignore` file to replace the current `.gitignore`                              |
 | `--src`                |                     | Directory where source repository is located. Uses root directory if not specified             |
 | `--root`               |                     | Path to the root for file path resolution. Uses current directory if not specified             |
 | `--message`            | `Deployment commit` | Commit message with optional tokens (see below)                                                |
 | `--no-cleanup`         |                     | Do not cleanup after run                                                                       |
 | `--log`                |                     | Path to the log file                                                                           |
-| `--show-changes`       |                     | Show changes made to the repo by the build in the output                                       |
+| `--show-changes`       |                     | Show changes made to the repo during packaging in the output                                   |
 | `--dry-run`            |                     | Run without pushing to the remote repository                                                   |
 | `--now`                |                     | Internal value used to set internal time                                                       |
 | `-h, --help`           |                     | Display help for the given command                                                             |
@@ -248,7 +248,7 @@ fully-configured [example in the Vortex project](https://github.com/drevops/vort
 ## 🧹 Modifying artifact content
 
 `--gitignore` option allows to specify the path to the artifact's `.gitignore`
-file that replaces existing `.gitignore` (if any) during the build. Any files no
+file that replaces existing `.gitignore` (if any) during packaging. Any files no
 longer ignored by the replaced artifact's `.gitignore` are added into the
 deployment commit. If there are no no-longer-excluded files, the deployment
 commit is still created, to make sure that the deployment timestamp is

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "drevops/git-artifact",
-    "description": "Build artifact from your codebase in CI and push it to a separate git repo.",
+    "description": "Package artifact from your codebase in CI and push it to a separate git repo.",
     "license": "GPL-2.0-or-later",
     "type": "package",
     "authors": [

src/Commands/ArtifactCommand.php

@@ -43,7 +43,7 @@ class ArtifactCommand extends Command {
   protected string $sourceDir = '';
 
   /**
-   * Mode in which current build is going to run.
+   * Mode in which artifact packaging is going to run.
    *
    * Available modes: branch, force-push.
    */
@@ -92,7 +92,7 @@ class ArtifactCommand extends Command {
   protected bool $isDryRun = FALSE;
 
   /**
-   * Flag to specify if cleanup is required to run after the build.
+   * Flag to specify if cleanup is required to run after packaging.
    */
   protected bool $needCleanup = TRUE;
 
@@ -102,7 +102,7 @@ class ArtifactCommand extends Command {
   protected string $logFile = '';
 
   /**
-   * Flag to show changes made to the repo by the build in the output.
+   * Flag to show changes made to the repo during packaging in the output.
    */
   protected bool $showChanges = FALSE;
 
@@ -168,12 +168,12 @@ protected function configure(): void {
       ->addOption('dry-run',                NULL, InputOption::VALUE_NONE,     'Run without pushing to the remote repository.')
       ->addOption('gitignore',              NULL, InputOption::VALUE_REQUIRED, 'Path to gitignore file to replace current .gitignore. Leave empty to use current .gitignore.')
       ->addOption('message',                NULL, InputOption::VALUE_REQUIRED, 'Commit message with optional tokens.', 'Deployment commit')
-      ->addOption('mode',                   NULL, InputOption::VALUE_REQUIRED, 'Mode of artifact build: branch, force-push. Defaults to force-push.', static::MODE_FORCE_PUSH)
+      ->addOption('mode',                   NULL, InputOption::VALUE_REQUIRED, 'Mode of artifact packaging: branch, force-push. Defaults to force-push.', static::MODE_FORCE_PUSH)
       ->addOption('no-cleanup',             NULL, InputOption::VALUE_NONE,     'Do not cleanup after run.')
       ->addOption('now',                    NULL, InputOption::VALUE_REQUIRED, 'Internal value used to set internal time.')
       ->addOption('log',                    NULL, InputOption::VALUE_REQUIRED, 'Path to the log file.')
       ->addOption('root',                   NULL, InputOption::VALUE_REQUIRED, 'Path to the root for file path resolution. If not specified, current directory is used.')
-      ->addOption('show-changes',           NULL, InputOption::VALUE_NONE,     'Show changes made to the repo by the build in the output.')
+      ->addOption('show-changes',           NULL, InputOption::VALUE_NONE,     'Show changes made to the repo during packaging in the output.')
       ->addOption('src',                    NULL, InputOption::VALUE_REQUIRED, 'Directory where source repository is located. If not specified, root directory is used.')
       ->addOption('fail-on-missing-branch', NULL, InputOption::VALUE_NONE,     'Fail artifact packaging if source branch cannot be determined. By default, artifact packaging is skipped gracefully.');
     // @formatter:on
@@ -402,13 +402,13 @@ protected function resolveOptions(string $url, array $options): void {
   }
 
   /**
-   * Show artifact build information.
+   * Show artifact packaging information.
    */
   protected function showInfo(): void {
     $lines[] = ('----------------------------------------------------------------------');
     $lines[] = (' Artifact information');
     $lines[] = ('----------------------------------------------------------------------');
-    $lines[] = (' Build timestamp:       ' . date('Y/m/d H:i:s', $this->now));
+    $lines[] = (' Packaging timestamp:   ' . date('Y/m/d H:i:s', $this->now));
     $lines[] = (' Mode:                  ' . $this->mode);
     $lines[] = (' Source repository:     ' . $this->sourceDir);
     $lines[] = (' Remote repository:     ' . $this->remoteUrl);
@@ -431,7 +431,7 @@ protected function showReport(bool $result): void {
     $lines[] = '----------------------------------------------------------------------';
     $lines[] = ' Artifact report';
     $lines[] = '----------------------------------------------------------------------';
-    $lines[] = ' Build timestamp:   ' . date('Y/m/d H:i:s', $this->now);
+    $lines[] = ' Packaging timestamp: ' . date('Y/m/d H:i:s', $this->now);
     $lines[] = ' Mode:              ' . $this->mode;
     $lines[] = ' Source repository: ' . $this->sourceDir;
     $lines[] = ' Remote repository: ' . $this->remoteUrl;
@@ -447,7 +447,7 @@ protected function showReport(bool $result): void {
   }
 
   /**
-   * Set build mode.
+   * Set packaging mode.
    *
    * @param string $mode
    *   Mode to set.

tests/Functional/BranchModeTest.php

@@ -20,7 +20,7 @@ protected function setUp(): void {
     parent::setUp();
   }
 
-  public function testBuild(): void {
+  public function testPackage(): void {
     $this->gitCreateFixtureCommits(2);
 
     $output = $this->assertArtifactCommandSuccess();
@@ -31,7 +31,7 @@ public function testBuild(): void {
     $this->gitAssertFixtureCommits(2, $this->dst, 'testbranch', ['Deployment commit']);
   }
 
-  public function testBuildMoreCommitsSameBranch(): void {
+  public function testPackageMoreCommitsSameBranch(): void {
     $this->gitCreateFixtureCommits(2);
 
     $this->assertArtifactCommandSuccess();
@@ -45,7 +45,7 @@ public function testBuildMoreCommitsSameBranch(): void {
     $this->gitAssertFixtureCommits(2, $this->dst, 'testbranch', ['Deployment commit']);
   }
 
-  public function testBuildMoreCommits(): void {
+  public function testPackageMoreCommits(): void {
     $this->gitCreateFixtureCommits(2);
 
     $this->now = time() - rand(1, 10 * 60);

tests/Functional/ForcePushModeTest.php

@@ -20,7 +20,7 @@ protected function setUp(): void {
     parent::setUp();
   }
 
-  public function testBuild(): void {
+  public function testPackage(): void {
     $this->gitCreateFixtureCommits(2);
 
     $output = $this->assertArtifactCommandSuccess();
@@ -30,7 +30,7 @@ public function testBuild(): void {
     $this->gitAssertFixtureCommits(2, $this->dst, 'testbranch', ['Deployment commit']);
   }
 
-  public function testBuildMoreCommits(): void {
+  public function testPackageMoreCommits(): void {
     $this->gitCreateFixtureCommits(2);
 
     $this->assertArtifactCommandSuccess();
@@ -165,7 +165,7 @@ public function testGitignoreCustom(): void {
 
     // Now, remove the .gitignore and push again.
     // We have to create 'uic' file since it was rightfully
-    // removed during previous build run and the source repo branch was not
+    // removed during previous packaging run and the source repo branch was not
     // reset (uncommitted files would be removed, unless they are excluded
     // in .gitignore).
     $this->fixtureCreateFile($this->src, 'uic');
@@ -266,7 +266,7 @@ public function testGitignoreCustomAllowlisting(): void {
       'dir_other/node_modules',
     ]);
 
-    // Run the build.
+    // Run the packaging.
     $this->assertArtifactCommandSuccess([
       '-vvv' => TRUE,
       '--gitignore' => $this->src . DIRECTORY_SEPARATOR . 'mygitignore',
@@ -305,7 +305,7 @@ public function testGitignoreCustomAllowlisting(): void {
     ]);
   }
 
-  public function testBuildSafebranch(): void {
+  public function testPackageSafebranch(): void {
     $this->gitCreateFixtureCommits(2);
     $this->gitCreateBranch($this->src, 'Feature/so1me/f3ature');
     $this->gitCheckout($this->src, 'Feature/so1me/f3ature');
@@ -314,7 +314,7 @@ public function testBuildSafebranch(): void {
     $this->assertArtifactCommandSuccess(['--branch' => '[safebranch]'], 'feature-so1me-f3ature');
   }
 
-  public function testBuildTag(): void {
+  public function testPackageTag(): void {
     $this->gitCreateFixtureCommits(2);
     $this->gitAddTag($this->src, 'tag1');
 
@@ -323,7 +323,7 @@ public function testBuildTag(): void {
     $this->gitAssertFixtureCommits(2, $this->dst, 'tag1', ['Deployment commit']);
   }
 
-  public function testBuildMultipleTags(): void {
+  public function testPackageMultipleTags(): void {
     $this->gitCreateFixtureCommits(2);
     $this->gitAddTag($this->src, 'tag1');
     $this->gitAddTag($this->src, 'tag2');
@@ -337,15 +337,15 @@ public function testBuildMultipleTags(): void {
     $this->gitAssertFixtureCommits(3, $this->dst, 'tag3', ['Deployment commit']);
   }
 
-  public function testBuildMultipleTagsMissingTags(): void {
+  public function testPackageMultipleTagsMissingTags(): void {
     $this->gitCreateFixtureCommits(2);
     $this->gitAddTag($this->src, 'tag1');
     $this->gitCreateFixtureCommit(3);
 
     $this->assertArtifactCommandFailure(['--branch' => '[tags]']);
   }
 
-  public function testBuildMultipleTagsDelimiter(): void {
+  public function testPackageMultipleTagsDelimiter(): void {
     $this->gitCreateFixtureCommits(2);
     $this->gitAddTag($this->src, 'tag1');
     $this->gitAddTag($this->src, 'tag2');

tests/Functional/FunctionalTestCase.php

@@ -94,10 +94,10 @@ protected function tearDown(): void {
   }
 
   /**
-   * Build the artifact and assert success.
+   * Package the artifact and assert success.
    *
    * @param array $args
-   *   Array of arguments to pass to the build.
+   *   Array of arguments to pass to packaging.
    * @param string $branch
    *   Expected branch name.
    * @param string $commit
@@ -120,10 +120,10 @@ protected function assertArtifactCommandSuccess(?array $args = [], string $branc
   }
 
   /**
-   * Build the artifact and assert failure.
+   * Package the artifact and assert failure.
    *
    * @param array $args
-   *   *   Array of arguments to pass to the build.
+   *   *   Array of arguments to pass to packaging.
    *   * @param string $branch
    *   *   Expected branch name.
    * @param string $commit
@@ -145,7 +145,7 @@ protected function assertArtifactCommandFailure(?array $args = [], string $commi
   }
 
   /**
-   * Run artifact build.
+   * Run artifact packaging.
    *
    * @param array $args
    *   Additional arguments or options as an associative array. If NULL, no