API entry point. More...

Public Member Functions
	Manager ()
	A Manager object is responsible for memory management, type evaluation and loading of plugins.
void	LoadComponents (string relativeDirectoryPath)
void	LoadComponent (string relativeDirectoryPath)
bool	IsRegistered (string routine)
void	Register (Model model)
void	UnRegister (Model model)
void	Register (Routine routine, Host host)
void	UnRegister (string routine)
void	Register (Routine routine)
	Register a new Routine.
void	ClearActiveLocks ()
void	UnloadPlugins ()
	Unload all plugins that were loaded via LoadComponents (subdirectory mode). This will deregister their routines and unload their ALCs (collectible).

Properties
Func< List< string >, Lexer >	LexerFactory = lines => new Lexer(lines) `[get, set]`
String	Name `[get, set]`
Scanner	Scanner `[get, set]`
	A Scanner reference.
Memory	SharedMemory `[get]`
ReadOnlyDictionary< String, Routine >	Routines `[get]`
bool	Debug `[get, set]`
bool	Optimize `[get, set]`
ReadOnlyDictionary< object, Interpreter >	ActiveLocks `[get]`

Private Attributes
string	name
Scanner	scanner
Memory	sharedMemory
Dictionary< string, Routine >	routines
Dictionary< object, Interpreter >	locks
bool	debug
bool	optimize
List< Plugin >	loadedPlugins = new List<Plugin>()

Detailed Description

API entry point.

Definition at line 20 of file Manager.cs.

Constructor & Destructor Documentation

◆ Manager()

ScriptStack.Manager.Manager ( )

A Manager object is responsible for memory management, type evaluation and loading of plugins.

Definition at line 52 of file Manager.cs.

        {
 
            scanner = new ScannerPrototype();
 
            sharedMemory = Memory.AllocateSharedMemory();
 
            routines = new Dictionary<string, Routine>();
 
            locks = new Dictionary<object, Interpreter>();
 
            debug = false;
 
            optimize = true;
 
            loadedPlugins = new List<Plugin>();
 
        }

References ScriptStack.Runtime.Memory.AllocateSharedMemory(), debug, loadedPlugins, locks, optimize, routines, scanner, and sharedMemory.

Member Function Documentation

◆ ClearActiveLocks()

void ScriptStack.Manager.ClearActiveLocks ( )

Definition at line 234 of file Manager.cs.

        {
            locks.Clear();
        }

References locks.

◆ IsRegistered()

bool ScriptStack.Manager.IsRegistered ( string routine )

Definition at line 180 of file Manager.cs.

        {
            return routines.ContainsKey(routine);
        }

References routines.

◆ LoadComponent()

void ScriptStack.Manager.LoadComponent ( string relativeDirectoryPath )

Definition at line 138 of file Manager.cs.

        {
 
            Assembly assembly = null;
            try
            {
                assembly = Assembly.LoadFile(relativeDirectoryPath);
            }
            catch (Exception e) { }
 
            Type[] arrayTypes = assembly.GetExportedTypes();
 
            foreach (Type type in arrayTypes)
            {
 
                if (!typeof(Model).IsAssignableFrom(type))
                    continue;
 
                ConstructorInfo constructorInfo = null;
                try
                {
                    constructorInfo = type.GetConstructor(new Type[0]);
                }
                catch (Exception e) { continue; }
 
                object objectHostModule = constructorInfo.Invoke(new object[0]);
                Model hostModule = (Model)objectHostModule;
 
                Register(hostModule);
 
            }
 
        }

References Register().

◆ LoadComponents()

void ScriptStack.Manager.LoadComponents ( string relativeDirectoryPath )

Definition at line 73 of file Manager.cs.

        {
 
            string path = relativeDirectoryPath; // System.AppDomain.CurrentDomain.BaseDirectory;
 
            if (!Directory.Exists(path))
                return;
 
            var subdirs = Directory.GetDirectories(path);
            if (subdirs.Length > 0)
            {
                var shared = new[] { Assembly.GetExecutingAssembly().GetName().Name! };
                var loaded = ScriptStack.Plugins.PluginLoader.LoadPlugins(path, this, shared);
                this.loadedPlugins = loaded;
                return;
            }
 
 
            foreach (string dll in System.IO.Directory.GetFiles(path, "*.dll"))
            {
 
                if (dll == path + "ScriptStack.dll")
                    continue;
 
                Assembly assembly = null;
 
                try
                {
                    assembly = Assembly.LoadFile(dll);
                }
                catch (Exception e) { 
                    Console.WriteLine($"[LoadComponents] Fehler beim Laden '{dll}': {e.Message}");
 
                    if (e is TargetInvocationException tie && tie.InnerException != null)
                        Console.WriteLine("INNER: " + tie.InnerException);
 
                    continue; 
                }
 
                Type[] arrayTypes = assembly.GetExportedTypes();
 
                foreach (Type type in arrayTypes)
                {
 
                    if (!typeof(Model).IsAssignableFrom(type))
                        continue;
 
                    ConstructorInfo constructorInfo = null;
                    try
                    {
                        constructorInfo = type.GetConstructor(new Type[0]);
                    }
                    catch (Exception e) { continue; }
 
                    object objectHostModule = constructorInfo.Invoke(new object[0]);
                    Model hostModule = (Model)objectHostModule;
 
                    Register(hostModule);
 
                }
 
            }
 
        }

References ScriptStack.Plugins.PluginLoader.LoadPlugins(), and Register().

◆ Register() [1/3]

void ScriptStack.Manager.Register ( Model model )

Definition at line 185 of file Manager.cs.

        {
 
            foreach (Routine routine in model.Routines)
                Register(routine, model);
 
        }

References Register().

Referenced by LoadComponent(), LoadComponents(), Register(), and Register().

◆ Register() [2/3]

void ScriptStack.Manager.Register ( Routine routine )

Register a new Routine.

Parameters

routine

Definition at line 229 of file Manager.cs.

        {
            Register(routine, null);
        }

References Register().

◆ Register() [3/3]

void ScriptStack.Manager.Register	(	Routine	routine,
		Host	host )

Definition at line 201 of file Manager.cs.

        {
 
            string name = routine.Name;
 
            if (routines.ContainsKey(name))
                throw new ScriptStackException("Die Routine '" + name + "' ist bereits registriert.");
 
            routine.Handler = host;
 
            routines[name] = routine;
 
        }

References ScriptStack.Runtime.Routine.Name, name, and routines.

◆ UnloadPlugins()

void ScriptStack.Manager.UnloadPlugins ( )

Unload all plugins that were loaded via LoadComponents (subdirectory mode). This will deregister their routines and unload their ALCs (collectible).

Definition at line 243 of file Manager.cs.

        {
            if (loadedPlugins == null || loadedPlugins.Count == 0)
                return;
 
            // Deregister routines
            foreach (var plugin in loadedPlugins)
            {
                try
                {
                    if (plugin?.Instance is Model model)
                    {
                        foreach (var r in model.Routines)
                        {
                            if (r != null && routines.ContainsKey(r.Name))
                                routines.Remove(r.Name);
                        }
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"[UnloadPlugins] Fehler beim Deregistrieren: {ex.Message}");
                }
            }
 
            // Unload contexts
            foreach (var plugin in loadedPlugins)
            {
                try
                {
                    plugin.LoadContext?.Unload();
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"[UnloadPlugins] Fehler beim Unload: {ex.Message}");
                }
            }
 
            loadedPlugins.Clear();
            
            GC.Collect();
            GC.WaitForPendingFinalizers();
            GC.Collect();
 
        }

References loadedPlugins, and routines.

◆ UnRegister() [1/2]

void ScriptStack.Manager.UnRegister ( Model model )

Definition at line 193 of file Manager.cs.

        {
 
            foreach (Routine routine in model.Routines)
                UnRegister(routine.Name);
 
        }

References ScriptStack.Runtime.Routine.Name, and UnRegister().

Referenced by UnRegister().

◆ UnRegister() [2/2]

void ScriptStack.Manager.UnRegister ( string routine )

Definition at line 215 of file Manager.cs.

        {
 
            if (!routines.ContainsKey(routine))
                throw new ScriptStackException("Die Routine '" + routine + "' wurde nicht gefunden.");
 
            routines.Remove(routine);
 
        }

References routines.

Member Data Documentation

◆ debug

bool ScriptStack.Manager.debug

private

Definition at line 30 of file Manager.cs.

Referenced by Manager().

◆ loadedPlugins

List<Plugin> ScriptStack.Manager.loadedPlugins = new List<Plugin>()

private

Definition at line 34 of file Manager.cs.

Referenced by Manager(), and UnloadPlugins().

◆ locks

Dictionary<object, Interpreter> ScriptStack.Manager.locks

private

Definition at line 29 of file Manager.cs.

Referenced by ClearActiveLocks(), and Manager().

◆ name

string ScriptStack.Manager.name

private

Definition at line 25 of file Manager.cs.

Referenced by Register().

◆ optimize

bool ScriptStack.Manager.optimize

private

Definition at line 31 of file Manager.cs.

Referenced by Manager().

◆ routines

Dictionary<string, Routine> ScriptStack.Manager.routines

private

Definition at line 28 of file Manager.cs.

Referenced by IsRegistered(), Manager(), Register(), UnloadPlugins(), and UnRegister().

◆ scanner

Scanner ScriptStack.Manager.scanner

private

Definition at line 26 of file Manager.cs.

Referenced by Manager().

◆ sharedMemory

Memory ScriptStack.Manager.sharedMemory

private

Definition at line 27 of file Manager.cs.

Referenced by Manager().

Property Documentation

◆ ActiveLocks

ReadOnlyDictionary<object, Interpreter> ScriptStack.Manager.ActiveLocks

get

Definition at line 326 of file Manager.cs.

        {
            get { return new ReadOnlyDictionary<object,Interpreter>(locks); }
        }

◆ Debug

bool ScriptStack.Manager.Debug

getset

Definition at line 314 of file Manager.cs.

        {
            get { return debug; }
            set { debug = value; }
        }

Referenced by ScriptStack.Runtime.Script.Script(), and ScriptStack.Runtime.Script.Script().

◆ LexerFactory

Func<List<string>, Lexer> ScriptStack.Manager.LexerFactory = lines => new Lexer(lines)

getset

Definition at line 71 of file Manager.cs.

71{ get; set; } = lines => new Lexer(lines);

◆ Name

String ScriptStack.Manager.Name

getset

Definition at line 172 of file Manager.cs.

        {
            get { return name; }
            set {
                name = value;
            }
        }

◆ Optimize

bool ScriptStack.Manager.Optimize

getset

Definition at line 320 of file Manager.cs.

        {
            get { return optimize; }
            set { optimize = value; }
        }

Referenced by ScriptStack.Runtime.Script.Script(), and ScriptStack.Runtime.Script.Script().

◆ Routines

ReadOnlyDictionary<String, Routine> ScriptStack.Manager.Routines

get

Definition at line 307 of file Manager.cs.

                                                            {
            get
            {
                return new ReadOnlyDictionary<string, Routine>(routines);
            }
        }

Referenced by ScriptStack.Compiler.Parser.RoutineCall().

◆ Scanner

Scanner ScriptStack.Manager.Scanner

getset

A Scanner reference.

Definition at line 296 of file Manager.cs.

        {
            get { return scanner; }
            set { scanner = value; }
        }

◆ SharedMemory

Memory ScriptStack.Manager.SharedMemory

get

Definition at line 302 of file Manager.cs.

        {
            get { return sharedMemory; }
        }

The documentation for this class was generated from the following file:

Src/Manager.cs

Public Member Functions

Properties

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Manager()

Member Function Documentation

◆ ClearActiveLocks()

◆ IsRegistered()

◆ LoadComponent()

◆ LoadComponents()

◆ Register() [1/3]

◆ Register() [2/3]

◆ Register() [3/3]

◆ UnloadPlugins()

◆ UnRegister() [1/2]

◆ UnRegister() [2/2]

Member Data Documentation

◆ debug

◆ loadedPlugins

◆ locks

◆ name

◆ optimize

◆ routines

◆ scanner

◆ sharedMemory

Property Documentation

◆ ActiveLocks

◆ Debug

◆ LexerFactory

◆ Name

◆ Optimize

◆ Routines

◆ Scanner

◆ SharedMemory