blob: 7bacafb9b2970069334ef1a08c0565b2e4ce551a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
package buildsrc.settings
import buildsrc.utils.adding
import buildsrc.utils.domainObjectContainer
import buildsrc.utils.toAlphaNumericCamelCase
import javax.inject.Inject
import org.gradle.api.Named
import org.gradle.api.NamedDomainObjectContainer
import org.gradle.api.file.ConfigurableFileCollection
import org.gradle.api.file.CopySpec
import org.gradle.api.file.DirectoryProperty
import org.gradle.api.model.ObjectFactory
import org.gradle.api.plugins.ExtensionAware
import org.gradle.api.provider.Property
import org.gradle.api.provider.SetProperty
import org.gradle.api.tasks.Input
import org.gradle.api.tasks.InputFiles
import org.gradle.api.tasks.Internal
import org.gradle.api.tasks.Optional
import org.gradle.kotlin.dsl.*
private typealias TemplateProjectsContainer = NamedDomainObjectContainer<DokkaTemplateProjectSettings.DokkaTemplateProjectSpec>
abstract class DokkaTemplateProjectSettings @Inject constructor(
private val objects: ObjectFactory,
private val copySpecs: () -> CopySpec
) : ExtensionAware {
/** Directory that will contain the projects downloaded from the Dokka source code. */
abstract val dokkaSourceDir: DirectoryProperty
abstract val destinationBaseDir: DirectoryProperty
internal val templateProjects: TemplateProjectsContainer =
// create an extension so Gradle will generate DSL accessors
extensions.adding("templateProjects", objects.domainObjectContainer { name ->
objects.newInstance<DokkaTemplateProjectSpec>(name, copySpecs())
})
/**
* Copy a directory from the Dokka source project into a local directory.
*
* @param[source] Source dir, relative to [templateProjectsDir]
* @param[destination] Destination dir, relative to [destinationBaseDir]
*/
fun register(
source: String,
destination: String,
configure: DokkaTemplateProjectSpec.() -> Unit = {},
) {
val name = source.toAlphaNumericCamelCase()
templateProjects.register(name) {
this.sourcePath.set(source)
this.destinationPath.set(destination)
configure()
}
}
fun configureEach(configure: DokkaTemplateProjectSpec.() -> Unit) {
templateProjects.configureEach(configure)
}
/**
* Details for how to copy a Dokka template project from the Dokka project to a local directory.
*/
abstract class DokkaTemplateProjectSpec @Inject constructor(
private val named: String,
@get:Internal
internal val copySpec: CopySpec,
) : Named {
@get:Input
abstract val sourcePath: Property<String>
@get:Input
@get:Optional
abstract val destinationPath: Property<String>
@get:Input
abstract val additionalPaths: SetProperty<String>
@get:InputFiles
abstract val additionalFiles: ConfigurableFileCollection
fun configureCopy(configure: CopySpec.() -> Unit) {
copySpec.configure()
}
@Input
override fun getName(): String = named
}
companion object {
const val EXTENSION_NAME = "dokkaTemplateProjects"
}
}
|
