# InAndOutDirectoryOperationRequest

# InAndOutDirectoryOperationRequest


```
public interface InAndOutDirectoryOperationRequest<TaskT extends Task>
```

<br />

*** ** * ** ***

## Summary

|                                                                                                                                                                                             ### Public methods                                                                                                                                                                                              |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                             | `<ArtifactTypeT extends `[Artifact.Single](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Single)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html)`> & `[Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable)`> `[toTransform](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/InAndOutDirectoryOperationRequest#toTransform(com.android.build.api.artifact.Artifact.Single))`(` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ArtifactTypeT type` `)` Initiates a transform request to a single [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable) artifact type.                                               |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ArtifactTransformationRequest](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/ArtifactTransformationRequest)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` TaskT>` | `<ArtifactTypeT extends `[Artifact.Single](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Single)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html)`> & `[Artifact.ContainsMany](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.ContainsMany)`> `[toTransformMany](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/InAndOutDirectoryOperationRequest#toTransformMany(com.android.build.api.artifact.Artifact.Single))`(` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ArtifactTypeT type` `)` Initiates a transform request to a single [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable) artifact type that can contain more than one artifact. |

## Public methods

### toTransform

```
abstract void <ArtifactTypeT extends Artifact.Single<@NonNull Directory> & Artifact.Transformable> toTransform(
    @NonNull ArtifactTypeT type
)
```

Initiates a transform request to a single [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable) artifact type.  

|                                                            Parameters                                                            |
|----------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ArtifactTypeT type` | The [Artifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact) identifying the artifact to transform. The [Artifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact)'s [Artifact.kind](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact#kind()) must be [Artifact.DIRECTORY](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact#DIRECTORY()) The artifact type must be [Artifact.Single](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Single) and [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable). Let's take a [Task](https://docs.gradle.org/current/javadoc/org/gradle/api/Task.html) transforming an input [org.gradle.api.file.Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html) into an output: ```scalate-server-page abstract class MyTask: DefaultTask() { @get:InputFiles abstract val inputDir: DirectoryProperty @get:OutputDirectory abstract val outputDir: DirectoryProperty @TaskAction fun taskAction() { ... read inputFile and write outputFile ... } } ``` An ArtifactType defined as follows : ```scalate-server-page sealed class ArtifactType<T: FileSystemLocation>(val kind: ArtifactKind) { object SINGLE_DIR_ARTIFACT: ArtifactType<Directory>(DIRECTORY), Single, Transformable } ``` You can register a transform to the collection of [org.gradle.api.file.RegularFile](https://docs.gradle.org/current/javadoc/org/gradle/api/file/RegularFile.html). ```verilog val taskProvider= projects.tasks.register(MyTask::class.java, "transformTask") artifacts.use(taskProvider) .wiredWithDirectories( MyTask::inputFile, MyTask::outputFile) .toTransform(ArtifactType.SINGLE_DIR_ARTIFACT) ``` |

### toTransformMany

```
abstract @NonNull ArtifactTransformationRequest<@NonNull TaskT> <ArtifactTypeT extends Artifact.Single<@NonNull Directory> & Artifact.ContainsMany> toTransformMany(
    @NonNull ArtifactTypeT type
)
```

Initiates a transform request to a single [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable) artifact type that can contain more than one artifact.  

|                                                            Parameters                                                            |
|----------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ArtifactTypeT type` | The [Artifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact) of the [Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html) identifying the artifact to transform. |

|                                                                                                                                                                                              Returns                                                                                                                                                                                               |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ArtifactTransformationRequest](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/ArtifactTransformationRequest)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` TaskT>` | [ArtifactTransformationRequest](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/ArtifactTransformationRequest) that will allow processing of individual artifacts located in the input directory. The artifact type must be [Artifact.Single](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Single), [Artifact.Transformable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.Transformable), and [Artifact.ContainsMany](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/Artifact.ContainsMany). For example, let's take a [Task](https://docs.gradle.org/current/javadoc/org/gradle/api/Task.html) to transform a list of [org.gradle.api.file.RegularFile](https://docs.gradle.org/current/javadoc/org/gradle/api/file/RegularFile.html) as inputs into a single output: ```scalate-server-page abstract class MyTask: DefaultTask() { @get:InputFiles abstract val inputFolder: DirectoryProperty @get:OutputFile abstract val outputFolder: DirectoryProperty @Internal abstract Property<ArtifactTransformationRequest<MyTask>> getTransformationRequest() @TaskAction fun taskAction() { transformationRequest.get().submit( ... submit a work item for each input file ... ) } } ``` You then register the task as follows: ```verilog val taskProvider= projects.tasks.register(MyTask::class.java, "combineTask") val transformationRequest = artifacts.use(taskProvider) .wiredWith( MyTask::inputFolder, MyTask::outputFolder) .toTransformMany(ArtifactType.APK) taskProvider.configure { task -> task.getTransformationRequest().set(transformationRequest) } ``` |