Runtime Library

Background tasks and async execution for HTTP servers.

Available Functions

Setup

import "github.com/paularlott/scriptling/extlibs"

// Register only the core runtime library (background function)
extlibs.RegisterRuntimeLibrary(p)

// Optionally register sub-libraries individually
extlibs.RegisterRuntimeHTTPLibrary(p)   // HTTP routes and responses
extlibs.RegisterRuntimeKVLibrary(p)     // Key-value store
extlibs.RegisterRuntimeSyncLibrary(p)   // Concurrency primitives

// Or register everything at once (core + all sub-libraries)
extlibs.RegisterRuntimeLibraryAll(p)

Functions

scriptling.runtime.background(name, handler)

Register a background task.

Parameters:

• name (string): Unique name for the task (used in logs and error messages)
• handler (string): Handler function as “library.function”

Background tasks run in separate goroutines alongside the HTTP server. The name is used to identify the task in server logs.

scriptling.runtime.run(func, *args, **kwargs)

Run function asynchronously within the current environment.

Parameters:

• func: Function to execute
• *args: Positional arguments
• **kwargs: Keyword arguments

Returns: Promise object with methods:

• get(): Wait for and return the result
• wait(): Wait for completion and discard the result

Sub-Libraries

• scriptling.runtime.http - HTTP route registration and response helpers
• scriptling.runtime.kv - Thread-safe key-value store
• scriptling.runtime.sync - Named cross-environment concurrency primitives

Examples

Background Task

# setup.py
import scriptling.runtime as runtime

runtime.http.get("/counter", "handlers.get_counter")
runtime.background("counter_task", "tasks.increment_counter")

# tasks.py
import scriptling.runtime as runtime
import time

def increment_counter():
    counter = runtime.sync.Atomic("request_counter", 0)
    while True:
        counter.add(1)
        print(f"Counter: {counter.get()}")
        time.sleep(1)

Async Execution

import scriptling.runtime as runtime

def worker(x, y):
    return x + y

promise = runtime.run(worker, 5, 10)
result = promise.get()  # Returns 15

Notes

• Background tasks run in isolated environments
• Use named sync primitives to share state between tasks and handlers
• Background tasks start automatically when the server starts