PSE - Protected Script Environment

[Je06 0]

The PSE will run any code you give it and will run it in it's own sandbox environment. What this means is that code will run with absolutely no functions or variables except for what you give it.

This means, unless you say so, the PSE will run code without any of the lua standard functions. However, any code the PSE runs cannot affect anything other than the functions and variables you give it.

 

I named my function by putting an underscore in between words, however, I also provided functions named in camel case that do the same thing. For example: new_sandbox() and newSandbox() do the same thing.

 

Functions

new_sandbox()

    Returns a sandbox that is ready to run your code in

debug_sandbox(sandbox)

    Will print some debug data to the screen

add_code(sandbox, name, code)

    Will add code the the sandbox using name as the index

    Returns the modified sandbox

add_argument(sandbox, argument)

    Adds the argument to the sandbox as a command line argument

    Returns the modified sandbox

add_file(sandbox, name, path)

    Will add whatever the file at path returns when it runs to the sandbox using name as the index

    Returns the modified sandbox

add_global(sandbox, name)

    Adds any global functions or variables with the index of name to the sandbox using name as the index

    Returns the modified sandbox

run_string(sandbox, name, data)

    Will run data as name in the sandbox

    Returns false,reason if the code failed to run

    Returns what the code returns

run(sandbox, name, path)

    Will run the file at path as name in the sandbox

    Returns false,reason if the code failed to run

    Returns what the code returns

 

Example

local sandbox = pse.new_sandbox()

sandbox = pse.add_global(sandbox,"print")

sandbox = pse.add_file(sandbox,"my_lib","/path_to_lib/my_lib.lua")

pse.run_string(sandbox,"my_code","my_lib:add_2_to_2()")

Download

pastebin get 3bt1LuFW pse.lua