diff options
author | brandjon <brandjon@google.com> | 2017-05-04 21:46:46 +0200 |
---|---|---|
committer | Damien Martin-Guillerez <dmarting@google.com> | 2017-05-04 23:06:20 +0200 |
commit | 3c56d6ac11378d57206550094f5fece0380d9c0b (patch) | |
tree | b9cc8f704a6a1ffb8e3e660267c90775d98cc1ad /site | |
parent | 721b47cee9acc60b7468e1bd3eb2b62b75cd7d04 (diff) |
Document our syntactic guarantees
RELNOTES: None
PiperOrigin-RevId: 155113548
Diffstat (limited to 'site')
-rw-r--r-- | site/versions/master/docs/skylark/language.md | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/site/versions/master/docs/skylark/language.md b/site/versions/master/docs/skylark/language.md index 1ca36e137d..583e4f7c0a 100644 --- a/site/versions/master/docs/skylark/language.md +++ b/site/versions/master/docs/skylark/language.md @@ -7,7 +7,7 @@ title: Extensions - Overview ## Syntax -The extension language (Skylark) is a superset of the +The extension language, Skylark, is a superset of the [Core Build Language](/docs/build-ref.html#core_build_language) and its syntax is a subset of Python. It is designed to be simple, thread-safe and integrated with the @@ -38,6 +38,12 @@ The following basic types are supported: [None](lib/globals.html#None), types are specific to Bazel: [depset](lib/depset.html) and [struct](lib/struct.html). +Skylark is syntactically a subset of both Python 2 and Python 3, and will remain +so through at least the 1.x release lifecycle. This ensures that Python-based +tooling can at least parse Skylark code. Although Skylark is not *semantically* +a subset of Python, behavioral differences are rare (excluding cases where +Skylark raises an error). + ## Mutability |