]> Creatis software - bbtk.git/blobdiff - kernel/src/bbtkInterpreter.h
=== MAJOR RELEASE ====
[bbtk.git] / kernel / src / bbtkInterpreter.h
index 732e8f725144e0aff6683f102b7749b1c337729f..b5ca18f3d168b349e071155f4eb53a76c83d8b41 100644 (file)
@@ -3,8 +3,8 @@
   Program:   bbtk
   Module:    $RCSfile: bbtkInterpreter.h,v $ $
   Language:  C++
-  Date:      $Date: 2008/01/29 10:12:45 $
-  Version:   $Revision: 1.5 $
+  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
 #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
@@ -57,7 +165,8 @@ namespace bbtk
       cSet,
       cConfig,  // JPR
       cReset,   // EED
-      cAuthor,
+      cAuthor, 
+      cCategory, // JPR
       cDescription,
       cHelp,
       cMessage,
@@ -67,7 +176,11 @@ namespace bbtk
       cUnload,
       cGraph,
       cPrint,
-      cWorkspace // LG
+      cIndex,
+      cKind, // LG
+      cNewGUI, // LG
+      cWorkspace, // LG
+      cObject
     } CommandCodeType;
 
     /// The structure storing the informations on a command 
@@ -83,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, bool use_configuration_file=true, bool verbose=false);
-
-    /// 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
@@ -128,7 +212,10 @@ namespace bbtk
                            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();
@@ -149,39 +236,67 @@ namespace bbtk
     void Graph(const std::vector<std::string>& 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<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:
 
-  void LoadScript( std::string fullPathScriptName);
+    /// 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);
+
+    /// 
+    void CatchBbtkException( const bbtk::Exception& e );
+    void CatchStdException( const std::exception& e );
+    void CatchUnknownException();
 
-  private:
 
+  
     //==================================================================
     // 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 opened 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
+    /// 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;
+
     /// Stores the current line number in each open file
     std::vector<int> mLine;
 
@@ -194,14 +309,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") {}
   };
 
 }