aviatorscript

AviatorScript

English Documentation | Chinese Documentation

---

AviatorScript is a high-performance, lightweight scripting language hosted on the JVM (including the Android platform).

It's not a game, it's a programming language. Please refrain from sending me any more unsolicited emails.RTFM

Feature introduction

1. It supports basic types such as numbers, strings, regular expressions, Boolean values, and regular expressions, and fully supports all Java operators and priorities.
2. Functions are first-class citizens, supporting closures and functional programming.
3. The built-in bigint/decimal types are used for large integer and high-precision operations. Operator overloading is supported to allow these types to use ordinary arithmetic operators +-*/ to participate in operations.
4. Complete script syntax support, including multi-line data, conditional statements, loop statements, lexical scope and exception handling, etc.
5. Functional programming combined with Sequence abstraction makes it easy to handle any collection.
6. Lightweight module system.
7. Multiple ways to conveniently call Java methods, fully supporting Java script API (convenient to call scripts from Java).
8. Rich customization options, available as a safe language sandbox and as a full-featured language.
9. Dynamic compilation and execution, lightweight, high performance, by directly compiling scripts into JVM bytecode in ASM mode, the interpreted mode can run on non-standard Java platforms such as Android.
10. Supports serialization of compilation results to facilitate cache acceleration, etc. Supports execution timeout settings to avoid destructive scripts from running out of resources.

Usage scenarios include:

1. Rule judgment and rule engine
2. Formula calculation
3. Dynamic script control
4. Collection data ELT etc...

It is recommended to use version 5.2.6 and above

News

• 5.4.3, add one-click activation method of security sandbox and fix bugs, etc.
• 5.4.2, add the getFunctionNames method to obtain the function list and set the evaluation timeout, etc.
• 5.4.1, fix the bug that the recursive function cannot work, fix the bug that the function cannot be serialized, etc.

Dependency

< dependency >
  < groupId >com.googlecode.aviator</ groupId >
  < artifactId >aviator</ artifactId >
  < version >{version}</ version >
</ dependency >

Available versions can be viewed at search.maven.org.

quick start

1. Download the aviator shell to a directory (preferably within the system's PATH environment variable), such as ~/bin/aviator :

$ wget https://raw.githubusercontent.com/killme2008/aviator/master/bin/aviator
$ chmod u+x aviator

2. Executing the aviator command will automatically download the latest document version aviator jar to the installation directory under ~/.aviatorscript and run:

$ aviator
Downloading AviatorScript now...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   153  100   153    0     0    111      0  0:00:01  0:00:01 --:--:--   111
100 1373k  100 1373k    0     0   689k      0  0:00:01  0:00:01 --:--:--  689k
Usage: java com.googlecode.aviator.Main [file] [args]
     : java com.googlecode.aviator.Main -e [script]
     : java com.googlecode.aviator.Main -v

3. Save the following script as the file hello.av :

 p ( "Hello, AviatorScript!" ) ;

let a = tuple ( 1 , 2 , 3 , 4 , 5 ) ;

p ( "sum of a is: " + reduce ( a , + , 0 ) ) ;

let date = new java . util . Date ( ) ;
p ( "The year is: " + getYear ( date ) ) ;
p ( "The month is: #{getMonth(date)}" ) ;

For an example of a more complex calculator (evaluating a string of arithmetic expressions) see calculator.av.

4. Execute the script:

$ aviator hello.av
Hello, AviatorScript !
sum of a is: 15
The year is: 120
The month is: 3

Please read the user guide for more details.

Links

• Releases: https://github.com/killme2008/aviator/releases
• Documents: https://www.yuque.com/boyan-avfmj/aviatorscript
• Changelog: https://www.yuque.com/boyan-avfmj/aviatorscript/bggwx2
• Javadoc: http://fnil.net/aviator/apidocs/
• Spring boot rule: https://github.com/mengxiangrui007/spring-boot-rule-jsr94
• Idea plugin: https://github.com/yanchangyou/aviatorscript-ideaplugin