From 538136e2a1eb09d7058c1478c538bf654bc981d2 Mon Sep 17 00:00:00 2001
From: Googler <pzembrod@google.com>
Date: Wed, 18 Sep 2024 02:33:16 -0700
Subject: [PATCH] Let methods from ObjcProviderApi throw
 UnsupportedOperationException() - the API isn't used anymore.

PiperOrigin-RevId: 675907100
Change-Id: Id1eed1405862aaf90fffdd4184c95ae53af83155
---
 .../objc/ObjcProviderApi.java                 | 28 ++++++++++++++-----
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/objc/ObjcProviderApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/objc/ObjcProviderApi.java
index f81e5cf3caa4d9..1160e2ce4d2c47 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/objc/ObjcProviderApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/objc/ObjcProviderApi.java
@@ -38,19 +38,25 @@ public interface ObjcProviderApi<FileApiT extends FileApi> extends StarlarkValue
       doc =
           "Non-propagated include search paths specified with '-I' on the command line. Also known "
               + "as header search paths (and distinct from <em>user</em> header search paths).")
-  Depset strictIncludeForStarlark();
+  default Depset strictIncludeForStarlark() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(
       name = "j2objc_library",
       structField = true,
       doc = "Static libraries that are built from J2ObjC-translated Java code.")
-  Depset /*<FileApiT>*/ j2objcLibrary();
+  default Depset /*<FileApiT>*/ j2objcLibrary() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(
       name = "module_map",
       structField = true,
       doc = "Clang module maps, used to enforce proper use of private header files.")
-  Depset /*<FileApiT>*/ moduleMap();
+  default Depset /*<FileApiT>*/ moduleMap() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(
       name = "direct_module_maps",
@@ -58,10 +64,14 @@ public interface ObjcProviderApi<FileApiT extends FileApi> extends StarlarkValue
       doc =
           "Module map files from this target directly (no transitive module maps). "
               + "Used to enforce proper use of private header files and for Swift compilation.")
-  Sequence<FileApiT> directModuleMaps();
+  default Sequence<FileApiT> directModuleMaps() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(name = "source", structField = true, doc = "All transitive source files.")
-  Depset /*<FileApiT>*/ sourceForStarlark();
+  default Depset /*<FileApiT>*/ sourceForStarlark() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(
       name = "direct_sources",
@@ -69,7 +79,9 @@ public interface ObjcProviderApi<FileApiT extends FileApi> extends StarlarkValue
       doc =
           "All direct source files from this target (no transitive files), "
               + "including any headers in the 'srcs' attribute.")
-  Sequence<FileApiT> directSources();
+  default Sequence<FileApiT> directSources() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 
   @StarlarkMethod(
       name = "umbrella_header",
@@ -77,5 +89,7 @@ public interface ObjcProviderApi<FileApiT extends FileApi> extends StarlarkValue
       doc =
           "Clang umbrella header. Public headers are #included in umbrella headers to be "
               + "compatible with J2ObjC segmented headers.")
-  Depset /*<FileApiT>*/ umbrellaHeader();
+  default Depset /*<FileApiT>*/ umbrellaHeader() {
+    throw new UnsupportedOperationException(); // just for docs
+  }
 }