Functional companion to Kotlin's Compiler & IDE
Arrow Meta is a meta-programming library that cooperates with the Kotlin compiler in all it's phases bringing its full power to the community. Writing compiler plugins, source transformations, IDEA plugins, linters, type search engines, automatic code refactoring,... are just a few of the use cases of the things that can be accomplished with Meta.
The following example shows a Hello World Compiler Plugin.
The Hello World plugin auto implements the helloWorld
function by rewriting the Kotlin AST before the compiler proceeds.
val Meta.helloWorld: Plugin
get() =
"Hello World" {
meta(
func({ name == "helloWorld" }) { c ->
Transform.replace(
replacing = c,
newDeclaration =
"""|fun helloWorld(): Unit =
| println("Hello ΛRROW Meta!")
|""".function.synthetic
)
}
)
}
For any user code whose function name is helloWorld
our compiler plugin will replace the matching function for a
function that returns Unit and prints our message.
-fun helloWorld(): Unit = TODO()
+fun helloWorld(): Unit =
+ println("Hello ΛRROW Meta!")
Build and run tests
./gradlew buildMeta -Dorg.gradle.debug=true -Dkotlin.compiler.execution.strategy="in-process"
Build and run test + IDE plugin
./gradlew publishAndRunIde -Dorg.gradle.debug=true -Dkotlin.compiler.execution.strategy="in-process"
Arrow Meta is an inclusive community powered by awesome individuals like you. As an actively growing ecosystem, Arrow Meta and its associated libraries and toolsets are in need of new contributors! We have issues suited for all levels, from entry to advanced, and our maintainers are happy to provide 1:1 mentoring. All are welcome in Arrow Meta.
If you’re looking to contribute, have questions, or want to keep up-to-date about what’s happening, please follow us here and say hello!
Copyright (C) 2017 The Λrrow Authors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.