Add convinence method which allows resolving plugin projection directories from SmithyBuild task instances

[brandondahler]

Background

Currently, the standardized method to resolve a given projection + plugin's path is via the SmithyExtension method getPluginProjectionPath. This method will return a Provider<Path> based on the outputDirectory property defined in the extension.

This pull request adds a similar convenience method on the SmithBuildTask implementation itself. The referenced location is functionally the same in most normal setups. In Gradle, utilizing a provider that is based off of the task implementation's DirectoryProperty instead of the extension's DirectoryProperty, even if the task's instance is bound to the extension's instance, will express the implicit dependency between task definitions.

That is, running ./gradlew copyOutput on this task implementation will not execute the smithyBuild task:

tasks.register<Sync>("copyOutput") {
    into(layout.buildDirectory.dir("model"))
    from(smithy.getPluginProjectionPath("source", "model"))
}

Correct behavior requires an explicit dependency:

tasks.register<Sync>("copyOutput") {
    dependsOn(smithyBuild)

    into(layout.buildDirectory.dir("model"))
    from(smithy.getPluginProjectionPath("source", "model"))
}

With this update, this will work as expected and express the dependency upon smithyBuild correctly:

tasks.register<Sync>("copyOutput") {
    into(layout.buildDirectory.dir("model"))
    from(smithyBuild.map { it.getPluginProjectionDirectory("source", "model") })
}

In the implementaiton, I chose to express it as a Provider<Directory> instead of Provider<Path> because utilizing the Gradle-provided Directory and similar api definitions aid in further idiomatic resolution of child directories and files over the Path class.

Testing

• Implemented integration test built on the smithy-build-task example that shows usage and verifies behavior

Links

N/A

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[hpmellema]

Great idea for simplifying usage. Thank you for the contribution!