| // Copyright 2019 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. |
| |
| package com.google.devtools.build.lib.skylarkbuildapi.python; |
| |
| import com.google.devtools.build.lib.skylarkinterface.SkylarkCallable; |
| import com.google.devtools.build.lib.skylarkinterface.SkylarkModule; |
| import com.google.devtools.build.lib.skylarkinterface.SkylarkValue; |
| import com.google.devtools.build.lib.syntax.StarlarkSemantics.FlagIdentifier; |
| |
| /** |
| * DO NOT USE. Skarlark module exposing Python transitions for Python 2 to 3 migration purposes |
| * only. |
| */ |
| @SkylarkModule( |
| name = "py_transitions", |
| doc = |
| "DO NOT USE. This is intended for Python 2 to 3 migration purposes only. If you depend" |
| + " on it, you will be broken when it is removed.", |
| documented = false) |
| public interface PyStarlarkTransitionsApi extends SkylarkValue { |
| |
| @SkylarkCallable( |
| name = "cfg", |
| doc = |
| "DO NOT USE. This is intended for Python 2 to 3 migration purposes only. If you depend on" |
| + " it, you will be broken when it is removed. A configuration that transitions to" |
| + " the Python version specified by the 'python_version' attribute of the rule." |
| + " Valid versions are: PY2, PY3, and DEFAULT. If 'python_version' attribute is not" |
| + " available, or has an invalid value, it succeeds silently without transitions.", |
| documented = false, |
| structField = true, |
| enableOnlyWithFlag = FlagIdentifier.EXPERIMENTAL_GOOGLE_LEGACY_API) |
| public SkylarkValue getTransition(); |
| } |