first commit

Author: marianopeck

.gitattributes

@@ -0,0 +1,6 @@
+# inform linguist that files with these extensions are indeed smalltalk files
+*.st text eol=crlf linguist-language=Smalltalk
+*.project text eol=crlf
+*.properties text eol=crlf
+*.configmaps text eol=crlf
+*.dat binary

.project

@@ -0,0 +1,3 @@
+{
+#srcDirectory : 'source'
+}

README.md

@@ -1,2 +1,49 @@
-# CSS2022-async-demo-vast
-Camp Smalltalk Supreme 2022 Async Demos
+
+<p align="center">
+<!---<img src="assets/logos/128x128.png">-->
+ <h1 align="center">Camp Smalltalk Supreme 2022 Async Demos</h1>
+  <p align="center">
+    Camp Smalltalk Supreme 2022 Async Demos
+    <!---
+    <br>
+    <a href="docs/"><strong>Explore the docs »</strong></a>
+    <br>
+    -->
+    <br>
+    <a href="https://github.com/instantiations/CSS2022-async-demo-vast/issues/new?labels=Type%3A+Defect">Report a defect</a>
+    |
+    <a href="https://github.com/instantiations/CSS2022-async-demo-vast/issues/new?labels=Type%3A+Feature">Request feature</a>
+  </p>
+</p>
+
+Material used for the [Intro to Asynchronous Programming with VAST](https://campsmalltalksupreme.wordpress.com/2020/06/28/daily-events/) presentation at the [Camp Smalltalk Supreme 2022](https://campsmalltalksupreme.wordpress.com/) conference.
+
+## License
+- The code is licensed under [MIT](LICENSE).
+- The documentation is licensed under [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/).
+
+
+## Installation
+
+1. Install [VA Smalltalk 11.0.0 or newer](https://www.instantiations.com/products/vasmalltalk/download.html).
+2. Install Tonel support in your development image following [this guide](https://github.com/vasmalltalk/tonel-vast#installation).
+3. Clone this repository.
+4. The easiest and recommended approach is to install it via a script:
+
+```smalltalk
+| loader path |
+path := (CfsPath named: '<insert path to root CSS2022-async-demo-vast local repo here>').
+loader := TonelLoader readFromPath: path.
+loader
+	beUnattended; "do not prompt and use all defaults"
+	useGitVersion.
+loader loadAllMapsWithRequiredMaps.
+```
+
+Or you can load the Configuration Map `CSS 2022 - Async Demos` from the context menu of the Configuration Maps Browser: `"Import"` -> `"Load Configuration Maps from Tonel repository..."` -> select path to root `CSS2022-async-demo-vast` local repo. This will open a dialog and will use convenient defaults for the load. Refer to [its documentation](https://github.com/instantiations/tonel-vast#using-gui-menus) for more details.
+
+
+
+## Demos
+
+All presented demos are in written as methods of the class `CampSmalltalkSupreme2022Examples`. We recoomend to first do Futures, then Promises, then Zones and finally Streams.

scripts/tonel-export.st

@@ -0,0 +1,7 @@
+| writer path |
+path := (CfsPath named: '<insert path to root CSS2022-async-demo-vast local repo here>').
+writer := TonelWriter new.
+writer
+	addLatestConfigurationMapNamed: 'CSS 2022 - Async Demos';
+	addApplicationsFromConfigurationMaps.
+writer writeProjectInto: path.

scripts/tonel-import.st

@@ -0,0 +1,7 @@
+| loader path |
+path := (CfsPath named: '<insert path to root CSS2022-async-demo-vast local repo here>').
+loader := TonelLoader readFromPath: path.
+loader
+	beUnattended;
+	useGitVersion.
+loader loadAllMapsWithRequiredMaps.

source/.configmaps

@@ -0,0 +1,17 @@
+[
+	{
+		#conditions : [ ],
+		#ts : 3832764876,
+		#comment : '',
+		#formatVersion : '1.1',
+		#applications : OrderedCollection [
+			{
+				#name : 'CampSmalltalkSupreme2022ExamplesApp',
+				#versionName : '1.0',
+				#ts : 3832759021
+			}
+		],
+		#name : 'CSS 2022 - Async Demos',
+		#versionName : '1.0'
+	}
+]

source/.properties

@@ -0,0 +1,4 @@
+{
+#format : 'tonel',
+#formatVersion: '1.1'
+}