AbstractProject (Gradle API 1.0)

java.lang.Object
- org.gradle.api.internal.project.AbstractProject

All Implemented Interfaces:

Comparable<Project>, DependencyMetaDataProvider, DomainObjectContext, DynamicObjectAware, FileOperations, ProcessOperations, ProjectIdentifier, ProjectInternal, ExtensionAware, Project, ScriptAware

Direct Known Subclasses:

DefaultProject
```
public abstract class AbstractProject
extends Object
implements ProjectInternal, DynamicObjectAware
```
Author:

Hans Dockter

Field Summary
- Fields inherited from interface org.gradle.api.Project
  DEFAULT_BUILD_DIR_NAME, DEFAULT_BUILD_FILE, DEFAULT_STATUS, DEFAULT_VERSION, GRADLE_PROPERTIES, PATH_SEPARATOR, SYSTEM_PROP_PREFIX

Constructor Summary

Constructors
Constructor and Description
`AbstractProject(String name, ProjectInternal parent, File projectDir, ScriptSource buildScriptSource, GradleInternal gradle, ServiceRegistryFactory serviceRegistryFactory)`

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`absoluteProjectPath(String path)` Converts a name to an absolute project path, resolving names relative to this project.
`void`	`addChildProject(ProjectInternal childProject)`
`void`	`afterCompile(ScriptPlugin configurer, Script script)`
`void`	`afterEvaluate(Action<? super Project> action)` Adds an action to execute immediately after this project is evaluated.
`void`	`afterEvaluate(Closure closure)` Adds a closure to be called immediately after this project has been evaluated.
`void`	`allprojects(Action<? super Project> action)` Configures this project and each of its sub-projects.
`void`	`allprojects(Closure configureClosure)` Configures this project and each of its sub-projects.
`AntBuilder`	`ant(Closure configureClosure)` Executes the given closure against the `AntBuilder` for this project.
`void`	`apply(Closure closure)` Configures this project using plugins or scripts.
`void`	`apply(Map<String,?> options)` Configures this project using plugins or scripts.
`void`	`artifacts(Closure configureClosure)` Configures the published artifacts for this project.
`void`	`beforeCompile(ScriptPlugin configurer)`
`void`	`beforeEvaluate(Action<? super Project> action)` Adds an action to execute immediately before this project is evaluated.
`void`	`beforeEvaluate(Closure closure)` Adds a closure to be called immediately before this project is evaluated.
`void`	`buildscript(Closure configureClosure)` Configures the build script classpath for this project.
`Project`	`childrenDependOnMe()` Declares that all child projects of this project have an execution dependency on this project.
`int`	`compareTo(Project otherProject)`
`void`	`configurations(Closure configureClosure)` Configures the dependency configurations for this project.
`Iterable<?>`	`configure(Iterable<?> objects, Closure configureClosure)` Configures a collection of objects via a closure.
`<T> Iterable<T>`	`configure(Iterable<T> objects, Action<? super T> configureAction)` Configures a collection of objects via an action.
`Object`	`configure(Object object, Closure configureClosure)` Configures an object via a closure, with the closure's delegate set to the supplied object.
`<T> NamedDomainObjectContainer<T>`	`container(Class<T> type)` Creates a container for managing named objects of the specified type.
`<T> NamedDomainObjectContainer<T>`	`container(Class<T> type, Closure factoryClosure)` Creates a container for managing named objects of the specified type.
`<T> NamedDomainObjectContainer<T>`	`container(Class<T> type, NamedDomainObjectFactory<T> factory)` Creates a container for managing named objects of the specified type.
`WorkResult`	`copy(Closure closure)` Copies the specified files.
`CopySpec`	`copySpec(Closure closure)` Creates a `CopySpec` which can later be used to copy files or create an archive.
`AntBuilder`	`createAntBuilder()` Creates an additional `AntBuilder` for this project.
`Task`	`createTask(Map<String,?> args, String name, Action<? super Task> action)`
`Task`	`createTask(Map args, String name, Closure action)`
`void`	`defaultTasks(String... defaultTasks)` Sets the names of the default tasks of this project.
`boolean`	`delete(Object... paths)` Deletes files and directories.
`void`	`dependencies(Closure configureClosure)` Configures the dependencies for this project.
`void`	`dependsOn(String path)` Declares that this project has an execution dependency on the project with the given path.
`void`	`dependsOn(String path, boolean evaluateDependsOnProject)` Declares that this project has an execution dependency on the project with the given path.
`Project`	`dependsOnChildren()` Declares that this project has an execution dependency on each of its child projects.
`Project`	`dependsOnChildren(boolean evaluateDependsOnProject)` Declares that this project has an execution dependency on each of its child projects.
`int`	`depthCompare(Project otherProject)` Compares the nesting level of this project with another project of the multi-project hierarchy.
`org.gradle.api.tasks.Directory`	`dir(String path)` Deprecated. Use the `mkdir(Object)` instead.
`AbstractProject`	`evaluate()`
`Project`	`evaluationDependsOn(String path)` Declares that this project has an evaluation dependency on the project with the given path.
`void`	`evaluationDependsOnChildren()` Declares that this project has an evaluation dependency on each of its child projects.
`ExecResult`	`exec(Closure closure)` Executes an external command.
`File`	`file(Object path)` Resolves a file path relative to the project directory of this project.
`File`	`file(Object path, PathValidation validation)` Resolves a file path relative to the project directory of this project and validates it using the given scheme.
`ConfigurableFileCollection`	`files(Object... paths)` Returns a `ConfigurableFileCollection` containing the given files.
`ConfigurableFileCollection`	`files(Object paths, Closure closure)` Creates a new `ConfigurableFileCollection` using the given paths.
`ConfigurableFileTree`	`fileTree(Closure closure)` Creates a new `ConfigurableFileTree` using the provided closure.
`ConfigurableFileTree`	`fileTree(Map<String,?> args)` Creates a new `ConfigurableFileTree` using the provided map of arguments.
`ConfigurableFileTree`	`fileTree(Object baseDir)` Creates a new `ConfigurableFileTree` using the given base directory.
`ConfigurableFileTree`	`fileTree(Object baseDir, Closure closure)` Creates a new `ConfigurableFileTree` using the given base directory.
`ProjectInternal`	`findProject(String path)` Locates a project by path.
`Set<Project>`	`getAllprojects()` Returns the set containing this project and its subprojects.
`Map<Project,Set<Task>>`	`getAllTasks(boolean recursive)` Returns a map of the tasks contained in this project, and optionally its subprojects.
`AntBuilder`	`getAnt()` Returns the `AntBuilder` for this project.
`Factory<AntBuilder>`	`getAntBuilderFactory()`
`ArtifactHandler`	`getArtifacts()` Returns a handler for assigning artifacts produced by the project to configurations.
`DynamicObject`	`getAsDynamicObject()` Returns a `DynamicObject` for this object.
`File`	`getBuildDir()` Returns the build directory of this project.
`File`	`getBuildFile()` Returns the build file Gradle will evaluate against this project object.
`ScriptHandler`	`getBuildscript()` Returns the build script handler for this project.
`ScriptSource`	`getBuildScriptSource()`
`Map<String,Project>`	`getChildProjects()` Returns the direct children of this project.
`ConfigurationContainerInternal`	`getConfigurations()` Returns the configurations of this project.
`Convention`	`getConvention()` Returns the `Convention` for this project.
`List<String>`	`getDefaultTasks()` Returns the names of the default tasks of this project.
`DependencyHandler`	`getDependencies()` Returns the dependency handler of this project.
`Set<Project>`	`getDependsOnProjects()` Returns the set of projects which this project depends on.
`int`	`getDepth()` Returns the nesting level of a project in a multi-project hierarchy.
`String`	`getDescription()` Returns the description of this project.
`ExtensionContainer`	`getExtensions()` Allows adding DSL extensions to the project.
`FileResolver`	`getFileResolver()`
`GradleInternal`	`getGradle()` Returns the `Gradle` invocation which this project belongs to.
`Object`	`getGroup()` Returns the group of this project.
`TaskContainerInternal`	`getImplicitTasks()`
`DynamicObject`	`getInheritedScope()`
`Logger`	`getLogger()` Returns the logger for this project.
`LoggingManager`	`getLogging()` Returns the `LoggingManager` which can be used to control the logging level and standard output/error capture for this project's build script.
`Module`	`getModule()`
`String`	`getName()` Returns the name of this project.
`ProjectInternal`	`getParent()` Returns the parent project of this project, if any.
`ProjectIdentifier`	`getParentIdentifier()`
`String`	`getPath()` Returns the path of this project.
`PluginContainer`	`getPlugins()` Returns the plugins container for this project.
`Project`	`getProject()` This method is used when scripts access the project via project.x
`File`	`getProjectDir()` The directory containing the project build file.
`ProjectEvaluationListener`	`getProjectEvaluationBroadcaster()`
`ProjectEvaluator`	`getProjectEvaluator()`
`IProjectRegistry<ProjectInternal>`	`getProjectRegistry()`
`Map<String,?>`	`getProperties()` Returns the properties of this project.
`RepositoryHandler`	`getRepositories()` Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project.
`ResourceHandler`	`getResources()` Provides access to resource-specific utility methods, for example factory methods that create various resources.
`File`	`getRootDir()` Returns the root directory of this project.
`ProjectInternal`	`getRootProject()` Returns the root project for the hierarchy that this project belongs to.
`ServiceRegistryFactory`	`getServices()`
`StandardOutputCapture`	`getStandardOutputCapture()`
`ProjectStateInternal`	`getState()` Returns the evaluation state of this project.
`Object`	`getStatus()` Returns the status of this project.
`Set<Project>`	`getSubprojects()` Returns the set containing the subprojects of this project.
`TaskContainerInternal`	`getTasks()` Returns the tasks of this project.
`Set<Task>`	`getTasksByName(String name, boolean recursive)` Returns the set of tasks with the given name contained in this project, and optionally its subprojects.
`Object`	`getVersion()` Returns the version of this project.
`boolean`	`hasProperty(String propertyName)` Determines if this project has the given property.
`ExecResult`	`javaexec(Closure closure)` Executes a Java main class.
`File`	`mkdir(Object path)` Creates a directory and returns a file pointing to it.
`Object`	`passThrough(Object object)` This is called by the task creation DSL.
`ProjectInternal`	`project(String path)` Locates a project by path.
`Project`	`project(String path, Closure configureClosure)` Locates a project by path and configures it using the given closure.
`Object`	`property(String propertyName)` Returns the value of the given property.
`String`	`relativePath(Object path)` Returns the relative path from the project directory to the given path.
`String`	`relativeProjectPath(String path)` Converts a name to a project path relative to this project.
`void`	`repositories(Closure configureClosure)` Configures the repositories for this project.
`void`	`setAnt(AntBuilder ant)`
`void`	`setAntBuilderFactory(Factory<AntBuilder> antBuilderFactory)`
`void`	`setArtifactHandler(ArtifactHandler artifactHandler)`
`void`	`setBuildDir(Object path)` Sets the build directory of this project.
`void`	`setConfigurationContainer(ConfigurationContainerInternal configurationContainer)`
`void`	`setDefaultTasks(List<String> defaultTasks)` Sets the names of the default tasks of this project.
`void`	`setDependencyHandler(DependencyHandler dependencyHandler)`
`void`	`setDescription(String description)` Sets a description for this project.
`void`	`setFileResolver(FileResolver fileResolver)`
`void`	`setGroup(Object group)` Sets the group of this project.
`void`	`setProjectEvaluator(ProjectEvaluator projectEvaluator)`
`void`	`setProperty(String name, Object value)` Sets a property of this project.
`void`	`setScript(Script buildScript)`
`void`	`setStatus(Object status)` Sets the status of this project.
`void`	`setTaskContainer(TaskContainerInternal taskContainer)`
`void`	`setVersion(Object version)` Sets the version of this project.
`void`	`subprojects(Action<? super Project> action)` Configures the sub-projects of this project
`void`	`subprojects(Closure configureClosure)` Configures the sub-projects of this project.
`FileTree`	`tarTree(Object tarPath)` Creates a new `FileTree` which contains the contents of the given TAR file.
`Task`	`task(Map options, Object task)`
`Task`	`task(Map options, Object task, Closure configureClosure)`
`Task`	`task(Map options, String task)` Creates a `Task` with the given name and adds it to this project.
`Task`	`task(Map options, String task, Closure configureClosure)` Creates a `Task` with the given name and adds it to this project.
`Task`	`task(Object task)`
`Task`	`task(Object task, Closure configureClosure)`
`Task`	`task(String task)` Creates a `Task` with the given name and adds it to this project.
`Task`	`task(String task, Closure configureClosure)` Creates a `Task` with the given name and adds it to this project.
`String`	`toString()`
`URI`	`uri(Object path)` Resolves a file path to a URI, relative to the project directory of this project.
`FileTree`	`zipTree(Object zipPath)` Creates a new `FileTree` which contains the contents of the given ZIP file.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AbstractProject

public AbstractProject(String name,
               ProjectInternal parent,
               File projectDir,
               ScriptSource buildScriptSource,
               GradleInternal gradle,
               ServiceRegistryFactory serviceRegistryFactory)

Method Detail

getRootProject
```
public ProjectInternal getRootProject()
```
Description copied from interface: Project

Returns the root project for the hierarchy that this project belongs to. In the case of a single-project build, this method returns this project.

Specified by:

getRootProject in interface ProjectInternal

Specified by:

getRootProject in interface Project

Returns:
The root project. Never returns null.

getGradle
```
public GradleInternal getGradle()
```
Description copied from interface: Project

Returns the Gradle invocation which this project belongs to.

Specified by:

getGradle in interface ProjectInternal

Specified by:

getGradle in interface Project

Returns:
The Gradle object. Never returns null.

getPlugins
```
public PluginContainer getPlugins()
```
Description copied from interface: Project

Returns the plugins container for this project. The returned container can be used to manage the plugins which are used by this project.

Specified by:

getPlugins in interface Project

Returns:
the plugin container. Never returns null.

getProjectEvaluator

public ProjectEvaluator getProjectEvaluator()

setProjectEvaluator

public void setProjectEvaluator(ProjectEvaluator projectEvaluator)

getBuildscript
```
public ScriptHandler getBuildscript()
```
Description copied from interface: Project

Returns the build script handler for this project. You can use this handler to query details about the build script for this project, and manage the classpath used to compile and execute the project's build script.

Specified by:

getBuildscript in interface Project

Returns:
the classpath handler. Never returns null.

beforeCompile
```
public void beforeCompile(ScriptPlugin configurer)
```
Specified by:

beforeCompile in interface ScriptAware

afterCompile

public void afterCompile(ScriptPlugin configurer,
                Script script)

Specified by:: afterCompile in interface ScriptAware

getBuildFile
```
public File getBuildFile()
```
Description copied from interface: Project

Returns the build file Gradle will evaluate against this project object. The default is "build.gradle". If an embedded script is provided the build file will be null.

Specified by:

getBuildFile in interface ProjectIdentifier

Specified by:

getBuildFile in interface Project

Returns:
Current build file. May return null.

setScript

public void setScript(Script buildScript)

getBuildScriptSource
```
public ScriptSource getBuildScriptSource()
```
Specified by:

getBuildScriptSource in interface ProjectInternal

getRootDir
```
public File getRootDir()
```
Description copied from interface: Project

Returns the root directory of this project. The root directory is the project directory of the root project.

Specified by:

getRootDir in interface Project

Returns:
The root directory. Never returns null.

getParent
```
public ProjectInternal getParent()
```
Description copied from interface: Project

Returns the parent project of this project, if any.

Specified by:

getParent in interface ProjectInternal

Specified by:

getParent in interface Project

Returns:
The parent project, or null if this is the root project.

getParentIdentifier
```
public ProjectIdentifier getParentIdentifier()
```
Specified by:

getParentIdentifier in interface ProjectIdentifier

getAsDynamicObject
```
public DynamicObject getAsDynamicObject()
```
Description copied from interface: DynamicObjectAware

Returns a DynamicObject for this object.

Specified by:

getAsDynamicObject in interface DynamicObjectAware

Returns:
The dynamic object.

getInheritedScope
```
public DynamicObject getInheritedScope()
```
Specified by:

getInheritedScope in interface ProjectInternal

getName
```
public String getName()
```
Description copied from interface: Project

Returns the name of this project. The project's name is not necessarily unique within a project hierarchy. You should use the Project.getPath() method for a unique identifier for the project.

Specified by:

getName in interface ProjectIdentifier

Specified by:

getName in interface Project

Returns:
The name of this project. Never return null.

getDescription
```
public String getDescription()
```
Description copied from interface: Project

Returns the description of this project.

Specified by:

getDescription in interface Project

Returns:
the description. May return null.

setDescription
```
public void setDescription(String description)
```
Description copied from interface: Project

Sets a description for this project.

Specified by:

setDescription in interface Project

Parameters:
description - The description of the project. Might be null.

getGroup
```
public Object getGroup()
```
Description copied from interface: Project

Returns the group of this project. Gradle always uses the toString() value of the group. The group defaults to the path with dots a separators.

Specified by:

getGroup in interface Project

Returns:
The group of this project. Never returns null.

setGroup
```
public void setGroup(Object group)
```
Description copied from interface: Project

Sets the group of this project.

Specified by:

setGroup in interface Project

Parameters:
group - The group of this project. Must not be null.

getVersion
```
public Object getVersion()
```
Description copied from interface: Project

Returns the version of this project. Gradle always uses the toString() value of the version. The version defaults to "unspecified".

Specified by:

getVersion in interface Project

Returns:
The version of this project. Never returns null.

setVersion
```
public void setVersion(Object version)
```
Description copied from interface: Project

Sets the version of this project.

Specified by:

setVersion in interface Project

Parameters:
version - The version of this project. Must not be null.

getStatus
```
public Object getStatus()
```
Description copied from interface: Project

Returns the status of this project. Gradle always uses the toString() value of the status. The status defaults to "release".

The status of the project is only relevant, if you upload libraries together with a module descriptor. The status specified here, will be part of this module descriptor.

Specified by:

getStatus in interface Project

Returns:
The status of this project. Never returns null.

setStatus
```
public void setStatus(Object status)
```
Description copied from interface: Project

Sets the status of this project.

Specified by:

setStatus in interface Project

Parameters:
status - The status. Must not be null.

getChildProjects
```
public Map<String,Project> getChildProjects()
```
Description copied from interface: Project

Returns the direct children of this project.

Specified by:

getChildProjects in interface Project

Returns:
A map from child project name to child project. Returns an empty map if this this project does not have any children.

getDefaultTasks
```
public List<String> getDefaultTasks()
```
Description copied from interface: Project

Returns the names of the default tasks of this project. These are used when no tasks names are provided when starting the build.

Specified by:

getDefaultTasks in interface Project

Returns:
The default task names. Returns an empty list if this project has no default tasks.

setDefaultTasks
```
public void setDefaultTasks(List<String> defaultTasks)
```
Description copied from interface: Project

Sets the names of the default tasks of this project. These are used when no tasks names are provided when starting the build.

Specified by:

setDefaultTasks in interface Project

Parameters:
defaultTasks - The default task names.

getDependsOnProjects
```
public Set<Project> getDependsOnProjects()
```
Description copied from interface: Project

Returns the set of projects which this project depends on.

Specified by:

getDependsOnProjects in interface Project

Returns:
The set of projects. Returns an empty set if this project depends on no projects.

getState
```
public ProjectStateInternal getState()
```
Description copied from interface: Project

Returns the evaluation state of this project. You can use this to access information about the evaluation of this project, such as whether it has failed.

Specified by:

getState in interface Project

Returns:
the project state. Never returns null.

getFileResolver
```
public FileResolver getFileResolver()
```
Specified by:

getFileResolver in interface FileOperations

Specified by:

getFileResolver in interface ProjectInternal

setFileResolver

public void setFileResolver(FileResolver fileResolver)

setAnt
```
public void setAnt(AntBuilder ant)
```

getArtifacts
```
public ArtifactHandler getArtifacts()
```
Description copied from interface: Project

Returns a handler for assigning artifacts produced by the project to configurations.
Examples:
See docs for ArtifactHandler

Specified by:

getArtifacts in interface Project

setArtifactHandler

public void setArtifactHandler(ArtifactHandler artifactHandler)

getRepositories
```
public RepositoryHandler getRepositories()
```
Description copied from interface: Project

Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project.

Specified by:

getRepositories in interface Project

Returns:
the repository handler. Never returns null.

getConfigurations
```
public ConfigurationContainerInternal getConfigurations()
```
Description copied from interface: Project

Returns the configurations of this project.
Examples:
See docs for ConfigurationContainer

Specified by:

getConfigurations in interface ProjectInternal

Specified by:

getConfigurations in interface Project

Returns:
The configuration of this project.

setConfigurationContainer

public void setConfigurationContainer(ConfigurationContainerInternal configurationContainer)

getConvention
```
public Convention getConvention()
```
Description copied from interface: Project

Returns the Convention for this project.

You can access this property in your build file using convention. You can also can also access the properties and methods of the convention object as if they were properties and methods of this project. See here for more details

Specified by:

getConvention in interface Project

Returns:
The Convention. Never returns null.

getPath
```
public String getPath()
```
Description copied from interface: Project

Returns the path of this project. The path is the fully qualified name of the project.

Specified by:

getPath in interface ProjectIdentifier

Specified by:

getPath in interface Project

Returns:
The path. Never returns null.

getDepth
```
public int getDepth()
```
Description copied from interface: Project

Returns the nesting level of a project in a multi-project hierarchy. For single project builds this is always 0. In a multi-project hierarchy 0 is returned for the root project.

Specified by:

getDepth in interface Project

getProjectRegistry
```
public IProjectRegistry<ProjectInternal> getProjectRegistry()
```
Specified by:

getProjectRegistry in interface ProjectInternal

depthCompare
```
public int depthCompare(Project otherProject)
```
Description copied from interface: Project

Compares the nesting level of this project with another project of the multi-project hierarchy.

Specified by:

depthCompare in interface Project

Parameters:
otherProject - The project to compare the nesting level with.

Returns:
a negative integer, zero, or a positive integer as this project has a nesting level less than, equal to, or greater than the specified object.
See Also:
Project.getDepth()

compareTo
```
public int compareTo(Project otherProject)
```
Specified by:

compareTo in interface Comparable<Project>

absoluteProjectPath
```
public String absoluteProjectPath(String path)
```
Description copied from interface: Project

Converts a name to an absolute project path, resolving names relative to this project.

Specified by:

absoluteProjectPath in interface DomainObjectContext

Specified by:

absoluteProjectPath in interface Project

Parameters:
path - The path to convert.

Returns:
The absolute path.

relativeProjectPath
```
public String relativeProjectPath(String path)
```
Description copied from interface: Project

Converts a name to a project path relative to this project.

Specified by:

relativeProjectPath in interface Project

Parameters:
path - The path to convert.

Returns:
The relative path.

project
```
public ProjectInternal project(String path)
```
Description copied from interface: Project

Locates a project by path. If the path is relative, it is interpreted relative to this project.

Specified by:

project in interface ProjectInternal

Specified by:

project in interface Project

Parameters:
path - The path.

Returns:
The project with the given path. Never returns null.

findProject
```
public ProjectInternal findProject(String path)
```
Description copied from interface: Project

Locates a project by path. If the path is relative, it is interpreted relative to this project.

Specified by:

findProject in interface ProjectInternal

Specified by:

findProject in interface Project

Parameters:
path - The path.

Returns:
The project with the given path. Returns null if no such project exists.

getAllprojects
```
public Set<Project> getAllprojects()
```
Description copied from interface: Project

Returns the set containing this project and its subprojects.

Specified by:

getAllprojects in interface Project

Returns:
The set of projects.

getSubprojects
```
public Set<Project> getSubprojects()
```
Description copied from interface: Project

Returns the set containing the subprojects of this project.

Specified by:

getSubprojects in interface Project

Returns:
The set of projects. Returns an empty set if this project has no subprojects.

subprojects
```
public void subprojects(Action<? super Project> action)
```
Description copied from interface: Project

Configures the sub-projects of this project

This method executes the given Action against the sub-projects of this project.

Specified by:

subprojects in interface Project

Parameters:
action - The action to execute.

allprojects
```
public void allprojects(Action<? super Project> action)
```
Description copied from interface: Project

Configures this project and each of its sub-projects.

This method executes the given Action against this project and each of its sub-projects.

Specified by:

allprojects in interface Project

Parameters:
action - The action to execute.

configure
```
public <T> Iterable<T> configure(Iterable<T> objects,
                        Action<? super T> configureAction)
```
Description copied from interface: Project

Configures a collection of objects via an action.

Specified by:

configure in interface Project

Parameters:
objects - The objects to configure
configureAction - The action to apply to each object

Returns:
The configured objects.

getAnt

public AntBuilder getAnt()

Description copied from interface: Project

Returns the AntBuilder for this project. You can use this in your build file to execute ant tasks. See example below.

 task printChecksum {
   doLast {
     ant {
       //using ant checksum task to store the file checksum in the checksumOut ant property
       checksum(property: 'checksumOut', file: 'someFile.txt')

       //we can refer to the ant property created by checksum task:
       println "The checksum is: " + checksumOut
     }

     //we can refer to the ant property later as well:
     println "I just love to print checksums: " + ant.checksumOut
   }
 }

Consider following example of ant target:

 <target name='printChecksum'>
   <checksum property='checksumOut'>
     <fileset dir='.'>
       <include name='agile.txt'/>
     </fileset>
   </checksum>
   <echo>The checksum is: ${checksumOut}</echo>
 </target>

Here's how it would look like in gradle. Observe how the ant xml is represented in groovy by the ant builder

 task printChecksum {
   doLast {
     ant {
       checksum(property: 'checksumOut') {
         fileset(dir: '.') {
           include name: 'agile1.txt'
         }
       }
     }
     logger.lifecycle("The checksum is $ant.checksumOut")
   }
 }

Specified by:: getAnt in interface Project
Returns:: The AntBuilder for this project. Never returns null.

createAntBuilder
```
public AntBuilder createAntBuilder()
```
Description copied from interface: Project

Creates an additional AntBuilder for this project. You can use this in your build file to execute ant tasks.

Specified by:

createAntBuilder in interface Project

Returns:
Creates an AntBuilder for this project. Never returns null.
See Also:
Project.getAnt()

getProject
```
public Project getProject()
```
This method is used when scripts access the project via project.x

Specified by:

getProject in interface Project

Returns:
This project. Never returns null.

evaluate
```
public AbstractProject evaluate()
```
Specified by:

evaluate in interface ProjectInternal

getTasks
```
public TaskContainerInternal getTasks()
```
Description copied from interface: Project

Returns the tasks of this project.

Specified by:

getTasks in interface ProjectInternal

Specified by:

getTasks in interface Project

Returns:
the tasks of this project.

getImplicitTasks
```
public TaskContainerInternal getImplicitTasks()
```
Specified by:

getImplicitTasks in interface ProjectInternal

defaultTasks
```
public void defaultTasks(String... defaultTasks)
```
Description copied from interface: Project

Sets the names of the default tasks of this project. These are used when no tasks names are provided when starting the build.

Specified by:

defaultTasks in interface Project

Parameters:
defaultTasks - The default task names.

createTask

public Task createTask(Map args,
              String name,
              Closure action)

createTask

public Task createTask(Map<String,?> args,
              String name,
              Action<? super Task> action)

addChildProject
```
public void addChildProject(ProjectInternal childProject)
```
Specified by:

addChildProject in interface ProjectInternal

getProjectDir
```
public File getProjectDir()
```
Description copied from interface: Project

The directory containing the project build file.

Specified by:

getProjectDir in interface ProjectIdentifier

Specified by:

getProjectDir in interface Project

Returns:
The project directory. Never returns null.

getBuildDir
```
public File getBuildDir()
```
Description copied from interface: Project

Returns the build directory of this project. The build directory is the directory which all artifacts are generated into. The default value for the build directory is projectDir/build

Specified by:

getBuildDir in interface Project

Returns:
The build directory. Never returns null.

setBuildDir
```
public void setBuildDir(Object path)
```
Description copied from interface: Project

Sets the build directory of this project. The build directory is the directory which all artifacts are generated into. The path parameter is evaluated as described for Project.file(Object). This mean you can use, amongst other things, a relative or absolute path or File object to specify the build directory.

Specified by:

setBuildDir in interface Project

Parameters:
path - The build directory. This is evaluated as for Project.file(Object)

dependsOn
```
public void dependsOn(String path)
```
Description copied from interface: Project

Declares that this project has an execution dependency on the project with the given path.

Specified by:

dependsOn in interface Project

Parameters:
path - The path of the project which this project depends on.

dependsOn
```
public void dependsOn(String path,
             boolean evaluateDependsOnProject)
```
Description copied from interface: Project

Declares that this project has an execution dependency on the project with the given path.

Specified by:

dependsOn in interface Project

Parameters:
path - The path of the project which this project depends on.
evaluateDependsOnProject - If true, adds an evaluation dependency.

evaluationDependsOnChildren
```
public void evaluationDependsOnChildren()
```
Description copied from interface: Project

Declares that this project has an evaluation dependency on each of its child projects.

Specified by:

evaluationDependsOnChildren in interface Project

evaluationDependsOn
```
public Project evaluationDependsOn(String path)
```
Description copied from interface: Project

Declares that this project has an evaluation dependency on the project with the given path.

Specified by:

evaluationDependsOn in interface Project

Parameters:
path - The path of the project which this project depends on.

Returns:
The project which this project depends on.

childrenDependOnMe
```
public Project childrenDependOnMe()
```
Description copied from interface: Project

Declares that all child projects of this project have an execution dependency on this project.

Specified by:

childrenDependOnMe in interface Project

Returns:
this project.

dependsOnChildren
```
public Project dependsOnChildren()
```
Description copied from interface: Project

Declares that this project has an execution dependency on each of its child projects.

Specified by:

dependsOnChildren in interface Project

Returns:
this project.

dependsOnChildren
```
public Project dependsOnChildren(boolean evaluateDependsOnProject)
```
Description copied from interface: Project

Declares that this project has an execution dependency on each of its child projects.

Specified by:

dependsOnChildren in interface Project

Parameters:
evaluateDependsOnProject - If true, adds an evaluation dependency.

Returns:
this project.

toString
```
public String toString()
```
Overrides:

toString in class Object

getAllTasks
```
public Map<Project,Set<Task>> getAllTasks(boolean recursive)
```
Description copied from interface: Project

Returns a map of the tasks contained in this project, and optionally its subprojects.

Specified by:

getAllTasks in interface Project

Parameters:
recursive - If true, returns the tasks of this project and its subprojects. If false, returns the tasks of just this project.

Returns:
A map from project to a set of tasks.

getTasksByName
```
public Set<Task> getTasksByName(String name,
                       boolean recursive)
```
Description copied from interface: Project

Returns the set of tasks with the given name contained in this project, and optionally its subprojects.

Specified by:

getTasksByName in interface Project

Parameters:
name - The name of the task to locate.
recursive - If true, returns the tasks of this project and its subprojects. If false, returns the tasks of just this project.

Returns:
The set of tasks. Returns an empty set if no such tasks exist in this project.

file
```
public File file(Object path)
```
Description copied from interface: Project
Resolves a file path relative to the project directory of this project. This method converts the supplied path based on its type:
- A CharSequence / String. Interpreted relative to the project directory, as for Project.file(Object). A string that starts with file: is treated as a file URL.
- File. If the file is an absolute file, it is returned as is. Otherwise, the file's path is interpreted relative to the project directory.
- URI or URL. The URL's path is interpreted as the file path. Currently, only file: URLs are supported.
- Closure. The closure's return value is resolved recursively.
- Callable. The callable's return value is resolved recursively.
- An Object. Its toString() value is treated the same way as a String, as for Project.file(Object). This handling of custom Objects has been deprecated and will be removed in the next version of Gradle.
Specified by:

file in interface FileOperations

Specified by:

file in interface Project

Parameters:
path - The object to resolve as a File.

Returns:
The resolved file. Never returns null.

file
```
public File file(Object path,
        PathValidation validation)
```
Description copied from interface: Project

Resolves a file path relative to the project directory of this project and validates it using the given scheme. See PathValidation for the list of possible validations.

Specified by:

file in interface FileOperations

Specified by:

file in interface Project

Parameters:
path - An object which toString method value is interpreted as a relative path to the project directory.
validation - The validation to perform on the file.

Returns:
The resolved file. Never returns null.

uri
```
public URI uri(Object path)
```
Description copied from interface: Project

Resolves a file path to a URI, relative to the project directory of this project. Evaluates the provided path object as described for Project.file(Object), with the exception that any URI scheme is supported, not just 'file:' URIs.

Specified by:

uri in interface FileOperations

Specified by:

uri in interface Project

Parameters:
path - The object to resolve as a URI.

Returns:
The resolved URI. Never returns null.

files
```
public ConfigurableFileCollection files(Object... paths)
```
Description copied from interface: Project
Returns a ConfigurableFileCollection containing the given files. You can pass any of the following types to this method:
- A CharSequence / String. Interpreted relative to the project directory, as for Project.file(Object). A string that starts with file: is treated as a file URL.
- A File. Interpreted relative to the project directory, as for Project.file(Object).
- URI or URL. The URL's path is interpreted as a file path. Currently, only file: URLs are supported.
- A Collection, Iterable, or an array. May contain any of the types listed here. The elements of the collection are recursively converted to files.
- A FileCollection. The contents of the collection are included in the returned collection.
- A Callable. The call() method may return any of the types listed here. The return value of the call() method is recursively converted to files. A null return value is treated as an empty collection.
- A Closure. May return any of the types listed here. The return value of the closure is recursively converted to files. A null return value is treated as an empty collection.
- A Task. Converted to the task's output files.
- A TaskOutputs. Converted to the output files the related task.
- An Object. Its toString() value is treated the same way as a String, as for Project.file(Object). Handling custom Objects has been deprecated and will be removed in the next version of Gradle.
- A Closure. May return any of the types listed here. The return value of the closure is recursively converted to files. A null return value is treated as an empty collection.
The returned file collection is lazy, so that the paths are evaluated only when the contents of the file collection are queried. The file collection is also live, so that it evaluates the above each time the contents of the collection is queried.

The returned file collection maintains the iteration order of the supplied paths.
Specified by:

files in interface FileOperations

Specified by:

files in interface Project

Parameters:
paths - The paths to the files. May be empty.

Returns:
The file collection. Never returns null.

files
```
public ConfigurableFileCollection files(Object paths,
                               Closure closure)
```
Description copied from interface: Project
Creates a new ConfigurableFileCollection using the given paths. The paths are evaluated as for Project.files(Object...). The file collection is configured using the given closure. The file collection is passed to the closure as its delegate. Example:
```
 files "$buildDir/classes" {
     builtBy 'compile'
 }
 
```
The returned file collection is lazy, so that the paths are evaluated only when the contents of the file collection are queried. The file collection is also live, so that it evaluates the above each time the contents of the collection is queried.
Specified by:

files in interface FileOperations

Specified by:

files in interface Project

Parameters:
paths - The contents of the file collection. Evaluated as for Project.files(Object...).
closure - The closure to use to configure the file collection.

Returns:
the configured file tree. Never returns null.

fileTree
```
public ConfigurableFileTree fileTree(Object baseDir)
```
Description copied from interface: Project
Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as for Project.file(Object).

Note: to use a closure as the baseDir, you must explicitly cast the closure to Object to force the use of this method instead of Project.fileTree(Closure). Example:
```
 fileTree((Object){ someDir })
 
```
The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
Specified by:

fileTree in interface FileOperations

Specified by:

fileTree in interface Project

Parameters:
baseDir - The base directory of the file tree. Evaluated as for Project.file(Object).

Returns:
the file tree. Never returns null.

fileTree
```
public ConfigurableFileTree fileTree(Object baseDir,
                            Closure closure)
```
Description copied from interface: Project
Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as for Project.file(Object). The closure will be used to configure the new file tree. The file tree is passed to the closure as its delegate. Example:
```
 fileTree('src') {
    exclude '**/.svn/**'
 }.copy { into 'dest'}
 
```
The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
Specified by:

fileTree in interface FileOperations

Specified by:

fileTree in interface Project

Parameters:
baseDir - The base directory of the file tree. Evaluated as for Project.file(Object).
closure - Closure to configure the ConfigurableFileTree object.

Returns:
the configured file tree. Never returns null.

fileTree
```
public ConfigurableFileTree fileTree(Map<String,?> args)
```
Description copied from interface: Project
Creates a new ConfigurableFileTree using the provided map of arguments. The map will be applied as properties on the new file tree. Example:
```
 fileTree(dir:'src', excludes:['**/ignore/**','**/.svn/**'])
 
```
The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
Specified by:

fileTree in interface FileOperations

Specified by:

fileTree in interface Project

Parameters:
args - map of property assignments to ConfigurableFileTree object

Returns:
the configured file tree. Never returns null.

fileTree
```
public ConfigurableFileTree fileTree(Closure closure)
```
Description copied from interface: Project
Creates a new ConfigurableFileTree using the provided closure. The closure will be used to configure the new file tree. The file tree is passed to the closure as its delegate. Example:
```
 fileTree {
    from 'src'
    exclude '**/.svn/**'
 }.copy { into 'dest'}
 
```
The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
Specified by:

fileTree in interface FileOperations

Specified by:

fileTree in interface Project

Parameters:
closure - Closure to configure the ConfigurableFileTree object

Returns:
the configured file tree. Never returns null.

zipTree
```
public FileTree zipTree(Object zipPath)
```
Description copied from interface: Project

Creates a new FileTree which contains the contents of the given ZIP file. The given zipPath path is evaluated as for Project.file(Object). You can combine this method with the Project.copy(groovy.lang.Closure) method to unzip a ZIP file.

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

Specified by:

zipTree in interface FileOperations

Specified by:

zipTree in interface Project

Parameters:
zipPath - The ZIP file. Evaluated as for Project.file(Object).

Returns:
the file tree. Never returns null.

tarTree
```
public FileTree tarTree(Object tarPath)
```
Description copied from interface: Project
Creates a new FileTree which contains the contents of the given TAR file. The given tarPath path can be:
- an instance of Resource
- any other object is evaluated as for Project.file(Object)
The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
Unless custom implementation of resources is passed, the tar tree attempts to guess the compression based on the file extension.
You can combine this method with the Project.copy(groovy.lang.Closure) method to untar a TAR file:
```
 task untar(type: Copy) {
   from tarTree('someCompressedTar.gzip')

   //tar tree attempts to guess the compression based on the file extension
   //however if you must specify the compression explicitly you can:
   from tarTree(resources.gzip('someTar.ext'))

   //in case you work with unconventionally compressed tars
   //you can provide your own implementation of a ReadableResource:
   //from tarTree(yourOwnResource as ReadableResource)

   into 'dest'
 }
 
```
Specified by:

tarTree in interface FileOperations

Specified by:

tarTree in interface Project

Parameters:
tarPath - The TAR file or an instance of Resource.

Returns:
the file tree. Never returns null.

getResources
```
public ResourceHandler getResources()
```
Description copied from interface: Project

Provides access to resource-specific utility methods, for example factory methods that create various resources.

Specified by:

getResources in interface FileOperations

Specified by:

getResources in interface Project

Returns:
Returned instance contains various resource-specific utility methods.

relativePath
```
public String relativePath(Object path)
```
Description copied from interface: Project

Returns the relative path from the project directory to the given path. The given path object is (logically) resolved as described for Project.file(Object), from which a relative path is calculated.

Specified by:

relativePath in interface FileOperations

Specified by:

relativePath in interface Project

Parameters:
path - The path to convert to a relative path.

Returns:
The relative path. Never returns null.

mkdir
```
public File mkdir(Object path)
```
Description copied from interface: Project

Creates a directory and returns a file pointing to it.

Specified by:

mkdir in interface FileOperations

Specified by:

mkdir in interface Project

Parameters:
path - The path for the directory to be created. Evaluated as for Project.file(Object).

Returns:
the created directory

delete
```
public boolean delete(Object... paths)
```
Description copied from interface: Project

Deletes files and directories.

Specified by:

delete in interface FileOperations

Specified by:

delete in interface Project

Parameters:
paths - Any type of object accepted by Project.files(Object...)

Returns:
true if anything got deleted, false otherwise

dir

@Deprecated
public org.gradle.api.tasks.Directory dir(String path)

Deprecated. Use the mkdir(Object) instead.

setTaskContainer

public void setTaskContainer(TaskContainerInternal taskContainer)

getAntBuilderFactory

public Factory<AntBuilder> getAntBuilderFactory()

setAntBuilderFactory

public void setAntBuilderFactory(Factory<AntBuilder> antBuilderFactory)

getDependencies
```
public DependencyHandler getDependencies()
```
Description copied from interface: Project

Returns the dependency handler of this project. The returned dependency handler instance can be used for adding new dependencies. For accessing already declared dependencies, the configurations can be used.
Examples:
See docs for DependencyHandler

Specified by:

getDependencies in interface Project

Returns:
the dependency handler. Never returns null.
See Also:
Project.getConfigurations()

setDependencyHandler

public void setDependencyHandler(DependencyHandler dependencyHandler)

getProjectEvaluationBroadcaster
```
public ProjectEvaluationListener getProjectEvaluationBroadcaster()
```
Specified by:

getProjectEvaluationBroadcaster in interface ProjectInternal

beforeEvaluate
```
public void beforeEvaluate(Action<? super Project> action)
```
Description copied from interface: Project

Adds an action to execute immediately before this project is evaluated.

Specified by:

beforeEvaluate in interface Project

Parameters:
action - the action to execute.

afterEvaluate
```
public void afterEvaluate(Action<? super Project> action)
```
Description copied from interface: Project

Adds an action to execute immediately after this project is evaluated.

Specified by:

afterEvaluate in interface Project

Parameters:
action - the action to execute.

beforeEvaluate
```
public void beforeEvaluate(Closure closure)
```
Description copied from interface: Project

Adds a closure to be called immediately before this project is evaluated. The project is passed to the closure as a parameter.

Specified by:

beforeEvaluate in interface Project

Parameters:
closure - The closure to call.

afterEvaluate
```
public void afterEvaluate(Closure closure)
```
Description copied from interface: Project

Adds a closure to be called immediately after this project has been evaluated. The project is passed to the closure as a parameter. Such a listener gets notified when the build file belonging to this project has been executed. A parent project may for example add such a listener to its child project. Such a listener can further configure those child projects based on the state of the child projects after their build files have been run.

Specified by:

afterEvaluate in interface Project

Parameters:
closure - The closure to call.

getLogger
```
public Logger getLogger()
```
Description copied from interface: Project

Returns the logger for this project. You can use this in your build file to write log messages.

Specified by:

getLogger in interface Project

Returns:
The logger. Never returns null.

getStandardOutputCapture
```
public StandardOutputCapture getStandardOutputCapture()
```
Specified by:

getStandardOutputCapture in interface ProjectInternal

getLogging
```
public LoggingManager getLogging()
```
Description copied from interface: Project

Returns the LoggingManager which can be used to control the logging level and standard output/error capture for this project's build script. By default, System.out is redirected to the Gradle logging system at the QUIET log level, and System.err is redirected at the ERROR log level.

Specified by:

getLogging in interface Project

Returns:
the LoggingManager. Never returns null.

property
```
public Object property(String propertyName)
                throws MissingPropertyException
```
Description copied from interface: Project
Returns the value of the given property. This method locates a property as follows:
1. If this project object has a property with the given name, return the value of the property.
2. If this project's convention object has a property with the given name, return the value of the property.
3. If this project has an additional property with the given name, return the value of the property.
4. If this project has a task with the given name, return the task.
5. Search up through this project's ancestor projects for a convention property or additional property with the given name.
6. If not found, throw MissingPropertyException
Specified by:

property in interface Project

Parameters:
propertyName - The name of the property.

Returns:
The value of the property, possibly null.

Throws:

MissingPropertyException - When the given property is unknown.

setProperty
```
public void setProperty(String name,
               Object value)
```
Description copied from interface: Project
Sets a property of this project. This method searches for a property with the given name in the following locations, and sets the property on the first location where it finds the property.
1. The project object itself. For example, the rootDir project property.
2. The project's Convention object. For example, the srcRootName java plugin property.
3. The project's additional properties.
If the property is not found in any of these locations, it is added to the project's additional properties.
Specified by:

setProperty in interface Project

Parameters:
name - The name of the property
value - The value of the property

hasProperty
```
public boolean hasProperty(String propertyName)
```
Description copied from interface: Project

Determines if this project has the given property. See here for details of the properties which are available for a project.

Specified by:

hasProperty in interface Project

Parameters:
propertyName - The name of the property to locate.

Returns:
True if this project has the given property, false otherwise.

getProperties
```
public Map<String,?> getProperties()
```
Description copied from interface: Project

Returns the properties of this project. See here for details of the properties which are available for a project.

Specified by:

getProperties in interface Project

Returns:
A map from property name to value.

copy
```
public WorkResult copy(Closure closure)
```
Description copied from interface: Project
Copies the specified files. The given closure is used to configure a CopySpec, which is then used to copy the files. Example:
```
 copy {
    from configurations.runtime
    into 'build/deploy/lib'
 }
 
```
Note that CopySpecs can be nested:
```
 copy {
    into 'build/webroot'
    exclude '**/.svn/**'
    from('src/main/webapp') {
       include '**/*.jsp'
       filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])
    }
    from('src/main/js') {
       include '**/*.js'
    }
 }
 
```
Specified by:

copy in interface FileOperations

Specified by:

copy in interface Project

Parameters:
closure - Closure to configure the CopySpec

Returns:
WorkResult that can be used to check if the copy did any work.

copySpec
```
public CopySpec copySpec(Closure closure)
```
Description copied from interface: Project

Creates a CopySpec which can later be used to copy files or create an archive. The given closure is used to configure the CopySpec before it is returned by this method.

Specified by:

copySpec in interface FileOperations

Specified by:

copySpec in interface Project

Parameters:
closure - Closure to configure the CopySpec

Returns:
The CopySpec

javaexec
```
public ExecResult javaexec(Closure closure)
```
Description copied from interface: Project

Executes a Java main class. The closure configures a JavaExecSpec.

Specified by:

javaexec in interface ProcessOperations

Specified by:

javaexec in interface Project

Parameters:
closure - The closure for configuring the execution.

Returns:
the result of the execution

exec
```
public ExecResult exec(Closure closure)
```
Description copied from interface: Project

Executes an external command. The closure configures a ExecSpec.

Specified by:

exec in interface ProcessOperations

Specified by:

exec in interface Project

Parameters:
closure - The closure for configuring the execution.

Returns:
the result of the execution

getServices
```
public ServiceRegistryFactory getServices()
```
Specified by:

getServices in interface ProjectInternal

getModule
```
public Module getModule()
```
Specified by:

getModule in interface DependencyMetaDataProvider

apply
```
public void apply(Closure closure)
```
Description copied from interface: Project

Configures this project using plugins or scripts. The given closure is used to configure an ObjectConfigurationAction which is then used to configure this project.

Specified by:

apply in interface Project

Parameters:
closure - The closure to configure the ObjectConfigurationAction.

apply
```
public void apply(Map<String,?> options)
```
Description copied from interface: Project
Configures this project using plugins or scripts. The following options are available:
- from: A script to apply to the project. Accepts any path supported by Project.uri(Object).
- plugin: The id or implementation class of the plugin to apply to the project.
- to: The target delegate object or objects. Use this to configure objects other than the project.
For more detail, see ObjectConfigurationAction.
Specified by:

apply in interface Project

Parameters:
options - The options to use to configure the ObjectConfigurationAction.

ant
```
public AntBuilder ant(Closure configureClosure)
```
Description copied from interface: Project

Executes the given closure against the AntBuilder for this project. You can use this in your build file to execute ant tasks. The AntBuild is passed to the closure as the closure's delegate. See example in javadoc for Project.getAnt()

Specified by:

ant in interface Project

Parameters:
configureClosure - The closure to execute against the AntBuilder.

Returns:
The AntBuilder. Never returns null.

subprojects
```
public void subprojects(Closure configureClosure)
```
Description copied from interface: Project

Configures the sub-projects of this project.

This method executes the given closure against each of the sub-projects of this project. The target Project is passed to the closure as the closure's delegate.

Specified by:

subprojects in interface Project

Parameters:
configureClosure - The closure to execute.

allprojects
```
public void allprojects(Closure configureClosure)
```
Description copied from interface: Project

Configures this project and each of its sub-projects.

This method executes the given closure against this project and its sub-projects. The target Project is passed to the closure as the closure's delegate.

Specified by:

allprojects in interface Project

Parameters:
configureClosure - The closure to execute.

project
```
public Project project(String path,
              Closure configureClosure)
```
Description copied from interface: Project

Locates a project by path and configures it using the given closure. If the path is relative, it is interpreted relative to this project. The target project is passed to the closure as the closure's delegate.

Specified by:

project in interface Project

Parameters:
path - The path.
configureClosure - The closure to use to configure the project.

Returns:
The project with the given path. Never returns null.

configure
```
public Object configure(Object object,
               Closure configureClosure)
```
Description copied from interface: Project
Configures an object via a closure, with the closure's delegate set to the supplied object. This way you don't have to specify the context of a configuration statement multiple times.
Instead of:
```
 MyType myType = new MyType()
 myType.doThis()
 myType.doThat()
 
```
you can do:
```
 MyType myType = configure(new MyType()) {
     doThis()
     doThat()
 }
 
```
The object being configured is also passed to the closure as a parameter, so you can access it explicitly if required:
```
 configure(someObj) { obj -> obj.doThis() }
 
```
Specified by:

configure in interface Project

Parameters:
object - The object to configure
configureClosure - The closure with configure statements

Returns:
The configured object

configure
```
public Iterable<?> configure(Iterable<?> objects,
                    Closure configureClosure)
```
Description copied from interface: Project

Configures a collection of objects via a closure. This is equivalent to calling Project.configure(Object, groovy.lang.Closure) for each of the given objects.

Specified by:

configure in interface Project

Parameters:
objects - The objects to configure
configureClosure - The closure with configure statements

Returns:
The configured objects.

configurations
```
public void configurations(Closure configureClosure)
```
Description copied from interface: Project

Configures the dependency configurations for this project.
This method executes the given closure against the ConfigurationContainer for this project. The ConfigurationContainer is passed to the closure as the closure's delegate.
Examples:
See docs for ConfigurationContainer

Specified by:

configurations in interface Project

Parameters:
configureClosure - the closure to use to configure the dependency configurations.

repositories
```
public void repositories(Closure configureClosure)
```
Description copied from interface: Project

Configures the repositories for this project.
This method executes the given closure against the RepositoryHandler for this project. The RepositoryHandler is passed to the closure as the closure's delegate.

Specified by:

repositories in interface Project

Parameters:
configureClosure - the closure to use to configure the repositories.

dependencies
```
public void dependencies(Closure configureClosure)
```
Description copied from interface: Project

Configures the dependencies for this project.
This method executes the given closure against the DependencyHandler for this project. The DependencyHandler is passed to the closure as the closure's delegate.
Examples:
See docs for DependencyHandler

Specified by:

dependencies in interface Project

Parameters:
configureClosure - the closure to use to configure the dependencies.

artifacts

public void artifacts(Closure configureClosure)

Description copied from interface: Project

Configures the published artifacts for this project.

This method executes the given closure against the ArtifactHandler for this project. The ArtifactHandler is passed to the closure as the closure's delegate.

Example:

 configurations {
   //declaring new configuration that will be used to associate with artifacts
   schema
 }

 task schemaJar(type: Jar) {
   //some imaginary task that creates a jar artifact with the schema
 }

 //associating the task that produces the artifact with the configuration
 artifacts {
   //configuration name and the task:
   schema schemaJar
 }

Specified by:: artifacts in interface Project
Parameters:: configureClosure - the closure to use to configure the published artifacts.

buildscript
```
public void buildscript(Closure configureClosure)
```
Description copied from interface: Project

Configures the build script classpath for this project.
The given closure is executed against this project's ScriptHandler. The ScriptHandler is passed to the closure as the closure's delegate.

Specified by:

buildscript in interface Project

Parameters:
configureClosure - the closure to use to configure the build script classpath.

task
```
public Task task(String task)
```
Description copied from interface: Project

Creates a Task with the given name and adds it to this project. Calling this method is equivalent to calling Project.task(java.util.Map, String) with an empty options map.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project, an exception is thrown.

Specified by:

task in interface Project

Parameters:
task - The name of the task to be created

Returns:
The newly created task object

task
```
public Task task(Object task)
```

task
```
public Task task(String task,
        Closure configureClosure)
```
Description copied from interface: Project

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

Specified by:

task in interface Project

Parameters:
task - The name of the task to be created
configureClosure - The closure to use to configure the created task.

Returns:
The newly created task object

task

public Task task(Object task,
        Closure configureClosure)

task

public Task task(Map options,
        String task)

Description copied from interface: Project

Creates a Task with the given name and adds it to this project. A map of creation options can be passed to this method to control how the task is created. The following options are available:

Option	Description	Default Value
`"type"`	The class of the task to create.	`DefaultTask`
`"overwrite"`	Replace an existing task?	`false`
`"dependsOn"`	A task name or set of task names which this task depends on	`[]`
`"action"`	A closure or `Action` to add to the task.	`null`
`"description"`	A description of the task.	`null`
`"group"`	A task group which this task belongs to.	`null`

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project and the override option is not set to true, an exception is thrown.

Specified by:: task in interface Project
Parameters:: options - The task creation options.; task - The name of the task to be created
Returns:: The newly created task object

task

public Task task(Map options,
        Object task)

task
```
public Task task(Map options,
        String task,
        Closure configureClosure)
```
Description copied from interface: Project

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task. A map of creation options can be passed to this method to control how the task is created. See Project.task(java.util.Map, String) for the available options.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project and the override option is not set to true, an exception is thrown.

Specified by:

task in interface Project

Parameters:
options - The task creation options.
task - The name of the task to be created
configureClosure - The closure to use to configure the created task.

Returns:
The newly created task object

task

public Task task(Map options,
        Object task,
        Closure configureClosure)

passThrough
```
public Object passThrough(Object object)
```
This is called by the task creation DSL. Need to find a cleaner way to do this...

container
```
public <T> NamedDomainObjectContainer<T> container(Class<T> type)
```
Description copied from interface: Project

Creates a container for managing named objects of the specified type. The specified type must have a public constructor which takes the name as a String parameter.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

Specified by:

container in interface Project

Type Parameters:
T - The type of objects for the container to contain.
Parameters:
type - The type of objects for the container to contain.

Returns:
The container.

container
```
public <T> NamedDomainObjectContainer<T> container(Class<T> type,
                                          NamedDomainObjectFactory<T> factory)
```
Description copied from interface: Project

Creates a container for managing named objects of the specified type. The given factory is used to create object instances.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

Specified by:

container in interface Project

Type Parameters:
T - The type of objects for the container to contain.
Parameters:
type - The type of objects for the container to contain.
factory - The factory to use to create object instances.

Returns:
The container.

container
```
public <T> NamedDomainObjectContainer<T> container(Class<T> type,
                                          Closure factoryClosure)
```
Description copied from interface: Project

Creates a container for managing named objects of the specified type. The given closure is used to create object instances. The name of the instance to be created is passed as a parameter to the closure.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

Specified by:

container in interface Project

Type Parameters:
T - The type of objects for the container to contain.
Parameters:
type - The type of objects for the container to contain.
factoryClosure - The closure to use to create object instances.

Returns:
The container.

getExtensions
```
public ExtensionContainer getExtensions()
```
Description copied from interface: Project

Allows adding DSL extensions to the project. Useful for plugin authors.

Specified by:

getExtensions in interface ExtensionAware

Specified by:

getExtensions in interface Project

Returns:
Returned instance allows adding DSL extensions to the project

Class AbstractProject

Field Summary

Fields inherited from interface org.gradle.api.Project

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AbstractProject

Method Detail

getRootProject

getGradle

getPlugins

getProjectEvaluator

setProjectEvaluator

getBuildscript

beforeCompile

afterCompile

getBuildFile

setScript

getBuildScriptSource

getRootDir

getParent

getParentIdentifier

getAsDynamicObject

getInheritedScope

getName

getDescription

setDescription

getGroup

setGroup

getVersion

setVersion

getStatus

setStatus

getChildProjects

getDefaultTasks

setDefaultTasks

getDependsOnProjects

getState

getFileResolver

setFileResolver

setAnt

getArtifacts

Examples:

setArtifactHandler

getRepositories

getConfigurations

Examples:

setConfigurationContainer

getConvention

getPath

getDepth

getProjectRegistry

depthCompare

compareTo

absoluteProjectPath

relativeProjectPath

project

findProject

getAllprojects

getSubprojects

subprojects

allprojects

configure

getAnt

createAntBuilder

getProject

evaluate

getTasks

getImplicitTasks

defaultTasks

createTask

createTask

addChildProject

getProjectDir

getBuildDir

setBuildDir

dependsOn

dependsOn

evaluationDependsOnChildren