Merge in 4.x changes

Author: namespacebrian

.env.dist

@@ -1,45 +1,16 @@
 export PROJECT_PATH=$(realpath .)
-## Note: The terminus test site must have some quicksilver scripts enabled
-## in order for tests to pass.
-## Needed for unit test fixutures
-export TERMINUS_PROJECT_ROOT=${PROJECT_PATH}
-
-## This is the site that will be used for testing
-export TERMINUS_SITE="ci-terminus-composer"
-
-## This is the site that will be used for testing wordpress commands
+export TERMINUS_SITE="terminus-test-site"
 export TERMINUS_SITE_WP="terminus-test-site-wordpress"
-
-## This is the site that will be used for testing wordpress network
 export TERMINUS_SITE_WP_NETWORK="terminus-test-site-wp-network"
-
-## This is the site that will be used for cloning a test environment on which to run tests
 export TERMINUS_ENV="dev"
-
-## this is the org that will be used. The site(s) above need to be in this org
 export TERMINUS_ORG="Agency"
-
-## This is the user that will be used for testing Should be attached the token below
 export TERMINUS_USER="[email protected]"
-
 ## To Autoload your token from your local machine, change the TERMINUS_TOKEN to the following command:
 ## export TERMINUS_TOKEN=$(cat $HOME/.terminus/cache/tokens/[email protected] | jq -r .token)
 export TERMINUS_TOKEN="{TERMINUS TOKEN}"
-
-## this is the folder that terminus will use to store its data during the tests
 export TERMINUS_BASE_DIR="/tmp/terminus-data"
-
-## this is the folder that terminus will use to store its plugins during the tests
 export TERMINUS_PLUGINS2_DIR="${TERMINUS_BASE_DIR}/plugins"
-
-## this is the folder that terminus will use to store its plugins during the tests
 export TERMINUS_PLUGINS_DIR="${TERMINUS_BASE_DIR}/plugins-3.x"
-
-## Used for testing plugins
 export TERMINUS_DEPENDENCIES_BASE_DIR="${TERMINUS_BASE_DIR}/dependencies-1"
-
-## this will prevent the tests from creating a test environment for the run
 export TERMINUS_TESTING_RUNTIME_ENV=
-
-## this will prevent tests from reinstalling the development packages once a phar is built
 export TERMINUS_ON_PHAR_COMPLETE_REINSTALL_COMPOSER_WITH_DEV=1

.github/workflows/3x.yml

@@ -1,8 +1,6 @@
-name: Terminus 3.x
+name: Terminus 4.x
 on:
   push:
-  schedule:
-    - cron: '0 6 * * *'
   workflow_dispatch:
     inputs:
       functional_tests_group:
@@ -24,18 +22,18 @@ jobs:
   checkout_build:
     runs-on: ubuntu-latest
     container:
-      image: quay.io/pantheon-public/php-ci:v7.4
+      image: quay.io/pantheon-public/php-ci:v8.2
     name: Checkout & build Phar
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v3
       - name: Save repo content as artifact
         uses: actions/upload-artifact@v4
         with:
           name: full-workspace
           path: ${{ github.workspace }}
       - name: Full Composer Install
-        run: composer install --dev
+        run: composer install
       - name: Validate Code
         run: composer code:lint
       - name: Phar Build
@@ -58,7 +56,7 @@ jobs:
     strategy:
       matrix:
         operating-system: [ 'macos-latest' ]
-        php-versions: [ '7.4', '8.2', '8.3' ]
+        php-versions: [ '8.2', '8.4' ]
       max-parallel: 1
     env:
       TERMINUS_TOKEN: ${{ secrets.TERMINUS_TOKEN }}
@@ -127,7 +125,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Release
     container:
-      image: quay.io/pantheon-public/php-ci:v7.4
+      image: quay.io/pantheon-public/php-ci:v8.2
     needs: [ functional ]
     if: ${{ startsWith(github.ref, 'refs/tags/')  && github.repository == 'pantheon-systems/terminus' }}
     steps:

CHANGELOG.md

@@ -1,7 +1,39 @@
 # Change Log
 All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org)
 
-## 3.6.2-dev -
+## 4.0.2-dev
+
+## 4.0.1 - 2025-05-19
+
+### Fixed
+
+- env:code-rebuild command should no longer throw a fatal error (#2694)
+
+## 4.0.0 - 2025-05-07
+
+### Added
+
+- Readd update check and prompt to update when running an old Terminus version (#2669)
+- Prompt for missing required arguments when in interactive mode (#2684)
+
+### Fixed
+
+- Response json_decode should fallback to original body text (#2687)
+- Simplify env:wake command (#2689)
+
+## 4.0.0-alpha1 - 2025-03-06
+
+### Added
+
+- Support for PHP 8.4
+
+### Removed
+
+- Support for PHP versions prior to 8.2
+
+## 3.6.2 - 2025-03-03
+- Pass verbose flag to ssh if terminus is in verbose mode (#2663)
+- Bug fix: backup:restore with --file parameter restores backups multiple ties (#2664)
 
 ## 3.6.1 - 2024-12-04
 

CONTRIBUTING.md

@@ -75,7 +75,7 @@ A PHAR file must also be built before running tests.
 
 The functional test files are in the `tests/Functional` directory.
 
-The Terminus 3.x functional tests can be run via:
+The Terminus 4.x functional tests can be run via:
 
   ```bash
   cd /install/location/terminus

RoboFile.php

@@ -1,7 +1,5 @@
 <?php
 
-use CzProject\GitPhp\Git;
-use CzProject\GitPhp\GitException;
 use Pantheon\Terminus\Config\ConfigAwareTrait;
 use Pantheon\Terminus\Helpers\CommandCoverageReport;
 use Pantheon\Terminus\Terminus;
@@ -208,124 +206,6 @@ public function setTerminus(Terminus $terminus): void
         $this->terminus = $terminus;
     }
 
-    /**
-     * Generates a test commit.
-     *
-     * @throws \Pantheon\Terminus\Exceptions\TerminusException
-     * @throws GitException
-     */
-    public function generateTestCommit()
-    {
-        $this->output()->writeln('Getting the Site Repo');
-        // get the git host and port from terminus
-        $commandResponse = $this->getTerminus()->execute(
-            '%s connection:info %s.dev --fields=git_host,git_port --format=json',
-            [
-                $this->getProjectPath() . "/terminus.phar",
-                $this->getSiteName(),
-            ]
-        );
-
-        // check if the command was successful
-        if ($commandResponse[1] !== 0) {
-            $this->output()->writeln('Failed to retrieve git host and port');
-            exit(1);
-        }
-
-        // decode the json response
-        $gitInfo = json_decode($commandResponse[0], true);
-        $this->output()->writeln('Retrieved git host and port' . print_r($gitInfo, true));
-
-        // check if the git host and port were retrieved
-        if (!isset($gitInfo['git_host']) || !isset($gitInfo['git_port'])) {
-            $this->output()->writeln('Failed to retrieve git host and port');
-            exit(1);
-        }
-
-        // Does the known_hosts file exist?
-        if (!file_exists(sprintf("%s/.ssh/known_hosts", getenv("HOME")))) {
-            // if not, create one
-            touch(sprintf("%s/.ssh/known_hosts", getenv("HOME")));
-        }
-
-        // get the contents of the known_hosts file
-        $knownHosts = file_get_contents(sprintf("%s/.ssh/known_hosts", getenv("HOME")));
-        // check if the git host is already in the known_hosts file
-        if (!str_contains($knownHosts, $gitInfo['git_host'])) {
-            // if not, add it
-            $this->output()->writeln('Adding the git host to known hosts file');
-            $addGitHostToKnownHostsCommand = sprintf(
-                'ssh-keyscan -p %d %s >> ~/.ssh/known_hosts',
-                $gitInfo['git_port'],
-                $gitInfo['git_host']
-            );
-            $this->output()->writeln($addGitHostToKnownHostsCommand);
-            exec($addGitHostToKnownHostsCommand);
-        }
-
-        // checkout the branch related to this test run
-        $clonedPath = sprintf(
-            "%s/pantheon-local-copies/%s",
-            getenv("HOME"),
-            $this->getSiteName()
-        );
-        if (is_dir($clonedPath)) {
-            // make sure you're working with a clean copy of the repo
-            exec("rm -rf {$clonedPath}");
-        }
-        $this->output()->writeln(sprintf('Cloning the site repository to %s', $clonedPath));
-        // get the git host and port from terminus
-        $commandResponse = $this->getTerminus()->execute(
-            '%s local:clone %s',
-            [
-                $this->getProjectPath() . "/terminus.phar",
-                $this->getSiteName(),
-            ]
-        );
-
-        $response = "";
-        try {
-            $git = new Git();
-            $repo = $git->open($clonedPath);
-            chdir($clonedPath);
-            $branches = $repo->getBranches();
-            if (!in_array($this->getSiteEnv(), $branches)) {
-                $this->output()->writeln(sprintf('Creating the %s branch', $this->getSiteEnv()));
-                // Create the branch
-                $repo->createBranch($this->getSiteEnv());
-            }
-            // Check out the branch in question
-            $repo->checkout($this->getSiteEnv());
-            // create a text file
-            $testFilePath = sprintf('%s/test.txt', $clonedPath);
-            file_put_contents($testFilePath, 'test');
-            // add the file to the repository
-            $repo->addFile("test.txt");
-            // commit the file
-            $repo->commit('Test commit');
-            // push the commit
-            $response = $repo->execute(
-                'push',
-                'origin',
-                $this->getSiteEnv(),
-            );
-        } catch (GitException $e) {
-            $this->output()->writeln(["Git Exception:", $e->getMessage()]);
-            $this->output()->writeln(print_r($response, true));
-            exit(1);
-        } catch (Exception $e) {
-            $this->output()->writeln($e->getMessage());
-            $this->output()->writeln(print_r($response, true));
-            exit(1);
-        }
-
-        // get the last commit
-        $commit = $repo->getLastCommit();
-        // output the commit id
-        $this->output()->writeln($commit->getId());
-        return $commit->getId();
-    }
-
     /**
      * Returns the absolute path to the project.
      *
@@ -335,21 +215,4 @@ private function getProjectPath(): string
     {
         return dirname(__FILE__);
     }
-
-
-    /**
-     * @return string
-     */
-    private function getSiteName(): string
-    {
-        return getenv('TERMINUS_SITE') ?? 'ci-terminus-composer';
-    }
-
-    /**
-     * @return string
-     */
-    private function getSiteEnv(): string
-    {
-        return getenv('TERMINUS_ENV') ?? 'dev';
-    }
 }

bin/terminus

@@ -12,17 +12,17 @@
 // Unset memory limit
 ini_set('memory_limit', -1);
 
-if (version_compare(PHP_VERSION, '7.4.0', '<') === true) {
+if (version_compare(PHP_VERSION, '8.2.0', '<') === true) {
     fwrite(STDERR, "\n");
     fwrite(STDERR, 'Sorry, your PHP version (' . PHP_VERSION . ') is no longer supported.' . "\n");
-    fwrite(STDERR, 'Upgrade to PHP 7.4 or newer to use Terminus 3. For PHP versions prior to 7.4, downgrade to Terminus 2.x.' . "\n\n");
+    fwrite(STDERR, 'Upgrade to PHP 8.2 or newer to use Terminus 4. For PHP versions prior to 8.2, downgrade to Terminus 3.x.' . "\n\n");
     fwrite(STDERR, 'For more information, see https://pantheon.io/docs/terminus/updates#php-version-compatibility-matrix' . "\n\n");
     exit(1);
 }
 
-if (!getenv('TERMINUS_ALLOW_UNSUPPORTED_NEWER_PHP') && version_compare(PHP_VERSION, '8.4.0', '>=') === true) {
+if (!getenv('TERMINUS_ALLOW_UNSUPPORTED_NEWER_PHP') && version_compare(PHP_VERSION, '8.5.0', '>=') === true) {
     fwrite(STDERR, "\n");
-    fwrite(STDERR, 'PHP 8.4+ is not supported by this version of Terminus.' . "\n");
+    fwrite(STDERR, 'PHP 8.5+ is not supported by this version of Terminus.' . "\n");
     fwrite(STDERR, 'Check for new versions at https://github.com/pantheon-systems/terminus/releases' . "\n");
     fwrite(STDERR, "\n");
     fwrite(STDERR, 'Set environment variable TERMINUS_ALLOW_UNSUPPORTED_NEWER_PHP to try continuing anyway.' . "\n");
@@ -32,7 +32,7 @@ if (!getenv('TERMINUS_ALLOW_UNSUPPORTED_NEWER_PHP') && version_compare(PHP_VERSI
 
 // This variable is automatically managed via updateDependenciesversion() in /RoboFile.php,
 // which is run after every call to composer update.
-$terminusPluginsDependenciesVersion = 'a6b56bb299';
+$terminusPluginsDependenciesVersion = 'b17f504e52';
 
 // Cannot use $_SERVER superglobal since that's empty during phpunit testing
 // getenv('HOME') isn't set on Windows and generates a Notice.