From 3c56d6ac11378d57206550094f5fece0380d9c0b Mon Sep 17 00:00:00 2001 From: brandjon Date: Thu, 4 May 2017 21:46:46 +0200 Subject: Document our syntactic guarantees RELNOTES: None PiperOrigin-RevId: 155113548 --- site/versions/master/docs/skylark/language.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'site/versions/master/docs') 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 -- cgit v1.2.3