bbtk::Interpreter Class Reference

The bbtk language interpreter. More...

#include <bbtkInterpreter.h>

Inheritance diagram for bbtk::Interpreter:

[legend]

Collaboration diagram for bbtk::Interpreter:

[legend]

List of all members.

Public Types
enum	ExitStatus { Interpreter_OK, Interpreter_ERROR, Interpreter_QUIT }
typedef Interpreter	Self
typedef boost::shared_ptr< Self >	Pointer
typedef boost::weak_ptr< Self >	WeakPointer
typedef Object	Superclass
typedef VirtualExec::DialogModeType	DialogModeType
Public Member Functions
std::string	GetObjectName () const
std::string	GetObjectInfo () const
size_t	GetObjectSize () const
size_t	GetObjectInternalSize () const
size_t	GetObjectRecursiveSize () const
ExitStatus	InterpretFile (const std::string &filename, bool source=false)
	Runs the interpretation of a file.
ExitStatus	InterpretBuffer (std::stringstream *buffer)
	Runs the interpretation of a buffer and deletes it !
ExitStatus	InterpretLine (const std::string &line)
	Runs the interpretation of a command.
void	CommandLineInterpreter ()
	Launches a command line interpreter (with a prompt).
void	SetInputs (const std::map< std::string, std::string > &m)
void	SetNoExecMode (bool m)
void	SetNoErrorMode (bool m)
void	SetDialogMode (DialogModeType t)
void	SetCommandLine (bool v=true)
	Sets the bool that indicates wether we are in command line context.
void	SetThrow (bool b)
void	SetUser (InterpreterUser *c)
	Sets the user of the interpreter (if any).
InterpreterUser *	GetUser ()
	Gets the InterpreterUser of this.
const InterpreterUser *	GetUser () const
	Gets the InterpreterUser of this (const).
VirtualExec::Pointer	GetExecuter () const
	Gets the Executer.
long	GetUseCount ()
Static Public Member Functions
static Pointer	New (const std::string &cpp_file="")
static Pointer	New (VirtualExec::Pointer)
static void	InsertInObjectList (Pointer)
static void	RemoveFromObjectList (WeakPointer)
static void	InsertInPackageList (Pointer)
static void	ReleasePackages ()
static void	PrintObjectListInfo (const std::string &name)
static void	PrintObjectInfo (const Pointer &o)
static long	GetObjectsCount ()
Protected Types
enum	CommandCodeType {   cNew, cDelete, cConnect, cExec,   cPackage, cEndPackage, cDefine, cEndDefine,   cInput, cOutput, cSet, cConfig,   cReset, cAuthor, cCategory, cDescription,   cHelp, cMessage, cInclude, cQuit,   cLoad, cUnload, cGraph, cPrint,   cIndex, cKind, cNewGUI, cWorkspace,   cDebug }
	The enumeration of command codes == Command name. More...
typedef std::map< std::string, CommandInfoType >	CommandDictType
	The type of dictionnary of commands.
Protected Member Functions
void	InterpretLine (const std::string &line, bool &insideComment)
	Interprets a line.
void	GetLineFromPrompt (std::string &line)
	Reads a line from prompt.
void	SplitLine (const std::string &line, std::vector< std::string > &words)
	Splits a line into words.
void	InterpretCommand (const std::vector< std::string > &words, CommandInfoType &info)
	Executes the right action depending on the command name.
void	SwitchToFile (const std::string &filename, bool source=false)
	Switch to the interpretation of a file.
void	SwitchToStream (std::stringstream *stream)
	Switch to the interpretation of a stringstream.
void	CloseCurrentFile ()
	Closes the currently open file.
void	CloseAllFiles ()
	Closes all open files.
void	Reset ()
	Resets all.
void	Help (const std::vector< std::string > &words)
	Displays help (entry point of any help).
void	HelpCommands ()
	Displays help on all the commands.
void	HelpCommand (const std::string &command)
	Displays help on a particular command.
void	Graph (const std::vector< std::string > &words)
void	Config () const
	Displays the Configuration.
void	Index (const std::string &filename, const std::string &type="Initials")
void	FindCommandsWithPrefix (char *buf, int n, std::vector< std::string > &commands)
void	NewGUI (const std::string &box, const std::string &instanceName)
void	Debug (const std::string &arg)
	~Interpreter ()
void	LockThis ()
void	UnLockThis ()
template<class U>
boost::shared_ptr< U >	GetThisPointer () const
Static Protected Member Functions
template<class U>
static boost::shared_ptr< U >	MakePointer (U *s, bool lock=false)
template<class U, class D>
static boost::shared_ptr< U >	MakePointer (U *s, const D &del, bool lock=false)
Private Member Functions
	Interpreter (const std::string &cpp_file="")
	Constructor.
	Interpreter (VirtualExec::Pointer)
void	Init (VirtualExec::Pointer, const std::string &cpp_file)
void	LoadScript (std::string fullPathScriptName, std::string includeScriptName)
void	CatchBbtkException (const bbtk::Exception &e)
void	CatchStdException (const std::exception &e)
void	CatchUnknownException ()
Private Attributes
bbtk::VirtualExec::Pointer	mVirtualExecuter
	The command executer used.
bbtk::Executer::WeakPointer	mRealExecuter
bbtk::InterpreterUser *	mUser
	The user of the interpreter (0 if none).
std::vector< std::istream * >	mFile
	Vector of open files / buffers (can be stringstream).
std::vector< std::string >	mFileName
	Vector of names of open files with full path (as open).
std::vector< std::string >	mFileNameHistory
std::vector< std::string >	mIncludeFileName
	Vector of names of open files as given to the include command.
std::vector< int >	mLine
	Stores the current line number in each open file.
CommandDictType	mCommandDict
	The dictionnary of commands.
bool	mCommandLine
	Are we in a command line context ?
std::deque< char * >	mHistory
	The history of commands.
int	bufferNb
bool	mThrow
Friends
struct	Object::Deleter
Classes
struct	CommandInfoType
	The structure storing the informations on a command. More...

---

Detailed Description

The bbtk language interpreter.

Definition at line 100 of file bbtkInterpreter.h.

---

Member Typedef Documentation

typedef Interpreter bbtk::Interpreter::Self

Definition at line 102 of file bbtkInterpreter.h.

typedef boost::shared_ptr<Self> bbtk::Interpreter::Pointer

Reimplemented from bbtk::Object.

Definition at line 102 of file bbtkInterpreter.h.

typedef boost::weak_ptr<Self> bbtk::Interpreter::WeakPointer

Reimplemented from bbtk::Object.

Definition at line 102 of file bbtkInterpreter.h.

typedef Object bbtk::Interpreter::Superclass

Definition at line 102 of file bbtkInterpreter.h.

typedef VirtualExec::DialogModeType bbtk::Interpreter::DialogModeType

Definition at line 145 of file bbtkInterpreter.h.

typedef std::map<std::string,CommandInfoType> bbtk::Interpreter::CommandDictType [protected]

The type of dictionnary of commands.

Definition at line 215 of file bbtkInterpreter.h.

---

Member Enumeration Documentation

enum bbtk::Interpreter::ExitStatus

Enumerator:

Interpreter_OK
Interpreter_ERROR
Interpreter_QUIT

Definition at line 108 of file bbtkInterpreter.h.

      {
        Interpreter_OK,
        Interpreter_ERROR,
        Interpreter_QUIT
      }

enum bbtk::Interpreter::CommandCodeType [protected]

The enumeration of command codes == Command name.

Enumerator:

cNew
cDelete
cConnect
cExec
cPackage
cEndPackage
cDefine
cEndDefine
cInput
cOutput
cSet
cConfig
cReset
cAuthor
cCategory
cDescription
cHelp
cMessage
cInclude
cQuit
cLoad
cUnload
cGraph
cPrint
cIndex
cKind
cNewGUI
cWorkspace
cDebug

Definition at line 171 of file bbtkInterpreter.h.

    {
      cNew,
      cDelete,
      cConnect,
      cExec,
      cPackage,
      cEndPackage,
      cDefine,
      cEndDefine,
      cInput,
      cOutput,
      cSet,
      cConfig,  // JPR
      cReset,   // EED
      cAuthor, 
      cCategory, // JPR
      cDescription,
      cHelp,
      cMessage,
      cInclude,
      cQuit,
      cLoad,
      cUnload,
      cGraph,
      cPrint,
      cIndex,
      cKind, // LG
      cNewGUI, // LG
      cWorkspace, // LG
      cDebug // LG
    } CommandCodeType;

---

Constructor & Destructor Documentation

bbtk::Interpreter::Interpreter

(

const std::string &

cpp_file = ""

)

[private]

Constructor.

Definition at line 72 of file bbtkInterpreter.cxx.

References Init().

  {
    Init(VirtualExec::Pointer(), cpp_file);
  }

Here is the call graph for this function:

bbtk::Interpreter::Interpreter

(

VirtualExec::Pointer

e

)

[private]

Definition at line 79 of file bbtkInterpreter.cxx.

References Init().

  {
    Init(e,"");
  }

Here is the call graph for this function:

bbtk::Interpreter::~Interpreter

(

)

[protected]

Definition at line 368 of file bbtkInterpreter.cxx.

References bbtkDebugMessageInc, and mVirtualExecuter.

  {
    bbtkDebugMessageInc("Interpreter",9,"==> Interpreter::~Interpreter()" <<std::endl);
    mVirtualExecuter = VirtualExec::Pointer();
    bbtkDebugMessageInc("Interpreter",9,"<== Interpreter::~Interpreter()" <<std::endl);
  }

---

Member Function Documentation

std::string bbtk::Interpreter::GetObjectName

(

)

const [virtual]

Reimplemented from bbtk::Object.

Definition at line 2155 of file bbtkInterpreter.cxx.

  {
    return std::string("Interpreter");
  }

std::string bbtk::Interpreter::GetObjectInfo

(

)

const [virtual]

Reimplemented from bbtk::Object.

Definition at line 2162 of file bbtkInterpreter.cxx.

  {
    std::stringstream i;
    return i.str();
  }

size_t bbtk::Interpreter::GetObjectSize

(

)

const [virtual]

Reimplemented from bbtk::Object.

Definition at line 2170 of file bbtkInterpreter.cxx.

{
  size_t s = Superclass::GetObjectSize();
  s += Interpreter::GetObjectInternalSize();
  return s;
  }

size_t bbtk::Interpreter::GetObjectInternalSize

(

)

const [virtual]

Reimplemented from bbtk::Object.

Definition at line 2178 of file bbtkInterpreter.cxx.

{
  size_t s = sizeof(Interpreter);
  return s;
  }

size_t bbtk::Interpreter::GetObjectRecursiveSize

(

)

const [virtual]

Reimplemented from bbtk::Object.

Definition at line 2185 of file bbtkInterpreter.cxx.

References mVirtualExecuter.

  {
    size_t s = Superclass::GetObjectRecursiveSize();
    s += Interpreter::GetObjectInternalSize();
    s += mVirtualExecuter->GetObjectRecursiveSize();
    return s;
  }

Interpreter::Pointer bbtk::Interpreter::New

(

const std::string &

cpp_file = ""

)

[static]

Definition at line 56 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, and bbtk::Object::MakePointer().

  {
    bbtkDebugMessage("Kernel",9,"Interpreter::New('"<<cpp_file<<"')"<<std::endl);
    return MakePointer(new Interpreter(cpp_file));
  }

Here is the call graph for this function:

Interpreter::Pointer bbtk::Interpreter::New

(

VirtualExec::Pointer

e

)

[static]

Definition at line 64 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, and bbtk::Object::MakePointer().

  {
    bbtkDebugMessage("Kernel",9,"Interpreter::New(VirtualExec)"<<std::endl);
    return MakePointer(new Interpreter(e));
  }

Here is the call graph for this function:

Interpreter::ExitStatus bbtk::Interpreter::InterpretFile	(	const std::string &	filename,
		bool	source = false
	)

Runs the interpretation of a file.

Definition at line 521 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, bbtkDebugMessageInc, bbtkDecTab, CATCH_MACRO, CloseAllFiles(), CloseCurrentFile(), Interpreter_OK, InterpretLine(), mCommandLine, mFile, mLine, and SwitchToFile().

Referenced by InterpretLine().

  {
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::InterpretFile(\""<<filename<<"\")"<<std::endl);

    bool exm = mCommandLine;
    mCommandLine = false;

    ExitStatus status = Interpreter_OK;

    try 
    {
      SwitchToFile(filename,source);

      bool insideComment = false; // for multiline comment
      while (mFile.size()>0) 
      {
        while (!mFile.back()->eof()) {
          mLine.back()++;
          char buf[500];
          mFile.back()->getline(buf,500);
          std::string str(buf);
          int size=str.length();
          if ( str[ size-1 ]==13  )
            {
              str.erase(size-1,1);
            }
          try
            {
              InterpretLine(str, insideComment);
            }
          CATCH_MACRO;
          
       }//while !eof
       CloseCurrentFile();
      }//while >0
    } // try
    CATCH_MACRO;
    
    CloseAllFiles();
    bbtkDebugMessage("Interpreter",9,"EO Interpreter::InterpretFile(\""<<filename<<"\")"<<std::endl);
    bbtkDecTab("Interpreter",9);

    mCommandLine = exm;
    
    return status;
  }

Here is the call graph for this function:

Here is the caller graph for this function:

Interpreter::ExitStatus bbtk::Interpreter::InterpretBuffer

(

std::stringstream *

buffer

)

Runs the interpretation of a buffer and deletes it !

Definition at line 575 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, bbtkDebugMessageInc, bbtkDecTab, CATCH_MACRO, CloseAllFiles(), CloseCurrentFile(), Interpreter_OK, InterpretLine(), mCommandLine, mFile, mLine, and SwitchToStream().

  {
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::InterpretBuffer()"<<std::endl);

    bool exm = mCommandLine;
    mCommandLine = false;

    ExitStatus status = Interpreter_OK;

    try 
    {
      SwitchToStream(buffer);
      bool insideComment = false; // for multiline comment
      while (mFile.size()>0) 
      {
        while (!mFile.back()->eof()) {
          mLine.back()++;
          char buf[500];
          mFile.back()->getline(buf,500);
          std::string str(buf);
          
          int size=str.length();
          if ( str[ size-1 ]==13  )
            {
              str.erase(size-1,1);
            }
          try
            {
              InterpretLine(str, insideComment);
            }
          CATCH_MACRO;
        }//while
        CloseCurrentFile();
      }
    }
    CATCH_MACRO;
    
    CloseAllFiles();
    bbtkDebugMessage("Interpreter",9,"EO Interpreter::InterpretBuffer()"<<std::endl);
    bbtkDecTab("Interpreter",9);
    
    mCommandLine = exm;
    return status;
  }

Here is the call graph for this function:

Interpreter::ExitStatus bbtk::Interpreter::InterpretLine

(

const std::string &

line

)

Runs the interpretation of a command.

Definition at line 623 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, bbtkDebugMessageInc, bbtkDecTab, CATCH_MACRO, Interpreter_OK, and InterpretLine().

Referenced by CommandLineInterpreter(), InterpretBuffer(), InterpretFile(), and InterpretLine().

  {
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::InterpretLine('"<<line<<"')"<<std::endl);

    ExitStatus status = Interpreter_OK;

    try 
    {
      bool insideComment = false;
      InterpretLine(line, insideComment);
    }
    CATCH_MACRO;
  

    bbtkDebugMessage("Interpreter",9,"EO Interpreter::InterpretLine()"
                     <<std::endl);
    bbtkDecTab("Interpreter",9);
    
    return status;
  }

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::CommandLineInterpreter

(

)

Launches a command line interpreter (with a prompt).

Definition at line 1841 of file bbtkInterpreter.cxx.

References bbtkDebugDecTab, bbtkDebugMessageInc, bbtkMessage, GetLineFromPrompt(), InterpretLine(), and mCommandLine.

  {
    bbtkDebugMessageInc("Interpreter",9,
                        "Interpreter::CommandLineInterpreter()"<<std::endl);

#ifdef BBTK_USE_TERMIOS_BASED_PROMPT  
    // Initialise the tty in non canonical mode with no echo
    // oter remembers the previous settings to restore them after 
    struct termios ter,oter;
    tcgetattr(0,&ter);
    oter=ter;
    ter.c_lflag &= ~ECHO;
    ter.c_lflag &= ~ICANON;
    ter.c_cc[VMIN]=1;
    ter.c_cc[VTIME]=0;
    tcsetattr(0,TCSANOW,&ter);
#endif
    
    mCommandLine = true;
    bool again = true;
    bool insideComment = false; // for multiline comment  
    do 
    {
      try
      {
        std::string line;
        GetLineFromPrompt(line);
        InterpretLine(line, insideComment);
      }
      catch (QuitException e)
      {
        bbtkMessage("Interpreter",1,"Interpreter : Quit"<<std::endl);
        again = false;
      }
      catch (bbtk::Exception e) 
      {
        e.Print();
      }
        catch (std::exception& e) 
      {
        std::cerr << "* ERROR :: "<<e.what()<<" (not in bbtk)"<<std::endl;
      }
      catch (...)
      {
        std::cerr << "* UNDEFINED ERROR (not a bbtk nor a std exception)"<<std::endl;
      }
    }
    while (again);

#ifdef BBTK_USE_TERMIOS_BASED_PROMPT
    tcsetattr(0,TCSANOW,&oter);
#endif

    std::cout << "Good bye !" << std::endl;

    bbtkDebugDecTab("Interpreter",9);
  }

Here is the call graph for this function:

void bbtk::Interpreter::SetInputs

(

const std::map< std::string, std::string > &

m

)

[inline]

Sets the inputs of the workspace : the map is passed as is to the Executer

Definition at line 133 of file bbtkInterpreter.h.

    { mVirtualExecuter->SetInputs(m); }

void bbtk::Interpreter::SetNoExecMode

(

bool

m

)

[inline]

Puts the executer in "no exec" mode, which creates but does not execute pipelines.

Definition at line 138 of file bbtkInterpreter.h.

{ mVirtualExecuter->SetNoExecMode(m); }

void bbtk::Interpreter::SetNoErrorMode

(

bool

m

)

[inline]

Puts the executer in "no error" mode, Errors do not stop execution (but warnings are produced)

Definition at line 142 of file bbtkInterpreter.h.

{ mVirtualExecuter->SetNoErrorMode(m);}

void bbtk::Interpreter::SetDialogMode

(

DialogModeType

t

)

[inline]

Definition at line 147 of file bbtkInterpreter.h.

{ mVirtualExecuter->SetDialogMode(t);}

void bbtk::Interpreter::SetCommandLine

(

bool

v = true

)

[inline]

Sets the bool that indicates wether we are in command line context.

Definition at line 150 of file bbtkInterpreter.h.

{ mCommandLine = v; }

void bbtk::Interpreter::SetThrow

(

bool

b

)

[inline]

Definition at line 152 of file bbtkInterpreter.h.

{ mThrow = b; }

void bbtk::Interpreter::SetUser

(

InterpreterUser *

c

)

[inline]

Sets the user of the interpreter (if any).

Definition at line 156 of file bbtkInterpreter.h.

{ mUser = c; }

InterpreterUser* bbtk::Interpreter::GetUser

(

)

[inline]

Gets the InterpreterUser of this.

Definition at line 158 of file bbtkInterpreter.h.

{ return mUser; }

const InterpreterUser* bbtk::Interpreter::GetUser

(

)

const [inline]

Gets the InterpreterUser of this (const).

Definition at line 160 of file bbtkInterpreter.h.

{ return mUser; }

VirtualExec::Pointer bbtk::Interpreter::GetExecuter

(

)

const [inline]

Gets the Executer.

Definition at line 165 of file bbtkInterpreter.h.

Referenced by Help(), Index(), InterpretLine(), and SwitchToFile().

{ return mVirtualExecuter; }

Here is the caller graph for this function:

void bbtk::Interpreter::InterpretLine	(	const std::string &	line,
		bool &	insideComment
	)			[protected]

Interprets a line.

Definition at line 649 of file bbtkInterpreter.cxx.

References bbtkDebugDecTab, bbtkDebugMessage, bbtkDebugMessageInc, bbtkDecTab, bbtkInternalError, bbtkMessage, cAuthor, cCategory, cConfig, cConnect, cDebug, cDefine, cDelete, cDescription, cEndDefine, cEndPackage, cExec, cGraph, cHelp, cInclude, cIndex, cInput, cKind, cLoad, cMessage, cNew, cNewGUI, bbtk::Interpreter::CommandInfoType::code, Config(), cOutput, cPackage, cPrint, cQuit, cReset, cSet, cUnload, Debug(), GetExecuter(), Graph(), Help(), Index(), InterpretCommand(), InterpretFile(), bbtk::Interpreter::CommandInfoType::keyword, mCommandLine, mFileName, mThrow, mVirtualExecuter, NewGUI(), Reset(), SplitLine(), and SwitchToFile().

{
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::InterpretLine(\""<<line<<"\")"<<std::endl);
    bbtkMessage("echo",2,line<<std::endl);

    std::vector<std::string> words;
    SplitLine(line,words);

    // Empty line
    if (words.size()<1) 
    {
       bbtkDebugDecTab("Interpreter",9);
       return;
    }

    // Single line comment : # or //
    if ( words[0][0]=='#' || (words[0][0]=='/' && words[0][1]=='/') ) 
    {  
       bbtkDebugDecTab("Interpreter",9);
       bbtkMessage("Interpreter",9,"Comment"<<std::endl);
       return;
    }

    // Multi line comment ( /* ... */ ) -delimiters on different lines !-
    
    if (words[0][0]=='/' && words[0][1]=='*') 
    {  
       bbtkDebugDecTab("Interpreter",9);
       bbtkMessage("Interpreter",9,"In multiline comment"<<std::endl);
       insideComment = true;
       return;
    }

    if (words[0][0]=='*' && words[0][1]=='/') 
    {  
       bbtkDebugDecTab("Interpreter",9);
       bbtkMessage("Interpreter",9,"Out multiline comment"<<std::endl);
       if ( !insideComment ) {
          bbtkDebugDecTab("Interpreter",9);
          bbtkMessage("Interpreter",9,"Comment mismatch : '*/' with no matching '/*'"<<std::endl);       
       }
       insideComment = false;
       return;
    }

    if (insideComment) 
    {  
       bbtkDebugDecTab("Interpreter",9);
       bbtkMessage("Interpreter",9,"Multiline Comment"<<std::endl);
       return;
    }

    // Command 
    CommandInfoType command;
    InterpretCommand(words,command);

    bbtkDebugMessage("Interpreter",9,
                     "Command='"<<command.keyword
                      <<"' code="<<command.code<<std::endl); 
    int level=0;
    std::string left,right,left2,right2;
    std::string filename;
    switch (command.code) 
    {
      case cNew :
        mVirtualExecuter->Create(words[1],words[2]);
        break;

      case cDelete :
        mVirtualExecuter->Destroy(words[1]);
        break;

      case cConnect :
        Utilities::SplitAroundFirstDot(words[1],left,right);
        Utilities::SplitAroundFirstDot(words[2],left2,right2);      
        mVirtualExecuter->Connect(left,right,left2,right2);
        break;

      case cPackage :
        mVirtualExecuter->BeginPackage(words[1]);
        break;

      case cEndPackage :
        mVirtualExecuter->EndPackage();
        break;

      case cDefine :
        if (mFileName.size()>0) 
        {
                   filename = mFileName.back(); //mIncludeFileName.back(); //Utilities::get_file_name(mFileName.back());
        }
        if (words.size()==2) 
        {
           mVirtualExecuter->Define(words[1],"",filename);
        }
        else
        {
           mVirtualExecuter->Define(words[1],words[2],filename);
        }
        break;

      case cEndDefine :
        mVirtualExecuter->EndDefine();
        break;

      case cKind :
        mVirtualExecuter->Kind(words[1]);
        break;

      case cPrint :
        mVirtualExecuter->Print(words[1]);
        break;
        
      case cExec :
        if (words[1]=="freeze") 
          {
            mVirtualExecuter->SetNoExecMode(true);
            mThrow = false;
          }
        else if (words[1]=="freeze_no_error ") 
          {
            mVirtualExecuter->SetNoExecMode(true);
            mVirtualExecuter->SetNoErrorMode(true);
            mThrow = false;
          }
        else if (words[1]=="unfreeze") 
          {
            mVirtualExecuter->SetNoExecMode(false);
            mVirtualExecuter->SetNoErrorMode(false);
          }
        else
          {
            mVirtualExecuter->Execute(words[1]);
          }
        break;

      case cInput :
        Utilities::SplitAroundFirstDot(words[2],left,right);
        mVirtualExecuter->DefineInput(words[1],left,right,words[3]);
        break;

      case cOutput :
        Utilities::SplitAroundFirstDot(words[2],left,right);
        mVirtualExecuter->DefineOutput(words[1],left,right,words[3]);
        break;

      case cSet :
        Utilities::SplitAroundFirstDot(words[1],left,right);
        mVirtualExecuter->Set(left,right,words[2]);
        break;

      case cAuthor :
        mVirtualExecuter->Author(words[1]);
        break;

      case cNewGUI :
        NewGUI(words[1],words[2]);
        break;

      case cCategory :
        mVirtualExecuter->Category(words[1]);
        break;

      case cIndex :
        if (words.size()==1)
             Index("tmp_index.html");
        else if (words.size()==2)
             Index(words[1]);
        else if (words.size()==3)
             Index(words[1],words[2]);
        break;

      case cDescription :
        mVirtualExecuter->Description(words[1]);
        break;

      case cHelp :
        Help(words);
        break;

      case cMessage : 
        if (words.size()<3)
        {
          mVirtualExecuter->HelpMessages();
        }
        else
        {
          sscanf(words[2].c_str(),"%d",&level);
          mVirtualExecuter->SetMessageLevel(words[1],level);
        }
        break;

      case cGraph :
        Graph(words);
        break;

      case cConfig :
        Config();
        break;

      case cReset :  
        Reset();
        break;

      case cInclude :
                // if 'source' was given (words.size()==3) then tell to set the 
                // source file name of the current complex box with the full file name included
                if (mCommandLine)
        {
           InterpretFile(words[1],(words.size()==3)); 
        }
        else
        {
            SwitchToFile(words[1],(words.size()==3) );
        }
                break;

      case cLoad:
        GetExecuter()->LoadPackage(words[1]);
        break;

      case cUnload:
        GetExecuter()->UnLoadPackage(words[1]);
        break;

      case cQuit :
        throw QuitException();
        break;

      case cDebug :
        if (words.size()==2) Debug(words[1]);
        else Debug("");
        break;
        /* obsolete
      case cWorkspace :
        if (words.size() == 2) 
        {
           if (words[1]=="freeze")        mVirtualExecuter->SetNoExecMode(true);
           else if (words[1]=="unfreeze") mVirtualExecuter->SetNoExecMode(false);
        }
        else
        {
           mVirtualExecuter->SetWorkspaceName(words[2]);
        }
        break;
        */
      default:
        bbtkInternalError("should not reach here !!!");
   }

   bbtkDecTab("Interpreter",9);
}

Here is the call graph for this function:

void bbtk::Interpreter::GetLineFromPrompt

(

std::string &

line

)

[protected]

Reads a line from prompt.

Definition at line 1808 of file bbtkInterpreter.cxx.

Referenced by CommandLineInterpreter().

  {  
    s.clear();

    putchar('>');
    putchar(' ');

    do 
    {
      char c = getchar();
      if (c=='\n') 
      {
        putchar('\n');
        break;
      }
      if (c=='\t') 
      {
        // putchar('T');
        continue;
      }
      // putchar(c);
      s += c;
    } 
    while (true);  
    
  }

Here is the caller graph for this function:

void bbtk::Interpreter::SplitLine	(	const std::string &	line,
		std::vector< std::string > &	words
	)			[protected]

Splits a line into words.

Definition at line 911 of file bbtkInterpreter.cxx.

References bbtkDebugDecTab, bbtkDebugMessage, bbtkDebugMessageCont, bbtkDebugMessageInc, and bbtk::i.

Referenced by InterpretLine().

{
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::SplitLine(\""<<str<<"\")"<<std::endl);

    std::string delimiters = "\"";
    std::vector<std::string> quote;
    Utilities::SplitString(str,delimiters,quote);

    delimiters = " \t";
    std::vector<std::string>::iterator i;
    for (i=quote.begin(); i!=quote.end(); ) 
    {
       Utilities::SplitString(*i,delimiters,tokens);
       ++i;
       if (i!=quote.end()) 
       {
        //    bbtkDebugMessage("Interpreter",0,"\""<<*i<<"\""<<std::endl);
          tokens.push_back(*i);
          ++i;
       }
    }

    for (i=tokens.begin(); i!=tokens.end(); ++i) 
    {
       bbtkDebugMessage("Interpreter",9,"["<<*i<<"] ");
    }
    bbtkDebugMessageCont("Interpreter",9,std::endl);

    bbtkDebugDecTab("Interpreter",9);
 }

Here is the caller graph for this function:

void bbtk::Interpreter::InterpretCommand	(	const std::vector< std::string > &	words,
		CommandInfoType &	info
	)			[protected]

Executes the right action depending on the command name.

Definition at line 1431 of file bbtkInterpreter.cxx.

References bbtkDebugMessageInc, bbtkDecTab, bbtkError, HelpCommand(), and mCommandDict.

Referenced by InterpretLine().

  {
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::InterpretCommand(...)"<<std::endl);

    // searches the command keyword
    CommandDictType::iterator c;
    c = mCommandDict.find(words[0]);
    if ( c == mCommandDict.end() ) {
      bbtkError(words[0]<<" : unknown command");
    }

    // tests the number of args 
    if ( ( ((int)words.size())-1 < c->second.argmin ) ||
         ( ((int)words.size())-1 > c->second.argmax ) )
    {
       HelpCommand(words[0]);
       bbtkError(words[0]<<" : wrong number of arguments");
    }

    info = c->second;
    bbtkDecTab("Interpreter",9);
  }

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::SwitchToFile	(	const std::string &	filename,
		bool	source = false
	)			[protected]

Switch to the interpretation of a file.

Definition at line 1035 of file bbtkInterpreter.cxx.

References bbtkDebugMessageInc, bbtkError, bbtkMessage, GetExecuter(), bbtk::i, LoadScript(), and SwitchToStream().

Referenced by InterpretFile(), and InterpretLine().

  {
  // Note : in the following :
  // name : the user supplied name 
  //      - abreviated name    e.g.       scr   scr.bbs
  //      - relative full name e.g.       ./scr.bbs   ../../scr.bbs 
  //      - absolute full name e.g.       /home/usrname/proj/dir/scr.bbs
  //          same for Windows, with      c:, d: ...
  //
  // use ./directory/subdir/scrname.bbs
  //

    bbtkDebugMessageInc("Interpreter",9,"Interpreter::SwitchToFile( \""
                         <<name<<"\")"<<std::endl);

    std::vector<std::string> script_paths;
    std::string fullPathScriptName;  // full path script name
    std::string pkgname;             // e.g. <scriptname>.bbs
    std::vector<std::string> Filenames;

    // The following is *NOT* a debug time message :
    // It's a user intended message.
    // Please don't remove it.
    bbtkMessage("Interpreter",1,
        "look for : [" << name
        << "]" << std::endl);


    std::string upath;
    pkgname = Utilities::ExtractScriptName(name,upath);

    bbtkMessage("Interpreter",3,
                "package name:[" << pkgname
                 << "] path:[" << upath << "]" << std::endl);
    bool fullnameGiven = false; 
    bool foundFile     = false;

    // ==== "*" provided : load all scripts in given path 
    // relative (e.g. std/boxes/*) or absolute 
    if (pkgname == "*") 
      {

        std::stringstream* stream = new std::stringstream;
        //if (upath.size()!=0) // avoid troubles for "*"
        
        // ==== no path provided : look in root bbs path
        if (upath.size()==0)
          {
            //      bbtkMessage("Interpreter",1,
            // LG : add all bbs path
            //  script_paths.push_back(  ConfigurationFile::GetInstance().Get_root_bbs_path() );
            std::vector<std::string>::const_iterator i;
            for (i=ConfigurationFile::GetInstance().Get_bbs_paths().begin();
                 i!=ConfigurationFile::GetInstance().Get_bbs_paths().end();
                 i++)
              {
                script_paths.push_back(*i);
              }
          }
        // ==== absolute path provided 
        else if (upath[0]=='/' || upath[1] == ':' ) 
          {
            if ( Utilities::IsDirectory( upath ) )
              {
                script_paths.push_back(upath);
              }
            else 
              {
                bbtkError("'"<<upath<<"' : directory does not exist"); 
              }
          }
        // ==== relative path provided : search all bbs path appended with 
        // the relative path provided
        else
          {    
            std::vector<std::string>::const_iterator i;
            for (i=ConfigurationFile::GetInstance().Get_bbs_paths().begin();
                 i!=ConfigurationFile::GetInstance().Get_bbs_paths().end();
                 i++)
              {
                std::string full_path(*i);
                // we *really* want '.' to be the current working directory
                if (full_path == ".") 
                  {
                    char buf[2048]; // for getcwd
                    char * currentDir = getcwd(buf, 2048);
                    std::string cwd(currentDir);
                    full_path = currentDir;
                  } // if full_path
                
                full_path += ConfigurationFile::GetInstance().Get_file_separator();
                full_path += upath;
                
                if ( Utilities::IsDirectory( full_path ) )
                  {
                    script_paths.push_back(full_path);
                  }
              } 
            if (script_paths.empty())
              {
                bbtkError("no '"<<upath<<"' subdir found in search paths" 
                          << std::endl);
              }
          }
        
        
        // === search paths list complete : now explore it
        int nbBssFiles = 0;     
        // ==== relative name, iterate + load all .bbs/.bbp files
        std::vector<std::string>::iterator i;
        for (i=script_paths.begin();i!=script_paths.end();i++)
          {
            bbtkMessage("Interpreter",1,
                        "--> Looking in '" << *i << "'" << std::endl);
            
            Filenames.clear();
            //int nbFiles = 
            Utilities::Explore(*i, false, Filenames);
            
            for (std::vector<std::string>::iterator j = Filenames.begin(); 
                 j!= Filenames.end(); ++j)
              {
                int lgr = (*j).size();
                if (lgr < 5) continue;  
                // ignore non .bbp file
                if ( (*j).substr(lgr-4, 4) != ".bbp") continue; 
                
                (*stream) << "include \"" << *j << "\"\n";
                bbtkMessage("Interpreter",2,"  --> Found '" << *j << "'" << std::endl);
                
                nbBssFiles++;
              } // for (std::vector...
          } // for (i=script_...

        // === Result ...
        if (nbBssFiles==0)
          {
            bbtkMessage("Interpreter",1,
                        "  --> No .bbp found"<< std::endl);
          } 
        else 
          {
            bbtkMessage("Interpreter",1,
                        "  --> "<<nbBssFiles<<" .bbp found"<< std::endl);
            SwitchToStream(stream);
          }
        return;
      }  
    //=============== end pkgname=="*" ===========
    
    
    // if name starts with a / or a . or contains : user is assumed to have passed a relative/absolute name
    // (not only a plain script name)
    // we trust him, and try to expland the directory name
    // WARNING : starting from current local directory :  ./whatYouWant  (./ mandatory!)

    if (name[0]=='/' || name[1] == ':' || name[0]=='.')  // absolute path (linux/windows) or relative path
    { 

      // ===========================================================check user supplied location
      fullnameGiven = true;

      fullPathScriptName =  Utilities::ExpandLibName(name, false);

      // allow user to always forget ".bbs"
      int l = fullPathScriptName.size();

      if (l!=0) 
          {
         if ((fullPathScriptName.substr(l-4, 4) != ".bbs")&&
                         (fullPathScriptName.substr(l-4, 4) != ".bbp"))
         {
                        std::string tfullPathScriptName = fullPathScriptName + ".bbs";
                        if ( Utilities::FileExists(tfullPathScriptName) )
                        {
                                fullPathScriptName = tfullPathScriptName;
                                foundFile = true;
                        }
                        else 
                        {
                                tfullPathScriptName = fullPathScriptName + ".bbp";
                                if ( Utilities::FileExists(tfullPathScriptName) )
                                {
                                        fullPathScriptName = tfullPathScriptName;
                                        foundFile = true;
                                }
                        }
                 }
                 else 
                 {
                        if ( Utilities::FileExists(fullPathScriptName) )
                        {
                                foundFile = true;
                        }
                 }
          } // endif l != 0
  }
  else
  // =============================== iterate on the paths
  {
      script_paths = ConfigurationFile::GetInstance().Get_bbs_paths();
      std::string path;
      std::vector<std::string>::iterator i;
      for (i=script_paths.begin();i!=script_paths.end();++i)
          {
                path = *i;
                // we *really* want '.' to be the current working directory
                if (path == ".") 
                {
                        char buf[2048]; // for getcwd
                        char * currentDir = getcwd(buf, 2048);
                        std::string cwd(currentDir);
                        path = currentDir;
                }
          
                std::string tfullPathScriptName = Utilities::MakePkgnameFromPath(path, name, false);
                if (tfullPathScriptName.substr(tfullPathScriptName.size()-4, 3)==".bb")
                {
                  fullPathScriptName = tfullPathScriptName;
                        if ( ! Utilities::FileExists(fullPathScriptName) )
                        {
                                // The following is *NOT* a debug time message :
                                // It's a user intended message.
                                // Please don't remove it.
                                bbtkMessage("Interpreter",2,
                          "   [" <<fullPathScriptName <<"] : does not exist" 
                          <<std::endl);
                                continue;  // try next path
                        }
                        bbtkMessage("Interpreter",2,
                              "   [" <<fullPathScriptName 
                                  <<"] : found" <<std::endl);
                        foundFile = true;
                        break; // a script was found; we stop iterating
                }
                else 
                {
                        fullPathScriptName = tfullPathScriptName + ".bbs";
                        // Check if library exists
                        if ( ! Utilities::FileExists(fullPathScriptName) )
                        {
                                fullPathScriptName = tfullPathScriptName + ".bbp";
                                if ( ! Utilities::FileExists(fullPathScriptName) )
                                {
                                        // The following is *NOT* a debug time message :
                                        // It's a user intended message.
                                        // Please don't remove it.
                                        bbtkMessage("Interpreter",2,
                                        "   [" <<tfullPathScriptName <<".bbs/.bbp] : do not exist" 
                                        <<std::endl);
                                        continue;  // try next path
                                }
                        }
                        bbtkMessage("Interpreter",2,
                      "   [" <<fullPathScriptName 
                      <<"] : found" <<std::endl);
                        foundFile = true;
                        break; // a script was found; we stop iterating
                }
        } //------------------ // end for ( package_paths.begin();i!=package_paths.end() )
  }

    if (!foundFile)
      {
        if (fullnameGiven)
          if(fullPathScriptName == "")
            bbtkError("Path ["<<upath<<"] doesn't exist");
          else
            bbtkError("Script ["<<fullPathScriptName<<"] not found");
        else
          bbtkError("No ["<<pkgname<<".bbs/.bbp] script found");
        return;
      }
    else
        {
      LoadScript(fullPathScriptName,name);
          if (source) GetExecuter()->SetCurrentFileName(fullPathScriptName);
        }
    
    return;
  }

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::SwitchToStream

(

std::stringstream *

stream

)

[protected]

Switch to the interpretation of a stringstream.

Definition at line 1320 of file bbtkInterpreter.cxx.

References bufferNb, mFile, mFileName, mIncludeFileName, and mLine.

Referenced by InterpretBuffer(), NewGUI(), and SwitchToFile().

{
    mFile.push_back(stream);
    std::ostringstream buffer_name;
    bufferNb++;
    buffer_name << "buffer_" ;

    if (mFileName.size()>0 )
    {
       buffer_name << mFileName.back() << "_" << mLine.back();
    }
    mFileName.push_back(buffer_name.str());
    mIncludeFileName.push_back(buffer_name.str());
    mLine.push_back(0);
}

Here is the caller graph for this function:

void bbtk::Interpreter::CloseCurrentFile

(

)

[protected]

Closes the currently open file.

Definition at line 1377 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, mFile, mFileName, mIncludeFileName, and mLine.

Referenced by CloseAllFiles(), InterpretBuffer(), and InterpretFile().

  {
    bbtkDebugMessage("Interpreter",9,"Interpreter::CloseCurrentFile()"
                      <<std::endl);

    if (mFile.size()==0)
    {
      bbtkDebugMessage("Interpreter",9," -> no file left open"<<std::endl);
      return;
    }

    bbtkDebugMessage("Interpreter",9," Closing file '"<<mFileName.back()<<"'"<<std::endl);

    std::ifstream* file = dynamic_cast<std::ifstream*>(mFile.back());
    if (file!=0) file->close();

    delete mFile.back();
    mFile.pop_back();
    mFileName.pop_back();
    mIncludeFileName.pop_back();
    mLine.pop_back();

    bbtkDebugMessage("Interpreter",9," Remains "
                     <<mFile.size()
                     <<" open"<<std::endl);
    bbtkDebugMessage("Interpreter",9,"EO Interpreter::CloseCurrentFile()"
                     <<std::endl);
  }

Here is the caller graph for this function:

void bbtk::Interpreter::CloseAllFiles

(

)

[protected]

Closes all open files.

Definition at line 1411 of file bbtkInterpreter.cxx.

References bbtkDebugMessage, CloseCurrentFile(), and mFile.

Referenced by CatchBbtkException(), CatchStdException(), CatchUnknownException(), InterpretBuffer(), and InterpretFile().

  {
    bbtkDebugMessage("Interpreter",9,"Interpreter::CloseAllFiles()"
                      <<std::endl);

    while (mFile.size() != 0) 
    {
       CloseCurrentFile();
    }
    bbtkDebugMessage("Interpreter",9,"EO Interpreter::CloseAllFiles()"
                      <<std::endl);
  }

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::Reset

(

)

[protected]

Resets all.

Definition at line 945 of file bbtkInterpreter.cxx.

References mFileNameHistory, and mVirtualExecuter.

Referenced by InterpretLine().

  {
    // Cannot close all files if the reset command is read from a file !
    //    CloseAllFiles();
    mFileNameHistory.clear();
    this->mVirtualExecuter->Reset();
  }

Here is the caller graph for this function:

void bbtk::Interpreter::Help

(

const std::vector< std::string > &

words

)

[protected]

Displays help (entry point of any help).

Displays help on all the commands.

Definition at line 1459 of file bbtkInterpreter.cxx.

References bbtkError, GetExecuter(), HelpCommand(), HelpCommands(), and mUser.

Referenced by InterpretLine().

{
    unsigned int nbarg = words.size()-1;

    if (nbarg==0) 
    {
       HelpCommands();
    }
    else if (nbarg==1) 
    {
      if (words[1]=="packages") 
      {
         GetExecuter()->GetFactory()->PrintPackages(true);
         return;
      }
      try 
      {
          HelpCommand(words[1]);
      }
      catch (bbtk::Exception e) 
      {
         try 
         {
            GetExecuter()->GetFactory()->HelpPackage(words[1]);
            if ( mUser != 0 )
              {
                std::string url = 
                  ConfigurationFile::GetInstance().Get_doc_path();
                url += "/bbdoc/" + words[1] + "/index.html";
                if (Utilities::FileExists(url)) 
                  {
                    mUser->InterpreterUserViewHtmlPage(url);
                  }
              }
         }
         catch (bbtk::Exception f) 
         {
           try 
             {
               std::string package;
               GetExecuter()->GetFactory()->HelpBlackBox(words[1],package);
               if ( mUser != 0 )
                 {
                   std::string url = 
                     ConfigurationFile::GetInstance().Get_doc_path();
                   url += "/bbdoc/" + package + "/index.html";
                   if (Utilities::FileExists(url)) 
                     {
                       url += "#" + words[1];
                       mUser->InterpreterUserViewHtmlPage(url);
                     }
                 }
             }
           catch (bbtk::Exception g) 
             {
               try
                 {
                   GetExecuter()->ShowRelations(words[1],"0","9999");
                 }
               catch (bbtk::Exception h){
                 bbtkError("\""<<words[1].c_str()
                           <<"\" is not a known command, package, black box type or black box name");
               }
             }
         }
      }
    }
    else if (nbarg==2) 
    {
      if (words[2]=="all")
      {
         if ( words[1]=="packages" )
         {
            GetExecuter()->GetFactory()->PrintPackages(true,true);
            return;
          }
         try 
         {
            GetExecuter()->GetFactory()->HelpPackage(words[1],true);
         }
         catch (bbtk::Exception f) 
         {
         }
     }
     else 
     {
        HelpCommand(words[0]);
        bbtkError(words[0]<<" : syntax error");
     }
  }
  else 
  {
     bbtkError("Should not reach here !!!");
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::HelpCommands

(

)

[protected]

Displays help on all the commands.

Definition at line 1566 of file bbtkInterpreter.cxx.

References bbtk::i, and mCommandDict.

Referenced by Help().

  {
    std::cout << "Available commands :" << std::endl;
    CommandDictType::iterator i;
    for ( i =  mCommandDict.begin();
          i != mCommandDict.end();
        ++i) {
              std::cout << " " << i->first << std::endl;
      //      std::cout << "   usage : " << i->second.syntax << std::endl;
      //     std::cout << "    " << i->second.help << std::endl;

    }
  }

Here is the caller graph for this function:

void bbtk::Interpreter::HelpCommand

(

const std::string &

command

)

[protected]

Displays help on a particular command.

Displays help on a particular commands.

Definition at line 1584 of file bbtkInterpreter.cxx.

References bbtkError, and mCommandDict.

Referenced by Help(), and InterpretCommand().

  {
    CommandDictType::iterator c;
    c = mCommandDict.find(s);
    if ( c == mCommandDict.end() ) {
      bbtkError(s<<" : Unknown command");
    }   
    //    std::cout << " " << s << " : "<<  std::endl;
    //    CommandParamDictType::iterator i;
    //    for ( i =  c->second.begin();
    //      i != c->second.end();
    //      ++i) {
    std::cout << " usage : " << c->second.syntax << std::endl;
    std::cout << "  " << c->second.help << std::endl;

  }

Here is the caller graph for this function:

void bbtk::Interpreter::Graph

(

const std::vector< std::string > &

words

)

[protected]

Definition at line 1900 of file bbtkInterpreter.cxx.

References mUser, and mVirtualExecuter.

Referenced by InterpretLine().

{
  std::string page;
    bool system_display = true;

    if ( ( mUser != 0 ) && ( mUser->InterpreterUserHasOwnHtmlPageViewer() ) )
      system_display = false; 
 
    if (words.size()==1) 
    {
      page = mVirtualExecuter->ShowGraph(".","0","0","","","",system_display);
    }
    else if (words.size()==2) 
    {
      page = mVirtualExecuter->ShowGraph(words[1],"0","0","","","",system_display);
    }
    else if (words.size()==3) 
    {
      page = mVirtualExecuter->ShowGraph(words[1],words[2],"0","","","",system_display);
    }
    else if (words.size()==4) 
    {
      page = mVirtualExecuter->ShowGraph(words[1],words[2],words[3],"","","",system_display);
    } 
    else if (words.size()==5) 
    {
      page = mVirtualExecuter->ShowGraph(words[1],words[2],words[3],words[4],"","",system_display);
    } 
    else if (words.size()==6) 
    {
      page = mVirtualExecuter->ShowGraph(words[1],words[2],words[3],words[4],words[5],"",system_display);
    } 
    else if (words.size()==7) 
      {
        page = mVirtualExecuter->ShowGraph(words[1],words[2],words[3],words[4],words[5],words[6],system_display);
      } 
    
    if ( ( mUser != 0 ) && ( mUser->InterpreterUserHasOwnHtmlPageViewer() ) )
      mUser->InterpreterUserViewHtmlPage(page);

  }

Here is the caller graph for this function:

void bbtk::Interpreter::Config

(

)

const [protected]

Displays the Configuration.

Definition at line 1558 of file bbtkInterpreter.cxx.

Referenced by InterpretLine().

  {
    ConfigurationFile::GetInstance().GetHelp(1);
  }  

Here is the caller graph for this function:

void bbtk::Interpreter::Index	(	const std::string &	filename,
		const std::string &	type = "Initials"
	)			[protected]

Definition at line 1945 of file bbtkInterpreter.cxx.

References GetExecuter().

Referenced by InterpretLine().

{
  Factory::IndexEntryType t;
  if (type=="Initials") t = Factory::Initials;
  else if (type=="Categories") t = Factory::Categories;
  else if (type=="Packages") t = Factory::Packages;
  else if (type=="Adaptors") t = Factory::Adaptors;
  
  GetExecuter()->GetFactory()->CreateHtmlIndex(t,filename);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::FindCommandsWithPrefix	(	char *	buf,
		int	n,
		std::vector< std::string > &	commands
	)			[protected]

Fills the vector commands with the commands which have the first n chars of buf for prefix TODO : skip initial spaces in buf and also return the position of first non blank char in buf

Definition at line 1608 of file bbtkInterpreter.cxx.

References bbtk::i, and mCommandDict.

  {
    CommandDictType::const_iterator i;
    for (i=mCommandDict.begin(); i!=mCommandDict.end(); ++i)
    {
      if ((i->first).find(buf,0,n) == 0) 
        commands.push_back(i->first);
    }
  }

void bbtk::Interpreter::NewGUI	(	const std::string &	box,
		const std::string &	instanceName
	)			[protected]

Creates and connects the piece of pipeline which defines a GUI for the box box. Define it as a complex box type with name instanceName+"Type" The instance is called instanceName and connected to the existing pipeline

Definition at line 1960 of file bbtkInterpreter.cxx.

References bbtkError, bbtk::BlackBoxInputOutputDescriptor::GetCreatorTypeInfo(), bbtk::BlackBoxInputOutputDescriptor::GetDataInfo(), bbtk::BlackBoxInputOutputDescriptor::GetTypeInfo(), mRealExecuter, mVirtualExecuter, and SwitchToStream().

Referenced by InterpretLine().

{
  if (mRealExecuter.expired())
    {
      bbtkError("command 'newgui' cannot be compiled yet");
    }

  std::string typeName = instanceName+"Type";
  std::stringstream* s = new std::stringstream;
  // create the complex box
  (*s) << "define "<<typeName<<std::endl;
  //  (*s) << "  description 'Automatically generated user interface for the box "
  //       << boxname << "'" <<std::endl;
  // create the Layout box
  (*s) << "  load wx"<<std::endl;
  (*s) << "  new LayoutLine layout"<<std::endl;
  // create the output 'Widget'
  (*s) << "  output Widget layout.Widget Widget"<<std::endl;
  // the box change output 
  (*s) << "  new MultipleInputs change"<<std::endl;
  (*s) << "  output BoxChange change.Out BoxChange"<<std::endl;

  // Browse the inputs of the box in order to find which ones are not 
  // connected and can be adapted from a widget adaptor
  // vector which stores the list of inputs of the box which must be connected
  std::vector<std::string> in;
 
  Factory::Pointer F = mVirtualExecuter->GetFactory();
  /*
  Package::Pointer user = F->GetPackage("user");
  */
  ComplexBlackBoxDescriptor::Pointer workspace = 
    mRealExecuter.lock()->GetCurrentDescriptor();

  if (workspace==0)
    {
      delete s;
      bbtkError("Interpreter::CreateGUI : could not access the executer currently defined complex box");
    }
 

  /*
    (ComplexBlackBoxDescriptor::Pointer)(user->GetBlackBoxMap().find("workspace")->second.get());
  */

  BlackBox::Pointer box = workspace->GetPrototype()->bbGetBlackBox(boxname);
  //  BlackBox::InputConnectorMapType incm = box->bbGetInputConnectorMap();
  // int nb = 0;
  BlackBox::InputConnectorMapType::iterator i;
  for (i=box->bbGetInputConnectorMap().begin();
       i!=box->bbGetInputConnectorMap().end();
       ++i)
    {
      // If the input is connected : continue
      if (i->second->IsConnected()) continue;
      // Get the input descriptor 
      const BlackBoxInputDescriptor* d = box->bbGetDescriptor()->GetInputDescriptor(i->first);
      // If it is a "system" input : skip it
      if ( ( d->GetCreatorTypeInfo() == typeid(AtomicBlackBoxDescriptor)) ||
           ( d->GetCreatorTypeInfo() == typeid(WxBlackBoxDescriptor)) )
        continue;
      bool widok = true;
      std::string widget,adaptor;
      // try to find a widget adaptor
      if (F->FindWidgetAdaptor(DataInfo(d->GetTypeInfo(),""),
                               d->GetDataInfo(),
                               adaptor))
        {
          // command to create the adaptor
          (*s) << "  new "<<adaptor<<" "<<i->first<<std::endl;
          // Sets the label of the widget adaptor to the name of the input
          (*s) << "  set "<<i->first<<".Label "<<i->first<<std::endl;
          // Sets the initial value of the widget to the value of the input
          (*s) << "  set "<<i->first<<".In \" "
               <<box->bbGetInputAsString(i->first)<<"\""
               << std::endl;
          // store the input name
          in.push_back(i->first);
          (*s) << "  connect "<<i->first<<".Widget layout.Widget"<<in.size()<<std::endl;
            //<i->first<<"'"<<std::endl;
          (*s) << "  connect "<<i->first<<".BoxChange change.In"<<in.size()<<std::endl;
        }
      // try to find a two pieces adaptor
      else if (F->FindWidgetAdaptor2(DataInfo(d->GetTypeInfo(),""),
                                     d->GetDataInfo(),
                                     widget,adaptor) )
        {
          // command to create the widget
          (*s) << "  new "<<widget<<" "<<i->first<<"Widget"<<std::endl;
          // command to create the adaptor
          (*s) << "  new "<<adaptor<<" "<<i->first<<std::endl;
          // connect the two
          (*s) << "  connect "<<i->first<<"Widget.Out "
               <<i->first<<".In"<<std::endl;
          // Sets the label of the widget adaptor to the name of the input
          (*s) << "  set "<<i->first<<"Widget.Label "<<i->first<<std::endl;
          // Sets the initial value of the widget to the value of the input
          (*s) << "  set "<<i->first<<"Widget.In \" "
               <<box->bbGetInputAsString(i->first)<<"\""<< std::endl;
          // store the input name
          in.push_back(i->first);
          (*s) << "  connect "<<i->first<<"Widget.Widget layout.Widget"<<in.size()<<std::endl;
            //<i->first<<"'"<<std::endl;
          (*s) << "  connect "<<i->first<<"Widget.BoxChange change.In"<<in.size()<<std::endl;

        }
      // try to find an adaptor from string 
      // If found then can create a text input which 
      // will be automatically adapted 
      else if (F->FindAdaptor(DataInfo(typeid(std::string),""),
                               d->GetDataInfo(),
                               adaptor))
        {
          // command to create the adaptor
          (*s) << "  new InputText "<<i->first<<std::endl;
          // Sets the label of the widget adaptor to the name of the input
          (*s) << "  set "<<i->first<<".Title "<<i->first<<std::endl;
          // Sets the initial value of the widget to the value of the input
          (*s) << "  set "<<i->first<<".In \" "
               <<box->bbGetInputAsString(i->first)<<"\""<< std::endl;
          // store the input name
          in.push_back(i->first);
          (*s) << "  connect "<<i->first<<".Widget layout.Widget"<<in.size()<<std::endl;
            //<i->first<<"'"<<std::endl;
          (*s) << "  connect "<<i->first<<".BoxChange change.In"<<in.size()<<std::endl;

        }
      else 
        {
          widok = false;
        }
      if (widok)
        {
          // command to create the output
          (*s) << "  output "<<i->first<<" "
               <<i->first<<".Out "<<i->first<<std::endl;
            //         <<" Output of the widget which allows to set "
          
        }
    }   
  // Inputs for window properties
  (*s) << "  input WinTitle layout.WinTitle Title"<<std::endl;
  (*s) << "  input WinWidth layout.WinWidth Width"<<std::endl;
  (*s) << "  input WinHeight layout.WinHeight Height"<<std::endl;
  (*s) << "  input WinDialog layout.WinDialog Dialog"<<std::endl;
  (*s) << "  input WinHide layout.WinHide Hide"<<std::endl;

  
  
  // Execute the box executes the layout
  (*s) << "  exec layout" << std::endl;
  (*s) << "endefine" << std::endl;
  // (*s) << "help "<< typeName<< std::endl;
  // instanciate the box and connect it
  (*s) << "new "<<typeName<<" "<<instanceName<<std::endl;
  // connections
  std::vector<std::string>::iterator j;
  for (j=in.begin();j!=in.end();++j)
    {
      // connect
      (*s) << "connect "<<instanceName<<"."<<*j<<" "
           << boxname<<"."<<*j<<std::endl;
    }
  // That's all folks ! now execute the commands :
  SwitchToStream(s);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::Debug

(

const std::string &

arg

)

[protected]

Definition at line 2132 of file bbtkInterpreter.cxx.

References mVirtualExecuter.

Referenced by InterpretLine().

  {
    if ((name.length()==2)&&(name[0]=='-'))
      {
        if (name[1]=='D')
          {
            bbtk::StaticInitTime::PrintObjectListInfo = true;
          }
        if (name[1]=='C')
          {
            //      int o = MessageManager::GetMessageLevel("debug");
            //      if (o<2) MessageManager::SetMessageLevel("debug",2);
            mVirtualExecuter->GetFactory()->CheckPackages();
            //      MessageManager::SetMessageLevel("debug",o);
          }
      }
    else 
      {
        Object:: PrintObjectListInfo(name);
      }
  }

Here is the caller graph for this function:

void bbtk::Interpreter::Init	(	VirtualExec::Pointer	e,
		const std::string &	cpp_file
	)			[private]

Definition at line 86 of file bbtkInterpreter.cxx.

References bbtk::Interpreter::CommandInfoType::argmax, bbtk::Interpreter::CommandInfoType::argmin, bbtkDebugDecTab, bbtkDebugMessageInc, bufferNb, cAuthor, cCategory, cConfig, cConnect, cDebug, cDefine, cDelete, cDescription, cEndDefine, cEndPackage, cExec, cGraph, cHelp, cInclude, cIndex, cInput, cKind, cLoad, cMessage, cNew, cNewGUI, bbtk::Interpreter::CommandInfoType::code, cOutput, cPackage, cPrint, cQuit, cReset, cSet, cUnload, bbtk::Interpreter::CommandInfoType::help, bbtk::Interpreter::CommandInfoType::keyword, bbtk::Object::MakePointer(), mCommandDict, mCommandLine, mRealExecuter, mThrow, mUser, mVirtualExecuter, and bbtk::Interpreter::CommandInfoType::syntax.

Referenced by Interpreter().

  {
    mUser = 0;
    mCommandLine = false;
    mThrow = false;
    bufferNb =0;  
    bbtk::MessageManager::RegisterMessageType("echo","Level>0 : Prints the output of the 'print' commands of the user.\n\tLevel>1 : Prints the command being interpreted",1);
    bbtk::MessageManager::RegisterMessageType("Interpreter","Messages of the interpreter",0);
    bbtkDebugMessageInc("Interpreter",9,"Interpreter::Interpreter()" <<std::endl);
    if (e)
      {
        mVirtualExecuter = e;
      }
    else if (cpp_file.size()!=0)
      {
        mVirtualExecuter = boost::static_pointer_cast<VirtualExec>(bbtk::Transcriptor::New(cpp_file));
      }
    else 
      {
        bbtk::Executer::Pointer exe = bbtk::Executer::New();
        mRealExecuter = exe;
        mVirtualExecuter = boost::static_pointer_cast<VirtualExec>(exe);
      }

    // Lock this pointer or will auto-destruct !!
    if (!e) mVirtualExecuter->SetInterpreter(MakePointer(this,true));
    
    // For the time being, comment out previous line, and
    // uncomment next line to check Transcriptor

    //mVirtualExecuter = new bbtk::Transcriptor("GeneratedProgram.txt");

    // Builds the commands dict
    CommandInfoType info;
   
    info.keyword = "new";
    info.argmin = 2;
    info.argmax = 2;
    info.code = cNew;
    info.syntax = "new <type> <name>";
    info.help = "Creates a new black box of type <type> with name <name>";
    mCommandDict[info.keyword] = info;
    
    info.keyword = "delete";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cDelete;
    info.syntax = "delete <box>";
    info.help = "Deletes the black box of name <box>";
    mCommandDict[info.keyword] = info;

    info.keyword = "newgui";
    info.argmin = 2;
    info.argmax = 2;
    info.code = cNewGUI;
    info.syntax = "newgui <box> <name>";
    info.help = "Automatically creates a graphical user interface with name <name> for the black box <box> and connects it to the box inputs";
    mCommandDict[info.keyword] = info;

    info.keyword = "connect";
    info.argmin = 2;
    info.argmax = 2;
    info.code = cConnect;
    info.syntax = "connect <box1.output> <box2.input>";
    info.help = "Connects the ouput <output> of black box <box1> to the input <input> of black box <box2>";
    mCommandDict[info.keyword] = info;

    info.keyword = "print";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cPrint;
    info.syntax = "print <string>";
    info.help = "Prints the string. Substitutes any token of the form '$box.output$' by the string adaptation of the output of the box (requires the right adaptor). No carriage return is issued at the end, use '\\n' to add carriage returns. The level of 'echo' messages must be greater than 1 (see the command 'message').";
    mCommandDict[info.keyword] = info;

    info.keyword = "exec";
    info.argmin = 1;
    info.argmax = 2;
    info.code = cExec;
    info.syntax = "exec <box | 'freeze' | 'unfreeze' | 'freeze_no_error' >";
    info.help = "Executes the black box of name <box> (and connected boxes if needed). If the special keyword 'freeze' is given then freezes any further execution command. 'unfreeze' reverts to normal execution mode. 'freeze_no_error' is like freeze but also skips any error.";
    mCommandDict[info.keyword] = info;

    info.keyword = "package";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cPackage;
    info.syntax = "package <name>";
    info.help = "Begins the definition of a package.";
    mCommandDict[info.keyword] = info;
    
    info.keyword = "endpackage";
    info.argmin = 0;
    info.argmax = 0;
    info.code = cEndPackage;
    info.syntax = "endpackage";
    info.help = "Ends the definition of a package.";
    mCommandDict[info.keyword] = info;

    info.keyword = "define";
    info.argmin = 1;
    info.argmax = 2;
    info.code = cDefine;
    info.syntax = "define <type> [<package>]";
    info.help = "Begins the definition of a new type of complex black box called <type>. If <package> is provided will create it in the given package.";
    mCommandDict[info.keyword] = info;
    
    info.keyword = "endefine";
    info.argmin = 0;
    info.argmax = 0;
    info.code = cEndDefine;
    info.syntax = "endefine";
    info.help = "Ends the definition of a new type of complex black box";
    mCommandDict[info.keyword] = info;

    info.keyword = "kind";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cKind;
    info.syntax = "kind <ADAPTOR|DEFAULT_ADAPTOR|WIDGET_ADAPTOR|DEFAULT_WIDGET_ADAPTOR>";
    info.help = "Sets the kind of the currently defined complex black box";
    mCommandDict[info.keyword] = info;

    info.keyword = "input";
    info.argmin = 3;
    info.argmax = 3;
    info.code = cInput;
    info.syntax = "input <name> <box.input> <help>";
    info.help = "Defines the input <name> of the current working black box as being an alias for the input <input> of the black box <box>. <help> defines the help string for the newly created input";
    mCommandDict[info.keyword] = info;

    info.keyword = "output";
    info.argmin = 3;
    info.argmax = 3;
    info.code = cOutput;
    info.syntax = "output <name> <box.output> <help>";
    info.help = "Defines the output <name> of the current working black box as being an alias for the output <output> of the black box <box>. <help> defines the help string for the newly created output";
    mCommandDict[info.keyword] = info;

    info.keyword = "set";
    info.argmin = 2;
    info.argmax = 2;
    info.code = cSet;
    info.syntax = "set <box.input> <value>";
    info.help = "Sets the value of the input <input> of the black box <box> to <value>. There must exist a string to the value type adaptor";
    mCommandDict[info.keyword] = info;
   
    info.keyword = "config";  // JPR
    info.argmin = 0;
    info.argmax = 0;
    info.code = cConfig;
    info.syntax = "config";
    info.help = "Prints the value of all configuration parameters";
    mCommandDict[info.keyword] = info;

    info.keyword = "index";  // LG
    info.argmin = 0;
    info.argmax = 2;
    info.code = cIndex;

    info.syntax = "index [<filename> ['Initials'(default)|'Packages'|'Categories'|'Adaptors']]";
    info.help = "Creates an html index of known boxes. If filename is provided then save it to the file 'filename'. The default index entries are the initial letters of the names of the boxes. If 'Packages' or 'Categories' is provided then the entries are either the packages names or the categories. If 'Adaptors' is provided then an alphabetical index of all adaptors is created.";
    mCommandDict[info.keyword] = info;

    info.keyword = "reset";  
    info.argmin = 0;
    info.argmax = 0;
    info.code = cReset;
    info.syntax = "reset";
    info.help = "Deletes all boxes and unloads all packages (reset to start state)";
    mCommandDict[info.keyword] = info;

    info.keyword = "author";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cAuthor;
    info.syntax = "author <string>";
    info.help = "Adds the string <string> to the author information of the black box being defined";
    mCommandDict[info.keyword] = info;
    
    info.keyword = "category"; //JP
    info.argmin = 1;
    info.argmax = 1;
    info.code = cCategory;
    info.syntax = "category <list of items, separated by ;>";
    info.help = "Adds the string <string> to the category information of the black box being defined";
    mCommandDict[info.keyword] = info;

    info.keyword = "description";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cDescription;
    info.syntax = "description <string>";
    info.help = "Adds the string <string> to the descriptive information of the black box being defined";
    mCommandDict[info.keyword] = info;

    info.keyword = "help";
    info.argmin = 0;
    info.argmax = 2;
    info.code = cHelp;
    info.syntax = "help";
    info.syntax = "\n         (1) help \n         (2) help <command name> \n         (3) help packages [all]\n         (4) help <package name> [all]\n         (5) help <black box type> \n         (6) help <black box name>";
    info.help = "Effect :\n         (1) Lists all available commands;\n         (2) Prints help on a particular command; \n         (3) Lists the packages loaded and their black boxes.\n             Add 'all' to list adaptors; \n         (4) Prints short help on the black boxes of a package.\n             Add 'all' to include adaptors; \n         (5) Prints full help on a black box type; \n         (6) Prints information on the inputs, outputs and connections of a black box instance.";
    mCommandDict[info.keyword] = info;

    info.keyword = "message";
    info.argmin = 0;
    info.argmax = 2;
    info.code = cMessage;
    info.syntax = "message <kind> <level>";
    info.help = "Sets the level of the kind of messages <kind> to <level>.\n  If kind='All' then sets the level for all kinds. If no kind nor level is passed then prints info on available kinds of messages and their current level.";  
    mCommandDict[info.keyword] = info;

    info.keyword = "include";
    info.argmin = 1;
    info.argmax = 2;
    info.code = cInclude;
    info.syntax = "include <filename> [source]";
    info.help = "Includes the file <filename>.\n  'source' : If the keyword 'source' is provided then informs the interpreter that the included file is the source of the current box definition (Advanced; used to get the right 'Include' field in html doc of packages 'appli' scripts).";
    mCommandDict[info.keyword] = info;

    info.keyword = "quit";
    info.argmin = 0;
    info.argmax = 0;
    info.code = cQuit;
    info.syntax = "quit";
    info.help = "Quits the program (during script execution it stops the complete execution)";
    mCommandDict[info.keyword] = info;

    info.keyword = "load";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cLoad;
    info.syntax = "load <packagename>";
    info.help = "Loads the black box package <packagename>";
    mCommandDict[info.keyword] = info;

    info.keyword = "unload";
    info.argmin = 1;
    info.argmax = 1;
    info.code = cUnload;
    info.syntax = "unload <packagename>";
    info.help = "Unloads the black box package <packagename>";
    mCommandDict[info.keyword] = info;

    info.keyword = "graph";
    info.argmin = 0;
    info.argmax = 6;
    info.code = cGraph;
    info.syntax = "graph [ BlackBoxName [ Detail 0..1 [ Level 0..99999 [ Output html file [ Custom header [ Custom title ]]]]]] \n         graph [ BlackBoxNameType [ Detail 0..1 [ Level 0..99999 [ Output html file [ Custom header [ Custom title ]]]]]]";
    info.help = "Shows a graphical view of a bbtk pipeline.\n- BlackBoxName : name of the box to view. Default '.' : current box.\n- BlackBoxNameType : name of the type of box to view, ex : 'workspace')";
    mCommandDict[info.keyword] = info;

    info.keyword = "debug";
    info.argmin = 0;
    info.argmax = 1;
    info.code = cDebug;
    info.syntax = "debug [expr|-C|-D]";
    info.help = "Prints debug info on living bbtk objects containing the string 'expr' (default expr=''). -C checks the factory integrity. -D turns on objects debug info after main ends";
    mCommandDict[info.keyword] = info;

    /*
    info.keyword = "workspace";
    info.argmin = 1;
    info.argmax = 2;
    info.code = cWorkspace;
    info.syntax = "workspace < ( freeze | unfreeze ) | ( rename <newname> ) >";
    info.help = "Configures the workspace.\n        'freeze' allows to block execution commands while keeping definition commands active. 'unfreeze' turns back the worspace in 'normal' mode.\n      'rename' allow to set a new name to the workspace.";
    mCommandDict[info.keyword] = info;
    */

    bbtkDebugDecTab("Interpreter",9);

  } 

Here is the call graph for this function:

Here is the caller graph for this function:

void bbtk::Interpreter::LoadScript	(	std::string	fullPathScriptName,
		std::string	includeScriptName
	)			[private]

Opens the file fullPathScriptName includeScriptName is the name as given to the include command

Definition at line 1339 of file bbtkInterpreter.cxx.

References bbtkError, bbtkMessage, INVALID_FILE_SEPARATOR, mFile, mFileName, mFileNameHistory, mIncludeFileName, mLine, and VALID_FILE_SEPARATOR.

Referenced by SwitchToFile().

  {
     Utilities::replace( fullPathScriptName , 
                         INVALID_FILE_SEPARATOR , VALID_FILE_SEPARATOR);
   
     if (find(mFileNameHistory.begin(),
              mFileNameHistory.end(),
              fullPathScriptName)!=mFileNameHistory.end())
     {
        return;
     }

    std::ifstream* s;
    s = new std::ifstream;
    s->open(fullPathScriptName.c_str());
    if (!s->good())
    {
        bbtkError("Could not open file ["<<fullPathScriptName<<"]");
        return;
    }

    bbtkMessage("Interpreter",1,"   -->[" << fullPathScriptName 
                << "] found" << std::endl);

    mFile.push_back(s);
    mFileName.push_back(fullPathScriptName);
    mFileNameHistory.push_back(fullPathScriptName);
    mIncludeFileName.push_back(includeScriptName);
    mLine.push_back(0);

        return;
  }

Here is the caller graph for this function:

void bbtk::Interpreter::CatchBbtkException

(

const bbtk::Exception &

e

)

[private]

Definition at line 400 of file bbtkInterpreter.cxx.

References CloseAllFiles(), mFile, mFileName, mLine, and mThrow.

  {
    if (mThrow) 
      {
        bool in_script = false;
        std::string file("");
        int line = 0;
        if (mFileName.size()) {
          std::ifstream* fs = dynamic_cast<std::ifstream*>(mFile.back());
          if (fs!=0) in_script = true;    
          file = mFileName.back();
          line = mLine.back();
        }   
        CloseAllFiles();
        throw InterpreterError(e,in_script,file,line);
      }
    else
      {
        std::stringstream mess;
        mess << "* ERROR : "<<e.GetErrorMessage()<<std::endl;
        if (mFileName.size()) {
          mess << "* FILE  : \""<<mFileName.back()<<"\""<<std::endl;
          mess << "* LINE  : "<<mLine.back()<<std::endl;
        }    
        std::cerr << mess.str();
      }
  }

Here is the call graph for this function:

void bbtk::Interpreter::CatchStdException

(

const std::exception &

e

)

[private]

Definition at line 430 of file bbtkInterpreter.cxx.

References CloseAllFiles(), mFile, mFileName, mLine, and mThrow.

  {  
    if (mThrow) 
      {
        bool in_script = false;
        std::string file("");
        int line = 0;
        if (mFileName.size()) {
          std::ifstream* fs = dynamic_cast<std::ifstream*>(mFile.back());
          if (fs!=0) in_script = true;    
          file = mFileName.back();
          line = mLine.back();
        }    
        CloseAllFiles();
        throw InterpreterError(e.what(),in_script,file,line);
      }
    else
      {
        std::stringstream mess;
        mess << "* ERROR : "<<e.what()<<std::endl;
        if (mFileName.size()) {
          mess << "* FILE  : \""<<mFileName.back()<<"\""<<std::endl;
          mess << "* LINE  : "<<mLine.back()<<std::endl;
        }    
        std::cerr << mess.str();
      }
  }

Here is the call graph for this function:

void bbtk::Interpreter::CatchUnknownException

(

)

[private]

Definition at line 460 of file bbtkInterpreter.cxx.

References CloseAllFiles(), mFile, mFileName, mLine, and mThrow.

  {
    if (mThrow) 
      {
        bool in_script = false;
        std::string file("");
        int line = 0;
        if (mFileName.size()) {
          std::ifstream* fs = dynamic_cast<std::ifstream*>(mFile.back());
          if (fs!=0) in_script = true;    
          file = mFileName.back();
          line = mLine.back();
        }    
        CloseAllFiles();
        throw InterpreterError("Unknown exception caught",
                                   in_script,file,line);
      }
    else
      {
        std::stringstream mess;
        mess << "* UNDEFINED ERROR (not a bbtk nor a std exception)" 
             << std::endl;
        if (mFileName.size()) {
          mess << "* FILE  : \""<<mFileName.back()<<"\""<<std::endl;
          mess << "* LINE  : "<<mLine.back()<<std::endl;
        }    
        std::cerr << mess.str();
      }
  }

Here is the call graph for this function:

long bbtk::Object::GetUseCount

(

)

[inline, inherited]

Definition at line 63 of file bbtkObject.h.

{ return mThisPointer.use_count(); }

void bbtk::Object::InsertInObjectList

(

Pointer

p

)

[static, inherited]

Definition at line 59 of file bbtkObject.cxx.

References bbtkDebugMessage, and bbtk::Object::mgObjectList.

  { 
    bbtkDebugMessage("object",9,"##> Object::InsertInObjectList(\""
                     <<p->GetObjectName()<<"\" ["<<p<<"])"<<std::endl);
    boost::weak_ptr<Object> w(p);
    mgObjectList.insert(w); 
  }

void bbtk::Object::RemoveFromObjectList

(

WeakPointer

p

)

[static, inherited]

Definition at line 80 of file bbtkObject.cxx.

References bbtkDebugMessage, and bbtk::Object::mgObjectList.

  { 
    bbtkDebugMessage("object",9,"##> Object::RemoveFromObjectList()"
                     <<std::endl);
    mgObjectList.erase(p);

  }

void bbtk::Object::InsertInPackageList

(

Pointer

p

)

[static, inherited]

Definition at line 69 of file bbtkObject.cxx.

References bbtkDebugMessage, and bbtk::Object::mgPackageList.

  { 
    bbtkDebugMessage("object",9,"##> Object::InsertInPackageList(\""
                     <<p->GetObjectName()<<"\" ["<<p<<"])"<<std::endl);
    boost::weak_ptr<Object> w(p);
    mgPackageList.insert(w); 
  }

void bbtk::Object::ReleasePackages

(

)

[static, inherited]

Definition at line 213 of file bbtkObject.cxx.

References bbtkDebugMessage, bbtk::i, and bbtk::Object::mgPackageList.

  {
    bbtkDebugMessage("object",1,"##> Object::ReleasePackages()"<<std::endl);
    // Release package pointers
    ObjectListType::iterator i;
    for (i = mgPackageList.begin();
         i!= mgPackageList.end();
         ++i)
      {
        if (i->use_count() != 0) 
          { 
            bbtkDebugMessage("object",1,"##> Releasing package '"<<
                             i->lock()->GetThisPointer<Package>()->GetName()
                             <<"'"<<std::endl);
            //      Object::Pointer p(i->lock());
            Package::WeakPointer w(i->lock()->GetThisPointer<Package>());
            Package::Release(w);
            /*
            if (p->GetObjectName().find(name) != std::string::npos ) 
              {
                std::cout << n << "/" << mgObjectList.size() << " ";
                PrintObjectInfo(p);
                m += p->GetObjectSize();
                n++;
              }
            */
          }
      }  

  }

void bbtk::Object::PrintObjectListInfo

(

const std::string &

name

)

[static, inherited]

Definition at line 105 of file bbtkObject.cxx.

References bbtk::i, bbtk::Object::mgObjectList, and bbtk::Object::PrintObjectInfo().

  {
    
    std::cout 
      << "=============== Living bbtk::Object pointers ========="<<std::endl;

    long n = 0;
    long u = 0;
    size_t m = 0;
    ObjectListType::iterator i;
    for (i = mgObjectList.begin();
         i!=mgObjectList.end();
         ++i)
      {
        if (i->use_count() == 0) 
          {
            u++;
          }
        else 
          { 
            Object::Pointer p(i->lock());
            if (p->GetObjectName().find(name) != std::string::npos ) 
              {
                std::cout << n << "/" << mgObjectList.size() << " ";
                PrintObjectInfo(p);
                m += p->GetObjectSize();
                n++;
              }
          }
      }
    std::cout 
      << "------------------------------------------------------"<<std::endl; 

    std::cout << " Total : "<<n<<" objects - "<<m<<" b"<<std::endl;
    if (u==1)
      {
        std::cout<<"* Note : "<<u
                 <<" object in list has 0 ref count, "
                 <<"i.e. destroyed without removing itself from the living objects list ! (this is just an implementation error not a memory leak)"<<std::endl;
      }
    else if (u>1)
      {
        std::cout<<"* Note : "<<u
                 <<" objects in list have 0 ref count, "
                 <<"i.e. destroyed without removing themselves from the living objects list ! (this is just an implementation error not a memory leak)"<<std::endl;
      }
    std::cout
      << "============ EO Living bbtk::Object pointers ========="<<std::endl;
        
  }

Here is the call graph for this function:

void bbtk::Object::PrintObjectInfo

(

const Pointer &

o

)

[static, inherited]

Definition at line 180 of file bbtkObject.cxx.

Referenced by bbtk::Object::PrintObjectListInfo().

  {
    std::cout << "* [" << p << "] \t" 
              << p.use_count()-1 << " r \t"
              << p->GetObjectRecursiveSize() << " ("
              << p->GetObjectSize() << ") b \t"
              << p->GetObjectName() 
              << std::endl;
    std::cout << p->GetObjectInfo();
  }

Here is the caller graph for this function:

static long bbtk::Object::GetObjectsCount

(

)

[inline, static, inherited]

Definition at line 75 of file bbtkObject.h.

{ return mgObjectList.size(); }

void bbtk::Object::LockThis

(

)

[inline, protected, inherited]

Definition at line 88 of file bbtkObject.h.

{ mThisPointerLocked = mThisPointer.lock(); }   

void bbtk::Object::UnLockThis

(

)

[inline, protected, inherited]

Definition at line 89 of file bbtkObject.h.

{ mThisPointerLocked = Pointer(); }

template<class U>

boost::shared_ptr<U> bbtk::Object::GetThisPointer

(

)

const [inline, protected, inherited]

Definition at line 92 of file bbtkObject.h.

    {
      return boost::dynamic_pointer_cast<U>(mThisPointer.lock());
    }

template<class U>

static boost::shared_ptr<U> bbtk::Object::MakePointer	(	U *	s,
		bool	lock = false
	)			[inline, static, protected, inherited]

Definition at line 97 of file bbtkObject.h.

Referenced by bbtk::Executer::Executer(), Init(), bbtk::Transcriptor::New(), bbtk::Package::New(), New(), bbtk::Factory::New(), and bbtk::Executer::New().

    {                                                                   
      if (s->mThisPointer.lock())                                       
        {                                                               
          boost::shared_ptr<U> p = s->GetThisPointer<U>();
          if (!lock) s->mThisPointerLocked.reset();
          return p;
        }                                                               
      boost::shared_ptr<U> p = boost::shared_ptr<U>(s,Object::Deleter());
      static_cast<Object::Deleter*>                                     
        (p._internal_get_deleter(typeid(Object::Deleter)))              
        ->mPointer = p;                                                 
      s->mThisPointer = p;                                              
      Object::InsertInObjectList(p);                                    
      if (lock) s->LockThis();                                          
      return p;                                                 
    }                                                                   

Here is the caller graph for this function:

template<class U, class D>

static boost::shared_ptr<U> bbtk::Object::MakePointer	(	U *	s,
		const D &	del,
		bool	lock = false
	)			[inline, static, protected, inherited]

Definition at line 115 of file bbtkObject.h.

    {                                                                   
      if (s->mThisPointer.lock())                                       
        {                                                               
          boost::shared_ptr<U> p = s->GetThisPointer<U>();
          if (!lock) s->mThisPointerLocked.reset();
          return p;
        }                                                               
      boost::shared_ptr<U> p = boost::shared_ptr<U>(s,del);
      static_cast<D*>                                   
        (p._internal_get_deleter(typeid(D)))            
        ->mPointer = p;                                                 
      s->mThisPointer = p;                                              
      Object::InsertInObjectList(p);                                    
      if (lock) s->LockThis();                                          
      return p;                                                 
    }                                                                   

---

Friends And Related Function Documentation

friend struct Object::Deleter [friend]

Definition at line 102 of file bbtkInterpreter.h.

---

Member Data Documentation

bbtk::VirtualExec::Pointer bbtk::Interpreter::mVirtualExecuter [private]

The command executer used.

Definition at line 306 of file bbtkInterpreter.h.

Referenced by Debug(), GetObjectRecursiveSize(), Graph(), Init(), InterpretLine(), NewGUI(), Reset(), and ~Interpreter().

bbtk::Executer::WeakPointer bbtk::Interpreter::mRealExecuter [private]

Definition at line 307 of file bbtkInterpreter.h.

Referenced by Init(), and NewGUI().

bbtk::InterpreterUser* bbtk::Interpreter::mUser [private]

The user of the interpreter (0 if none).

Definition at line 310 of file bbtkInterpreter.h.

Referenced by Graph(), Help(), and Init().

std::vector<std::istream*> bbtk::Interpreter::mFile [private]

Vector of open files / buffers (can be stringstream).

Definition at line 313 of file bbtkInterpreter.h.

Referenced by CatchBbtkException(), CatchStdException(), CatchUnknownException(), CloseAllFiles(), CloseCurrentFile(), InterpretBuffer(), InterpretFile(), LoadScript(), and SwitchToStream().

std::vector<std::string> bbtk::Interpreter::mFileName [private]

Vector of names of open files with full path (as open).

Definition at line 316 of file bbtkInterpreter.h.

Referenced by CatchBbtkException(), CatchStdException(), CatchUnknownException(), CloseCurrentFile(), InterpretLine(), LoadScript(), and SwitchToStream().

std::vector<std::string> bbtk::Interpreter::mFileNameHistory [private]

Vector of names of files which have been open before (and may closed then which are no more in mFileName) with full path (as open)

Definition at line 321 of file bbtkInterpreter.h.

Referenced by LoadScript(), and Reset().

std::vector<std::string> bbtk::Interpreter::mIncludeFileName [private]

Vector of names of open files as given to the include command.

Definition at line 324 of file bbtkInterpreter.h.

Referenced by CloseCurrentFile(), LoadScript(), and SwitchToStream().

std::vector<int> bbtk::Interpreter::mLine [private]

Stores the current line number in each open file.

Definition at line 327 of file bbtkInterpreter.h.

Referenced by CatchBbtkException(), CatchStdException(), CatchUnknownException(), CloseCurrentFile(), InterpretBuffer(), InterpretFile(), LoadScript(), and SwitchToStream().

CommandDictType bbtk::Interpreter::mCommandDict [private]

The dictionnary of commands.

Definition at line 330 of file bbtkInterpreter.h.

Referenced by FindCommandsWithPrefix(), HelpCommand(), HelpCommands(), Init(), and InterpretCommand().

bool bbtk::Interpreter::mCommandLine [private]

Are we in a command line context ?

Definition at line 333 of file bbtkInterpreter.h.

Referenced by CommandLineInterpreter(), Init(), InterpretBuffer(), InterpretFile(), and InterpretLine().

std::deque< char* > bbtk::Interpreter::mHistory [private]

The history of commands.

Definition at line 336 of file bbtkInterpreter.h.

int bbtk::Interpreter::bufferNb [private]

Definition at line 338 of file bbtkInterpreter.h.

Referenced by Init(), and SwitchToStream().

bool bbtk::Interpreter::mThrow [private]

Definition at line 340 of file bbtkInterpreter.h.

Referenced by CatchBbtkException(), CatchStdException(), CatchUnknownException(), Init(), and InterpretLine().

---

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

• /home/guigues/bbtk-build-tmp/bbtk/kernel/src/bbtkInterpreter.h
• /home/guigues/bbtk-build-tmp/bbtk/kernel/src/bbtkInterpreter.cxx