[LOPS-1656] Handle ICR exceptions from backend.

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Change Log
 All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org)
 
+## 3.2.3-dev
+
 ## 3.2.2 - 2023-09-28
 
 ### Fixed

config/constants.yml

@@ -7,7 +7,7 @@
 ---
 
 # App
-TERMINUS_VERSION: '3.2.2'
+TERMINUS_VERSION: '3.2.3-dev'
 
 # Connectivity
 TERMINUS_HOST:        'terminus.pantheon.io'

src/Commands/Branch/ListCommand.php

@@ -7,6 +7,7 @@
 use Pantheon\Terminus\Commands\StructuredListTrait;
 use Pantheon\Terminus\Site\SiteAwareInterface;
 use Pantheon\Terminus\Site\SiteAwareTrait;
+use Pantheon\Terminus\Exceptions\TerminusIcrSiteException;
 
 /**
  * Class ListCommand
@@ -37,6 +38,12 @@ class ListCommand extends TerminusCommand implements SiteAwareInterface
      */
     public function listBranches($site_id)
     {
-        return $this->getRowsOfFields($this->getSiteById($site_id)->getBranches());
+        try {
+            return $this->getRowsOfFields($this->getSiteById($site_id)->getBranches());
+        } catch (TerminusIcrSiteException $e) {
+            $this->log()->notice("This is an ICR site, branches are managed in the external VCS.");
+            $this->log()->debug($e->getMessage());
+            return;
+        }
     }
 }

src/Commands/Connection/SetCommand.php

@@ -7,6 +7,7 @@
 use Pantheon\Terminus\Site\SiteAwareInterface;
 use Pantheon\Terminus\Site\SiteAwareTrait;
 use Pantheon\Terminus\Exceptions\TerminusException;
+use Pantheon\Terminus\Exceptions\TerminusIcrSiteException;
 
 /**
  * Class SetCommand.
@@ -64,6 +65,10 @@ public function connectionSet($site_env, $mode)
         try {
             $mode = strtolower($mode ?? '');
             $workflow = $env->changeConnectionMode($mode);
+        } catch (TerminusIcrSiteException $e) {
+            $this->log()->debug($e->getMessage());
+            $this->log()->notice("This is an ICR site, connection mode switching is not currently supported.");
+            return;
         } catch (TerminusException $e) {
             $message = $e->getMessage();
             if (strpos($message, $mode) !== false) {

src/Exceptions/TerminusIcrSiteException.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Pantheon\Terminus\Exceptions;
+
+/**
+ * Class TerminusIcrSiteException
+ * @package Pantheon\Terminus\Exceptions
+ */
+class TerminusIcrSiteException extends TerminusException
+{
+}

src/Request/Request.php

@@ -15,6 +15,7 @@
 use League\Container\ContainerAwareTrait;
 use Pantheon\Terminus\Config\ConfigAwareTrait;
 use Pantheon\Terminus\Exceptions\TerminusException;
+use Pantheon\Terminus\Exceptions\TerminusIcrSiteException;
 use Pantheon\Terminus\Helpers\LocalMachineHelper;
 use Pantheon\Terminus\Session\SessionAwareInterface;
 use Pantheon\Terminus\Session\SessionAwareTrait;
@@ -227,7 +228,7 @@ private function createRetryDecider(): callable
                 );
             } else {
                 if (preg_match('/[2,4]0\d/', $response->getStatusCode())) {
-                    // Do not retry on 20x and 40x responses.
+                    // Do not retry on 20x or 40x responses.
                     return false;
                 }
 
@@ -427,6 +428,11 @@ public function request($path, array $options = []): RequestOperationResult
             $this->logger->debug($jsonException->getMessage());
         }
 
+        if ($response->getStatusCode() == 409 && $body == "icr_site") {
+            // This request is expected to fail for an ICR site, throw exception that will be catched down the road.
+            throw new TerminusIcrSiteException("This is an ICR site.");
+        }
+
         return new RequestOperationResult([
             'data' => $body,
             'headers' => $response->getHeaders(),