/**************************************************************************** ** ** Copyright (C) 2015 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing ** ** This file is part of the Qt Build Suite. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms and ** conditions see http://www.qt.io/terms-conditions. For further information ** use the contact form at http://www.qt.io/contact-us. ** ** 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 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, The Qt Company gives you certain additional ** rights. These rights are described in The Qt Company LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ****************************************************************************/ #include "item.h" #include "builtindeclarations.h" #include "deprecationinfo.h" #include "filecontext.h" #include "itemobserver.h" #include "itempool.h" #include "value.h" #include #include #include #include #include namespace qbs { namespace Internal { Item::Item(ItemPool *pool, ItemType type) : m_pool(pool) , m_propertyObserver(0) , m_prototype(0) , m_scope(0) , m_outerItem(0) , m_parent(0) , m_type(type) { } Item::~Item() { if (m_propertyObserver) m_propertyObserver->onItemDestroyed(this); } Item *Item::create(ItemPool *pool, ItemType type) { return pool->allocateItem(type); } Item *Item::clone() const { Item *dup = create(pool()); dup->m_id = m_id; dup->m_type = m_type; dup->m_typeName = m_typeName; dup->m_location = m_location; dup->m_prototype = m_prototype; dup->m_scope = m_scope; dup->m_outerItem = m_outerItem; dup->m_parent = m_parent; dup->m_file = m_file; dup->m_propertyDeclarations = m_propertyDeclarations; dup->m_functions = m_functions; dup->m_modules = m_modules; dup->m_children.reserve(m_children.count()); foreach (const Item *child, m_children) { Item *clonedChild = child->clone(); clonedChild->m_parent = dup; dup->m_children.append(clonedChild); } for (PropertyMap::const_iterator it = m_properties.constBegin(); it != m_properties.constEnd(); ++it) { dup->m_properties.insert(it.key(), it.value()->clone()); } return dup; } bool Item::hasProperty(const QString &name) const { const Item *item = this; do { if (item->m_properties.contains(name)) return true; item = item->m_prototype; } while (item); return false; } bool Item::hasOwnProperty(const QString &name) const { return m_properties.contains(name); } ValuePtr Item::property(const QString &name) const { ValuePtr value; const Item *item = this; do { if ((value = item->m_properties.value(name))) break; item = item->m_prototype; } while (item); return value; } ItemValuePtr Item::itemProperty(const QString &name, bool create) { ItemValuePtr result; ValuePtr v = property(name); if (v && v->type() == Value::ItemValueType) { result = v.staticCast(); } else if (create) { result = ItemValue::create(Item::create(m_pool)); setProperty(name, result); } return result; } JSSourceValuePtr Item::sourceProperty(const QString &name) const { ValuePtr v = property(name); if (!v || v->type() != Value::JSSourceValueType) return JSSourceValuePtr(); return v.staticCast(); } VariantValuePtr Item::variantProperty(const QString &name) const { ValuePtr v = property(name); if (!v || v->type() != Value::VariantValueType) return VariantValuePtr(); return v.staticCast(); } PropertyDeclaration Item::propertyDeclaration(const QString &name) const { const PropertyDeclaration decl = m_propertyDeclarations.value(name); return (!decl.isValid() && m_prototype) ? m_prototype->propertyDeclaration(name) : decl; } void Item::addModule(const Item::Module &module) { const auto it = std::lower_bound(m_modules.begin(), m_modules.end(), module); QBS_CHECK(it == m_modules.end() || (module.name != it->name && module.item != it->item)); m_modules.insert(it, module); } void Item::setPropertyObserver(ItemObserver *observer) const { QBS_ASSERT(!observer || !m_propertyObserver, return); // warn if accidentally overwritten m_propertyObserver = observer; } void Item::setProperty(const QString &name, const ValuePtr &value) { m_properties.insert(name, value); if (m_propertyObserver) m_propertyObserver->onItemPropertyChanged(this); } void Item::dump() const { dump(0); } bool Item::isPresentModule() const { // Initial value is "true" as JS source, overwritten one is always QVariant(false). const ValueConstPtr v = property(QLatin1String("present")); return v && v->type() == Value::JSSourceValueType; } void Item::setupForBuiltinType(Logger &logger) { const BuiltinDeclarations &builtins = BuiltinDeclarations::instance(); foreach (const PropertyDeclaration &pd, builtins.declarationsForType(type()).properties()) { m_propertyDeclarations.insert(pd.name(), pd); ValuePtr &value = m_properties[pd.name()]; if (!value) { JSSourceValuePtr sourceValue = JSSourceValue::create(); sourceValue->setFile(file()); static const QString undefinedKeyword = QLatin1String("undefined"); sourceValue->setSourceCode(pd.initialValueSource().isEmpty() ? QStringRef(&undefinedKeyword) : QStringRef(&pd.initialValueSource())); value = sourceValue; } else if (pd.isDeprecated()) { const DeprecationInfo &di = pd.deprecationInfo(); if (di.removalVersion() <= Version::qbsVersion()) { QString message = Tr::tr("The property '%1' is no longer valid for %2 items. " "It was removed in qbs %3.") .arg(pd.name(), typeName(), di.removalVersion().toString()); ErrorInfo error(message, value->location()); if (!di.additionalUserInfo().isEmpty()) error.append(di.additionalUserInfo()); throw error; } QString warning = Tr::tr("The property '%1' is deprecated and will be removed in " "qbs %2.").arg(pd.name(), di.removalVersion().toString()); ErrorInfo error(warning, value->location()); if (!di.additionalUserInfo().isEmpty()) error.append(di.additionalUserInfo()); logger.printWarning(error); } } } void Item::copyProperty(const QString &propertyName, Item *target) const { target->setProperty(propertyName, property(propertyName)); } static const char *valueType(const Value *v) { switch (v->type()) { case Value::JSSourceValueType: return "JS source"; case Value::ItemValueType: return "Item"; case Value::VariantValueType: return "Variant"; case Value::BuiltinValueType: return "Built-in"; } return ""; // For dumb compilers. } void Item::dump(int indentation) const { const QByteArray indent(indentation, ' '); qDebug("%stype: %s, pointer value: %p", indent.constData(), qPrintable(m_typeName), this); if (!m_properties.isEmpty()) qDebug("%sproperties:", indent.constData()); for (auto it = m_properties.constBegin(); it != m_properties.constEnd(); ++it) { const QByteArray nextIndent(indentation + 4, ' '); qDebug("%skey: %s, value type: %s", nextIndent.constData(), qPrintable(it.key()), valueType(it.value().data())); switch (it.value()->type()) { case Value::JSSourceValueType: qDebug("%svalue: %s", nextIndent.constData(), qPrintable(it.value().staticCast()->sourceCodeForEvaluation())); break; case Value::ItemValueType: qDebug("%svalue:", nextIndent.constData()); it.value().staticCast()->item()->dump(indentation + 8); break; case Value::VariantValueType: qDebug("%svalue: %s", nextIndent.constData(), qPrintable(it.value().staticCast()->value().toString())); break; case Value::BuiltinValueType: break; } } if (!m_children.isEmpty()) qDebug("%schildren:", indent.constData()); foreach (const Item * const child, m_children) child->dump(indentation + 4); if (prototype()) { qDebug("%sprototype:", indent.constData()); prototype()->dump(indentation + 4); } } void Item::removeProperty(const QString &name) { m_properties.remove(name); } Item *Item::child(ItemType type, bool checkForMultiple) const { Item *child = 0; foreach (Item * const currentChild, children()) { if (currentChild->type() == type) { if (!checkForMultiple) return currentChild; if (child) { ErrorInfo error(Tr::tr("Multiple instances of item '%1' found where at most one " "is allowed.") .arg(BuiltinDeclarations::instance().nameForType(type))); error.append(Tr::tr("First item"), child->location()); error.append(Tr::tr("Second item"), currentChild->location()); throw error; } child = currentChild; } } return child; } void Item::addChild(Item *parent, Item *child) { parent->m_children.append(child); child->setParent(parent); } void Item::setPropertyDeclaration(const QString &name, const PropertyDeclaration &declaration) { m_propertyDeclarations.insert(name, declaration); } } // namespace Internal } // namespace qbs