Add support for filtering Gerrit changes by status.

This allows users to specify `STATUS` in the `events` field of the `git.gerrit_trigger`. The desired statuses (e.g., "PENDING", "ABANDONED", "MERGED", "CLOSED", "REVIEWED", "OPEN") can be provided in the `SUBTYPES_STATUS` list.

This enables workflows to react to changes in Gerrit status, such as triggering garbage collection on abandoned changes.

BUG=491868096
GWSQ_IGNORE: joshgoldman@google.com
PiperOrigin-RevId: 885767818
Change-Id: I82538311797ae8c2896edf34c705c8f7b8760a6b

Author: joshgoldman-google

java/com/google/copybara/git/GerritTrigger.java

@@ -37,7 +37,7 @@ public class GerritTrigger implements Trigger {
   private final ImmutableSet<GerritEventTrigger> events;
   private final Console console;
   private final boolean allowSubmitChange;
-  
+
   GerritTrigger(
       LazyResourceLoader<GerritApi> apiSupplier,
       String url,

java/com/google/copybara/git/GitModule.java

@@ -3179,10 +3179,20 @@ private ImmutableSet<GerritEventTrigger> handleGerritEventTypes(Object events)
         GerritEventType eventType = stringToEnum("events", event.getKey(), GerritEventType.class);
 
         check(types.add(eventType), "Repeated element %s", event);
+        if (eventType == GerritEventType.STATUS) {
+          // TODO: Consider supporting all Gerrit statuses.
+          ImmutableSet<String> allowedStatuses =
+              ImmutableSet.of("PENDING", "ABANDONED", "MERGED", "CLOSED", "REVIEWED", "OPEN");
+          for (String status : event.getValue()) {
+            check(
+                allowedStatuses.contains(status),
+                "Invalid status '%s'. Valid values are %s",
+                status,
+                allowedStatuses);
+          }
+        }
         eventBuilder.add(
-            GerritEventTrigger.create(
-                eventType,
-                ImmutableSet.copyOf(event.getValue())));
+            GerritEventTrigger.create(eventType, ImmutableSet.copyOf(event.getValue())));
       }
     }
 

java/com/google/copybara/git/gerritapi/GerritEventType.java

@@ -22,5 +22,6 @@ public enum GerritEventType {
   UNKNOWN, // Used if we don't know the event type.
 
   LABELS,
-  SUBMIT_REQUIREMENTS;
+  SUBMIT_REQUIREMENTS,
+  STATUS;
 }

javatests/com/google/copybara/git/GerritTriggerTest.java

@@ -17,11 +17,13 @@
 package com.google.copybara.git;
 
 import static com.google.common.truth.Truth.assertThat;
+import static org.junit.Assert.assertThrows;
 
 import com.google.common.collect.ImmutableSet;
 import com.google.copybara.testing.DummyChecker;
 import com.google.copybara.testing.OptionsBuilder;
 import com.google.copybara.testing.SkylarkTestExecutor;
+import com.google.copybara.exception.ValidationException;
 import com.google.copybara.util.console.testing.TestingConsole;
 import org.junit.Before;
 import org.junit.Test;
@@ -61,6 +63,104 @@ public void testParsing() throws Exception {
             "gerritSubmit", "true");
   }
 
+  @Test
+  public void testParsing_statusPending() throws Exception {
+    GerritTrigger gerritTrigger =
+        skylarkTestExecutor.eval(
+            "e",
+            "e = git.gerrit_trigger("
+                + "url = 'https://test.googlesource.com/example',"
+                + "events = {'STATUS': ['PENDING'], 'LABELS': []}, allow_submit = True)");
+
+    assertThat(gerritTrigger.describe())
+        .containsExactly(
+            "type",
+            "gerrit_trigger",
+            "url",
+            "https://test.googlesource.com/example",
+            "events",
+            "STATUS",
+            "events",
+            "LABELS",
+            "SUBTYPES_STATUS",
+            "PENDING",
+            "gerritSubmit",
+            "true");
+  }
+
+  @Test
+  public void testParsing_statusAbandoned() throws Exception {
+    GerritTrigger gerritTrigger =
+        skylarkTestExecutor.eval(
+            "e",
+            "e = git.gerrit_trigger("
+                + "url = 'https://test.googlesource.com/example',"
+                + "events = {'STATUS': ['ABANDONED']}, allow_submit = True)");
+
+    assertThat(gerritTrigger.describe())
+        .containsExactly(
+            "type",
+            "gerrit_trigger",
+            "url",
+            "https://test.googlesource.com/example",
+            "events",
+            "STATUS",
+            "SUBTYPES_STATUS",
+            "ABANDONED",
+            "gerritSubmit",
+            "true");
+  }
+
+  @Test
+  public void testParsing_statusMultiple() throws Exception {
+    GerritTrigger gerritTrigger =
+        skylarkTestExecutor.eval(
+            "e",
+            "e = git.gerrit_trigger(\n"
+                + "url = 'https://test.googlesource.com/example',"
+                + "events = {'STATUS': ['PENDING', 'ABANDONED']})");
+
+    assertThat(gerritTrigger.describe())
+        .containsExactly(
+            "type", "gerrit_trigger",
+            "url", "https://test.googlesource.com/example",
+            "events", "STATUS",
+            "SUBTYPES_STATUS", "PENDING",
+            "SUBTYPES_STATUS", "ABANDONED",
+            "gerritSubmit", "false");
+  }
+
+  @Test
+  public void testParsing_statusMultipleValid() throws Exception {
+    GerritTrigger gerritTrigger =
+        skylarkTestExecutor.eval(
+            "e",
+            "e = git.gerrit_trigger(\n"
+                + "url = 'https://test.googlesource.com/example',events = {'STATUS': ['PENDING',"
+                + " 'ABANDONED', 'MERGED', 'CLOSED', 'REVIEWED', 'OPEN']})");
+
+    assertThat(gerritTrigger.describe())
+        .containsExactly(
+            "type", "gerrit_trigger",
+            "url", "https://test.googlesource.com/example",
+            "events", "STATUS",
+            "SUBTYPES_STATUS", "PENDING",
+            "SUBTYPES_STATUS", "ABANDONED",
+            "SUBTYPES_STATUS", "MERGED",
+            "SUBTYPES_STATUS", "CLOSED",
+            "SUBTYPES_STATUS", "REVIEWED",
+            "SUBTYPES_STATUS", "OPEN",
+            "gerritSubmit", "false");
+  }
+
+  @Test
+  public void testParsing_invalidStatus() throws Exception {
+    skylarkTestExecutor.evalFails(
+        "git.gerrit_trigger(url = 'https://test.googlesource.com/example', events = {'STATUS':"
+            + " ['INVALID']})",
+        "Invalid status 'INVALID'. Valid values are ");
+  }
+
   @Test
   public void testParsing_Dict() throws Exception {
     GerritTrigger gerritTrigger =