]> Creatis software - bbtk.git/blobdiff - kernel/src/bbtkInterpreter.h
=== MAJOR RELEASE ====
[bbtk.git] / kernel / src / bbtkInterpreter.h
index 124323be80bdc9ed46abdad1984b48e18dfa303a..b5ca18f3d168b349e071155f4eb53a76c83d8b41 100644 (file)
@@ -3,8 +3,8 @@
   Program:   bbtk
   Module:    $RCSfile: bbtkInterpreter.h,v $ $
   Language:  C++
-  Date:      $Date: 2008/03/03 08:06:36 $
-  Version:   $Revision: 1.12 $
+  Date:      $Date: 2008/04/18 12:59:15 $
+  Version:   $Revision: 1.26 $
 
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
@@ -28,8 +28,6 @@
 #define __bbtkInterpreter_h__
 
 #include "bbtkVirtualExec.h"
-#include "bbtkExecuter.h"
-#include "bbtkTranscriptor.h"
 
 #include <fstream>
 #include <deque>
 namespace bbtk
 {
 
-
-  class BBTK_EXPORT Interpreter
+#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 : public Object
+  {
+    BBTK_OBJECT_INTERFACE(Interpreter);
+    typedef Object Superclass;
+  public:
+    static Pointer New(const std::string& cpp_file = "");
+
+    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 :
+    /// the map is passed as is to the Executer
+    void SetInputs(const std::map<std::string,std::string>& m)
+    { mExecuter->SetInputs(m); }
+
+    /// 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); }
+
+    /// 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::Pointer GetExecuter() const { return mExecuter; }
+
+
+  protected:
 
     /// The enumeration of command codes == Command name
     typedef enum
@@ -71,13 +177,16 @@ namespace bbtk
       cGraph,
       cPrint,
       cIndex,
-      cWorkspace // LG
+      cKind, // LG
+      cNewGUI, // LG
+      cWorkspace, // LG
+      cObject
     } CommandCodeType;
 
     /// The structure storing the informations on a command 
     typedef struct 
     {
-      std::string category;
+      std::string keyword;
       int argmin, argmax;
       CommandCodeType code;
       std::string syntax;
@@ -87,37 +196,8 @@ namespace bbtk
     /// The type of dictionnary of commands 
     typedef std::map<std::string,CommandInfoType> CommandDictType;
 
-  public:
-    /// Constructor
-    Interpreter();
-
-    /// Destructor
-    ~Interpreter();
-
-   static Interpreter* mGlobalInterpreter;
-
-    /// Launches a command line interpreter (with a prompt)
-    void CommandLineInterpreter();
-
-    /// Sets the inputs of the workspace :
-    /// the map is passed as is to the Executer
-    void SetInputs(const std::map<std::string,std::string>& m)
-    { mExecuter->SetInputs(m); }
-
-    /// 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);
 
-    /// Interprets a line (either from a file or typed interactively)
+    /// Interprets a line 
     void InterpretLine( const std::string& line, bool &insideComment );
 
     /// Reads a line from prompt
@@ -134,6 +214,9 @@ namespace bbtk
     /// Switch to the interpretation of a file
     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();
 
@@ -155,7 +238,7 @@ namespace bbtk
     ///
     void Config() const; 
     /// 
-    void Print(const std::string&);
+    //    void Print(const std::string&);
 
     void Index(const std::string& filename, 
               const std::string& type = "Initials");
@@ -164,34 +247,53 @@ namespace bbtk
                                 int n,
                                 std::vector<std::string>& 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);
 
+    void ObjectInfo(const std::string& name);
 
   private:
 
+    /// Constructor
+    Interpreter(const std::string& cpp_file = "");
+
     /// Opens the file fullPathScriptName 
     /// includeScriptName is the name as given to the include command 
     void LoadScript( std::string fullPathScriptName,
                     std::string includeScriptName);
 
-  private:
+    /// 
+    void CatchBbtkException( const bbtk::Exception& e );
+    void CatchStdException( const std::exception& e );
+    void CatchUnknownException();
+
 
+  
     //==================================================================
     // ATTRIBUTES
 
-    /// The factory
-    //    bbtk::Factory* mFactory;
+    /// The command executer used
+    bbtk::VirtualExec::Pointer mExecuter;
 
-    /// The command executer
-    bbtk::VirtualExec* mExecuter;
+    /// The user of  the interpreter (0 if none)
+    bbtk::InterpreterUser* mUser;
 
-    /// Vector of open files 
-    std::vector<std::ifstream*> mFile;
+    /// Vector of open files / buffers (can be stringstream)
+    std::vector<std::istream*> mFile;
 
     /// Vector of names of open files with full path (as open)
     std::vector<std::string> 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<std::string> mFileNameHistory;
+
     /// Vector of names of open files as given to the include command
     std::vector<std::string> mIncludeFileName;
 
@@ -207,13 +309,18 @@ namespace bbtk
     /// The history of commands
     std::deque< char* > mHistory;
 
+   int bufferNb;
+    
+    bool mThrow;
+
   };
+  // EO class Interpreter
 
 
   // The "Quit" exception
   struct QuitException : public bbtk::Exception
   {
-    QuitException() : bbtk::Exception("","","") {}
+    QuitException() : bbtk::Exception("Interpreter","","Quit") {}
   };
 
 }