| # Copyright 2018 The Bazel Authors. All rights reserved. |
| # |
| # 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. |
| load( |
| "//kotlin/internal:utils.bzl", |
| _utils = "utils", |
| ) |
| load( |
| "//kotlin/internal:kt.bzl", |
| _kt = "kt", |
| ) |
| |
| """Kotlin Toolchains |
| |
| This file contains macros for defining and registering specific toolchains. |
| |
| ### Examples |
| |
| To override a tool chain use the appropriate macro in a `BUILD` file to declare the toolchain: |
| |
| ```bzl |
| load("@io_bazel_rules_kotlin//kotlin:toolchains.bzl", "define_kt_toolchain") |
| |
| define_kt_toolchain( |
| name= "custom_toolchain", |
| api_version = "1.1", |
| language_version = "1.1", |
| ) |
| ``` |
| and then register it in the `WORKSPACE`: |
| ```bzl |
| register_toolchains("//:custom_toolchain") |
| ``` |
| """ |
| |
| _KT_COMPILER_REPO="com_github_jetbrains_kotlin" |
| |
| # The toolchain rules are not made private, at least the jvm ones so that they may be introspected in Intelij. |
| _common_attrs = { |
| "kotlin_home": attr.label( |
| default = Label("@" + _KT_COMPILER_REPO + "//:home"), |
| allow_files = True, |
| ), |
| "kotlinbuilder": attr.label( |
| default = Label("//kotlin/builder"), |
| executable = True, |
| allow_files = True, |
| cfg = "host", |
| ), |
| "language_version": attr.string( |
| default = "1.2", |
| values = [ |
| "1.1", |
| "1.2", |
| ], |
| ), |
| "api_version": attr.string( |
| default = "1.2", |
| values = [ |
| "1.1", |
| "1.2", |
| ], |
| ), |
| "coroutines": attr.string( |
| default = "enable", |
| values = [ |
| "enable", |
| "warn", |
| "error", |
| ], |
| ), |
| } |
| |
| _kt_jvm_attrs = dict(_common_attrs.items() + { |
| "jvm_runtime": attr.label( |
| default = Label("@" + _KT_COMPILER_REPO + "//:kotlin-runtime"), |
| ), |
| "jvm_stdlibs": attr.label_list( |
| default = [ |
| Label("@" + _KT_COMPILER_REPO + "//:kotlin-stdlib"), |
| Label("@" + _KT_COMPILER_REPO + "//:kotlin-stdlib-jdk7"), |
| Label("@" + _KT_COMPILER_REPO + "//:kotlin-stdlib-jdk8"), |
| ] |
| ), |
| "jvm_target": attr.string( |
| default = "1.8", |
| values = [ |
| "1.6", |
| "1.8", |
| ], |
| ), |
| }.items()) |
| |
| def _kotlin_toolchain_impl(ctx): |
| toolchain = platform_common.ToolchainInfo( |
| label = _utils.restore_label(ctx.label), |
| language_version = ctx.attr.language_version, |
| api_version = ctx.attr.api_version, |
| coroutines = ctx.attr.coroutines, |
| |
| jvm_target = ctx.attr.jvm_target, |
| |
| |
| kotlinbuilder = ctx.attr.kotlinbuilder, |
| kotlin_home = ctx.files.kotlin_home, |
| |
| jvm_runtime = ctx.files.jvm_runtime, |
| jvm_stdlibs = ctx.files.jvm_stdlibs |
| ) |
| return struct(providers=[toolchain]) |
| |
| kt_toolchain = rule( |
| attrs = _kt_jvm_attrs, |
| implementation = _kotlin_toolchain_impl, |
| ) |
| |
| """The kotlin jvm toolchain |
| Args: |
| language_version: the -languag_version flag [see](https://kotlinlang.org/docs/reference/compatibility.html). |
| api_version: the -api_version flag [see](https://kotlinlang.org/docs/reference/compatibility.html). |
| jvm_target: the -jvm_target flag. |
| coroutines: the -Xcoroutines flag, enabled by default as it's considered production ready 1.2.0 onward. |
| """ |
| |
| def define_kt_toolchain(name, language_version=None, api_version=None, jvm_target=None, coroutines=None): |
| """Define a Kotlin JVM Toolchain, the name is used in the `toolchain` rule so can be used to register the toolchain in the WORKSPACE file.""" |
| impl_name = name + "_impl" |
| kt_toolchain( |
| name = impl_name, |
| language_version = language_version, |
| api_version = api_version, |
| jvm_target = jvm_target, |
| coroutines = coroutines, |
| visibility = ["//visibility:public"] |
| ) |
| native.toolchain( |
| name = name, |
| toolchain_type = _kt.defs.TOOLCHAIN_TYPE, |
| toolchain = impl_name, |
| visibility = ["//visibility:public"] |
| ) |