#33: bump version for new release and update some documentation

Author: jaccomoc

build.gradle

@@ -23,7 +23,7 @@ plugins {
 }
 
 group   'io.jactl'
-version '2.0.1-SNAPSHOT'
+version '2.1.0'
 
 repositories {
     mavenCentral()
@@ -38,8 +38,8 @@ sourceSets {
 }
 
 dependencies {
-    implementation 'org.ow2.asm:asm:9.6'
-    implementation 'org.ow2.asm:asm-util:9.6'
+    implementation 'org.ow2.asm:asm:9.7.1'
+    implementation 'org.ow2.asm:asm-util:9.7.1'
     testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
     testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
 }

docs/README.md

@@ -74,6 +74,16 @@ switch (x) {
 }
 ```
 
+A simple quicksort:
+```groovy
+def qsort(x) {
+  switch (x) {
+    [],[_] -> x
+    [p,*t] -> qsort(t.filter{it <= p}) + p + qsort(t.filter{it > p})
+  }
+}
+```
+
 See [Language Features](https://jactl.io/language-features) for more language features and examples.
 
 ### Compiles to Java bytecode
@@ -160,7 +170,7 @@ features.
 ## Download
 
 To run command line scripts you only need the Jactl jar which can be downloaded from Maven Central:
-[https://repo1.maven.org/maven2/io/jactl/jactl/2.0.0/jactl-2.0.0.jar](https://repo1.maven.org/maven2/io/jactl/jactl/2.0.0/jactl-2.0.0.jar)
+[https://repo1.maven.org/maven2/io/jactl/jactl/2.1.0/jactl-2.1.0.jar](https://repo1.maven.org/maven2/io/jactl/jactl/2.1.0/jactl-2.1.0.jar)
 
 To download the Jactl REPL, which gives you an interactive shell for trying out Jactl code, see the
 [jactl-repl](https://github.com/jaccomoc/jactl-repl) project.
@@ -198,7 +208,7 @@ To use Jactl you will need to add a dependency on the Jactl library.
 
 In the `dependencies` section of your `build.gradle` file:
 ```groovy
-implementation group: 'io.jactl', name: 'jactl', version: '2.0.0'
+implementation group: 'io.jactl', name: 'jactl', version: '2.1.0'
 ```
 
 ### Maven
@@ -208,7 +218,7 @@ In the `dependencies` section of your `pom.xml`:
 <dependency>
  <groupId>io.jactl</groupId>
  <artifactId>jactl</artifactId>
- <version>2.0.0</version>
+ <version>2.1.0</version>
 </dependency>
 ```
 

docs/_config.yml

@@ -36,7 +36,7 @@ plugins:
   - jekyll-feed
 
 content:
-  jactl_version: 2.0.0
+  jactl_version: 2.1.0
 
 # Exclude from processing.
 # The following items will not be processed, by default.

docs/pages/faq.md

@@ -215,8 +215,11 @@ See the [Integration Guide](integration-guide.md) for more information.
 
 ### Is there an IntelliJ plugin for Jactl?
 
-At the moment, no, there is no plugin available but work is underway, so I hope to have
-a plugin available in the future.
+Yes, there is an IntelliJ plugin.
+It is in the process of being released into the Intellij marketplace for plugins and should be available from within
+IntelliJ shortly.
+
+The source code for the plugin can be found here: [Jactl IntelliJ Plugin](https://github.com/jaccomoc/jactl-intellij-plugin)
 
 ### How can I improve the runtime speed of my Jactl script?
 
@@ -231,7 +234,7 @@ To force the JVM to use hotspot compilation even on large methods add the `-XX:-
 command line flag to the `java` command.
 For example:
 ```bash
-java -XX:-DontCompileHugeMethods -jar jactl-2.0.0-jar
+java -XX:-DontCompileHugeMethods -jar jactl-2.1.0-jar
 ```
 
 ### Does Jactl provide any thread synchronisation mechanisms?

docs/pages/language-features.md

@@ -309,14 +309,25 @@ Jactl provides `switch` expressions that can match on literal values but can als
 match on the structure of the data and bind variables to different parts of the structure:
 ```groovy
 switch (x) {
-  /X=(\d+),Y=(\d+)/n ->  $1 + $2   // regex match with capture vars
-  [1,*]              -> 'matched'  // list whose first element is 1
-  [_,_]              -> 'matched'  // list with 2 elements
-  [int,String,_]     -> 'matched'  // 3 element list. 1st is an int, 2nd is a String
-  [a,_,a]            -> a * 2      // 1st and last elements the same in 3 element list
-  [a,*,a] if a < 10  -> a * 3      // list with at least 2 elements. 1st and last the same and < 10
-  [a,${2*a},${3*a}]  -> a          // match if list is of form [2,4,6] or [3,6,9] etc
-  [a,b,c,d]          -> a+b+c+d    // 4 element list
+  /X=(\d+),Y=(\d+)/n ->  $1 + $2     // regex match with capture vars
+  [1,*]              -> 'matched'    // list whose first element is 1
+  [_,_]              -> 'matched'    // list with 2 elements
+  [int,String,_]     -> 'matched'    // 3 element list. 1st is an int, 2nd is a String
+  [a,_,a]            -> a * 2        // 1st and last elements the same in 3 element list
+  [a,*,a] if a < 10  -> a * 3        // list with at least 2 elements. 1st and last the same and < 10
+  [a,${2*a},${3*a}]  -> a            // match if list is of form [2,4,6] or [3,6,9] etc
+  [a,b,c,d]          -> a+b+c+d      // 4 element list
+  ['abc',*mid,'xyz'] -> m.join(':')  // mid binds to list without first and last elements  
+}
+```
+
+Simple quicksort:
+```groovy
+def qsort(x) {
+  switch(x) {
+    []      -> x
+    [p, *t] -> qsort(t.filter{it <= p}) + p + qsort(t.filter{it > p}) 
+  }
 }
 ```
 

docs/pages/language-guide.md

@@ -4512,6 +4512,14 @@ switch(x) {
 }
 ```
 
+The `*` can appear only once but can appear anywhere in the list pattern (not just at the end):
+```groovy
+switch (x) {
+  [*,'abc']         -> 1
+  ['xyz',*,'abc',_] -> 2
+}
+```
+
 If you want to be able to specify the type of the wildcard you can use a type name instead of `_`:
 ```groovy
 switch(x) {
@@ -4536,6 +4544,14 @@ switch(x) {
 Note that for map literals, only the value can be bound to a binding variable.
 The keys themselves are literal values, not binding variables.
 
+You can bind a variable to the `*` part of a list pattern by specifying a name after the `*`:
+```groovy
+switch (x) {
+  [h,*t]   -> "First element is $h, rest of the list is $t"
+  [h,*m,t] -> "Middle of the list is $m" 
+}
+```
+
 Binding variables can occur multiple times but will only match if the value for the variable is the same in all places
 where it is used:
 ```groovy

src/main/java/io/jactl/runtime/RuntimeUtils.java

@@ -1256,6 +1256,7 @@ private static String keyAsString(Object obj) {
    * @param isDot        true if access type is '.' or '?.' (false for '[' or '?[')
    * @param isOptional   true if access type is '?.' or '?['
    * @param defaultValue default value to return if field does not exist
+   * @param captureStackTrace whether to capture stack trace for any NullError generated
    * @param source       source code
    * @param offset       offset into source for operation
    * @return the field value or the default value