Class ValidateTask
-
- All Implemented Interfaces:
-
kotlin.Comparable,org.gradle.api.Named,org.gradle.api.Task,org.gradle.api.internal.DynamicObjectAware,org.gradle.api.internal.TaskInternal,org.gradle.api.plugins.ExtensionAware,org.gradle.util.Configurable
@CacheableTask() public abstract class ValidateTask extends DefaultTaskA generator which validates an Open API spec. This task outputs a list of validation issues and errors.
Example: cli:
./gradlew openApiValidate --input=/path/to/file
build.gradle.kts:
openApiValidate { inputSpec.set(layout.projectDirectory.file("path/to/spec.yaml")) }
Jim Schubert
-
-
Field Summary
Fields Modifier and Type Field Description private final ProjectLayoutlayoutprivate final RegularFilePropertyinputSpecprivate final Property<String>remoteInputSpecprivate final Property<Boolean>recommendprivate final Property<Boolean>treatWarningsAsErrorsprivate final TaskOutputsInternaloutputsprivate final Spec<in TaskInternal>onlyIfprivate final Property<Duration>timeoutprivate final TaskRequiredServicesrequiredServicesprivate final TaskDependencyInternaltaskDependenciesprivate final Set<Object>dependsOnprivate final TaskDestroyablesdestroyablesprivate final Loggerloggerprivate final Stringpathprivate final Factory<File>temporaryDirFactoryprivate final Optional<String>reasonTaskIsIncompatibleWithConfigurationCacheprivate final TaskLocalStatelocalStateprivate final List<InputChangesAwareTaskAction>taskActionsprivate final TaskDependencyInternallifecycleDependenciesprivate BooleanisEnabledprivate BooleanimpliesSubProjectsprivate final TaskInputsInternalinputsprivate final Conventionconventionprivate Booleanenabledprivate final TaskStateInternalstateprivate final TaskIdentity<?>taskIdentityprivate final TaskDependencyshouldRunAfterprivate final ExtensionContainerextensionsprivate final BooleanisCompatibleWithConfigurationCacheprivate final TaskDependencyfinalizedByprivate final AntBuilderantprivate final DynamicObjectasDynamicObjectprivate final List<ResourceLock>sharedResourcesprivate BooleandidWorkprivate final Optional<String>reasonNotToTrackStateprivate Stringgroupprivate final BooleanisHasCustomActionsprivate List<Action<in Task>>actionsprivate final Stringnameprivate final FiletemporaryDirprivate final LoggingManagerloggingprivate final PathidentityPathprivate final TaskDependencymustRunAfterprivate final StandardOutputCapturestandardOutputCaptureprivate final Projectprojectprivate Stringdescription
-
Constructor Summary
Constructors Constructor Description ValidateTask()
-
Method Summary
Modifier and Type Method Description abstract ProjectLayoutgetLayout()abstract RegularFilePropertygetInputSpec()The local OpenAPI 2.0/3.x specification file to validate. abstract Property<String>getRemoteInputSpec()The remote OpenAPI 2.0/3.x specification URL to validate. abstract Property<Boolean>getRecommend()Whether to include recommendations in the validation output. abstract Property<Boolean>getTreatWarningsAsErrors()When true, the task fails if the spec produces validation warnings.final UnitsetInput(String value)final UnitdoWork()final Unitset(RegularFileProperty $self, String path)Extension function to allow setting inputSpec with a String path in Kotlin DSL. final UnitsetInputSpecAsString(String path)Groovy-compatible setter for inputSpec property. -
Methods inherited from class org.gradle.api.DefaultTask
getActions, getAnt, getConvention, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, setActions, setDescription, setDidWork, setEnabled, setEnabled, setGroup -
Methods inherited from class org.gradle.api.internal.AbstractTask
getAsDynamicObject, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, setImpliesSubProjects -
Methods inherited from class org.gradle.api.Task
configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, doNotTrackState, finalizedBy, getConvention, hasProperty, mustRunAfter, notCompatibleWithConfigurationCache, onlyIf, onlyIf, onlyIf, property, setDependsOn, setFinalizedBy, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService -
Methods inherited from class kotlin.Comparable
compareTo -
Methods inherited from class org.gradle.api.internal.TaskInternal
acceptServiceReferences, appendParallelSafeAction, hasTaskActions, prependParallelSafeAction -
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
Method Detail
-
getLayout
@Inject() abstract ProjectLayout getLayout()
-
getInputSpec
@Optional()@InputFile()@PathSensitive(value = PathSensitivity.RELATIVE) abstract RegularFileProperty getInputSpec()
The local OpenAPI 2.0/3.x specification file to validate.
Use remoteInputSpec instead when validating a spec hosted at a URL.
-
getRemoteInputSpec
@Optional()@Input() abstract Property<String> getRemoteInputSpec()
The remote OpenAPI 2.0/3.x specification URL to validate.
When both inputSpec and remoteInputSpec are set, remoteInputSpec takes priority.
-
getRecommend
@Optional()@Input() abstract Property<Boolean> getRecommend()
Whether to include recommendations in the validation output. Defaults to
true.Recommendations are advisory hints about spec quality that do not cause the task to fail.
-
getTreatWarningsAsErrors
@Optional()@Input() abstract Property<Boolean> getTreatWarningsAsErrors()
When
true, the task fails if the spec produces validation warnings. Defaults tofalse.
-
set
final Unit set(RegularFileProperty $self, String path)
Extension function to allow setting inputSpec with a String path in Kotlin DSL. Example: inputSpec.set("$rootDir/api.yaml")
-
setInputSpecAsString
final Unit setInputSpecAsString(String path)
Groovy-compatible setter for inputSpec property. Accepts a String and automatically routes to remote or local file based on URI detection. Clears the opposite property to prevent stale values from taking precedence.
-
-
-
-