Scriptling Scriptling

Embedding

Get up and running with Scriptling as an embedded scripting language in your Go application.

Installation

go get github.com/paularlott/scriptling

Hello World

package main

import (
    "fmt"
    "github.com/paularlott/scriptling"
    "github.com/paularlott/scriptling/stdlib"
)

func main() {
    // Create interpreter
    p := scriptling.New()

    // Register standard libraries
    stdlib.RegisterAll(p)

    // Execute Scriptling code
    result, err := p.Eval(`
print("Hello, World!")
`)
    if err != nil {
        fmt.Println("Error:", err)
    }
}

Variables and Functions

p := scriptling.New()
stdlib.RegisterAll(p)

result, err := p.Eval(`
# Variables
x = 42
name = "Alice"
numbers = [1, 2, 3]

# Functions
def greet(n):
    return "Hello " + n

# Output
print(greet(name))
print("Sum:", x + len(numbers))
`)

Variable Exchange

Pass data between Go and Scriptling:

// Set variables from Go
p.SetVar("api_base", "https://api.example.com")
p.SetVar("timeout", 30)

// Execute script
p.Eval(`
response = requests.get(api_base + "/users", {"timeout": timeout})
data = json.loads(response.body)
result = len(data)
`)

// Get variables back
count, _ := p.GetVarAsInt("result")
fmt.Printf("Found %d users\n", count)

Registering Libraries

Standard libraries are registered with a single call:

import (
    "github.com/paularlott/scriptling/stdlib"
    "github.com/paularlott/scriptling/extlibs"
)

// Register all standard libraries (json, math, re, time, etc.)
stdlib.RegisterAll(p)

// Register extended libraries as needed
p.RegisterLibrary(extlibs.RequestsLibrary)         // HTTP client
extlibs.RegisterOSLibrary(p, []string{"/tmp"})      // File access (restricted)

See the Go Integration guide for the full library registration reference.

Next Steps