ClassTokenReplacer

Gradle plugin to replace string tokens in class files during compile time.

ClassTokenReplacer allows you to replace string placeholders in your code with actual values during the building process. This can be used to replace tokens like ${version} with the actual version of the project.

Releases

Gradle

To use ClassTokenReplacer in your Gradle project you can follow the instructions on the Gradle Plugin Portal.

Usage

The plugin extends all source sets with a new extension called classTokenReplacer. This allows you to specify replacements for your source sets:

sourceSets {
    main {
        classTokenReplacer {
            property("\${version}", project.version)
        }
    }
}

That's it! Now all compiled class files in the main source set will be scanned for the token ${version} and have it replaced with the value specified in the property method. Be careful to choose placeholders in a way where don't accidentally match some other strings in your code.

Additional Options

You can also specify the following options in the classTokenReplacer block:

• replaceInPlace (boolean, default: false): If set to true, the original class files will be replaced with the modified ones. This is useful if your build setup uses the class files directly. This option requires a project rebuild if the contents of a token changes.

Contact

If you encounter any issues, please report them on the issue tracker.
If you just want to talk or need help implementing ClassTokenReplacer feel free to join my Discord.