Add and use acctest.SkipTestUntil (GoogleCloudPlatform#16559)

Author: rileykarson

docs/content/test/test.md

@@ -553,6 +553,40 @@ If you skip a test in VCR mode, include a code comment explaining the reason for
 {{< /tab >}}
 {{% /tabs %}}
 
+## Time-based skips {#skip-until-time}
+
+Acceptance tests can be marked to be skipped until a certain future date, such as the projected date of a launch or
+rollout. This should generally be added after coordinating with your reviewer to capture a successful test run such as
+through a local run with an allowlisted project, against staging, etc.
+
+Please include a comment with context where the skip is defined.
+
+{{% tabs "skipping-tests-until-time" %}}
+{{< tab "Skip a generated test" >}}
+Skipping acceptance tests that are generated from example files can be achieved by adding `skip_func: acctest.SkipTestUntil(t, "YYYY-MM-DD")` in the example's YAML:
+
+```yaml
+examples:
+- name: 'compute_address_basic'
+   ...
+  skip_func: acctest.SkipTestUntil(t, "2026-01-31")  # waiting for rollout
+```
+
+{{< /tab >}}
+{{< tab "Skip a handwritten test" >}}
+Skipping acceptance tests that are handwritten can be achieved by adding `acctest.SkipTestUntil(t, "YYYY-MM-DD")` at the start of the test:
+
+```go
+func TestAccPubsubTopic_update(t *testing.T) {
+      acctest.SkipTestUntil(t, "2026-01-31") // b/1234567890
+      acctest.VcrTest(t, resource.TestCase{ ... })
+}
+```
+
+{{< /tab >}}
+{{% /tabs %}}
+
+
 ### Reasons that tests are skipped in VCR replaying mode
 
 | Problem                                          | How to fix/Other info  | Skip in VCR replaying? |

mmv1/api/resource/examples.go

@@ -164,6 +164,9 @@ type Examples struct {
 	// unskipping the test. If this is not empty, the test will be skipped.
 	SkipTest string `yaml:"skip_test,omitempty"`
 
+	// SkipFunc is a function call to a custom skip check
+	SkipFunc string `yaml:"skip_func,omitempty"`
+
 	// Specify which external providers are needed for the testcase.
 	// Think before adding as there is latency and adds an external dependency to
 	// your test so avoid if you can.

mmv1/products/iamworkforcepool/WorkforcePoolProvider.yaml

@@ -107,6 +107,7 @@ examples:
     test_env_vars:
       org_id: ORG_ID
   - name: iam_workforce_pool_provider_extra_attributes_display_name_oauth2_config_client_basic
+    skip_func: acctest.SkipTestUntil(t, "2026-03-05")  # waiting for rollout
     primary_resource_id: example
     vars:
       workforce_pool_id: example-pool
@@ -117,6 +118,7 @@ examples:
       - oidc.0.client_secret.0.value.0.plain_text
       - extra_attributes_oauth2_client.0.client_secret.0.value.0.plain_text
   - name: iam_workforce_pool_provider_extra_attributes_display_name_oauth2_config_client_full
+    skip_func: acctest.SkipTestUntil(t, "2026-03-05")  # waiting for rollout
     primary_resource_id: example
     vars:
       workforce_pool_id: example-pool

mmv1/templates/terraform/examples/base_configs/test_file.go.tmpl

@@ -56,6 +56,10 @@ func TestAcc{{ $e.TestSlug $.Res.ProductMetadata.Name $.Res.Name }}(t *testing.T
 	t.Skip("{{$e.SkipTest}}")
 	{{- end }}
 
+	{{- if $e.SkipFunc }}
+	{{$e.SkipFunc}}
+	{{- end}}
+
 	{{- if $e.SkipVcr }}
 	acctest.SkipIfVcr(t)
 	{{- end }}

mmv1/third_party/terraform/acctest/test_utils.go.tmpl

@@ -12,6 +12,7 @@ import (
 	"os"
 	"strings"
 	"testing"
+	"time"
 
 	"github.com/hashicorp/terraform-plugin-framework/providerserver"
 	"github.com/hashicorp/terraform-plugin-go/tfprotov5"
@@ -157,6 +158,22 @@ func RandIntRange(t *testing.T, minInt int, maxInt int) int {
 	return rand.New(s.source).Intn(maxInt-minInt) + minInt
 }
 
+// SkipTestUntil skips a test until a given date, specified in YYYY-MM-DD.
+// You can bypass this skip by setting DISABLE_SKIP_TEST_UNTIL to "true"
+func SkipTestUntil(t *testing.T, enableDate string) {
+	format := "2006-01-02" // go string for YYYY-MM-DD.
+	enableDateTime, err := time.Parse(format, enableDate) // With no timezone we will use local time rather than UTC or a fixed TZ.
+	if err != nil {
+		t.Fatalf("failed to parse SkipTestUntil: %q, err: %v", enableDate, err)
+	}
+
+	if time.Now().Before(enableDateTime) {
+		if v := os.Getenv("DISABLE_SKIP_TEST_UNTIL"); v != "true" {
+			t.Skipf("skipping test until %v", enableDate)
+		}
+	}
+}
+
 // ProtoV5ProviderFactories returns a muxed ProviderServer that uses the provider code from this repo (SDK and plugin-framework).
 // Used to set ProtoV5ProviderFactories in a resource.TestStep within an acceptance test.
 func ProtoV5ProviderFactories(t *testing.T) map[string]func() (tfprotov5.ProviderServer, error) {