Metadata-Version: 2.1
Name: scriptable
Version: 0.1.1
Summary: Scriptable is a sand-boxed scripting engine which can be used safely in an embedded environment.
Home-page: https://github.com/c7nw3r/scriptable
Author: x-and-y
Author-email: christian.weber@leftshift.one
License: Apache Software License
Download-URL: https://github.com/c7nw3r/scriptable/archive/refs/tags/v0.1.1.tar.gz
Keywords: scripting-engine
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Interpreters
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt

Scriptable is a sand-boxed scripting engine which can be used safely in an embedded environment.

Its canonical abstract syntax tree model is designed to support various syntax forms.
At the moment only the typescript syntax is supported.

The scripting engine forbids endless loops and has a recursion guard, which detects loops in
a function call stack. In addition to that scriptable allows to define more detailed AST
restrictions. At the moment following restrictions are supported:

 * max_precision # The max allowed number of digits in a number. 
 * max_scale     # The max allowed digits to the right of the decimal point in a number.
 * max_loops     # The max allowed number of loop iterations.

**Usage**

```typescript
engine = TypescriptEngine.parse("""
   function fibonacci(n:number) {
      if (n == 0) return 0
      if (n == 1) return 1
      if (n == 2) return 1
      return fibonacci(n - 1) + fibonacci(n - 2)
   }
   
   fibonacci(8) // returns 21
""")
    
engine.execute()
```

