586: allow --force param to always re-install a package

Author: asgrim

features/install-extensions.feature

@@ -9,3 +9,15 @@ Feature: Extensions can be installed with PIE
   Example: An extension can be installed and enabled
     When I run a command to install an extension
     Then the extension should have been installed and enabled
+
+  # pie install <ext> && pie install <ext>
+  Example: Re-installing an existing extension is a no-op
+    Given an extension was previously installed and enabled
+    When I run a command to install an extension
+    Then the extension should not have been re-installed
+
+  # pie install <ext> && pie install --force <ext>
+  Example: Forcefully re-installing an existing extension should re-install the extension
+    Given an extension was previously installed and enabled
+    When I run a command to forcefully install an extension
+    Then the extension should have been installed and enabled

src/ComposerIntegration/ComposerIntegrationHandler.php

@@ -89,7 +89,7 @@ public function runInstall(
                 $status->description(),
             ), verbosity: IOInterface::VERY_VERBOSE);
 
-            if ($status->isVerified()) {
+            if ($status->isVerified() && ! $forceInstallPackageVersion) {
                 $this->arrayCollectionIo->write(sprintf(
                     '%s PIE package %s (%s) is already installed and verified.',
                     Emoji::GREEN_CHECKMARK,

test/behaviour/CliContext.php

@@ -191,6 +191,14 @@ public function iRunACommandToInstallAnExtension(): void
         $this->runPieCommand(['install', $this->thePackage]);
     }
 
+    #[When('I run a command to forcefully install an extension')]
+    public function iRunACommandToForcefullyInstallAnExtension(): void
+    {
+        $this->theExtension = 'example_pie_extension';
+        $this->thePackage   = 'asgrim/example-pie-extension';
+        $this->runPieCommand(['install', '--force', $this->thePackage]);
+    }
+
     #[When('I run a command to install an extension without enabling it')]
     public function iRunACommandToInstallAnExtensionWithoutEnabling(): void
     {
@@ -265,6 +273,20 @@ public function theExtensionShouldHaveBeenInstalledAndEnabled(): void
         Assert::same($isExtEnabled, 'yes');
     }
 
+    #[Then('the extension should not have been re-installed')]
+    public function theExtensionShouldNotHaveBeenReinstalled(): void
+    {
+        $this->assertCommandSuccessful();
+
+        Assert::contains($this->output, 'PIE package asgrim/example-pie-extension (example_pie_extension) is already installed and verified.');
+
+        $isExtEnabled = (new Process([self::PHP_BINARY, '-r', 'echo extension_loaded("' . $this->theExtension . '")?"yes":"no";']))
+            ->mustRun()
+            ->getOutput();
+
+        Assert::same($isExtEnabled, 'yes');
+    }
+
     #[Given('I have an invalid extension installed')]
     public function iHaveAnInvalidExtensionInstalled(): void
     {