Nasal-Interpreter/doc/namespace.md

Nasal Namespace

Introduction

In this nasal interpreter, we use this way below to construct namespaces:

• library is linked directly with the script
• module is wraped by a function generated by linker, and return a hash

Library

Library file is linked with script file directly, like this:

In std/lib.nas:

var a = 1;

In example.nas:

var b = 1;

At the link stage, in fact we put the ast of two files together to make a new ast, so the result is equal to:

var a = 1;
var b = 1;

Module

Modules is wraped up by a function, and return a hash, for example:

In std/example_module.nas:

var a = 1;

We analysed this file and generated the ast. Then we find all the global symbols. At last we use the information of all the globals symbols in this file to generate a hash to return.

So the result is equal to:

var example_module = func {
    # source code begin
    var a = 1;
    # source code end
    return {
        a: a
    };
}();