X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=kernel%2Fsrc%2FbbtkInterpreter.h;h=48bd0ae2c22cd492ce927a5faf544a458cbb2807;hb=c2a4b1893412e50a3d9abff221938a2d16c4a7cb;hp=52ec57496f1c5131332ceefb147df20a14dfbe1e;hpb=40b39757a6f9d5056bc08a59081ed19d0406837f;p=bbtk.git diff --git a/kernel/src/bbtkInterpreter.h b/kernel/src/bbtkInterpreter.h index 52ec574..48bd0ae 100644 --- a/kernel/src/bbtkInterpreter.h +++ b/kernel/src/bbtkInterpreter.h @@ -1,19 +1,19 @@ /*========================================================================= - + Program: bbtk Module: $RCSfile: bbtkInterpreter.h,v $ $ Language: C++ - Date: $Date: 2008/01/28 15:08:53 $ - Version: $Revision: 1.4 $ - + Date: $Date: 2008/04/09 11:16:57 $ + Version: $Revision: 1.25 $ + Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or http://www.creatis.insa-lyon.fr/Public/bbtk/License.html for details. - + This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the above copyright notices for more information. - + =========================================================================*/ /** * \file @@ -23,28 +23,70 @@ * \class bbtk::Interpreter * \brief The bbtk language interpreter */ - + #ifndef __bbtkInterpreter_h__ #define __bbtkInterpreter_h__ #include "bbtkVirtualExec.h" -#include "bbtkExecuter.h" -#include "bbtkTranscriptor.h" #include #include namespace bbtk { + +#ifdef _USE_WXWIDGETS_ + class WxConsole; +#endif + + class BBTK_EXPORT InterpreterUser + { + public: + InterpreterUser() {} + ~InterpreterUser() {} + + virtual bool InterpreterUserHasOwnHtmlPageViewer() { return false; } + virtual void InterpreterUserViewHtmlPage(const std::string&) {} + + + }; + + /// + class BBTK_EXPORT InterpreterError : public Exception + { + public: + InterpreterError( const std::string& message, + bool in_script_file, + const std::string& script_file, + int script_line + ); + InterpreterError( const Exception& excep, + bool in_script_file, + const std::string& script_file, + int script_line + ); + ~InterpreterError() throw() {} + + bool IsInScriptFile() const { return mInScriptFile; } + const std::string& GetScriptFile() const { return mScriptFile; } + int GetScriptLine() const { return mScriptLine; } + private: + bool mInScriptFile; + std::string mScriptFile; + int mScriptLine; + }; + + + /// class BBTK_EXPORT Interpreter { private: - + /// The enumeration of command codes == Command name - typedef enum + typedef enum { - cNew, + cNew, cDelete, cConnect, cExec, @@ -57,7 +99,8 @@ namespace bbtk cSet, cConfig, // JPR cReset, // EED - cAuthor, + cAuthor, + cCategory, // JPR cDescription, cHelp, cMessage, @@ -67,7 +110,10 @@ namespace bbtk cUnload, cGraph, cPrint, - cWorkspace // LG + cIndex, + cKind, // LG + cNewGUI, // LG + cWorkspace // LG } CommandCodeType; /// The structure storing the informations on a command @@ -85,35 +131,73 @@ namespace bbtk public: /// Constructor - Interpreter(); - + Interpreter(const std::string& cpp_file = ""); + /// Destructor ~Interpreter(); - - static Interpreter* mGlobalInterpreter; + + + typedef enum + { + Interpreter_OK, + Interpreter_ERROR, + Interpreter_QUIT + } + ExitStatus; + + /// Runs the interpretation of a file + ExitStatus InterpretFile( const std::string& filename); + + /// Runs the interpretation of a buffer and deletes it ! + ExitStatus InterpretBuffer( std::stringstream* buffer ); + + /// Runs the interpretation of a command + ExitStatus InterpretLine( const std::string& line ); + /// Launches a command line interpreter (with a prompt) void CommandLineInterpreter(); - - /// Sets the inputs of the workspace : + + + + /// Sets the inputs of the workspace : /// the map is passed as is to the Executer void SetInputs(const std::map& m) { mExecuter->SetInputs(m); } - - /// Puts the executer in "no exec" mode, + + /// Puts the executer in "no exec" mode, /// which creates but does not execute pipelines. void SetNoExecMode(bool b) { mExecuter->SetNoExecMode(b); } - /// + /// //typedef Executer::DialogModeType DialogModeType; typedef VirtualExec::DialogModeType DialogModeType; void SetDialogMode(DialogModeType t) { mExecuter->SetDialogMode(t); } - /// Runs the interpretation of a file - void InterpretFile( const std::string& filename, bool use_configuration_file=true, bool verbose=false); + /// Sets the bool that indicates wether we are in command line context + void SetCommandLine(bool v = true) { mCommandLine = v; } + + void SetThrow(bool b) { mThrow = b; } + +#ifdef _USE_WXWIDGETS_ + /// Sets the user of the interpreter (if any) + void SetUser(InterpreterUser* c) { mUser = c; } + /// Gets the InterpreterUser of this + InterpreterUser* GetUser() { return mUser; } + /// Gets the InterpreterUser of this (const) + const InterpreterUser* GetUser() const { return mUser; } + +#endif + + /// Gets the Executer + VirtualExec* GetExecuter() { return mExecuter; } + /// Gets the Executer (const) + const VirtualExec* GetExecuter() const { return mExecuter; } - /// Interprets a line (either from a file or typed interactively) + + protected: + /// Interprets a line void InterpretLine( const std::string& line, bool &insideComment ); /// Reads a line from prompt @@ -123,63 +207,91 @@ namespace bbtk void SplitLine ( const std::string& line, std::vector& words ); - /// Executes the right action depending on the command name - void InterpretCommand( const std::vector& words, + /// Executes the right action depending on the command name + void InterpretCommand( const std::vector& words, CommandInfoType& info ); - + /// Switch to the interpretation of a file - void SwitchToFile( const std::string& filename, bool use_configuration_file=true, bool verbose=false ); - + void SwitchToFile( const std::string& filename ); + + /// Switch to the interpretation of a stringstream + void SwitchToStream( std::stringstream* stream ); + /// Closes the currently open file void CloseCurrentFile(); - + /// Closes all open files void CloseAllFiles(); /// Displays help (entry point of any help) void Help(const std::vector& words); - + /// Displays help on all the commands void HelpCommands(); - + /// Displays help on a particular command void HelpCommand( const std::string& command ); - + /// void Graph(const std::vector& words); - + /// - void Config(bool verbose) const; // JPR + void Config() const; /// - void Print(const std::string&); + // void Print(const std::string&); + void Index(const std::string& filename, + const std::string& type = "Initials"); /// void FindCommandsWithPrefix( char* buf, int n, std::vector& commands ); - /// Sets the bool that indicates wether we are in command line context - void SetCommandLine(bool v = true) { mCommandLine = v; } + /// 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 + void NewGUI(const std::string& box, + const std::string& instanceName); - private: + private: + + /// Opens the file fullPathScriptName + /// includeScriptName is the name as given to the include command + void LoadScript( std::string fullPathScriptName, + std::string includeScriptName); + + /// + void CatchBbtkException( const bbtk::Exception& e ); + void CatchStdException( const std::exception& e ); + void CatchUnknownException(); private: //================================================================== // ATTRIBUTES - /// The factory - // bbtk::Factory* mFactory; - - /// The command executer + /// The command executer used bbtk::VirtualExec* mExecuter; - /// Vector of opened files - std::vector mFile; + /// The user of the interpreter (0 if none) + bbtk::InterpreterUser* mUser; + + /// Vector of open files / buffers (can be stringstream) + std::vector mFile; - /// Vector of names of open files + /// Vector of names of open files with full path (as open) std::vector mFileName; + /// 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) + std::vector mFileNameHistory; + + /// Vector of names of open files as given to the include command + std::vector mIncludeFileName; + /// Stores the current line number in each open file std::vector mLine; @@ -192,14 +304,18 @@ namespace bbtk /// The history of commands std::deque< char* > mHistory; - bool verbose; // true -> displays the search results (for packages) + int bufferNb; + + bool mThrow; + }; + // EO class Interpreter // The "Quit" exception struct QuitException : public bbtk::Exception { - QuitException() : bbtk::Exception("","","") {} + QuitException() : bbtk::Exception("Interpreter","","Quit") {} }; }