package dev.caskeleton.buildlogic.apisurface; import dev.caskeleton.buildlogic.ApiSurfacePolicy; import dev.caskeleton.buildlogic.JavaPublicTypes; import java.io.File; 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.InputFile; import org.gradle.api.tasks.InputFiles; import org.gradle.api.tasks.Internal; import org.gradle.api.tasks.Optional; import org.gradle.api.tasks.PathSensitive; import org.gradle.api.tasks.PathSensitivity; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; @DisableCachingByDefault(because = "Verification task has no reusable outputs") public abstract class VerifyApiSurfaceTask extends DefaultTask { @InputFiles public abstract ConfigurableFileCollection getSourceRoots(); @Internal public abstract RegularFileProperty getBaseline(); @Input public String getBaselinePath() { return getBaseline().get().getAsFile().getAbsolutePath(); } @Input public abstract Property getLabel(); @Input public abstract Property getSurfaceDescription(); @Input public abstract ListProperty getRationale(); @Input public abstract Property getOwningProjectPath(); @Input public abstract Property getUpdateTaskName(); @Input public abstract Property getApprovalProperty(); @Input public abstract Property getUpdateApproved(); /** Other leaves' production sources, held to the adopter baseline when one is declared. */ @InputFiles @PathSensitive(PathSensitivity.RELATIVE) public abstract ConfigurableFileCollection getAdopterSources(); @Optional @InputFile public abstract RegularFileProperty getAdopterBaseline(); @TaskAction public void verifySurface() { if (getUpdateApproved().get()) { throw new GradleException( getName() + " is read-only; use " + getUpdateTaskName().get() + " to record an approved change."); } List roots = getSourceRoots().getFiles().stream().sorted().toList(); try { String rendered = ApiSurfacePolicy.render( roots, getLabel().get(), getSurfaceDescription().get(), getRationale().get(), getOwningProjectPath().get(), getUpdateTaskName().get(), getApprovalProperty().get()); ApiSurfacePolicy.verify( getName(), getUpdateTaskName().get(), getOwningProjectPath().get(), getApprovalProperty().get(), getBaseline().get().getAsFile(), rendered); if (getAdopterBaseline().isPresent()) { ApiSurfacePolicy.verifyAdopters( getName(), rendered, getAdopterBaseline().get().getAsFile(), JavaPublicTypes.imports(getAdopterSources().getFiles())); } } catch (IllegalStateException invalidSurface) { throw new GradleException(invalidSurface.getMessage(), invalidSurface); } getLogger().lifecycle("{}: OK — the committed public API surface is unchanged.", getName()); } }