# ADR-0003 - Avoid introducing Groovy types to public API

## Status

- ACCEPTED on 2024-01-12

## Context

Gradle's public API requires equal access from all JVM-based languages.
Kotlin, Groovy, Java, and other JVM-based languages should be able to use the Gradle API without relying on another language's standard library.

Historically, Gradle has shipped with some Groovy types in very prominent APIs.

    for (int i = 0; i < 8; i++) {
      limiter.acquire(); // #1
    }
    stopwatch.sleepMillis(500); // #2: to repay for the last acquire
    stopwatch.sleepMillis(4000); // #3: becomes cold again
    for (int i = 0; i < 8; i++) {
      limiter.acquire(); // // #4
    }
    stopwatch.sleepMillis(500); // #5: to repay for the last acquire

    for (int i = 0; i < 8; i++) {
      limiter.acquire(); // #1
    }
    stopwatch.sleepMillis(500); // #2: to repay for the last acquire
    stopwatch.sleepMillis(4000); // #3: becomes cold again
    for (int i = 0; i < 8; i++) {
      limiter.acquire(); // // #4
    }
    stopwatch.sleepMillis(500); // #5: to repay for the last acquire

      override val nonDefaultValue: java.net.Proxy? = java.net.Proxy.NO_PROXY

      override val badValue: java.net.Proxy? =
        java.net.Proxy(Proxy.Type.HTTP, InetSocketAddress.createUnresolved("proxy.example.com", 1003))

      override fun isDefaultValue(value: java.net.Proxy?): Boolean = value == null
    }

    object ProxySelectorOverride : Override<ProxySelector> {

async def stream_items() -> AsyncIterable[ServerSentEvent]:
    yield ServerSentEvent(comment="stream of item updates")
    for i, item in enumerate(items):

    public void testOnConnectMethod() {
        CurlRequest request = new CurlRequest(Method.GET, "https://example.com");

        CurlRequest result = request.onConnect((req, conn) -> {
            conn.setConnectTimeout(5000);
        });

        assertSame(request, result); // Fluent API
    }

    @Test
    public void testParamMethod() {
        CurlRequest request = new CurlRequest(Method.GET, "https://example.com");

    yield ServerSentEvent(data={"key": "value"}, event="json-data", id="2")
    yield ServerSentEvent(comment="just a comment")
    yield ServerSentEvent(data="retry-test", retry=5000)


@app.get("/items/stream-mixed", response_class=EventSourceResponse)
async def sse_items_mixed() -> AsyncIterable[Item]:
    yield items[0]
    yield ServerSentEvent(data="custom-event", event="special")

            } else {
                a.dataset.internalLink = "";
            }
        } catch (_) {}
    });
}

async function main() {
    setupTermynal();
    showRandomAnnouncement('announce-left', 5000)
    handleSponsorImages();
    openLinksInNewTab();
}
document$.subscribe(() => {
    main()

    ticker.advance(1234567);
    assertThat(stopwatch.toString()).isEqualTo("1.235 ms");
    stopwatch.reset();
    stopwatch.start();
    ticker.advance(5000000000L);
    assertThat(stopwatch.toString()).isEqualTo("5.000 s");
    stopwatch.reset();
    stopwatch.start();
    ticker.advance((long) (1.5 * 60 * 1000000000L));
    assertThat(stopwatch.toString()).isEqualTo("1.500 min");
    stopwatch.reset();
    stopwatch.start();

        options.fileConfigIds = "file1";
        options.dataConfigIds = "data1";
        options.propertiesPath = "/path/to/props";
        options.expires = "7";
        options.hotThread = 5000;

        String result = options.toString();
        assertNotNull(result);
        assertTrue(result.contains("sessionId=session123"));
        assertTrue(result.contains("name=testCrawl"));