package dev.caskeleton.buildlogic.apisurface; import dev.caskeleton.buildlogic.ApiSurfacePolicy; import java.io.File; import java.io.IOException; import java.io.UncheckedIOException; import java.nio.charset.StandardCharsets; import java.nio.file.Files; import java.util.List; import org.gradle.api.DefaultTask; import org.gradle.api.GradleException; import org.gradle.api.file.ConfigurableFileCollection; import org.gradle.api.file.RegularFileProperty; import org.gradle.api.provider.ListProperty; import org.gradle.api.provider.Property; import org.gradle.api.tasks.Input; import org.gradle.api.tasks.InputFiles; import org.gradle.api.tasks.OutputFile; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; @DisableCachingByDefault(because = "This task intentionally updates a committed review baseline") public abstract class UpdateApiSurfaceTask extends DefaultTask { @InputFiles public abstract ConfigurableFileCollection getSourceRoots(); @OutputFile public abstract RegularFileProperty getBaseline(); @Input public abstract Property getLabel(); @Input public abstract Property getSurfaceDescription(); @Input public abstract ListProperty getRationale(); @Input public abstract Property getOwningProjectPath(); @Input public abstract Property getApprovalProperty(); @Input public abstract Property getCeilingProperty(); @Input public abstract Property getApproved(); @Input public abstract Property getCeilingRaiseApproved(); @TaskAction public void updateSurface() { if (!getApproved().get()) { throw new GradleException( getName() + " requires -P" + getApprovalProperty().get() + ": growing the public surface is a review decision, not a build step."); } List roots = getSourceRoots().getFiles().stream().sorted().toList(); String rendered; File baseline = getBaseline().get().getAsFile(); try { rendered = ApiSurfacePolicy.render( roots, getLabel().get(), getSurfaceDescription().get(), getRationale().get(), getOwningProjectPath().get(), getName(), getApprovalProperty().get()); if (baseline.isFile()) { ApiSurfacePolicy.requireNoUnapprovedGrowth( getName(), getOwningProjectPath().get(), getApprovalProperty().get(), getCeilingProperty().get(), ApiSurfacePolicy.countTypes( Files.readString(baseline.toPath(), StandardCharsets.UTF_8)), rendered, getCeilingRaiseApproved().get()); } } catch (IOException exception) { throw new UncheckedIOException("failed to read " + baseline, exception); } catch (IllegalStateException invalidSurface) { throw new GradleException(invalidSurface.getMessage(), invalidSurface); } File parent = baseline.getParentFile(); if (!parent.isDirectory() && !parent.mkdirs()) { throw new GradleException("Could not create API surface baseline directory " + parent); } try { Files.writeString(baseline.toPath(), rendered, StandardCharsets.UTF_8); } catch (IOException exception) { throw new UncheckedIOException("failed to write " + baseline, exception); } getLogger().lifecycle("{}: wrote {}", getName(), baseline); } }