mirror of
https://github.com/apple/pkl.git
synced 2026-03-24 10:01:10 +01:00
01bf844a96
Motivation: Spring Boot configuration classes neither require nor benefit from annotating constructor parameters with their name. The same is true for pkl-config-java configuration classes compiled with `-parameter`. Changes: - Change CLI parameter `--params-annotation` to accept a `none` value. This is recommended in https://clig.dev/#arguments-and-flags and is how the `-F` parameter of the `ssh` command works. - Change `paramsAnnotation` property in Gradle plugin, CliJavaCodeGeneratorOptions, and JavaCodegenOptions as follows: - Change meaning of `null` from "generate org.pkl.java.config.mapper.Named annotations" to "do not generate annotations". This is a breaking change (only) affecting users who explicitly set the property to `null` instead of omitting it. - Change property default from `null` to: `null` if `generateSpringBootConfig` is `true` and `org.pkl.java.config.mapper.Named` otherwise - add tests - update docs of this and other codegen options Result: Generated code does not contain unnecessary annotations.
97 lines
3.7 KiB
Plaintext
97 lines
3.7 KiB
Plaintext
.indent: Property<String>
|
|
[%collapsible]
|
|
====
|
|
Default: `" "` (two spaces) +
|
|
Example: `indent = "\t"` (one tab) +
|
|
The characters to use for indenting generated source code.
|
|
====
|
|
|
|
.outputDir: DirectoryProperty
|
|
[%collapsible]
|
|
====
|
|
Default: `layout.buildDirectory.dir("generated/pkl/<generator_name>")` +
|
|
Example: `outputDir = layout.projectDirectory.dir("src/main/pkl")` +
|
|
The directory where generated classes are placed.
|
|
|
|
The default places generated sources within the build directory of the project, to avoid sources from being committed into the repository on accident.
|
|
====
|
|
|
|
.sourceSet: Property<SourceSet>
|
|
[%collapsible]
|
|
====
|
|
Default: `sourceSets.main` (if it exists; no default otherwise) +
|
|
Example: `sourceSet = sourceSets.test` +
|
|
The Gradle source set that generated code is compiled together with.
|
|
|
|
For the codegen tasks, the `modulePath` property defaults to the compilation classpath of this source set, as well as all of the source directories of the `resource` source directory set of this source set. This setup makes it possible to rely on modules defined in classpath dependencies of your project or in the resources of your project.
|
|
|
|
For projects which apply the `idea` plugin and are opened in IntelliJ IDEA, this option determines whether generated sources are marked as test sources (if the source set's name contains the word "test") or regular sources (otherwise).
|
|
====
|
|
|
|
.generateSpringBootConfig: Property<Boolean>
|
|
[%collapsible]
|
|
====
|
|
Default: `false` +
|
|
Example: `generateSpringBootConfig = true` +
|
|
Whether to generate config classes for use with Spring Boot.
|
|
====
|
|
|
|
.implementSerializable: Property<Boolean>
|
|
[%collapsible]
|
|
====
|
|
Default: `false` +
|
|
Example: `implementSerializable = true` +
|
|
Whether to generate classes that implement `java.io.Serializable`.
|
|
====
|
|
|
|
.renames: MapProperty<String, String>
|
|
[%collapsible]
|
|
====
|
|
Default: `[:]` +
|
|
Example: `renames = ["foo.": "com.example.foo.", "bar.Config": "com.example.bar.Config"]` +
|
|
Allows to change default class and package names (derived from Pkl module names) in the generated code.
|
|
|
|
When you need the generated class or package names to be different from the default names derived from the Pkl module names, you can define a rename mapping, where the key is the original Pkl module name prefix, and the value is its replacement.
|
|
When you do, the generated code's `package` declarations, class names, as well as file locations, will be modified according to this mapping.
|
|
|
|
The prefixes are replaced literally, which means that dots at the end are important.
|
|
If you want to rename packages only, in most cases, you must ensure that you have an ending dot on both sides of a mapping (except for an empty mapping, if you use it), otherwise you may get unexpected results:
|
|
|
|
----
|
|
// Assuming the following mapping configuration:
|
|
renames = [
|
|
"com.foo.": "x", // Dot on the left only
|
|
"org.bar": "y.", // Dot on the right only
|
|
"net.baz": "z" // No dots
|
|
]
|
|
|
|
// The following renames will be made:
|
|
"com.foo.bar" -> "xbar" // Target prefix merged into the suffix
|
|
"org.bar.baz" -> "y..baz" // Double dot, invalid name
|
|
"net.baz.qux" -> "z.qux" // Looks okay, but...
|
|
"net.bazqux" -> "zqux" // ...may cut the name in the middle.
|
|
----
|
|
|
|
When computing the appropriate target name, the longest matching prefix is used:
|
|
|
|
----
|
|
// Assuming the following mapping configuration:
|
|
renames = [
|
|
"com.foo.Main": "w.Main",
|
|
"com.foo.": "x.",
|
|
"com.": "y.",
|
|
"": "z."
|
|
]
|
|
|
|
// The following renames will be made:
|
|
com.foo.Main -> w.Main
|
|
com.foo.bar -> x.bar
|
|
com.baz.qux -> y.baz.qux
|
|
org.foo.bar -> z.org.foo.bar
|
|
----
|
|
|
|
Keys in this mapping can be arbitrary strings, including an empty string.
|
|
Values must be valid dot-separated fully qualifed class name prefixes, possibly terminated by a dot.
|
|
====
|
|
|