API

@RuntimeGeneratedFunction(function_expression)
@RuntimeGeneratedFunction(context_module, function_expression, opaque_closures=true)

RuntimeGeneratedFunction(cache_module, context_module, function_expression; opaque_closures=true)

Construct a function from function_expression which can be called immediately without world age problems. Somewhat like using eval(function_expression) and then calling the resulting function. The differences are:

• The result can be called immediately (immune to world age errors)
• The result is not a named generic function, and doesn't participate in generic function dispatch; it's more like a callable method.

You need to use RuntimeGeneratedFunctions.init(your_module) a single time at the top level of your_module before any other uses of the macro.

If provided, context_module is the module in which symbols within function_expression will be looked up. By default, this is the module in which @RuntimeGeneratedFunction is expanded.

cache_module is the module where the expression code will be cached. If RuntimeGeneratedFunction is used during precompilation, this must be a module which is currently being precompiled. Normally this would be set to @__MODULE__ using one of the macro constructors.

If opaque_closures is true, all closures in function_expression are converted to opaque closures. This allows for the use of closures and generators inside the generated function, but may not work in all cases due to slightly different semantics.

Examples

RuntimeGeneratedFunctions.init(@__MODULE__) # Required at module top-level

function foo()
    expression = :((x,y)->x+y+1) # May be generated dynamically
    f = @RuntimeGeneratedFunction(expression)
    f(1,2) # May be called immediately
end

RuntimeGeneratedFunctions.init(mod)

Use this at top level to set up your module mod before using @RuntimeGeneratedFunction.

@RuntimeGeneratedFunction(function_expression)
@RuntimeGeneratedFunction(context_module, function_expression, opaque_closures=true)

RuntimeGeneratedFunction(cache_module, context_module, function_expression; opaque_closures=true)

Construct a function from function_expression which can be called immediately without world age problems. Somewhat like using eval(function_expression) and then calling the resulting function. The differences are:

• The result can be called immediately (immune to world age errors)
• The result is not a named generic function, and doesn't participate in generic function dispatch; it's more like a callable method.

You need to use RuntimeGeneratedFunctions.init(your_module) a single time at the top level of your_module before any other uses of the macro.

If provided, context_module is the module in which symbols within function_expression will be looked up. By default, this is the module in which @RuntimeGeneratedFunction is expanded.

cache_module is the module where the expression code will be cached. If RuntimeGeneratedFunction is used during precompilation, this must be a module which is currently being precompiled. Normally this would be set to @__MODULE__ using one of the macro constructors.

If opaque_closures is true, all closures in function_expression are converted to opaque closures. This allows for the use of closures and generators inside the generated function, but may not work in all cases due to slightly different semantics.

Examples

RuntimeGeneratedFunctions.init(@__MODULE__) # Required at module top-level

function foo()
    expression = :((x,y)->x+y+1) # May be generated dynamically
    f = @RuntimeGeneratedFunction(expression)
    f(1,2) # May be called immediately
end