From a353b2bf86f7a872459fcc454c94a9bfd604fd99 Mon Sep 17 00:00:00 2001
From: monadabot <109207340+monadabot@users.noreply.github.com>
Date: Thu, 29 Jun 2023 10:17:01 -0400
Subject: [PATCH 1/4] feat(docs): update docs (#489)
feat(docs): update docs
Updates the Wing docs. See details in [workflow run].
[Workflow Run]: https://github.com/winglang/docsite/actions/runs/5413226945
------
*Automatically created via the "update-docs" workflow*
---
.../compatibility/compatibility.json | 67 ++++++++++---------
1 file changed, 37 insertions(+), 30 deletions(-)
diff --git a/versioned_docs/version-latest/04-standard-library/compatibility/compatibility.json b/versioned_docs/version-latest/04-standard-library/compatibility/compatibility.json
index 453afc89b..3261199c7 100644
--- a/versioned_docs/version-latest/04-standard-library/compatibility/compatibility.json
+++ b/versioned_docs/version-latest/04-standard-library/compatibility/compatibility.json
@@ -14,35 +14,35 @@
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": true}
},
- "on_upload": {
+ "onUpload": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1954},
"tf-gcp": {"implemented": false},
- "aws-cdk": {"implemented": false}
+ "aws-cdk": {"implemented": true}
},
- "on_delete": {
+ "onDelete": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1954},
"tf-gcp": {"implemented": false},
- "aws-cdk": {"implemented": false}
+ "aws-cdk": {"implemented": true}
},
- "on_update": {
+ "onUpdate": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1954},
"tf-gcp": {"implemented": false},
- "aws-cdk": {"implemented": false}
+ "aws-cdk": {"implemented": true}
},
- "on_event": {
+ "onEvent": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1954},
"tf-gcp": {"implemented": false},
- "aws-cdk": {"implemented": false}
+ "aws-cdk": {"implemented": true}
},
- "add_object": {
+ "addObject": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
@@ -56,7 +56,7 @@
"tf-gcp": {"implemented": false, "issue": 1282},
"aws-cdk": {"implemented": true}
},
- "put_json": {
+ "putJson": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
@@ -70,21 +70,21 @@
"tf-gcp": {"implemented": false, "issue": 1282},
"aws-cdk": {"implemented": true}
},
- "try_get": {
+ "tryGet": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": false}
},
- "get_json": {
+ "getJson": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": false}
},
- "try_get_json": {
+ "tryGetJson": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
@@ -98,7 +98,7 @@
"tf-gcp": {"implemented": false, "issue": 1282},
"aws-cdk": {"implemented": true}
},
- "try_delete": {
+ "tryDelete": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": true},
@@ -140,14 +140,14 @@
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": true}
},
- "public_url": {
+ "publicUrl": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1805},
"tf-gcp": {"implemented": false, "issue": 1282},
"aws-cdk": {"implemented": true}
},
- "signed_url": {
+ "signedUrl": {
"sim": {"implemented": false, "issue": 1383},
"tf-aws": {"implemented": false, "issue": 1383},
"tf-azure": {"implemented": false},
@@ -184,14 +184,14 @@
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": true}
},
- "add_consumer": {
+ "setConsumer": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false},
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": true}
},
- "approx_size": {
+ "approxSize": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false},
@@ -270,7 +270,7 @@
"tf-gcp": {"implemented": false},
"aws-cdk": {"implemented": false}
},
- "add_env": {
+ "addEnv": {
"sim": {"implemented": false},
"tf-aws": {"implemented": false},
"tf-azure": {"implemented": false},
@@ -284,7 +284,7 @@
"tf-gcp": {"implemented": false, "issue": 614},
"aws-cdk": {"implemented": true}
},
- "invoke_async": {
+ "invokeAsync": {
"sim": {"implemented": false},
"tf-aws": {"implemented": false},
"tf-azure": {"implemented": false},
@@ -337,7 +337,7 @@
"tf-gcp": {"implemented": false, "issue": 620},
"aws-cdk": {"implemented": true}
},
- "on_message": {
+ "onMessage": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 621},
@@ -346,21 +346,21 @@
}
},
"Schedule": {
- "from_cron": {
+ "fromCron": {
"sim": {"implemented": false},
"tf-aws": {"implemented": false},
"tf-azure": {"implemented": false, "issue": 1291},
"tf-gcp": {"implemented": false, "issue": 1292},
"aws-cdk": {"implemented": false}
},
- "from_rate": {
+ "fromRate": {
"sim": {"implemented": false},
"tf-aws": {"implemented": false},
"tf-azure": {"implemented": false, "issue": 1291},
"tf-gcp": {"implemented": false, "issue": 1292},
"aws-cdk": {"implemented": false}
},
- "on_tick": {
+ "onTick": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1291},
@@ -486,7 +486,7 @@
"tf-gcp": {"implemented": false, "issue": 2179},
"aws-cdk": {"implemented": true}
},
- "SecretProps.value_json": {
+ "SecretProps.valueJson": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 2178},
@@ -495,7 +495,7 @@
}
},
"Service": {
- "ServiceProps.buildpack_path": {
+ "ServiceProps.buildpackPath": {
"sim": {"implemented": false, "issue": 1305},
"tf-aws": {"implemented": false, "issue": 1306},
"tf-azure": {"implemented": false, "issue": 1307},
@@ -544,7 +544,7 @@
"tf-gcp": {"implemented": false, "issue": 1308},
"aws-cdk": {"implemented": false}
},
- "buildpack_path": {
+ "buildpackPath": {
"sim": {"implemented": false, "issue": 1305},
"tf-aws": {"implemented": false, "issue": 1306},
"tf-azure": {"implemented": false, "issue": 1307},
@@ -586,7 +586,7 @@
"tf-gcp": {"implemented": false, "issue": 1308},
"aws-cdk": {"implemented": false}
},
- "add_env": {
+ "addEnv": {
"sim": {"implemented": false, "issue": 1305},
"tf-aws": {"implemented": false, "issue": 1306},
"tf-azure": {"implemented": false, "issue": 1307},
@@ -616,7 +616,7 @@
"tf-gcp": {"implemented": false, "issue": 1316},
"aws-cdk": {"implemented": false}
},
- "TableProps.primary_key": {
+ "TableProps.primaryKey": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1315},
@@ -637,13 +637,20 @@
"tf-gcp": {"implemented": false, "issue": 1316},
"aws-cdk": {"implemented": false}
},
- "primary_key": {
+ "primaryKey": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
"tf-azure": {"implemented": false, "issue": 1315},
"tf-gcp": {"implemented": false, "issue": 1316},
"aws-cdk": {"implemented": false}
},
+ "addRow": {
+ "sim": {"implemented": true},
+ "tf-aws": {"implemented": true},
+ "tf-azure": {"implemented": false},
+ "tf-gcp": {"implemented": false},
+ "aws-cdk": {"implemented": false}
+ },
"insert": {
"sim": {"implemented": true},
"tf-aws": {"implemented": true},
From f25da1f0ba7783c8f7e8352c5404aaba6efa52fd Mon Sep 17 00:00:00 2001
From: monadabot <109207340+monadabot@users.noreply.github.com>
Date: Thu, 29 Jun 2023 13:17:32 -0400
Subject: [PATCH 2/4] feat(docs): update docs (#491)
feat(docs): update docs
Updates the Wing docs. See details in [workflow run].
[Workflow Run]: https://github.com/winglang/docsite/actions/runs/5414969792
------
*Automatically created via the "update-docs" workflow*
---
.../01-start-here/05-development.md | 2 +-
.../03-language-guide/90-reference.md | 1360 +++++------------
2 files changed, 374 insertions(+), 988 deletions(-)
diff --git a/contributing_versioned_docs/version-latest/01-start-here/05-development.md b/contributing_versioned_docs/version-latest/01-start-here/05-development.md
index f83bb7422..ddd036f34 100644
--- a/contributing_versioned_docs/version-latest/01-start-here/05-development.md
+++ b/contributing_versioned_docs/version-latest/01-start-here/05-development.md
@@ -207,7 +207,7 @@ The [insta](https://marketplace.visualstudio.com/items?itemName=mitsuhiko.insta)
To debug the Rust compiler on VSCode, first you need to install the [CodeLLDB extension](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb).
Next, you can use the `Debug Wing Compiler` launch configuration available on our [launch.json](https://github.com/winglang/wing/blob/main/.vscode/launch.json).
-Hit F5 to start debugging. You'll be prompted to insert the path to the `.w` file you want to debug.
You can use the `${workspaceFolder}/examples/tests/valid/hello.w` file for example.
+Open the `.w` file you wish to debug compilation for (e.g. `${workspaceFolder}/examples/tests/valid/hello.w`) and hit F5 to start debugging.
## How do I make changes to the Wing grammar?
diff --git a/versioned_docs/version-latest/03-language-guide/90-reference.md b/versioned_docs/version-latest/03-language-guide/90-reference.md
index 23557f6f7..80777cb30 100644
--- a/versioned_docs/version-latest/03-language-guide/90-reference.md
+++ b/versioned_docs/version-latest/03-language-guide/90-reference.md
@@ -1,22 +1,15 @@
---
-title: Language reference
-id: reference
-description: The Wing Language Specification
+title: Language Reference
+id: language-reference
+description: The Wing Language Reference
keywords: [Wing reference, Wing language, language, Wing language spec, Wing programming language]
---
-:::caution Not fully implemented yet
-
-This document is a *specification* of the programming language, and many features
-are still not implemented (see [project board](https://github.com/orgs/winglang/projects/1)).
-
-:::
-
## 0. Preface
### 0.1 Motivation
-The Wing Programming Language (aka winglang[RFC](/2022-05-28-winglang-reqs)) is a general
+The Wing Programming Language (aka Winglang) is a general
purpose programming language designed for building applications for the cloud.
What makes Wing special? Traditional programming languages are designed around
@@ -68,40 +61,18 @@ import TOCInline from '@theme/TOCInline';
| Name | Extra information |
| ------ | ---------------------------------- |
| `void` | represents the absence of a type |
-| `nil` | represents the absence of a value |
-| `any` | represents everything and anything |
| `num` | represents numbers (doubles) |
| `str` | UTF-16 encoded strings |
| `bool` | represents true or false |
-> `any` is only available to JSII imported modules.
-
-User defined explicit "any" is supported iff declared by the user.
-Almost all types can be implicitly resolved by the compiler except for "any".
-"any" must be explicitly declared and annotated.
-
> ```TS
> let x = 1; // x is a num
> let v = 23.6; // v is a num
> let y = "Hello"; // y is a str
> let z = true; // z is a bool
-> let w: any = 1; // w is an any
> let q: num? = nil; // q is an optional num
> ```
-Equivalent TypeScript Code
-
-> ```TS
-> const x: number = 1;
-> const v: number = 23.6;
-> const y: string = "Hello";
-> const z: boolean = true;
-> const w: any = 1;
-> const q: number? = undefined;
-> ```
-
-
+> Check out the [roadmap](#1149-roadmap) section below, to see what parts are still not implemented.
+
+Wing has a primitive data type called `Json`. This type represents an immutable untyped [JSON
value](https://www.json.org/json-en.html), including JSON primitives (`string`, `number`,
`boolean`), arrays (both heterogenous and homogenous) and objects (key-value maps where keys are
-strings and values can be any other JSON value)).
+strings and values can be any other JSON value).
`Json` objects are immutable and can be referenced across inflight context.
@@ -186,35 +171,34 @@ since Wing is statically-typed (type must be known during compilation) and JSON
(type is only known at runtime), bridging is required between these two models.
Let's look at a quick example:
-
```js
struct Employee {
id: str;
name: str;
}
-let response = httpGet("/employees");
+let response = http.get("/employees");
// returns something like { "items": [ { "id": "12234", "name": "bob" }, ... ] }
-
-let employees = Array.fromJson(response.items);
+
+let employees = Array.fromJson(response.get("items")); //NOTE: Array.fromJson is currently not implemented
for e in employees {
log("hello, ${e.name}, your employee id is ${e.id}");
}
```
-
-In the above example, the `httpGet` function returns a `Json` object from the server that has a
+In the above example, the `http.get` function returns a `Json` object from the server that has a
single field `items`, with a JSON array of JSON objects, each with an `id` and `name` fields.
-The expression `response.items` returns a `Json` array, and we use `Array.fromJson` to convert
-this array from `Json` to an `Array`. Note that by default `fromJson` will perform schema
-validation on the array and on each item (based on the declaration of the `Employee` struct).
+The expression `response.get("items")` returns a `Json` array, and we use `Array.fromJson` to
+convert this array from `Json` to an `Array`. Note that by default `fromJson` will
+perform schema validation on the array and on each item (based on the declaration of the `Employee`
+struct).
##### 1.1.4.1 Literals
Literals can be defined using the `Json` type initializers:
-```js
+```TS
let jsonString = Json "hello";
let jsonNumber = Json 123;
let jsonBool = Json true;
@@ -229,7 +213,7 @@ let jsonMutObj = MutJson {
The `Json` keyword can be omitted from `Json` object literals:
-```js
+```TS
let jsonObj = { boom: 123, bam: [4, 5, 6] };
```
@@ -237,63 +221,42 @@ Every value within a `Json` array or object also has a type of `Json`.
##### 1.1.4.2 JSON objects
-To access a field within an object, use the `.` notation:
+To access a field within an object, use `.get("{field name}")`:
-```js
-let boom: Json = jsonObj.boom;
+```TS
+let boom: Json = jsonObj.get("boom");
```
Trying to access a non-existent field will fail at runtime. For example:
-```js
-log(jsonObj.boom.dude.world);
-// RUNTIME ERROR: Uncaught TypeError: Cannot read properties of undefined (reading 'world')
-```
-
-Like in JavaScript, it is also possible to access object fields using `[]`:
-
-```js
-let foo = j["my-field"].yourField["their-field"];
+```TS
+log("${jsonObj.get("boom").get("dude").get("world")}");
+// ERROR: Cannot read properties of undefined (reading 'world')
```
To obtain an array of all the keys within a JSON object use the `Json.keys(o)` method.
-
-```js
+```TS
let j = Json { hello: 123, world: [ 1, 2, 3 ] };
-assert(Json.keys(j) == ["hello", "world"]);
+assert(Json.keys(j).at(0) == "hello");
+assert(Json.keys(j).at(1) == "world");
```
-To obtain an array of all the values, use `Json.values(o)`. To obtain an array of all key/value
-pairs use `Json.entries(o)` (P2):
+To obtain an array of all the values, use `Json.values(o)`:
-```js
+```TS
assert(Json.values(j).equals([ Json 123, Json [ 1, 2, 3 ] ]));
-assert(Json.entries(j).equals([
- [ Json "hello", Json 123 ],
- [ Json "world", Json [ 1, 2, 3 ] ]
-]));
```
-> NOTE: `values()` and `entries()` return an array inside a `Json` object because at the moment we
+> NOTE: `values()` returns an array inside a `Json` object because at the moment we
> cannot represent heterogenous arrays in Wing.
-##### 1.1.4.3 JSON arrays
-
-To access an array element, use the `[]` notation:
-
-```js
-let item2 = jsonArray[2]; // type: Json
-```
-
-Trying to index a value that is not an array will return JavaScript `undefined`.
-
-##### 1.1.4.4 Assignment from native types
+##### 1.1.4.3 Assignment from native types
It is also possible to assign the native `str`, `num`, `bool` and `Array` values and they will
implicitly be casted to `Json`:
-```js
+```TS
let myStr: str = "hello";
let myNum: num = 183;
let myBool: bool = true;
@@ -307,13 +270,12 @@ let jsonObj = Json {
};
```
-
-##### 1.1.4.5 Assignment to native types
+##### 1.1.4.4 Assignment to native types
We only allow implicit assignment from *safe* to *unsafe* types because otherwise we cannot
guarantee safety (e.g. from `str` to `Json` but not from `Json` to `str`), so this won't work:
-```js
+```TS
let j = Json "hello";
let s: str = j;
// ^ cannot assign `Json` to `str`.
@@ -322,144 +284,62 @@ let s: str = j;
To assign a `Json` to a strong-type variable, use the `fromJson()` static method on the target
type:
-```js
+```TS
let myStr = str.fromJson(jsonString);
let myNumber = num.fromJson(jsonNumber);
-let myArr = Array.fromJson(jsonArray);
```
-##### 1.1.4.6 Schema validation
+##### 1.1.4.5 Schema validation
All `fromJson()` methods will validate that the runtime type is compatible with the target type in
order to ensure type safety (at a runtime cost):
-```js
+```TS
str.fromJson(jsonNumber); // RUNTIME ERROR: unable to parse number `123` as a string.
num.fromJson(Json "\"hello\""); // RUNTIME ERROR: unable to parse string "hello" as a number
-
-let myArray = Json [1,2,3,"hello"];
-Array.fromJson(myArray); // RUNTIME ERROR: unable to parse `[1,2,3,"hello"]` as an array of `num`.
```
-Use `unsafe: true` to disable this check at your own risk (P2):
-
-```js
-let trustMe = Json [1,2,3];
-let x = Array.fromJson(trustMe, unsafe: true);
-assert(x.at(1) == 2);
-```
-
-For each `fromJson()`, there is a `tryFromJson()` method which returns an optional `T?` which
-indicates if parsing was successful or not:
-
-```js
-let s = str.tryFromJson(myJson) ?? "invalid string";
-```
-
-##### 1.1.4.7 Assignment to user-defined structs
-
-All [structs](#31-structs) also have a `fromJson()` method that can be used to parse `Json` into a
-struct:
-
-```js
-struct Contact {
- first: str;
- last: str;
- phone: str?;
-}
-
-let j = Json { first: "Wing", last: "Lyly" };
-let myContact = Contact.fromJson(j);
-assert(myContact.first == "Wing");
-```
-
-When a `Json` is parsed into a struct, the schema will be validated to ensure the result is
-type-safe:
-
-```js
-let p = Json { first: "Wing", phone: 1234 };
-Contact.fromJson(p);
-// RUNTIME ERROR: unable to parse Contact:
-// - field "last" is required and missing
-// - field "phone" is expected to be a string, got number.
-```
-
-Same as with primitives and containers, it is possible to opt-out of validation using `unsafe:
-true`:
-
-```js
-let p = Json { first: "Wing", phone: 1234 };
-let x = Contact.fromJson(p, unsafe: true);
-assert(x.last.len > 0);
-// RUNTIME ERROR: Cannot read properties of undefined (reading 'length')
-```
-
-Struct parsing is *partial* by default. This means that parsing is successful even if the `Json`
-includes extraneous fields:
-
-```js
-let p = Json { first: "hello", last: "world", anotherField: "ignored" };
-let c = Contact.fromJson(p);
-assert(c.first == "hello");
-assert(c.last == "world");
-// `c.anotherField` is not a thing
-```
-
-This can be disabled using `partial: false` (P2):
-
-```js
-Contact.fromJson(Json { first: "hello", last: "world", anotherField: "ignored" }, partial: false);
-// RUNTIME ERROR: cannot parse Contact due to extraneous field "anotherField"
-```
-
-##### 1.1.4.7 Schemas
-
-Structs have a `schema` static method which returns a `JsonSchema` object (P2):
-
-```js
-let schema = Contact.schema();
-schema.validate(j);
-```
-
-##### 1.1.4.8 Mutability
+##### 1.1.4.6 Mutability
To define a mutable JSON container, use the `MutJson` type:
-```js
+```TS
let myObj = MutJson { hello: "dear" };
```
Now you can mutate the contents by assigning values:
-```js
+```TS
+let myObj = MutJson { hello: "dear" };
let fooNum = 123;
-myObj.world = "world";
-myObj.dang = [1,2,3,4];
-myObj.subObject = {};
-myObj.subObject.arr = [1,"hello","world"];
-myObj.foo = fooNum;
+myObj.set("world", "world");
+myObj.set("dang", [1,2,3,4]);
+myObj.set("subObject", MutJson {});
+myObj.get("subObject").set("arr", MutJson [1,"hello","world"]);
+myObj.set("foo", fooNum);
```
For the sake of completeness, it is possible to also define primitives using `MutJson` but that's
not very interesting because there is no way to mutate them:
-```js
+```TS
let foo = MutJson "hello";
// ok what now?
```
-Use the `MutJson.deepCopy()` method to get an immutable *deep copy* of the object:
+Use the `Json.deepCopyMut(MutJson json)` method to get an mutable *deep copy* of a `Json` object.
+Use the `MutJson.deepCopy(Json json)` method to get an immutable *deep copy* of a `MutJson` object:
-```js
+```TS
let mutObj = MutJson { hello: 123 };
-let immutObj = mutObj.deepCopy(mutObj);
-mutObj.hello = 999;
-assert(immutObj.hello == 123);
+let immutObj = MutJson.deepCopy(mutObj);
+mutObj.set("hello", 999);
+assert(immutObj.get("hello") == 123);
```
To delete a key from an object, use the `Json.delete()` method:
-```js
+```TS
let myObj = MutJson { hello: 123, world: 555 };
Json.delete(myObj, "world");
@@ -468,101 +348,57 @@ Json.delete(immutObj, "hello");
// ^^^^^^^^^ expected `JsonMut`
```
-To modify a Json array, you will need to parse it into a native `MutArray` and then modify it. This
-implies that at the moment, it is not possible to mutate heterogenous JSON arrays:
-
-```js
-let j1 = MutJson { hello: [1,2,3,4] };
-let a1 = MutArray.fromJson(j1);
-a1.push(5);
-
-j1.hello = a1;
-```
-
-> We will need to revisit this as we progress if this is a major use case.
-
-##### 1.1.4.9 Serialization
+##### 1.1.4.7 Serialization
The `Json.stringify(j: Json): str` static method can be used to serialize a `Json` as a string
([JSON.stringify](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify)):
-```js
+```TS
+let jsonString = Json "hello";
+let jsonObj = Json { boom: 123 };
assert(Json.stringify(jsonString) == "\"hello\"");
assert(Json.stringify(jsonObj) == "{\"boom\":123}");
-assert(Json.stringify(jsonMutObj, indent: 2) == "{\n\"hello\": 123,\n" \"world\": [\n 1,\n 2,\n 3\n ],\n \"boom\": {\n \"hello\": 1233\n }\n}");
```
The `Json.parse(s: str): Json` static method can be used to parse a string into a `Json`:
-```js
-let jArray = Json.parse("[1,2,3]");
-let arr = Array.fromJson(jArray);
+```TS
+let j = Json.parse("{ \"boom\": 123 }");
+let boom = num.fromJson(j.get("boom"));
```
`Json.tryParse` returns an optional:
-```js
+```TS
let o = Json.tryParse("xxx") ?? Json [1,2,3];
```
-##### 1.1.4.10 Equality, diff and patch
-
-The `Json.equals(lhs: Json, rhs: Json): bool` static method can be used to determine if two values
-are equal (recursively comparing arrays and objects):
-
-```js
-assert(Json.equals(jsonString, Json "hello"));
-assert(Json.equals(jsonObj, { boom: [ 1, 2, 3 ] }));
-assert(!Json.equals(Json { hello: [ 1, 2, 3 ] }, Json { hello: [ 1, 2 ] }));
-```
-
-The `Json.diff(lhs: Json, rhs: Json): JsonPatch` static method can be used to calculate the deep
-difference between two JSON values. It returns a list of differences in
-[json-patch](https://jsonpatch.com/) format (P2).
-
-```js
-let j1 = Json {
- baz: "qux",
- foo: "bar"
-};
-
-let j2 = Json {
- baz: "boo",
- hello: ["world"]
-};
-
-assert(Json.diff(j1, j2) = [
- { op: JsonPatch.REPLACE, path: "/baz", value: "boo" },
- { op: JsonPatch.ADD, path: "/hello", value: ["world"] },
- { op: JsonPatch.REMOVE, path: "/foo" }
-]);
-```
-
-The `Json.patch(j: Json, patch: JsonPatch): Json` static method applies a `JsonPatch` to a `Json` object (P2).
-
-##### 1.1.4.11 Logging
+##### 1.1.4.8 Logging
A `Json` value can be logged using `log()`, in which case it will be pretty-formatted:
-```js
+```TS
log("my object is: ${jsonObj}");
// is equivalent to
-log("my object is: ${Json.stringify(jsonObj, indent: 2)}");
+log("my object is: ${Json.stringify(jsonObj)}");
```
This will output:
-```js
+```TS
my object is: {
boom: 123
}
```
-It is also legal to just log a json object:
+#### 1.1.4.9 Roadmap
-```js
-log(jsonMutObj);
-```
+The following features are not yet implemented, but we are planning to add them in the future:
+
+* Array/Set/Map.fromJson() - see https://github.com/winglang/wing/issues/1796 to track.
+* Json.entries() - see https://github.com/winglang/wing/issues/3142 to track.
+* Schema validation and assignment to struct - see https://github.com/winglang/wing/issues/3139 to track.
+* Equality, diff and patch - see https://github.com/winglang/wing/issues/3140 to track.
[`▲ top`][top]
@@ -574,7 +410,7 @@ The `Duration` (alias `duration`) type represents a time duration.
Duration literals are numbers with `m`, `s`, `h` suffixes:
-```js
+```TS
let oneMinute = 1m;
let twoSeconds = 2s;
let threeHours = 3h;
@@ -583,7 +419,7 @@ let halfMinute: duration = 0.5m;
Then:
-```js
+```TS
assert(oneMinute.seconds == 60);
assert(halfMinute.seconds == 30);
assert(threeHours.minutes == 180);
@@ -591,109 +427,47 @@ assert(threeHours.minutes == 180);
Duration objects are immutable and can be referenced across inflight context.
-#### 1.1.6 `Datetime`
+#### 1.1.5.1 Roadmap
-The `Datetime` (alias `datetime`) type represents a single moment in time in a platform-independent
+An additional built-in `datetime` type is planned and not yet implemented. `datetime` represents a single moment in time in a platform-independent
format.
-
-`Datetime` objects are immutable and can be referenced across inflight context.
-
-Here is the initial API for the `Datetime` type:
-
-```js
-struct DatetimeComponents {
- year: num;
- month: num;
- day: num;
- hour: num;
- min: num;
- sec: num;
- ms: num;
- tz: num; // timezone offset in minutes from UTC
-}
-
-class Datetime {
- static utcNow(): Datetime; // returns the current time in UTC timezone
- static systemNow(): Datetime; // returns the current time in system timezone
- static fromIso(iso: str): Datetime; // creates an instance from an ISO-8601 string
- static fromComponents(c: DatetimeComponents): Datetime;
-
- timestamp: num; // Date.valueOf()/1000 (non-leap seconds since epoch)
- timestampMs: num; // Date.valueOf() (non-leap milliseconds since epoch)
-
- hours: num; // Date.getHours()
- min: num; // Date.getMinutes()
- sec: num; // Date.getSeconds()
- ms: num; // Date.getMilliseconds()
- day: num; // Date.getDay()
- month: num; // Date.getMonth()
- year: num; // Date.getFullYear()
-
- timezone: num; // Date.getTimezoneOffset() (offset in minutes from UTC)
- utc: Datetime; // returns the same time in UTC timezone
-
- toIso(): str; // returns ISO-8601 string
-}
-```
-
-A few examples:
-
-```js
-let now = Datetime.utcNow();
-log("It is now ${now.month}/${now.day}/${now.year} at ${now.hours}:${now.min}:${now.sec})");
-assert(now.timezone == 0); // UTC
-
-let t1 = DateTime.fromIso("2023-02-09T06:20:17.573Z");
-log("Timezone is GMT${d.timezone() / 60}"); // output: Timezone is GMT-2
-log("UTC: ${t1.utc.toIso())}"); // output: 2023-02-09T06:21:03.000Z
-```
-
-[`▲ top`][top]
-
----
-
+See https://github.com/winglang/wing/issues/2102 to track.
### 1.2 Utility Functions
| Name | Extra information |
| -------- | -------------------------------------------------------- |
-| `log` | logs anything serializable. |
+| `log` | logs str |
| `throw` | creates and throws an instance of an exception |
| `panic` | exits with a serializable, dumps the trace + a core dump |
| `assert` | checks a condition and _panics_ if evaluated to false |
-Wing is a statically typed language, so attempting to redefine any of the above
-functions, just like any other "symbol" will result in a compile-time error.
-
-The above functions can accept variadic arguments of any type except `throw` which
-only accepts one argument and that is the message to be contained in the error.
-
`panic` is a fatal call by design. If the intention is error handling, panic is the
last resort. Exceptions are non fatal and should be used instead for effectively
communicating errors to the user.
> ```TS
-> log(23, "Hello", true, { "a": 1, "b": 2 });
+> log("Hello ${name}");
> throw("a recoverable error occurred");
-> panic("a fatal error encountered", [1,2]);
-> assert(x > 0, x < 10);
+> panic("a fatal error encountered");
+> assert(x > 0);
> ```
Equivalent TypeScript Code
> ```TS
-> console.log(23, "Hello", true, Object.freeze(new Map([["a", 1], ["b", 2]])));
+> console.log("Hello ${name}");
> // throws
> throw new Error("a recoverable error occurred");
> // calling panic in wing is fatal
> (() => {
-> console.error("Something went wrong", [1,2]);
+> console.error("Something went wrong");
> // generate core dump
> // show stack trace
> process.exit(1);
> })();
-> // multiple assertions
-> (() => { assert.ok(x > 0); assert.ok(x < 10); })();
+> // assertion
+> (() => { assert.ok(x > 0); })();
> ```
Equivalent TypeScript Code
-
-> ```TS
-> class MyClass {
-> async foo(): Promise {
-> const w = somePromise();
-> const x = Object.freeze(await w);
-> return x;
-> }
-> async boo(): Promise {
-> const x = Object.freeze(await somePromise());
-> return x;
-> }
-> }
-> ```
-
-Equivalent TypeScript Code
> ```TS
-> const arr: number[] = Object.freeze([1, 2, 3]);
+> const arr: readonly number[] = Object.freeze([1, 2, 3]);
> const set: Set = Object.freeze(new Set([1, 2, 3]));
> for (const item of arr) {
> console.log(item);
@@ -1566,7 +1228,7 @@ The loop invariant in for loops is implicitly re-assignable (`var`).
> console.log(item);
> }
> // calling 0..100 does not allocate, just returns an iterator
-> function* iterator(start, end) {
+> function* iterator(start: number, end: number) {
> let i = start;
> while (i < end) yield i++;
> while (i > end) yield i--;
@@ -1583,7 +1245,7 @@ The loop invariant in for loops is implicitly re-assignable (`var`).
---
-### 2.8 while
+### 2.7 while
**while** statement is used to execute a block of code while a condition is true.
@@ -1627,11 +1289,11 @@ Structs can inherit from multiple other structs.
> struct MyDataModel1 {
> field1: num;
> field2: str;
-> };
+> }
> struct MyDataModel2 {
> field3: num;
> field4: bool?;
-> };
+> }
> struct MyDataModel3 extends MyDataModel1, MyDataModel2 {
> field5: str;
> }
@@ -1651,16 +1313,16 @@ Structs can inherit from multiple other structs.
> ```TS
> interface MyDataModel1 {
-> public readonly field1: number;
-> public readonly field2: string;
+> readonly field1: number;
+> readonly field2: string;
> }
> interface MyDataModel2 {
-> public readonly field3: number;
-> public readonly field4?: boolean;
+> readonly field3: number;
+> readonly field4?: boolean;
> }
> interface MyDataModel3 extends MyDataModel1, MyDataModel2 {
-> public readonly field5: string;
-> public readonly field6: number;
+> readonly field5: string;
+> readonly field6: number;
> }
> const s1: MyDataModel1 = { field1: 1, field2: "sample" };
> const s2: MyDataModel2 = { field3: 1, field4: true };
@@ -1699,10 +1361,14 @@ program's entrypoint), it will be a *preflight class*. If a class is declared wi
scope, it will be implicitly an inflight class.
A method that has the name **init** is considered to be a class
-constructor (or initializer, or allocator).
+constructor (or initializer).
```TS
inflight class Name extends Base impl IMyInterface1, IMyInterface2 {
+ // class fields
+ _field1: num;
+ _field2: str;
+
init() {
// constructor implementation
// order is up to user
@@ -1710,35 +1376,17 @@ inflight class Name extends Base impl IMyInterface1, IMyInterface2 {
this._field2 = "sample";
}
- // class fields (private by due to having leading underscore)
- _field1: num;
- _field2: str;
-
// static method (access with Name.staticMethod(...))
- public static staticMethod(arg: type, arg: type, ...) { /* impl */ }
- // private method
- private _privateMethod(arg: type, arg: type, ...): type { /* impl */ }
+ static staticMethod(arg: type, arg: type, ...) { /* impl */ }
// visible to outside the instance
- public publicMethod(arg:type, arg:type, ...) { /* impl */ }
- // visible to children only
- protected protectedMethod(type:arg, type:arg, ...) { /* impl */ }
- // public in current compilation unit only
- internal _internalMethod3(type:arg, type:arg, ...): type { /* impl */ }
+ publicMethod(arg:type, arg:type, ...) { /* impl */ }
}
```
+If no `init()` is defined, the class will have a default constructor that does nothing.
-Default initialization does not exist in Wing. All member fields must be
+Implicit default field initialization does not exist in Wing. All member fields must be
initialized in the constructor. Absent initialization is a compile error. All
-field types, including the optional types must be initialized. Optionals are
-initialized to `nil` if omitted, unless the type is `nil?`, which in that case,
-absent initialization is a compile error.
-
-Member function and field access in constructor with the "this" keyword before
-all fields are initialized is invalid and would throw a compile error.
-
-In other words, the `this` keyword is immutable to its field access operator `.`
-before all the member fields are properly initialized. The behavior is similar
-to JavaScript and TypeScript in their "strict" mode.
+field types, including the optional types must be initialized.
```TS
class Foo {
@@ -1749,23 +1397,20 @@ class Bar {
y: num;
z: Foo;
init() {
- // this.log() // is compile error here
this.y = 1;
- // this.log() // is also compile error here
this.z = new Foo();
this.log(); // OK to call here
}
public log() {
- log(this.y);
+ log("${this.y}");
}
}
let a = new Bar();
-a.log(); // logs 20.
+a.log(); // logs 1
```
-Overloading methods is allowed. This means functions can be overloaded with many
+Overloading methods is currently not allowed. This means functions cannot be overloaded with many
signatures only varying in the number of arguments and their unique type order.
-Overloading the constructor is also allowed.
Inheritance is allowed with the `extends` keyword. `super` can be used to access
the base class, immediately up the inheritance chain (parent class).
@@ -1785,15 +1430,11 @@ class Boo extends Foo {
super();
this.x = 10; // OK
}
- public override method() {
- // override implementation
- }
}
```
Classes can inherit and extend other classes using the `extends` keyword.
Classes can implement interfaces iff the interfaces do not contain `inflight`.
-You can use the keyword `final` to stop the inheritance chain.
```TS
class Foo {
@@ -1801,33 +1442,30 @@ class Foo {
init() { this.x = 0; }
public method() { }
}
-final class Boo extends Foo {
+class Boo extends Foo {
init() { super(); this.x = 10; }
- public override method() {
- // override implementation
- }
}
-// compile error
-// class FinalBoo extends Boo {}
-```
-By default all methods are virtual. But if you are about to override a method,
-you need to explicitly provide the keyword **override**.
-Static, private, and internal methods cannot be and are not virtual.
+```
Statics are not inherited. As a result, statics can be overridden mid hierarchy
chain. Access to statics is through the class name that originally defined it:
`.Foo`.
-Child class must not introduce additional signatures (overloads) for overridden
-(virtual) methods.
-
Multiple inheritance is invalid and forbidden.
Multiple implementations of various interfaces is allowed.
Multiple implementations of the same interface is invalid and forbidden.
In methods if return type is missing, `: void` is assumed.
+#### Roadmap
+
+The following features are not yet implemented, but we are planning to add them in the future:
+
+* Overloading class methods (including `init`) - see https://github.com/winglang/wing/issues/3123 to track.
+* Overriding class methods - see https://github.com/winglang/wing/issues/1124 to track.
+* Using the `final` keyword to stop the inheritance chain - see https://github.com/winglang/wing/issues/460 to track.
+
[`▲ top`][top]
---
@@ -1842,35 +1480,50 @@ For example:
```TS
// Wing Code:
class Foo {
- init() { /* initialize preflight fields */ } // preflight constructor
- inflight init() {} // optional client initializer
+ // preflight fields
+ field1: num;
+ field2: str;
+ field3: bool;
- // inflight members
- inflight foo(arg: num): num { return arg; }
- inflight boo(): num { return 32; }
+ // re-assignable class fields (preflight, in this case), read about them in the mutability section
+ var field4: num;
+ var field5: str;
// inflight fields
- inflight field1: num;
- inflight field2: str;
- inflight field3: bool;
-
- // preflight members
- foo(arg: num): num { return arg; }
- boo(): num { return 32; }
+ inflight field6: num;
+ inflight field7: str;
+ inflight field8: bool;
+
+ // preflight constructor
+ init(field1: num, field2: str, field3: bool, field4: num, field5: str) {
+ /* initialize preflight fields */
+ this.field1 = field1;
+ this.field2 = field2;
+ this.field3 = field3;
+ this.field4 = field4;
+ this.field5 = field5;
+ }
+
+ // inflight constructor
+ inflight init() {
+ /* initialize inflight fields */
+ this.field6 = 123;
+ this.field7 = "hello";
+ this.field8 = true;
+ }
- // preflight fields
- field4: num;
- field5: str;
- field6: bool;
+ // preflight methods
+ foo1(arg: num): num { return arg; }
+ boo1(): num { return 32; }
- // re-assignable class fields, read about them in the mutability section
- var field4: num;
- var field5: str;
+ // inflight methods
+ inflight foo2(arg: num): num { return arg; }
+ inflight boo2(): num { return 32; }
}
```
Preflight objects all have a scope and a unique ID. Compiler provides an implicit scope
-and ID for each object, both overrideable by user-defined ones in constructor.
+and ID for each object.
The default for scope is `this`, which means the scope in which the object was
defined (instantiated). The implicit ID is the type name of the class iff the type
@@ -1882,8 +1535,8 @@ Preflight objects instantiated at block scope root level of entrypoint are assig
root app as their default implicit scope.
Preflight object instantiation syntax uses the `let` keyword the same way variables are declared in
-Wing. The `as` and `in` keywords can be used to customize the scope and identifier assigned to this
-preflight object.
+Wing. The `as` and `in` keywords can be used to customize the identifier and scope assigned to this
+preflight object respectively.
```pre
let [: ] = new () [as ] [in ];
@@ -1891,12 +1544,11 @@ let [: ] = new () [as ] [in ];
```TS
// Wing Code:
-let a = Foo(); // with default scope and id
-let a = Foo() in scope; // with user-defined scope
+let a = new Foo(); // with default scope and id
+let a = new Foo() in scope; // with user-defined scope
let a = new Foo() as "custom-id" in scope; // with user-defined scope and id
let a = new Foo(...) as "custom-id2" in scope; // with constructor arguments
```
-
"id" must be of type string. It can also be a string literal with substitution
support (normal strings as well as shell strings).
"scope" must be an expression that resolves to a preflight object.
@@ -1905,12 +1557,11 @@ Preflight objects can be captured into inflight scopes and once that happens, in
the capture block only the inflight members are available.
Preflight classes can extend other preflight classes (but not [structs](#31-structs)) and implement
-[interfaces](#34-interfaces). If a class implements an interface marked `inflight interface`, then
-all of the implemented methods must be `inflight`.
+[interfaces](#34-interfaces).
-Declaration of fields of the same name with different phases is not allowed due to requirement of
-having inflight fields of same name being implicitly initialized by the compiler. But declaration
-of methods with different phases is allowed.
+Declaration of fields of the same name with different phases is not allowed due to the requirement of
+having inflight fields of same name being implicitly initialized by the compiler. Declaration
+of methods with different phases is not allowed as well.
[`▲ top`][top]
@@ -1920,12 +1571,13 @@ of methods with different phases is allowed.
Interfaces represent a contract that a class must fulfill.
Interfaces are defined with the `interface` keyword.
-Both preflight and inflight signatures are allowed.
-If the `inflight` modifier is used in the interface declaration, all methods will be automatically considered inflight methods. `impl` keyword is used to implement an interface or multiple interfaces that are
+Currently, preflight interfaces are allowed, while inflight interfaces are not supported yet (see https://github.com/winglang/wing/issues/1961).
+`impl` keyword is used to implement an interface or multiple interfaces that are
separated with commas.
All methods of an interface are implicitly public and cannot be of any other
type of visibility (private, protected, etc.).
+Return type is required for interface methods.
Interface fields are not supported.
@@ -1934,18 +1586,17 @@ Interface fields are not supported.
> interface IMyInterface1 {
> method1(x: num): str;
> inflight method3(): void;
-> };
+> }
>
-> inflight interface IMyInterface2 {
-> method2(): str; // <-- "inflight" is implied
-> };
+> interface IMyInterface2 {
+> method2(): str;
+> }
>
> class MyResource impl IMyInterface1, IMyInterface2 {
> field1: num;
> field2: str;
>
-> inflight init(x: num) {
-> // inflight client initialization
+> init(x: num) {
> this.field1 = x;
> this.field2 = "sample";
> }
@@ -1953,22 +1604,22 @@ Interface fields are not supported.
> return "sample: ${x}";
> }
> inflight method3(): void { }
-> inflight method2(): str {
+> method2(): str {
> return this.field2;
> }
-> };
+> }
> ```
Equivalent TypeScript Code
> ```TS
> interface IMyInterface1 {
-> public readonly field1: number;
-> public method1(x: number): string;
+> readonly field1: number;
+> method1(x: number): string;
> }
> interface IMyInterface2 {
-> public readonly __inflight__field2: string;
-> public __inflight__method2(): string;
+> readonly __inflight__field2: string;
+> __inflight__method2(): string;
> }
> // this is only shown as a hypothetical sample
> class MyResource extends constructs.Construct
@@ -2000,7 +1651,7 @@ Interface fields are not supported.
> Let let be let. (Elad B. 2022)
```pre
-let [: ] = ;
+let [var] [: ] = [] ;
```
Assignment operator is `=`.
@@ -2036,46 +1687,21 @@ However, it is possible to create anonymous closures and assign to variables
> ```TS
> // preflight closure:
-> let f1 = (a: num, b: num) => { log(a + b); }
+> let f1 = (a: num, b: num) => { log("${a + b}"); };
> // inflight closure:
-> let f2 = inflight (a: num, b: num) => { log(a + b); }
+> let f2 = inflight (a: num, b: num) => { log("${a + b}"); };
> // OR:
> // preflight closure:
-> let f4 = (a: num, b: num): void => { log(a + b); }
+> let f4 = (a: num, b: num): void => { log("${a + b}"); };
> // inflight closure:
-> let f5 = inflight (a: num, b: num): void => { log(a + b); }
-> ```
-
-[`▲ top`][top]
-
----
-
-#### 3.6.2 Promises
-
-Promises in Wing are defined with `Promise` syntax.
-All `inflight` functions implicitly wrap their return type in `Promise`.
-
-> ```TS
-> let schema = inflight (): Struct => {
-> return someCallForSchema();
-> }
-> ```
-
-Equivalent TypeScript Code
-
-> ```TS
-> const schema = async (): Promise => {
-> return await someCallForSchema();
-> }
+> let f5 = inflight (a: num, b: num): void => { log("${a + b}"); };
> ```
-
-Equivalent TypeScript Code
> ```TS
-> const arr1: number[] = Object.freeze([1, 2, 3]);
-> const arr2: string[] = Object.freeze(["a", "b", "c"]);
+> const arr1: readonly number[] = Object.freeze([1, 2, 3]);
+> const arr2: readonly string[] = Object.freeze(["a", "b", "c"]);
> const arr3: string[] = ["a1", "b2", "c3"];
> const l = arr1.length + arr2.length + arr3.length + arr1[0];
> ```
@@ -2157,17 +1770,16 @@ Arrays are similar to dynamically sized arrays or vectors in other languages.
Enumeration type (`enum`) is a type that groups a list of named constant members.
Enumeration is defined by writing **enum**, followed by enumeration name and a
-list of comma-separated constants in a {}. Last comma is optional in single line
-definitions but required in multi line definitions.
+list of comma-separated constants in a {}.
Naming convention for enums is to use "TitleCase" for name and ALL_CAPS for members.
> ```TS
-> enum SomeEnum { ONE, TWO, THREE };
+> enum SomeEnum { ONE, TWO, THREE }
> enum MyFoo {
> A,
> B,
> C,
-> };
+> }
> let x = MyFoo.B;
> let y = x; // type is MyFoo
> ```
@@ -2187,113 +1799,16 @@ Naming convention for enums is to use "TitleCase" for name and ALL_CAPS for memb
Equivalent TypeScript Code
-
-```TS
-interface Vec2 { x: number; y: number; }
-class Rect {
- size: Vec2;
- origin: Vec2;
- // computed property with a getter and setter block
- get center(): Vec2 {
- let centerX = origin.x + (size.width / 2);
- let centerY = origin.y + (size.height / 2);
- return Vec2(x: centerX, y: centerY);
- }
- set center(_new: Vec2) {
- origin.x = _new.x - (size.width / 2);
- origin.y = _new.y - (size.height / 2);
- }
-}
-```
-
-Equivalent TypeScript Code
@@ -2497,33 +1998,10 @@ Processing unicode escape sequences happens in these strings.
---
-#### 6.1.2 Shell strings \`...\`
-
-If string is enclosed with backticks, the contents of that string will be
-interpreted as a shell command and its output will be used as a string. `` `echo
-"Hello"` `` is equal to `"Hello"` for example.
-
-Shell strings are invalid in the bring expression.
-
-> ```TS
-> let name = `echo "World"`;
-> let s = "Hello, ${name}!";
-> ```
-
-Shell strings are executed in an instance of the BusyBox shell, compiled to run
-in WebAssembly to guarantee portability, in runtime. The stdout is returned as a
-string, interleaved with stderr. If BusyBox exits with a non-zero exit code, the
-stderr is thrown as an exception.
-
-[`▲ top`][top]
-
----
-
### 6.2 Comments
Single line comments start with a `//` and continue to the end of the line.
Multi-line comments are supported with the `/* ... */` syntax.
-Commenting in Wing has a style that's described earlier in this document.
> ```TS
> // comment
@@ -2632,7 +2110,7 @@ Using a `nil?` type is also ambiguous and results in a compile error.
```TS
let x: num? = 1;
-if x {
+if x? {
// ...
}
```
@@ -2670,99 +2148,11 @@ for immutable data (on top of nominal typing).
---
-### 6.4 Kitchen Sink
-
-This is an example with almost every feature of the Wing, showing you a whole
-picture of what the syntax feels like.
-
-```TS
-bring cloud;
-bring fs;
-
-struct DenyListRule {
- packageName: str;
- version: str?;
- reason: str;
-}
-
-struct DenyListProps {
- rules: MutArray[];
-}
-
-class DenyList {
- _bucket: cloud.Bucket;
- _objectKey: str;
-
- init(props: DenyListProps) {
- this._bucket = cloud.Bucket();
- this._objectKey = "deny-list.json";
-
- let rulesDir = this._writeToFile(props.rules, this._objectKey);
- this._bucket.upload("${rulesDir}/*/**", prune: true, retainOnDelete: true);
- }
-
- _writeToFile(list: MutArray[], filename: str): str {
- let tmpdir = fs.mkdtemp();
- let filepath = "${tmpdir}/${filename}";
- let map = MutMap{};
- for rule in list {
- let suffix = DenyList._maybeSuffix(rule.version);
- let path = "${rule.packageName}${suffix}";
- map[path] = rule;
- }
- fs.writeJson(filepath, map);
- return tmpdir;
- }
-
- inflight rules: MutMap{}?;
-
- inflight init() {
- // this._bucket is already initialized by the capture mechanic!
- this.rules = this._bucket.get(this._objectKey) ?? MutMap{};
- }
-
- public inflight lookup(name: str, version: str): DenyListRule? {
- return this.rules[name] ?? this.rules["${name}/v${version}"];
- }
-
- static _maybeSuffix(version: str?): str {
- if version {
- return "/v${version}";
- } else {
- return "";
- }
- }
-}
-
-let denyList = DenyList();
-let filterFn = inflight (event: cloud.QueueEvent) => {
- let packageName = event.data["packageName"];
- let version = event.data["version"];
- let reason = event.data["reason"];
- if denyList.lookup(packageName, version) {
- log("Package rejected: ${packageName}");
- } else {
- log("Package accepted: ${packageName}");
- }
-};
-
-queue = cloud.Queue();
-filter = cloud.Function(filterFn);
-queue.setConsumer(filter);
-```
-
-[`▲ top`][top]
-
----
-
-### 6.5 Roadmap
-
+### 6.4 Roadmap
- [ ] Asynchronous Execution Safety Model.
- [ ] Make the language `async` by default.
-- [x] Make inflight functions `async` by default.
-- [ ] First class support for `regx`, `glob`, and `cron` types.
+- [ ] First class support for `regex`, `glob`, and `cron` types.
- [ ] Support of math operations over `date` and `duration` types.
-- [x] Add `time`, `date`, and `durations` as first class types with syntax.
- [ ] More useful enums: Support for Enum Classes and Swift style enums.
- [ ] Reflection: add an extended `typeof` operator to get type information.
- [ ] Advanced OOP: Support for `abstract` and `private` implementations.
@@ -2774,28 +2164,24 @@ queue.setConsumer(filter);
- [ ] Distributed data structures.
[`▲ top`][top]
-
---
-### 6.6 Credits
+### 6.5 Credits
* **Contributors (A-Z):**
* Chris R. ([@Chriscbr](https://github.com/Chriscbr))
+ * Cristian P. ([@skyrpex](https://github.com/skyrpex))
* Elad B. ([@eladb](https://github.com/eladb))
* Eyal K. ([@ekeren](https://github.com/ekeren))
+ * Hasan AR. ([@hasanaburayyan](https://github.com/hasanaburayyan))
* Mark MC. ([@MarkMcCulloh](https://github.com/MarkMcCulloh))
+ * Pol A. ([@polamoros](https://github.com/polamoros))
+ * Revital B. ([@revitalbarletz](https://github.com/revitalbarletz))
* Sepehr L. ([@3p3r](https://github.com/3p3r))
+ * Shai A. ([@ainvoner](https://github.com/ainvoner))
* Shai B. ([@ShaiBer](https://github.com/ShaiBer))
+ * Tsuf C. ([@tsuf239](https://github.com/tsuf239))
* Uri B. ([@staycoolcall911](https://github.com/staycoolcall911))
* Yoav S. ([@yoav-steinberg](https://github.com/yoav-steinberg))
-Inspiration:
-
--
--
--
--
--
--
-
[top]: #0-preface
From d84db83e04e1f5fe573730e0b21571cb1cc709da Mon Sep 17 00:00:00 2001
From: monadabot <109207340+monadabot@users.noreply.github.com>
Date: Thu, 29 Jun 2023 14:53:30 -0400
Subject: [PATCH 3/4] feat(docs): update docs (#492)
feat(docs): update docs
Updates the Wing docs. See details in [workflow run].
[Workflow Run]: https://github.com/winglang/docsite/actions/runs/5415645872
------
*Automatically created via the "update-docs" workflow*
---
.../01-start-here/01-contributing-to-wing.md | 16 ++++++++--------
.../02-concepts/03-compile-targets.md | 4 ++--
.../03-language-guide/80-equality.md | 2 +-
3 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/contributing_versioned_docs/version-latest/01-start-here/01-contributing-to-wing.md b/contributing_versioned_docs/version-latest/01-start-here/01-contributing-to-wing.md
index 10d1073ed..a6a451568 100644
--- a/contributing_versioned_docs/version-latest/01-start-here/01-contributing-to-wing.md
+++ b/contributing_versioned_docs/version-latest/01-start-here/01-contributing-to-wing.md
@@ -11,14 +11,14 @@ to know to help out with the Wing project.
There are many ways to contribute to Wing:
* Reporting bugs through a [GitHub issue](https://github.com/winglang/wing/issues)
-* Writing [documentation and guides](https://github.com/winglang/wing/issues?q=is:issue+is:open+sort:updated-desc+label:documentation) or adding [examples](docs)
-* Setting up your [development environment](./development) and working on the code
-* Submitting [pull requests](./pull_requests) for new features or helping with [reviews](https://github.com/winglang/wing/pulls)
-* Picking up a [good first issue](https://github.com/winglang/wing/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+no%3Aassignee+sort%3Aupdated-desc+) to work on
-* Reporting and fixing [bugs](./bugs)
-* Contributing to the [Wing SDK (standard library)](./wingsdk)
-* Find solutions to common issues in our [troubleshooting guide](./troubleshooting)
-* Commenting on [RFCs](/category/rfcs) or submitting one for major features
+* Writing [documentation and guides](https://github.com/winglang/wing/issues?q=is:issue+is:open+sort:updated-desc+label:documentation) or adding [examples](/contributing/start-here/docs#%EF%B8%8F-how-do-i-add-an-example)
+* Setting up your [development environment](/contributing/start-here/development) and working on the code
+* Submitting [pull requests](/contributing/start-here/pull_requests) for new features or helping with [reviews](https://github.com/winglang/wing/pulls)
+* Picking up a [good first issue](https://github.com/winglang/wing/issues?q=is%3Aissue+is%3Aopen+label%3A%221%EF%B8%8F%E2%83%A3+good+first+issue%22+no%3Aassignee+sort%3Aupdated-desc) to work on
+* Reporting and fixing [bugs](/contributing/start-here/bugs)
+* Contributing to the [Wing SDK (standard library)](/contributing/start-here/wingsdk)
+* Find solutions to common issues in our [troubleshooting guide](/contributing/start-here/troubleshooting)
+* Commenting on [RFCs](/contributing/category/rfcs) or submitting one for major features
* Asking and answering questions in the [Wing Slack](https://t.winglang.io/slack)
* Posting or answering questions in [Wing Discussions](https://github.com/winglang/wing/discussions)
diff --git a/versioned_docs/version-latest/02-concepts/03-compile-targets.md b/versioned_docs/version-latest/02-concepts/03-compile-targets.md
index d93b41697..c61a05b96 100644
--- a/versioned_docs/version-latest/02-concepts/03-compile-targets.md
+++ b/versioned_docs/version-latest/02-concepts/03-compile-targets.md
@@ -33,7 +33,7 @@ These targets contain a combination of provisioning engine and cloud environment
## Portability
-Wing's [cloud library](docs/docs/04-standard-librarylibrary/01-cloud) has several classes representing abstracted cloud resources, whose APIs are not specific to a single cloud provider. This allows you to write code that can be deployed to any supported cloud environment or provisioning engine.
+Wing's [cloud library](/docs/standard-library/cloud/api-reference) has several classes representing abstracted cloud resources, whose APIs are not specific to a single cloud provider. This allows you to write code that can be deployed to any supported cloud environment or provisioning engine.
Here's an example of a portable code snippet:
@@ -44,7 +44,7 @@ let bucket = new cloud.Bucket();
```
Each resource needs a dedicated implementation to work on a given compiler target.
-A catalog of which resources are supported on each cloud can be found [here](docs/docs/04-standard-library/03-winglang-support-matrix).
+A catalog of which resources are supported on each cloud can be found [here](/docs/standard-library/compatibility-matrix).
### Provisioning engines
diff --git a/versioned_docs/version-latest/03-language-guide/80-equality.md b/versioned_docs/version-latest/03-language-guide/80-equality.md
index f413ac5ee..d8c87b8b5 100644
--- a/versioned_docs/version-latest/03-language-guide/80-equality.md
+++ b/versioned_docs/version-latest/03-language-guide/80-equality.md
@@ -11,7 +11,7 @@ Checking for equality is performed with the `==` operator. It returns `true` if
Equality in Wing is a symmetric and transitive relationship - that is, (1) if `a == b`, then `b == a`, and (2) if `a == b` and `b == c`, then `a == c`.
-The execution phase ([preflight or inflight](../02-core-concepts/01-preflight-and-inflight.md)) that a value was created in does not affect its equality. For example, a value created in preflight can be equal to a value created in inflight.
+The execution phase ([preflight or inflight](/docs/concepts/inflights)) that a value was created in does not affect its equality. For example, a value created in preflight can be equal to a value created in inflight.
Some types are compared *by value*, which means that two values are equal if their contents are equivalent. For example, two `str` values are equal if they have the same characters in the same order, even if they are stored in different places in memory.
From 01597e954fc3586dfd262a0c940e28245890ad54 Mon Sep 17 00:00:00 2001
From: monadabot <109207340+monadabot@users.noreply.github.com>
Date: Fri, 30 Jun 2023 02:03:40 -0400
Subject: [PATCH 4/4] feat(docs): update docs (#493)
feat(docs): update docs
Updates the Wing docs. See details in [workflow run].
[Workflow Run]: https://github.com/winglang/docsite/actions/runs/5419800086
------
*Automatically created via the "update-docs" workflow*
---
.../01-start-here/02-installation.md | 27 ++---------
.../01-start-here/04-run-locally.md | 43 +++++++----------
.../01-start-here/console-app.png | Bin 640569 -> 83515 bytes
.../01-start-here/console-bucket-1.png | Bin 685321 -> 97126 bytes
.../01-start-here/console-bucket-2.png | Bin 848565 -> 0 bytes
.../01-start-here/console-install.png | Bin 491500 -> 0 bytes
.../01-start-here/console-queue.png | Bin 669148 -> 97874 bytes
.../05-wing-console/01-installation.md | 6 ---
.../05-wing-console/02-navigation.md | 6 ---
.../05-wing-console/03-interacting.md | 6 ---
.../05-wing-console/04-testing.md | 6 ---
.../05-wing-console/05-logging.md | 6 ---
.../05-wing-console/_category_.yml | 3 --
.../06-tools/02-wing-console.md | 45 ++++++++++++++++++
.../06-tools/{02-plugins.md => 03-plugins.md} | 0
.../06-tools/console-demo-1.png | Bin 0 -> 298653 bytes
.../06-tools/console-explorer-1.png | Bin 0 -> 124228 bytes
.../06-tools/console-interaction-1.png | Bin 0 -> 237477 bytes
.../06-tools/console-logs-1.png | Bin 0 -> 146175 bytes
.../version-latest/06-tools/console-map-1.png | Bin 0 -> 64210 bytes
.../06-tools/console-tests-1.png | Bin 0 -> 352809 bytes
21 files changed, 67 insertions(+), 81 deletions(-)
delete mode 100644 versioned_docs/version-latest/01-start-here/console-bucket-2.png
delete mode 100644 versioned_docs/version-latest/01-start-here/console-install.png
delete mode 100644 versioned_docs/version-latest/05-wing-console/01-installation.md
delete mode 100644 versioned_docs/version-latest/05-wing-console/02-navigation.md
delete mode 100644 versioned_docs/version-latest/05-wing-console/03-interacting.md
delete mode 100644 versioned_docs/version-latest/05-wing-console/04-testing.md
delete mode 100644 versioned_docs/version-latest/05-wing-console/05-logging.md
delete mode 100644 versioned_docs/version-latest/05-wing-console/_category_.yml
create mode 100644 versioned_docs/version-latest/06-tools/02-wing-console.md
rename versioned_docs/version-latest/06-tools/{02-plugins.md => 03-plugins.md} (100%)
create mode 100644 versioned_docs/version-latest/06-tools/console-demo-1.png
create mode 100644 versioned_docs/version-latest/06-tools/console-explorer-1.png
create mode 100644 versioned_docs/version-latest/06-tools/console-interaction-1.png
create mode 100644 versioned_docs/version-latest/06-tools/console-logs-1.png
create mode 100644 versioned_docs/version-latest/06-tools/console-map-1.png
create mode 100644 versioned_docs/version-latest/06-tools/console-tests-1.png
diff --git a/versioned_docs/version-latest/01-start-here/02-installation.md b/versioned_docs/version-latest/01-start-here/02-installation.md
index bae25440d..3057edcc4 100644
--- a/versioned_docs/version-latest/01-start-here/02-installation.md
+++ b/versioned_docs/version-latest/01-start-here/02-installation.md
@@ -23,14 +23,14 @@ The toolchain includes three tools:
1. **Wing CLI** - the compiler toolchain
2. **Wing VSCode Extension** - IDE support for Wing
-3. **Wing Console** - a desktop app for interacting with your Wing programs.
+3. **Wing Console** - a web application for viewing and interacting with your Wing programs.
To install Wing, you will need the following setup:
* [Node.js](https://nodejs.org/en/) (v18 or later)
- * We recommend [volta](https://volta.sh) to manage node tools
+ * We recommend [volta](https://volta.sh) to manage node tools
* [VSCode]
- * Not required, but currently supported with an [extension](#wing-ide-extension)
+ * Not required, but currently supported with an [extension](#wing-ide-extension)
## Wing CLI
@@ -83,26 +83,9 @@ to use it, but it's great. It's available through the VSCode Marketplace [here](
## Wing Console
-:::caution Wing Console doesn't support Linux yet
-
-Click :thumbsup: on [this issue](https://github.com/winglang/wing/issues/723) to indicate that you
-are looking for Linux support.
-
-:::
-
-
-The Wing Console is a desktop application that allows you to interact with your
-Wing applications running locally on the cloud simulator.
-
-1. Download the latest version of the **Wing Console**:
- * [macOS](https://wing-console.s3.amazonaws.com/wing-console.dmg)
- * [macOS arm64](https://wing-console.s3.amazonaws.com/wing-console-arm64.dmg)
- * [Windows](https://wing-console.s3.amazonaws.com/wing-console.exe)
-2. Accept the license agreement.
-3. In macOS: drag the Wing Console app into **Applications**
-
-
+The Wing Console is a web application that provides a developer-friendly interface for viewing, exploring, and interacting with your Wing applications running on the local cloud simulator.
+The Wing Console is included as part of the Wing CLI package. There is no need to install it separately. Once the Wing CLI is successfully installed, you can directly access the Wing Console and begin utilizing its features.
[AWS account]: https://portal.aws.amazon.com/billing/signup
[AWS CLI]: https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html
diff --git a/versioned_docs/version-latest/01-start-here/04-run-locally.md b/versioned_docs/version-latest/01-start-here/04-run-locally.md
index f4fc02e27..dadecaa9d 100644
--- a/versioned_docs/version-latest/01-start-here/04-run-locally.md
+++ b/versioned_docs/version-latest/01-start-here/04-run-locally.md
@@ -4,8 +4,7 @@ id: local
keywords: [Wing Local, Wing testing, Wing Console installation, Wing Console usage, Wing Console setup]
---
-The Wing Console is a graphical user interface that can be used to interact with
-Wing applications on the local machine.
+The Wing Console is a web application that provides a developer-friendly interface that can be used to view, explore, and interact with Wing applications running on your local machine.
## Opening your app in the console
@@ -14,12 +13,9 @@ Wing applications on the local machine.
Make sure you have [installed](./installation#wing-console) the Wing Console on your system
before getting started with this step.
-If you are unable to install the Wing Console (e.g. you are running on Linux), you can
-also test your application against the [Wing simulator](../concepts/simulator) or [deploy it to AWS](./aws).
-
:::
-We can use the Wing CLI to start the console with our newly created Wing source file:
+Use the Wing CLI to start the console with our newly created Wing source file:
```sh
wing it hello.w
@@ -30,46 +26,41 @@ and load the application.
> The console will "hot reload" your app on each change in the source file parent directory.
-Wing Console desktop application will show the following view of you application:
+In your Wing Console you will see the following view of you application:
You are now able to run your IDE and the Wing Console side-by-side and watch how changes to your code update your application.
-## The console view
+## The Wing Console view
-In the main view you'll see two resources: a **Queue** and a **Function**.
-You'll also notice that the function is connected to the queue through the
-`message` event.
+In the console [map view](../tools/wing-console#view-and-explore-your-wing-application) you'll see three resources: a **Queue**, a **Function** and a **Bucket**.
+The Queue and the Bucket are connected through the Function resource, which serves as a message handler and is set as the consumer for the Queue.
-Once you click on the queue resource, the console will navigate into the queue
-resource. The inspector pane on the right will show information about your
-queue, as well as any relationships (in our case, an outbound relationship to
-the function that handles messages).
+Click on the Queue resource and pay attention to the right hand panel. This is the [resource interaction panel](../tools/wing-console#interact-with-your-wing-application).
-## Sending a message to the queue
+## Push a message to the Queue
-In the center you should be able to type in a message and send it to the queue.
-Type `Wing` and hit **Send Message**.
+On the right side interaction panel view, Type a message in the `Push Message` text area (let's say `Wing it`) and hit **Push** in order to push it to the queue.
-## Viewing the file
+## View the file in the Bucket
-On the left sidebar click on the Bucket, you will see the following view:
+Now, click on the Bucket in the Console map view. Notice that the interaction panel has changed and now shows the Bucket's interaction view.
-
+Check out the `wing.txt` file, click on it and see it's preview.
-Now, check the `wing.txt` file and download it, using the download button
+
-
+You can also download the file, using the **download** button.
-The downloaded file should contain `Hello, Wing` text
+The downloaded file should contain `Hello, Wing it` text (as you already saw in the preview).
## Congrats! :clap:
-You have just written and tested your first Wing program!
+You have just written and ran your first Wing program!
---
-Now, after you have tested your application, lets deploy it to AWS.
+Now, after you have made sure your application works, lets deploy it to AWS.
diff --git a/versioned_docs/version-latest/01-start-here/console-app.png b/versioned_docs/version-latest/01-start-here/console-app.png
index efa4c80a47fc5d721fab05e59c0ea8919058e4d3..bcf04f57d63c4460508c750f0b4238e3aada15a5 100644
GIT binary patch
literal 83515
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