Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdevelop@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 236 insertions, 0 deletions

diff --git a/buildtools/lib/parsers/qmake/qmakeast.h b/buildtools/lib/parsers/qmake/qmakeast.h
new file mode 100644
index 00000000..b8486433
--- /dev/null
+++ b/buildtools/lib/parsers/qmake/qmakeast.h
@@ -0,0 +1,236 @@
+/***************************************************************************
+ *   Copyright (C) 2005 by Alexander Dymo                                  *
+ *   adymo@kdevelop.org                                                    *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU Library General Public License as       *
+ *   published by the Free Software Foundation; either version 2 of the    *
+ *   License, or (at your option) any later version.                       *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU Library General Public     *
+ *   License along with this program; if not, write to the                 *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+#ifndef QMAKEQMAKEAST_H
+#define QMAKEQMAKEAST_H
+
+#include <qstringlist.h>
+
+/**
+@file qmakeast.h
+Abstract Syntax Tree (AST) class declarations.
+*/
+
+namespace QMake {
+
+/**
+AST node.
+This is the base class. Objects of this type are not created by the parser.
+
+Each AST node holds the list of its children which are always deleted in the
+destructor. This way, it's possible call delete for only root AST node and
+others will be deleted automatically.
+
+Each AST node also knows how to write the information back into .pro file.
+*/
+class AST {
+public:
+    /**Type of AST node.*/
+    enum NodeType {
+        ProjectAST        /**<Project, scope or function scope.*/,
+        AssignmentAST     /**<Variable assignment.*/,
+        NewLineAST        /**<Line feed.*/,
+        CommentAST        /**<Comment.*/,
+        IncludeAST        /**<.pri include.*/,
+        OrOperatorAST     /* | */
+    };
+
+    /**Constructs AST with given node type.*/
+    AST(NodeType nodeType): m_nodeType(nodeType), m_depth(0) {}
+    virtual ~AST();
+
+    /**Adds child AST node to this node. Despite this function is virtual,
+    reimplementations should call it to make automatic destruction of
+    AST tree possible.*/
+    virtual void addChildAST(AST *node);
+    /**Removes child AST node from this node. Despite this function is virtual,
+    reimplementations should call it to make automatic destruction of
+    AST tree possible.*/
+    virtual void removeChildAST(AST *node);
+    /**Writes information stored in the AST into the @p buffer.
+    This is a default implementation which iterates over child nodes
+    and calls writeBack for each child node.*/
+    virtual void writeBack(QString &buffer);
+
+    /**@return The type of the node.*/
+    virtual NodeType nodeType() const { return m_nodeType; }
+
+    /**Sets the depth of the node in AST.*/
+    void setDepth(int depth) { m_depth = depth; }
+    /**@return The depth of the node in AST.*/
+    int depth() const { return m_depth; }
+    /**@return The indentation string based on node depth.*/
+    virtual QString indentation();
+
+    /**The list of child AST nodes.*/
+    QValueList<AST*> m_children;
+
+protected:
+    NodeType m_nodeType;
+
+private:
+    int m_depth;
+
+};
+
+
+/**
+Project AST node.
+Represents complete projects, scopes and function scopes.
+Examples:
+@code
+scopename{
+var=value
+}
+function(args){
+var=value
+}
+@endcode
+*/
+class ProjectAST: public AST {
+public:
+    /**The kind of a project node.*/
+    enum Kind {
+        Project        /**<Project*/,
+        Scope          /**<Scope*/,
+        FunctionScope  /**<FunctionScope*/,
+        Empty          /**<Project does not exist, the AST is empty*/
+    };
+
+    enum LineEnding {
+        Unix,
+        MacOS,
+        Windows
+    };
+
+    /**Constructs a project node of given @p kind.*/
+    ProjectAST(Kind kind = Project): AST(AST::ProjectAST), m_kind(kind) {}
+
+    virtual void writeBack(QString &buffer);
+
+    /**@return true if this node is a project.*/
+    bool isProject() const { return m_kind == Project; }
+    /**@return true if this node is a scope.*/
+    bool isScope() const { return m_kind == Scope; }
+    /**@return true if this node is a function scope.*/
+    bool isFunctionScope() const { return m_kind == FunctionScope; }
+    /**@return true if this node is empty.*/
+    bool isEmpty() const { return m_kind == Empty; }
+
+    void setFileName(const QString& fileName) { m_fileName = fileName; }
+    QString fileName() const { return m_fileName; }
+
+    void setLineEnding( LineEnding );
+    LineEnding lineEnding();
+
+    /**Scoped identifier (scope name or function name).*/
+    QString scopedID;
+    /**Function arguments. Empty for other kinds of projects.*/
+    QString args;
+
+private:
+    Kind m_kind;
+    QString m_fileName;
+    LineEnding m_lineEnding;
+};
+
+
+/**
+Assignment AST node.
+Represents assignments, for example:
+<pre>
+var=value
+</pre>
+
+Values can be specified on several lines and
+each line is stored as a string in the list of values.@n
+For example, if we have in .pro:
+<pre>
+SOURCES=a.cpp \
+    b.cpp c.cpp
+</pre>
+then values will be stored as a two elements list:
+<pre>
+a.cpp
+    b.cpp c.cpp
+</pre>
+*/
+class AssignmentAST: public AST {
+public:
+    AssignmentAST(): AST(AST::AssignmentAST){}
+    ~AssignmentAST();
+
+    virtual void writeBack(QString &buffer);
+
+    /**Scoped name of the variable.*/
+    QString scopedID;
+    /**Operator.*/
+    QString op;
+    /**List of values.*/
+    QStringList values;
+    /**Indentation of multiline values*/
+    QString indent;
+};
+
+
+/**
+New line AST node.
+Represents line feeds in files.
+*/
+class NewLineAST: public AST {
+public:
+    NewLineAST(): AST(AST::NewLineAST) {}
+
+    virtual void writeBack(QString &buffer);
+
+};
+
+
+/**
+Comment AST node.
+Represents comments.
+*/
+class CommentAST: public AST {
+public:
+    CommentAST(): AST(AST::CommentAST) {}
+
+    virtual void writeBack(QString &buffer);
+
+    /**Comment text.*/
+    QString comment;
+
+};
+
+
+/**
+Include AST node.
+Represents pri include.
+ */
+class IncludeAST: public AST {
+public:
+    IncludeAST(): AST(AST::IncludeAST) {}
+
+    virtual void writeBack(QString &buffer);
+
+    QString projectName;
+};
+
+}
+
+#endif