rubyscript.h

00001 /***************************************************************************
00002  * rubyscript.h
00003  * This file is part of the KDE project
00004  * copyright (C)2005 by Cyrille Berger (cberger@cberger.net)
00005  *
00006  * This program is free software; you can redistribute it and/or
00007  * modify it under the terms of the GNU Library General Public
00008  * License as published by the Free Software Foundation; either
00009  * version 2 of the License, or (at your option) any later version.
00010  * This program is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  * Library General Public License for more details.
00014  * You should have received a copy of the GNU Library General Public License
00015  * along with this program; see the file COPYING.  If not, write to
00016  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00017  * Boston, MA 02110-1301, USA.
00018  ***************************************************************************/
00019 
00020 #ifndef KROSS_RUBYRUBYSCRIPT_H
00021 #define KROSS_RUBYRUBYSCRIPT_H
00022 
00023 #include <api/script.h>
00024 
00025 namespace Kross {
00026 
00027 namespace Ruby {
00028 
00029 class RubyScriptPrivate;
00030 
00031 /**
00032  * Handle ruby scripts. This class implements
00033  * \a Kross::Api::Script for ruby.
00034  * @author Cyrille Berger
00035  */
00036 class RubyScript : public Kross::Api::Script
00037 {
00038     public:
00039 
00040         /**
00041          * Constructor.
00042          *
00043          * @param interpreter The @a RubyInterpreter instance used to
00044          *        create this script.
00045          * @param scriptcontainer The @a Kross::Api::ScriptContainer
00046          *        instance this @a RubyScript does handle the
00047          *        backend-work for.
00048          */
00049         RubyScript(Kross::Api::Interpreter* interpreter, Kross::Api::ScriptContainer* scriptcontainer);
00050 
00051         /**
00052          * Destructor.
00053          */
00054         ~RubyScript();
00055 
00056         /**
00057          * Return a list of callable functionnames this
00058          * script spends.
00059          */
00060         virtual const QStringList& getFunctionNames();
00061 
00062         /**
00063          * Execute the script.
00064          */
00065         virtual Kross::Api::Object::Ptr execute();
00066 
00067         /**
00068          * Call a function.
00069          */
00070         virtual Kross::Api::Object::Ptr callFunction(const QString& name, Kross::Api::List::Ptr args);
00071 
00072         /**
00073          * Return a list of class types this script supports.
00074          */
00075         virtual const QStringList& getClassNames();
00076 
00077         /**
00078          * Create and return a new class instance.
00079          */
00080         virtual Kross::Api::Object::Ptr classInstance(const QString& name);
00081 
00082     private:
00083 
00084         /**
00085          * Compile the script.
00086          */
00087         void compile();
00088 
00089     private:
00090         /// Private d-pointer.
00091         RubyScriptPrivate* d;
00092 };
00093 
00094 }
00095 
00096 }
00097 
00098 #endif

Generated on Thu Feb 9 17:59:11 2006 for Kross by  doxygen 1.4.6