====
include::sample[dir="snippets/files/fileCollections/kotlin",files="build.gradle.kts[tags=closure]"]
include::sample[dir="snippets/files/fileCollections/groovy",files="build.gradle[tags=closure]"]
====

----
$ gradle -q list
include::{snippetsPath}/files/fileCollections/tests/fileCollectionsWithClosure.out[]
----

    }

    @Override
    @Deprecated
    public FileCollection fileCollection(Closure dependencySpecClosure) {
        return fileCollectionInternal("fileCollection(Closure)", Specs.convertClosureToSpec(dependencySpecClosure));
    }

    @Override
    @Deprecated
    public FileCollection fileCollection(Dependency... dependencies) {
        Set<Dependency> deps = WrapUtil.toLinkedSet(dependencies);

        def fileSet = [new File("somePath")] as Set
        resolver.resolveGraph(configuration) >> graphResolved(fileSet)

        when:
        def fileCollection = configuration.fileCollection(dependency1)

        then:
        fileCollection.files == fileSet
        configuration.state == RESOLVED
    }

    def fileCollectionWithSpec() {
        def configuration = conf()

                    String getTransformName()
                    void setTransformName(String name)
                }

                @InputArtifactDependencies
                abstract FileCollection getInputArtifactDependencies()

                @InputArtifact
                abstract Provider<FileSystemLocation> getInputArtifact()

                void transform(TransformOutputs outputs) {

        private String prop;
        private FileCollection files;
        private List<Object> things;

        public String getProp() {
            return prop;
        }

        public void setProp(String prop) {
            this.prop = prop;
        }

        public FileCollection getFiles() {
            return files;
        }

Currently, the following methods should only be called with these listed allowed usages:

- `resolve()` - RESOLVABLE configurations only
- `files(Closure)`, `files(Spec)`, `files(Dependency…)`, `fileCollection(Spec)`, `fileCollection(Closure)`, `fileCollection(Dependency…)` - RESOLVABLE configurations only
- `getResolvedConfigurations()` - RESOLVABLE configurations only
- `defaultDependencies(Action)` - DECLARABLE configurations only

* Filesystem types
+

| `project.files(paths)`
| link:{javadocPath}/org/gradle/api/model/ObjectFactory.html#fileCollection--[ObjectFactory.fileCollection()].link:{javadocPath}/org/gradle/api/file/ConfigurableFileCollection.html#from-java.lang.Object...-[from(paths)]

| `project.fileTree(paths)`

        collection.replace { null }

        then:
        collection.isEmpty()
    }

    def "replace transformation runs eagerly"() {
        given:
        Transformer<FileCollection, FileCollection> transform = Mock()
        collection.from(containing(new File("a.txt")))

        when:
        collection.replace(transform)

        then:
        1 * transform.transform(_)
    }

to reset the property back to its default value. Use `DuplicatesStrategy.INHERIT` instead.
 * The `FileCollection.stopExecutionIfEmpty()` method has been removed — use the link:{javadocPath}/org/gradle/api/tasks/SkipWhenEmpty.html[@SkipWhenEmpty] annotation on `FileCollection` task properties instead.