# Annotation Type SkipWhenEmpty

@Documented @Retention(RUNTIME) @Target({METHOD,FIELD}) public @interface SkipWhenEmpty

Attached to a task property to indicate that the task should be skipped when the value of the property is an empty `FileCollection` or directory.

If all of the inputs declared with this annotation are empty, the task will be skipped with a "NO-SOURCE" message.

Consider using `IgnoreEmptyDirectories` as well, if the task only works on files and not on directories.

This annotation implies `Incremental`, and thus inputs annotated with this annotation can also be queried for changes.

This annotation should be attached to the getter method in Java or the property in Groovy. Annotations on setters or just the field in Java are ignored.

This annotation can be used with the following annotations:

- `InputFiles`
- `InputDirectory`

Since:
  0.8