Class ToolExecBase<P extends EnhancedProblems>

java.lang.Object

org.gradle.api.internal.AbstractTask

org.gradle.api.DefaultTask

org.gradle.api.internal.ConventionTask

org.gradle.api.tasks.JavaExec

net.minecraftforge.gradleutils.shared.ToolExecBase<P>

Type Parameters:

P - The type of enhanced problems, used for common problems reporting with illegal task arguments

All Implemented Interfaces:

Comparable<Task>, EnhancedPluginAdditions, EnhancedTask<P>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.IConventionAware, org.gradle.api.internal.TaskInternal, Named, ExtensionAware, Task, BaseExecSpec, JavaExecSpec, JavaForkOptions, ProcessForkOptions, Configurable<Task>

public abstract class ToolExecBase<P extends EnhancedProblems>
extends JavaExec
implements EnhancedTask<P>

This tool execution task is a template on top of JavaExec to make executing tools much easier and more consistent between plugins.

See Also:

• JavaExec
• Tool

Implementation Requirements:

Implementing plugins should make a shared subclass named ToolExec which all other tool executing tasks should extend from.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gradle.api.Named

Named.Namer

Field Summary

Fields

Modifier and Type	Field	Description
protected final DirectoryProperty	defaultToolDir	The default tool directory (usage is not required).

Fields inherited from interface org.gradle.api.Task

TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ToolExecBase(Tool tool)	Creates a new task instance using the given types and tool information.

Method Summary

Modifier and Type	Method	Description
protected void	addArguments()	This method should be overridden by subclasses to add arguments to this task via JavaExec.args(java.lang.Object...).
protected final void	args(String arg, Iterable<? extends File> files)	Adds each file to the arguments preceded by the given argument.
protected final void	args(String arg, FileSystemLocationProperty<? extends FileSystemLocation> fileProvider)	Adds the given argument followed by the given file location to the arguments.
protected final void	args(String arg, @UnknownNullability Provider<?> provider)	Adds the given argument followed by the given object (may be a file location) to the arguments.
protected final void	args(Map<?,?> args)	Adds the given map of arguments.
void	exec()
ListProperty<String>	getAdditionalArgs()	Additional arguments to use when invoking the tool.
protected final P	getProblems()	The enhanced problems instance to use for this task.

Methods inherited from class org.gradle.api.tasks.JavaExec

args, args, bootstrapClasspath, classpath, copyTo, copyTo, debugOptions, environment, environment, executable, getAllJvmArgs, getArgs, getArgumentProviders, getBootstrapClasspath, getClasspath, getCommandLine, getDebug, getDebugOptions, getDefaultCharacterEncoding, getEnableAssertions, getEnvironment, getErrorOutput, getExecActionFactory, getExecutable, getExecutionResult, getJavaLauncher, getJavaToolchainService, getJavaVersion, getJvmArgs, getJvmArgumentProviders, getJvmArguments, getMainClass, getMainModule, getMaxHeapSize, getMinHeapSize, getModularity, getObjectFactory, getPropertyFactory, getProviderFactory, getStandardInput, getStandardOutput, getSystemProperties, getWorkingDir, isIgnoreExitValue, jvmArgs, jvmArgs, setAllJvmArgs, setAllJvmArgs, setArgs, setArgs, setArgsString, setBootstrapClasspath, setClasspath, setDebug, setDefaultCharacterEncoding, setEnableAssertions, setEnvironment, setErrorOutput, setExecutable, setExecutable, setIgnoreExitValue, setJvmArgs, setJvmArgs, setMaxHeapSize, setMinHeapSize, setStandardInput, setStandardOutput, setSystemProperties, setWorkingDir, setWorkingDir, systemProperties, systemProperty, workingDir

Methods inherited from class org.gradle.api.internal.ConventionTask

conventionMapping, conventionMapping, getConventionMapping

Methods inherited from class org.gradle.api.DefaultTask

compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

Methods inherited from class org.gradle.api.internal.AbstractTask

acceptServiceReferences, appendParallelSafeAction, doNotTrackState, getAsDynamicObject, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, setImpliesSubProjects

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface net.minecraftforge.gradleutils.shared.EnhancedTask

getDefaultOutputDirectory, getDefaultOutputFile, getDefaultOutputFile, getTool, globalCaches, localCaches, pluginType, problemsType, rootProjectDirectory, workingProjectDirectory

Methods inherited from interface org.gradle.api.plugins.ExtensionAware

getExtensions

Methods inherited from interface org.gradle.api.Task

configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, doNotTrackState, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getFinalizedBy, getGroup, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getPath, getProject, getShouldRunAfter, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, notCompatibleWithConfigurationCache, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

Field Details

defaultToolDir

protected final DirectoryProperty defaultToolDir

The default tool directory (usage is not required).

Constructor Details

ToolExecBase

protected ToolExecBase(Tool tool)

Creates a new task instance using the given types and tool information.

Parameters:

tool - The tool to use for this task

Implementation Requirements:

The implementing subclass must make their constructor public, annotated with Inject, and have only a single parameter for Tool, passing in static plugin and problems types to this base constructor. The types must also be manually specified in the class declaration when overriding this class. The best practice is to make a single ToolExec class for the implementing plugin to use, which other tasks can extend off of.

Method Details

getAdditionalArgs

@Input
@Optional
public ListProperty<String> getAdditionalArgs()

Additional arguments to use when invoking the tool. Use in configuration instead of args(java.lang.String, java.lang.Iterable<? extends java.io.File>).

Returns:

The list property for the additional arguments

getProblems

@Internal
protected final P getProblems()

The enhanced problems instance to use for this task.

Returns:

The enhanced problems

addArguments

@MustBeInvokedByOverriders
protected void addArguments()

This method should be overridden by subclasses to add arguments to this task via JavaExec.args(java.lang.Object...). To preserve arguments added by superclasses, this method must be invoked by overriders.

exec

public void exec()

Overrides:

exec in class JavaExec

Implementation Note:

Not invoking this method from an overriding method will result in the tool never being executed and addArguments() never being run.

args

protected final void args(String arg,
 Iterable<? extends File> files)

Adds each file to the arguments preceded by the given argument. Designed to work well with JOpt Simple.

Parameters:

arg - The flag to use for each file

files - The files to add

args

protected final void args(String arg,
 FileSystemLocationProperty<? extends FileSystemLocation> fileProvider)

Adds the given argument followed by the given file location to the arguments.

Parameters:

arg - The flag to use

fileProvider - The file to add

args

protected final void args(String arg,
 @UnknownNullability Provider<?> provider)

Adds the given argument followed by the given object (may be a file location) to the arguments.

Parameters:

arg - The flag to use

provider - The object (or file) to add

args

protected final void args(Map<?,?> args)

Adds the given map of arguments.

args(String, Provider) will be invoked for each entry in the map. If the key and/or value are not of the required types, they will be automatically converted using Object.toString() and ProviderFactory.provider(Callable).

Parameters:

args - The args to add