Implements an Interactive Console for the BadScript Language. More...

Public Member Functions
	BadInteractiveConsole (BadRuntime runtime, BadTaskRunner runner, IEnumerable< string > files)
	Constructs a new BadInteractiveConsole instance.

void	Reset ()
	Resets the Current Context.

BadObject	LoadIsolated (string file)
	Loads a File isolated from the Interactive Session.

void	Load (string file)
	Loads a File into the Interactive Session.

IEnumerable< object?>	RunIsolatedRoutine (string code)
	Runs a set of Expressions isolated from the Interactive Session.

BadObject	RunIsolated (string code)
	Runs a set of Expressions isolated from the Interactive Session.

void	Run (string code)
	Runs a set of Expressions.

Properties
BadScope?	CurrentScope `[get]`
	The Current Scope of the Interactive Console.

bool	CatchErrors `[get, set]`
	If true, the Interactive Console will catch and print errors.

bool	PreParse `[get, set]`
	If true, the Interactive Console will pre-parse the input before executing it.

Private Member Functions
BadExecutionContext	CreateContext ()
	Creates a new Execution Context with the Interactive Console Api.

IEnumerable< object?>	RunRoutine (IEnumerable< BadExpression > expressions)
	The Routine that is used to execute the Interactive Session.

void	Run (IEnumerable< BadExpression > expressions)
	Runs a set of Expressions.

Private Attributes
readonly BadInteractiveConsoleApi	m_Api
	The Interactive API.

readonly BadTaskRunner	m_Runner
	The Task runner.

readonly BadRuntime	m_Runtime
	The Execution Context Options.

BadExecutionContext?	m_Context
	The Execution Context.

Detailed Description

Implements an Interactive Console for the BadScript Language.

Definition at line 22 of file BadInteractiveConsole.cs.

Constructor & Destructor Documentation

◆ BadInteractiveConsole()

BadScript2.Interactive.BadInteractiveConsole.BadInteractiveConsole	(	BadRuntime	runtime,
		BadTaskRunner	runner,
		IEnumerable< string >	files
	)

Constructs a new BadInteractiveConsole instance.

Parameters

runtime	The Runtime that the Interactive Console will be started from.
runner	The Task runner
files	The Files that are loaded before the interactive session begins

Definition at line 50 of file BadInteractiveConsole.cs.

    {
        m_Runner = runner;
        m_Api = new BadInteractiveConsoleApi(this);
        m_Runtime = runtime;
        Reset();
 
        foreach (string file in files)
        {
            LoadIsolated(file);
        }
    }

Member Function Documentation

◆ CreateContext()

BadExecutionContext BadScript2.Interactive.BadInteractiveConsole.CreateContext ( )

private

Creates a new Execution Context with the Interactive Console Api.

Returns: Execution Context

Definition at line 82 of file BadInteractiveConsole.cs.

    {
        BadExecutionContext ctx = m_Runtime.CreateContext(BadFileSystem.Instance.GetCurrentDirectory());
        BadTable apiTable = new BadTable();
        m_Api.Load(ctx, apiTable);
 
        ctx.Scope.DefineVariable(m_Api.Name, apiTable);
 
        return ctx;
    }

◆ Load()

void BadScript2.Interactive.BadInteractiveConsole.Load ( string file )

Loads a File into the Interactive Session.

Parameters

file	The File to be Loaded

Definition at line 129 of file BadInteractiveConsole.cs.

    {
        BadSourceParser parser = BadSourceParser.Create(file, BadFileSystem.ReadAllText(file));
        Run(parser.Parse());
    }

◆ LoadIsolated()

BadObject BadScript2.Interactive.BadInteractiveConsole.LoadIsolated ( string file )

Loads a File isolated from the Interactive Session.

Parameters

file	The File to be Executed

Returns: Result of the Execution

Exceptions

BadRuntimeException Gets raised if the context was not initialized

Definition at line 108 of file BadInteractiveConsole.cs.

    {
        if (m_Context == null)
        {
            throw new BadRuntimeException("Context is not initialized");
        }
 
        Reset();
        BadExecutionContext current = m_Context;
        BadSourceParser parser = BadSourceParser.Create(file, BadFileSystem.ReadAllText(file));
        Run(parser.Parse());
 
        Reset();
 
        return current.Scope.ReturnValue ?? current.Scope.GetTable();
    }

◆ Reset()

void BadScript2.Interactive.BadInteractiveConsole.Reset ( )

Resets the Current Context.

Definition at line 97 of file BadInteractiveConsole.cs.

    {
        m_Context = CreateContext();
    }

◆ Run() [1/2]

void BadScript2.Interactive.BadInteractiveConsole.Run ( IEnumerable< BadExpression > expressions )

private

Runs a set of Expressions.

Parameters

expressions The Expressions to be Executed

Exceptions

BadRuntimeException Gets raised if the context was not initialized

Definition at line 182 of file BadInteractiveConsole.cs.

    {
        IEnumerable<BadExpression> exprs = expressions;
 
        if (PreParse)
        {
            exprs = exprs.ToArray();
        }
 
        if (BadNativeOptimizationSettings.Instance.UseConstantFoldingOptimization)
        {
            exprs = BadConstantFoldingOptimizer.Optimize(exprs);
        }
 
        if (m_Context == null)
        {
            throw new BadRuntimeException("Context is not initialized");
        }
 
 
        m_Runner.AddTask(new BadTask(BadRunnable.Create(m_Context.Execute(exprs)), "Main"), true);
 
        if (CatchErrors)
        {
            try
            {
                while (!m_Runner.IsIdle)
                {
                    m_Runner.RunStep();
                }
            }
            catch (Exception e)
            {
                BadConsole.WriteLine(e.Message);
            }
        }
        else
        {
            while (!m_Runner.IsIdle)
            {
                m_Runner.RunStep();
            }
        }
 
    }

◆ Run() [2/2]

void BadScript2.Interactive.BadInteractiveConsole.Run ( string code )

Runs a set of Expressions.

Parameters

code	The Source Code

Definition at line 280 of file BadInteractiveConsole.cs.

    {
        BadSourceParser parser = BadSourceParser.Create("<stdin>", code);
        Run(parser.Parse());
    }

◆ RunIsolated()

BadObject BadScript2.Interactive.BadInteractiveConsole.RunIsolated ( string code )

Runs a set of Expressions isolated from the Interactive Session.

Parameters

code	The Source Code

Returns: The Result of the Execution

Exceptions

BadRuntimeException Gets raised if the context was not initialized

Definition at line 259 of file BadInteractiveConsole.cs.

    {
        if (m_Context == null)
        {
            throw new BadRuntimeException("Context is not initialized");
        }
 
        BadExecutionContext ctx = m_Context;
        Reset();
        BadExecutionContext current = m_Context;
        BadSourceParser parser = BadSourceParser.Create("<stdin>", code);
        Run(parser.Parse());
        m_Context = ctx;
 
        return current.Scope.ReturnValue ?? current.Scope.GetTable();
    }

◆ RunIsolatedRoutine()

IEnumerable< object?> BadScript2.Interactive.BadInteractiveConsole.RunIsolatedRoutine ( string code )

Runs a set of Expressions isolated from the Interactive Session.

Parameters

code	The Source Code

Returns: The Results of the Execution

Exceptions

BadRuntimeException Gets raised if the context was not initialized

Definition at line 234 of file BadInteractiveConsole.cs.

    {
        if (m_Context == null)
        {
            throw new BadRuntimeException("Context is not initialized");
        }
 
        BadExecutionContext ctx = m_Context;
        Reset();
        BadSourceParser parser = BadSourceParser.Create("<stdin>", code);
 
        foreach (object? o in RunRoutine(parser.Parse()))
        {
            yield return o;
        }
 
        m_Context = ctx;
    }

◆ RunRoutine()

IEnumerable< object?> BadScript2.Interactive.BadInteractiveConsole.RunRoutine ( IEnumerable< BadExpression > expressions )

private

The Routine that is used to execute the Interactive Session.

Parameters

expressions The Expressions to be executed

Returns: Enumeration of objects

Exceptions

BadRuntimeException Gets raised if the context was not initialized

Definition at line 141 of file BadInteractiveConsole.cs.

    {
        IEnumerable<BadExpression> exprs = expressions;
 
        if (PreParse)
        {
            exprs = exprs.ToArray();
        }
 
        if (BadNativeOptimizationSettings.Instance.UseConstantFoldingOptimization)
        {
            exprs = BadConstantFoldingOptimizer.Optimize(exprs);
        }
 
        if (BadNativeOptimizationSettings.Instance.UseConstantSubstitutionOptimization)
        {
            exprs = BadConstantSubstitutionOptimizer.Optimize(exprs);
        }
 
        if (m_Context == null)
        {
            throw new BadRuntimeException("Context is not initialized");
        }
 
 
        m_Runner.AddTask(new BadTask(BadRunnable.Create(m_Context.Execute(exprs)), "Main"), true);
 
        while (!m_Runner.IsIdle)
        {
            m_Runner.RunStep();
 
            yield return null;
        }
 
    }

Member Data Documentation

◆ m_Api

readonly BadInteractiveConsoleApi BadScript2.Interactive.BadInteractiveConsole.m_Api

private

The Interactive API.

Definition at line 27 of file BadInteractiveConsole.cs.

◆ m_Context

BadExecutionContext? BadScript2.Interactive.BadInteractiveConsole.m_Context

private

The Execution Context.

Definition at line 42 of file BadInteractiveConsole.cs.

◆ m_Runner

readonly BadTaskRunner BadScript2.Interactive.BadInteractiveConsole.m_Runner

private

The Task runner.

Definition at line 32 of file BadInteractiveConsole.cs.

◆ m_Runtime

readonly BadRuntime BadScript2.Interactive.BadInteractiveConsole.m_Runtime

private

The Execution Context Options.

Definition at line 37 of file BadInteractiveConsole.cs.

Property Documentation

◆ CatchErrors

bool BadScript2.Interactive.BadInteractiveConsole.CatchErrors

getset

If true, the Interactive Console will catch and print errors.

Definition at line 71 of file BadInteractiveConsole.cs.

71{ get; set; }

◆ CurrentScope

BadScope? BadScript2.Interactive.BadInteractiveConsole.CurrentScope

get

The Current Scope of the Interactive Console.

Definition at line 66 of file BadInteractiveConsole.cs.

◆ PreParse

bool BadScript2.Interactive.BadInteractiveConsole.PreParse

getset

If true, the Interactive Console will pre-parse the input before executing it.

Definition at line 76 of file BadInteractiveConsole.cs.

76{ get; set; }

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

src/BadScript2.Common/BadScript2.Interactive/BadInteractiveConsole.cs

Public Member Functions

Properties

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ BadInteractiveConsole()

Member Function Documentation

◆ CreateContext()

◆ Load()

◆ LoadIsolated()

◆ Reset()

◆ Run() [1/2]

◆ Run() [2/2]

◆ RunIsolated()

◆ RunIsolatedRoutine()

◆ RunRoutine()

Member Data Documentation

◆ m_Api

◆ m_Context

◆ m_Runner

◆ m_Runtime

Property Documentation

◆ CatchErrors

◆ CurrentScope

◆ PreParse