/**************************************************************************** ** ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the tools applications of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** No Commercial Usage ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the Technology Preview License Agreement accompanying ** this package. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** ** ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ /* qmlcodemarker.cpp */ #include "private/qdeclarativejsast_p.h" #include "private/qdeclarativejsastfwd_p.h" #include "private/qdeclarativejsengine_p.h" #include "private/qdeclarativejslexer_p.h" #include "private/qdeclarativejsnodepool_p.h" #include "private/qdeclarativejsparser_p.h" #include "atom.h" #include "node.h" #include "qmlcodemarker.h" #include "qmlmarkupvisitor.h" #include "text.h" #include "tree.h" QT_BEGIN_NAMESPACE QmlCodeMarker::QmlCodeMarker() { } QmlCodeMarker::~QmlCodeMarker() { } /*! Returns true if the \a code is recognized by the parser. */ bool QmlCodeMarker::recognizeCode(const QString &code) { QDeclarativeJS::Engine engine; QDeclarativeJS::Lexer lexer(&engine); QDeclarativeJS::Parser parser(&engine); QDeclarativeJS::NodePool m_nodePool("", &engine); QString newCode = code; extractPragmas(newCode); lexer.setCode(newCode, 1); return parser.parse(); } /*! Returns true if \a ext is any of a list of file extensions for the QML language. */ bool QmlCodeMarker::recognizeExtension(const QString &ext) { return ext == "qml"; } /*! Returns true if the \a language is recognized. Only "QML" is recognized by this marker. */ bool QmlCodeMarker::recognizeLanguage(const QString &language) { return language == "QML"; } /*! Returns the name of the \a node. Method names include are returned with a trailing set of parentheses. */ QString QmlCodeMarker::plainName(const Node *node) { QString name = node->name(); if (node->type() == Node::QmlMethod) name += "()"; return name; } QString QmlCodeMarker::plainFullName(const Node *node, const Node *relative) { if (node->name().isEmpty()) { return "global"; } else { QString fullName; while (node) { fullName.prepend(plainName(node)); if (node->parent() == relative || node->parent()->name().isEmpty()) break; fullName.prepend("::"); node = node->parent(); } return fullName; } } QString QmlCodeMarker::markedUpCode(const QString &code, const Node *relative, const QString &dirPath) { return addMarkUp(code, relative, dirPath); } QString QmlCodeMarker::markedUpName(const Node *node) { QString name = linkTag(node, taggedNode(node)); if (node->type() == Node::QmlMethod) name += "()"; return name; } QString QmlCodeMarker::markedUpFullName(const Node *node, const Node *relative) { if (node->name().isEmpty()) { return "global"; } else { QString fullName; for (;;) { fullName.prepend(markedUpName(node)); if (node->parent() == relative || node->parent()->name().isEmpty()) break; fullName.prepend("<@op>::"); node = node->parent(); } return fullName; } } QString QmlCodeMarker::markedUpIncludes(const QStringList& includes) { QString code; QStringList::ConstIterator inc = includes.begin(); while (inc != includes.end()) { code += "import " + *inc + "\n"; ++inc; } return protect(addMarkUp(code, 0, "")); } QString QmlCodeMarker::functionBeginRegExp(const QString& funcName) { return "^" + QRegExp::escape("function " + funcName) + "$"; } QString QmlCodeMarker::functionEndRegExp(const QString& /* funcName */) { return "^\\}$"; } QString QmlCodeMarker::addMarkUp(const QString &code, const Node * /* relative */, const QString & /* dirPath */) { QDeclarativeJS::Engine engine; QDeclarativeJS::Lexer lexer(&engine); QString newCode = code; QList pragmas = extractPragmas(newCode); lexer.setCode(newCode, 1); QDeclarativeJS::Parser parser(&engine); QDeclarativeJS::NodePool m_nodePool("", &engine); QString output; if (parser.parse()) { QDeclarativeJS::AST::UiProgram *ast = parser.ast(); // Pass the unmodified code to the visitor so that pragmas and other // unhandled source text can be output. QmlMarkupVisitor visitor(code, pragmas, &engine); QDeclarativeJS::AST::Node::accept(ast, &visitor); output = visitor.markedUpCode(); } return output; } /* Copied and pasted from src/declarative/qml/qdeclarativescriptparser.cpp. */ static void replaceWithSpace(QString &str, int idx, int n) { QChar *data = str.data() + idx; const QChar space(QLatin1Char(' ')); for (int ii = 0; ii < n; ++ii) *data++ = space; } /* Copied and pasted from src/declarative/qml/qdeclarativescriptparser.cpp then modified to return a list of removed pragmas. Searches for ".pragma " declarations within \a script. Currently supported pragmas are: library */ QList QmlCodeMarker::extractPragmas(QString &script) { const QString pragma(QLatin1String("pragma")); const QString library(QLatin1String("library")); QList removed; QDeclarativeJS::Lexer l(0); l.setCode(script, 0); int token = l.lex(); while (true) { if (token != QDeclarativeJSGrammar::T_DOT) return removed; int startOffset = l.tokenOffset(); int startLine = l.currentLineNo(); int startColumn = l.currentColumnNo(); token = l.lex(); if (token != QDeclarativeJSGrammar::T_IDENTIFIER || l.currentLineNo() != startLine || script.mid(l.tokenOffset(), l.tokenLength()) != pragma) return removed; token = l.lex(); if (token != QDeclarativeJSGrammar::T_IDENTIFIER || l.currentLineNo() != startLine) return removed; QString pragmaValue = script.mid(l.tokenOffset(), l.tokenLength()); int endOffset = l.tokenLength() + l.tokenOffset(); token = l.lex(); if (l.currentLineNo() == startLine) return removed; if (pragmaValue == QLatin1String("library")) { replaceWithSpace(script, startOffset, endOffset - startOffset); removed.append( QDeclarativeJS::AST::SourceLocation( startOffset, endOffset - startOffset, startLine, startColumn)); } else return removed; } return removed; } QT_END_NAMESPACE