cite
0.9.0indexedCompiler plugin embeds metadata about source files directly into the generated code, allowing access to filename, enclosing type, member name, and line number at runtime.
369
Stars
2
Used by
dependents
—
Health
/ 100
Compiler plugin embeds metadata about source files directly into the generated code, allowing access to filename, enclosing type, member name, and line number at runtime.
A Kotlin compiler plugin for embedding information about the file being compiled.
For example, given:
object Greeter {
fun sayHi() {
println("Hello: $__FILE__, $__TYPE__, $__MEMBER__, $__LINE__")
}
}
When invoked, this will output:
Hello: main.kt, Greeter, sayHi, 16
The Java bytecode shows values were resolved at compile time:
9: getstatic #19 // Field java/lang/System.out:Ljava/io/PrintStream;
11: ldc #27 // String Hello: main.kt, Greeter, sayHi, 16
14: invokevirtual #25 // Method java/io/PrintStream.println:(Ljava/lang/Object;)V
The values are constants, so they can be folded with other constants.
Every Kotlin target is supported. Here's JS:
Greeter.prototype.h = function () {
println('Hello: main.kt, Greeter, sayHi, 16');
};
Native (as LLVM IR):
Six properties are provided:
Using type properties in locations without an associated enclosing type is an error.
For example, using __TYPE__ in a top-level function will fail to compile.
Add the buildscript dependency and apply the plugin to each module in which you want to access the properties.
buildscript {
repository {
mavenCental()
}
dependencies {
classpath 'com.jakewharton.cite:cite-gradle-plugin:0.9.0'
}
}
apply plugin: 'org.jetbrains.kotlin.multiplatform' // Or .jvm, or .android
apply plugin: 'com.jakewharton.cite'
The runtime dependency will be added as an implementation dependency automatically.
Never add the runtime dependency yourself, as use without the plugin will not work.
buildscript {
repositories {
mavenCentral()
maven {
url 'https://central.sonatype.com/repository/maven-snapshots/'
}
}
dependencies {
classpath 'com.jakewharton.cite:cite-gradle-plugin:0.10.0-SNAPSHOT'
}
}
apply plugin: 'org.jetbrains.kotlin.multiplatform' // Or .jvm, or .android
apply plugin: 'com.jakewharton.cite'
Since Kotlin compiler plugins are an unstable API, certain versions of Cite only work with certain versions of Kotlin.
| Kotlin | Cite |
|---|---|
| 2.4.0 | 0.9.0 |
| 2.3.0 | 0.8.0 |
| 2.0.21 - 2.2.0 |
Kotlin versions newer than those listed may be supported but have not been tested.
Copyright 2023 Jake Wharton
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
@760 = … { …, [68 x i8] c"H\00e\00l\00l\00o\00:\00 \00m\00a\00i\00n\00.\00k\00t\00,\00 \00G\00r\00e\00e\00t\00e\00r\00,\00 \00s\00a\00y\00H\00i\00,\00 \001\007\00" }
⋮
call void @"kfun:kotlin.io#println(kotlin.Any?){}"(ptr @760)
| Property | Type | Description | Example |
|---|
__MODULE__ | String | Name of the Kotlin module. | "example" |
__FILE__ | String | Filename of the source file. | "main.kt" |
__TYPE__ | String | Name of the nearest enclosing class, object, interface, or enum. | "Greeter" |
__FQ_TYPE__ | String | Fully-qualified name of the nearest enclosing type or file facade. | "com.example.Greeter" |
__MEMBER__ | String | Name of the nearest enclosing function or property body. | "sayHi" |
__LINE__ | Int | One-based line number of this property access. | 16 |
| 0.4.0 - 0.7.0 |
| 1.8.0 - 1.9.25 | 0.1.0 - 0.3.0 |
Surfaced from shared tags and platforms — no rankings paid for.