From 074b0b86747198ee1862ca0450d5192137cccdee Mon Sep 17 00:00:00 2001 From: Thiago Macieira Date: Mon, 6 Mar 2006 15:27:56 +0000 Subject: 2006-03-06 Thiago Macieira * qt/dbusidl2cpp.cpp: * qt/Makefile.am: add the dbusidl2cpp tool, the replacement for dcopidl2cpp, found in the KDE installations (or the more modern kalyptus): generate Qt4 C++ code for the input XML introspection. Currently no IDL parsing. --- ChangeLog | 8 + qt/Makefile.am | 4 + qt/dbusidl2cpp.cpp | 881 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 893 insertions(+) create mode 100644 qt/dbusidl2cpp.cpp diff --git a/ChangeLog b/ChangeLog index 86dea3a2..627e00fb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-03-06 Thiago Macieira + + * qt/dbusidl2cpp.cpp: + * qt/Makefile.am: add the dbusidl2cpp tool, the replacement + for dcopidl2cpp, found in the KDE installations (or the more + modern kalyptus): generate Qt4 C++ code for the input XML + introspection. Currently no IDL parsing. + 2006-03-06 Thiago Macieira * test/qt/*: Update the self-tests. diff --git a/qt/Makefile.am b/qt/Makefile.am index b133ece5..1f87216b 100644 --- a/qt/Makefile.am +++ b/qt/Makefile.am @@ -60,6 +60,10 @@ libdbus_qt4_1_la_SOURCES = \ qdbusvariant.h \ qdbusxmlparser_p.h +bin_PROGRAMS = dbusidl2cpp +dbusidl2cpp_SOURCES = dbusidl2cpp.cpp +dbusidl2cpp_LDFLAGS = $(all_libraries) -no-undefined +dbusidl2cpp_LDADD = $(LIB_QTCORE) libdbus-qt4-1.la qdbusabstractadaptor.lo: qdbusabstractadaptor.moc qdbusabstractadaptor_p.moc qdbusserver.lo: qdbusserver.moc diff --git a/qt/dbusidl2cpp.cpp b/qt/dbusidl2cpp.cpp new file mode 100644 index 00000000..51fb8e45 --- /dev/null +++ b/qt/dbusidl2cpp.cpp @@ -0,0 +1,881 @@ +/* -*- C++ -*- + * + * Copyright (C) 2006 Trolltech AS. All rights reserved. + * Author: Thiago Macieira + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU 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 General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * + */ + +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include + +#include + +#define PROGRAMNAME "dbusidl2cpp" +#define PROGRAMVERSION "0.1" +#define PROGRAMCOPYRIGHT "Copyright (C) 2006 Trolltech AS. All rights reserved." + +#define ANNOTATION_NO_WAIT "org.freedesktop.DBus.Method.NoReply" + +static const char cmdlineOptions[] = "a:h:Np:vV"; +static const char *proxyFile; +static const char *adaptorFile; +static const char *inputFile; +static bool skipNamespaces; +static bool verbose; +static QStringList wantedInterfaces; + +static const char help[] = + "Usage: " PROGRAMNAME " [options...] [idl-or-xml-file] [interfaces...]\n" + "Produces the C++ code to implement the interfaces defined in the input file.\n" + "If no options are given, the code is written to the standard output.\n" + "\n" + "Options:\n" + " -a Write the adaptor code to \n" + " -h Show this information\n" + " -N Don't use namespaces\n" + " -p Write the proxy code to \n" + " -v Be verbose.\n" + " -V Show the program version and quit.\n" + "\n" + "If the file name given to the options -a and -p does not end in .cpp or .h, the\n" + "program will automatically append the suffixes and produce both files.\n"; + +static void showHelp() +{ + printf("%s", help); + exit(0); +} + +static void showVersion() +{ + printf("%s version %s\n", PROGRAMNAME, PROGRAMVERSION); + printf("D-Bus binding tool for Qt\n"); + exit(0); +} + +static void parseCmdLine(int argc, char **argv) +{ + int c; + opterr = true; + while ((c = getopt(argc, argv, cmdlineOptions)) != -1) + switch (c) + { + case 'a': + adaptorFile = optarg; + break; + + case 'v': + verbose = true; + break; + + case 'N': + skipNamespaces = true; + break; + + case 'h': + showHelp(); + break; + + case 'V': + showVersion(); + break; + + case 'p': + proxyFile = optarg; + break; + + case '?': + exit(1); + default: + abort(); + } + + if (optind != argc) + inputFile = argv[optind++]; + + while (optind != argc) + wantedInterfaces << QString::fromLocal8Bit(argv[optind++]); +} + +static QDBusIntrospection::Interfaces readInput() +{ + QFile input(QFile::decodeName(inputFile)); + if (inputFile) + input.open(QIODevice::ReadOnly); + else + input.open(stdin, QIODevice::ReadOnly); + + QByteArray data = input.readAll(); + + // check if the input is already XML + data = data.trimmed(); + if (data.startsWith("") << endl + << " *" << endl + << " * " PROGRAMNAME " is " PROGRAMCOPYRIGHT << endl + << " *" << endl + << " * This is an auto-generated file." << endl; + + if (changesWillBeLost) + ts << " * Do not edit! All changes made to it will be lost." << endl; + + ts << " */" << endl + << endl; + + return ts; +} + +enum ClassType { Proxy, Adaptor }; +static QString classNameForInterface(const QString &interface, ClassType classType) +{ + QStringList parts = interface.split('.'); + + QString retval; + if (classType == Proxy) + foreach (QString part, parts) { + part[0] = part[0].toUpper(); + retval += part; + } + else { + retval = parts.last(); + retval[0] = retval[0].toUpper(); + } + + if (classType == Proxy) + retval += "Interface"; + else + retval += "Adaptor"; + + return retval; +} + +static QString templateArg(const QString &arg) +{ + if (!arg.endsWith('>')) + return arg; + + return arg + ' '; +} + +static QString constRefArg(const QString &arg) +{ + if (!arg.startsWith('Q')) + return arg + ' '; + else + return QString("const %1 &").arg(arg); +} + +static QString makeQtName(const QString &dbusName) +{ + QString name = dbusName; + if (name.length() > 3 && name.startsWith("Get")) + name = name.mid(3); // strip Get from GetXXXX + + // recapitalize the name + QChar *p = name.data(); + while (!p->isNull()) { + // capitalized letter + // leave it + if (!p->isNull()) + ++p; + + // lowercase all the next capital letters, except for the last one + while (!p->isNull() && p->isUpper()) { + if (!p[1].isNull() && p[1].isUpper()) + *p = p->toLower(); + ++p; + } + + if (p->isUpper()) + ++p; + + // non capital letters: skip them + while (!p->isNull() && !p->isUpper()) + ++p; + } + + name[0] = name[0].toLower(); // lowercase the first one + return name; +} + +static QStringList makeArgNames(const QDBusIntrospection::Arguments &inputArgs, + const QDBusIntrospection::Arguments &outputArgs = + QDBusIntrospection::Arguments()) +{ + QStringList retval; + for (int i = 0; i < inputArgs.count(); ++i) { + const QDBusIntrospection::Argument &arg = inputArgs.at(i); + QString name = arg.name; + if (name.isEmpty()) + name = QString("in%1").arg(i); + while (retval.contains(name)) + name += "_"; + retval << name; + } + for (int i = 0; i < outputArgs.count(); ++i) { + const QDBusIntrospection::Argument &arg = outputArgs.at(i); + QString name = arg.name; + if (name.isEmpty()) + name = QString("out%1").arg(i); + while (retval.contains(name)) + name += "_"; + retval << name; + } + return retval; +} + +static void writeArgList(QTextStream &ts, const QStringList &argNames, + const QDBusIntrospection::Arguments &inputArgs, + const QDBusIntrospection::Arguments &outputArgs = QDBusIntrospection::Arguments()) +{ + // input args: + bool first = true; + int argPos = 0; + for (int i = 0; i < inputArgs.count(); ++i) { + const QDBusIntrospection::Argument &arg = inputArgs.at(i); + QString type = constRefArg(arg.type.toString(QDBusType::QVariantNames)); + + if (!first) + ts << ", "; + ts << type << argNames.at(argPos++); + first = false; + } + + argPos++; + + // output args + // yes, starting from 1 + for (int i = 1; i < outputArgs.count(); ++i) { + const QDBusIntrospection::Argument &arg = outputArgs.at(i); + QString name = arg.name; + + if (!first) + ts << ", "; + ts << arg.type.toString(QDBusType::QVariantNames) << " &" << argNames.at(argPos++); + first = false; + } +} + +static QString stringify(const QString &data) +{ + QString retval; + int i; + for (i = 0; i < data.length(); ++i) { + retval += '\"'; + for ( ; i < data.length() && data[i] != QChar('\n'); ++i) + if (data[i] == '\"') + retval += "\\\""; + else + retval += data[i]; + retval += "\"\n"; + } + return retval; +} + +static void writeProxy(const char *proxyFile, const QDBusIntrospection::Interfaces &interfaces) +{ + // open the file + QString name = header(proxyFile); + QFile file(name); + if (!name.isEmpty()) + file.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text); + else + file.open(stdout, QIODevice::WriteOnly | QIODevice::Text); + + QTextStream ts(&file); + + // write the header: + writeHeader(ts, true); + + // include guards: + QString includeGuard; + if (!name.isEmpty()) { + includeGuard = name.toUpper().replace(QChar('.'), QChar('_')); + int pos = includeGuard.lastIndexOf('/'); + if (pos != -1) + includeGuard = includeGuard.mid(pos + 1); + } else { + includeGuard = QString("QDBUSIDL2CPP_PROXY"); + } + includeGuard = QString("%1_%2%3") + .arg(includeGuard) + .arg(getpid()) + .arg(QDateTime::currentDateTime().toTime_t()); + ts << "#ifndef " << includeGuard << endl + << "#define " << includeGuard << endl + << endl; + + // include our stuff: + ts << "#include " << endl + << "#include " << endl + << endl; + + foreach (const QDBusIntrospection::Interface *interface, interfaces) { + // comment: + ts << "/*" << endl + << " * Proxy class for interface " << interface->name << endl + << " */" << endl; + + // class header: + QString className = classNameForInterface(interface->name, Proxy); + ts << "class " << className << ": public QDBusInterface" << endl + << "{" << endl + << "public:" << endl + << " static inline const char *staticInterfaceName()" << endl + << " { return \"" << interface->name << "\"; }" << endl + << endl + << " static inline const char *staticIntrospectionData()" << endl + << " { return \"\"" << endl + << stringify(interface->introspection) + << " \"\"; }" << endl + << endl; + + // constructors/destructors: + ts << "public:" << endl + << " explicit inline " << className << "(const QDBusObject &obj)" << endl + << " : QDBusInterface(obj, staticInterfaceName())" << endl + << " { }" << endl + << endl + << " inline ~" << className << "()" << endl + << " { }" << endl + << endl; + + // the introspection virtual: + ts << " inline virtual QString introspectionData() const" << endl + << " { return QString::fromUtf8(staticIntrospectionData()); }" << endl + << endl; + + // properties: + ts << "public: // PROPERTIES" << endl; + foreach (const QDBusIntrospection::Property &property, interface->properties) { + QString type = property.type.toString(QDBusType::QVariantNames); + QString templateType = templateArg(type); + QString constRefType = constRefArg(type); + QString getter = property.name; + QString setter = "set" + property.name; + getter[0] = getter[0].toLower(); + setter[3] = setter[3].toUpper(); + + // getter: + if (property.access != QDBusIntrospection::Property::Write) { + ts << " inline QDBusReply<" << templateType << "> " << getter << "() const" << endl + << " {" << endl + << " QDBusReply retval = QDBusPropertiesInterface(object())" << endl + << " .get(QLatin1String(\"" << interface->name << "\"), QLatin1String(\"" + << property.name << "\"));" << endl + << " return QDBusReply<" << templateType << ">::fromVariant(retval);" << endl + << " }" << endl; + } + + // setter + if (property.access != QDBusIntrospection::Property::Read) { + ts << " inline QDBusReply " << setter << "(" << constRefType << "value)" << endl + << " {" << endl + << " QDBusVariant v(value, QDBusType("; + + QString sig = property.type.dbusSignature(); + if (sig.length() == 1) + ts << "'" << sig.at(0) << "'"; + else + ts << "\"" << sig << "\""; + + ts << "));" << endl + << " return QDBusPropertiesInterface(object())" << endl + << " .set(QLatin1String(\"" << interface->name << "\"), QLatin1String(\"" + << property.name << "\"), v);" << endl + << " }" << endl; + } + + ts << endl; + } + + + // methods: + ts << "public: // METHODS" << endl; + foreach (const QDBusIntrospection::Method &method, interface->methods) { + bool isAsync = method.annotations.value(ANNOTATION_NO_WAIT) == "true"; + if (isAsync && !method.outputArgs.isEmpty()) { + fprintf(stderr, "warning: method %s in interface %s is marked 'async' but has output arguments.\n", + qPrintable(method.name), qPrintable(interface->name)); + continue; + } + + ts << " inline "; + + QString returnType; + + if (method.annotations.value("org.freedesktop.DBus.Deprecated") == "true") + ts << "Q_DECL_DEPRECATED "; + + if (isAsync) + ts << "Q_ASYNC void "; + else if (method.outputArgs.isEmpty()) + ts << "QDBusReply "; + else { + returnType = method.outputArgs.first().type.toString(QDBusType::QVariantNames); + ts << "QDBusReply<" << templateArg(returnType) << "> "; + } + + QString name = makeQtName(method.name); + ts << name << "("; + + QStringList argNames = makeArgNames(method.inputArgs, method.outputArgs); + writeArgList(ts, argNames, method.inputArgs, method.outputArgs); + + ts << ")" << endl + << " {" << endl; + + if (method.outputArgs.count() > 1) + ts << " QDBusMessage reply = call(QLatin1String(\""; + else if (!isAsync) + ts << " return call(QLatin1String(\""; + else + ts << " callAsync(QLatin1String(\""; + + QString signature = QChar('.'); + foreach (const QDBusIntrospection::Argument &arg, method.inputArgs) + signature += arg.type.dbusSignature(); + if (signature.length() == 1) + signature.clear(); + ts << method.name << signature << "\")"; + + int argPos = 0; + for (int i = 0; i < method.inputArgs.count(); ++i) + ts << ", " << argNames.at(argPos++); + + // close the QDBusIntrospection::call/callAsync call + ts << ");" << endl; + + argPos++; + if (method.outputArgs.count() > 1) { + ts << " if (reply.type() == QDBusMessage::ReplyMessage) {" << endl; + + // yes, starting from 1 + for (int i = 1; i < method.outputArgs.count(); ++i) + ts << " " << argNames.at(argPos++) << " = qvariant_cast<" + << templateArg(method.outputArgs.at(i).type.toString(QDBusType::QVariantNames)) + << ">(reply.at(" << i << "));" << endl; + ts << " }" << endl + << " return reply;" << endl; + } + + // close the function: + ts << " }" << endl + << endl; + } + + // close the class: + ts << "};" << endl + << endl; + } + + if (!skipNamespaces) { + QStringList last; + QDBusIntrospection::Interfaces::ConstIterator it = interfaces.constBegin(); + do + { + QStringList current; + QString name; + if (it != interfaces.constEnd()) { + current = it->constData()->name.split('.'); + name = current.takeLast(); + } + + int i = 0; + while (i < current.count() && i < last.count() && current.at(i) == last.at(i)) + ++i; + + // i parts matched + // close last.count() - i namespaces: + for (int j = i; j < last.count(); ++j) + ts << QString((last.count() - j - 1 + i) * 2, ' ') << "}" << endl; + + // open current.count() - i namespaces + for (int j = i; j < current.count(); ++j) + ts << QString(j * 2, ' ') << "namespace " << current.at(j) << " {" << endl; + + // add this class: + if (!name.isEmpty()) { + ts << QString(current.count() * 2, ' ') + << "typedef ::" << classNameForInterface(it->constData()->name, Proxy) + << " " << name << ";" << endl; + } + + if (it == interfaces.constEnd()) + break; + ++it; + last = current; + } while (true); + } + + // close the include guard + ts << "#endif" << endl; +} + +static void writeAdaptor(const char *adaptorFile, const QDBusIntrospection::Interfaces &interfaces) +{ + // open the file + QString headerName = header(adaptorFile); + QFile file(headerName); + if (!headerName.isEmpty()) + file.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text); + else + file.open(stdout, QIODevice::WriteOnly | QIODevice::Text); + QTextStream hs(&file); + + QString cppName = cpp(adaptorFile); + QByteArray cppData; + QTextStream cs(&cppData); + + // write the headers + writeHeader(hs, false); + + // include guards: + QString includeGuard; + if (!headerName.isEmpty()) { + includeGuard = headerName.toUpper().replace(QChar('.'), QChar('_')); + int pos = includeGuard.lastIndexOf('/'); + if (pos != -1) + includeGuard = includeGuard.mid(pos + 1); + } else { + includeGuard = QString("QDBUSIDL2CPP_ADAPTOR"); + } + includeGuard = QString("%1_%2%3") + .arg(includeGuard) + .arg(getpid()) + .arg(QDateTime::currentDateTime().toTime_t()); + hs << "#ifndef " << includeGuard << endl + << "#define " << includeGuard << endl + << endl; + + // include our stuff: + hs << "#include " << endl; + if (cppName == headerName) + hs << "#include " << endl; + hs << "#include " << endl + << endl; + + if (cppName != headerName) { + writeHeader(cs, false); + cs << "#include \"" << headerName << "\"" << endl + << "#include " << endl + << endl; + } + + foreach (const QDBusIntrospection::Interface *interface, interfaces) { + QString className = classNameForInterface(interface->name, Adaptor); + + // comment: + hs << "/*" << endl + << " * Adaptor class for interface " << interface->name << endl + << " */" << endl; + cs << "/*" << endl + << " * Implementation of adaptor class " << className << endl + << " */" << endl + << endl; + + // class header: + hs << "class " << className << ": public QDBusAbstractAdaptor" << endl + << "{" << endl + << " Q_OBJECT" << endl + << " Q_CLASSINFO(\"D-Bus Interface\", \"" << interface->name << "\")" << endl + << " Q_CLASSINFO(\"D-Bus Introspection\", \"\"" << endl + << stringify(interface->introspection) + << " \"\")" << endl + << "public:" << endl + << " " << className << "(QObject *parent);" << endl + << " virtual ~" << className << "();" << endl + << endl; + + // constructor/destructor + cs << className << "::" << className << "(QObject *parent)" << endl + << " : QDBusAbstractAdaptor(parent)" << endl + << "{" << endl + << " // constructor" << endl + << " setAutoRelaySignals(true);" << endl + << "}" << endl + << endl + << className << "::~" << className << "()" << endl + << "{" << endl + << " // destructor" << endl + << "}" << endl + << endl; + + hs << "public: // PROPERTIES" << endl; + foreach (const QDBusIntrospection::Property &property, interface->properties) { + QString type = property.type.toString(QDBusType::QVariantNames); + QString constRefType = constRefArg(type); + QString getter = property.name; + QString setter = "set" + property.name; + getter[0] = getter[0].toLower(); + setter[3] = setter[3].toUpper(); + + hs << " Q_PROPERTY(" << type << " " << getter; + if (property.access != QDBusIntrospection::Property::Write) + hs << " READ " << getter; + if (property.access != QDBusIntrospection::Property::Read) + hs << " WRITE " << setter; + hs << ")" << endl; + + // getter: + if (property.access != QDBusIntrospection::Property::Write) { + hs << " " << type << " " << getter << "() const;" << endl; + cs << type << " " + << className << "::" << getter << "() const" << endl + << "{" << endl + << " // get the value of property " << property.name << endl + << " return qvariant_cast< " << type <<" >(object()->property(\"" << getter << "\"));" << endl + << "}" << endl + << endl; + } + + // setter + if (property.access != QDBusIntrospection::Property::Read) { + hs << " void " << setter << "(" << constRefType << "value);" << endl; + cs << "void " << className << "::" << setter << "(" << constRefType << "value)" << endl + << "{" << endl + << " // set the value of property " << property.name << endl + << " object()->setProperty(\"" << getter << "\", value);" << endl + << "}" << endl + << endl; + } + + hs << endl; + } + + hs << "public slots: // METHODS" << endl; + foreach (const QDBusIntrospection::Method &method, interface->methods) { + bool isAsync = method.annotations.value(ANNOTATION_NO_WAIT) == "true"; + if (isAsync && !method.outputArgs.isEmpty()) { + fprintf(stderr, "warning: method %s in interface %s is marked 'async' but has output arguments.\n", + qPrintable(method.name), qPrintable(interface->name)); + continue; + } + + hs << " "; + if (method.annotations.value("org.freedesktop.DBus.Deprecated") == "true") + hs << "Q_DECL_DEPRECATED "; + + if (isAsync) { + hs << "Q_ASYNC void "; + cs << "Q_ASYNC void "; + } else if (method.outputArgs.isEmpty()) { + hs << "void "; + cs << "void "; + } else { + QString type = method.outputArgs.first().type.toString(QDBusType::QVariantNames); + hs << type << " "; + cs << type << " "; + } + + QString name = makeQtName(method.name); + hs << name << "("; + cs << className << "::" << name << "("; + + QStringList argNames = makeArgNames(method.inputArgs, method.outputArgs); + writeArgList(hs, argNames, method.inputArgs, method.outputArgs); + writeArgList(cs, argNames, method.inputArgs, method.outputArgs); + + hs << ");" << endl; // finished for header + cs << ")" << endl + << "{" << endl + << " // handle method call " << interface->name << "." << method.name << endl; + + // create the return type + int j = method.inputArgs.count(); + cs << " " << method.outputArgs.at(0).type.toString(QDBusType::QVariantNames) + << " " << argNames.at(j) << ";" << endl; + + // make the call + if (method.inputArgs.count() <= 10 && method.outputArgs.count() <= 1) { + // we can use QMetaObject::invokeMethod + static const char invoke[] = " QMetaObject::invokeMethod(object(), \""; + cs << invoke << name << "\""; + + if (!method.outputArgs.isEmpty()) + cs << ", Q_RETURN_ARG(" + << method.outputArgs.at(0).type.toString(QDBusType::QVariantNames) + << ", " + << argNames.at(method.inputArgs.count()) + << ")"; + + for (int i = 0; i < method.inputArgs.count(); ++i) + cs << ", Q_ARG(" + << method.inputArgs.at(i).type.toString(QDBusType::QVariantNames) + << ", " + << argNames.at(i) + << ")"; + + cs << ");" << endl; + } + + cs << endl + << " // Alternative:" << endl + << " //"; + if (!method.outputArgs.isEmpty()) + cs << argNames.at(method.inputArgs.count()) << " = "; + cs << "static_cast(object())->" << name << "("; + + int argPos = 0; + bool first = true; + for (int i = 0; i < method.inputArgs.count(); ++i) { + cs << (first ? "" : ", ") << argNames.at(argPos++); + first = false; + } + ++argPos; // skip retval, if any + for (int i = 1; i < method.outputArgs.count(); ++i) { + cs << (first ? "" : ", ") << argNames.at(argPos++); + first = false; + } + + cs << ");" << endl; + if (!method.outputArgs.isEmpty()) + cs << " return " << argNames.at(method.inputArgs.count()) << ";" << endl; + cs << "}" << endl + << endl; + } + + hs << "signals: // SIGNALS" << endl; + foreach (const QDBusIntrospection::Signal &signal, interface->signals_) { + hs << " "; + if (signal.annotations.value("org.freedesktop.DBus.Deprecated") == "true") + hs << "Q_DECL_DEPRECATED "; + + QString name = makeQtName(signal.name); + hs << "void " << name << "("; + + QStringList argNames = makeArgNames(signal.outputArgs); + writeArgList(hs, argNames, signal.outputArgs); + + hs << ");" << endl; // finished for header + } + + // close the class: + hs << "};" << endl + << endl; + } + + // close the include guard + hs << "#endif" << endl; + + cs.flush(); + hs.flush(); + if (headerName == cppName) + file.write(cppData); + else { + // write to cpp file + QFile f(cppName); + f.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text); + f.write(cppData); + } +} + +int main(int argc, char **argv) +{ + parseCmdLine(argc, argv); + + QDBusIntrospection::Interfaces interfaces = readInput(); + cleanInterfaces(interfaces); + + writeProxy(proxyFile, interfaces); + + if (adaptorFile) + writeAdaptor(adaptorFile, interfaces); + + return 0; +} + +/*! + \page dbusidl2cpp QtDBus IDL compiler (dbusidl2cpp) + + The QtDBus IDL compiler is a tool that can be used to parse interface descriptions and produce + static code representing those interfaces, which can then be used to make calls to remote + objects or implement said interfaces. + + \p %dbusidl2dcpp has two modes of operation, that correspond to the two possible outputs it can + produce: the interface (proxy) class or the adaptor class. The former is similar to the + \ref StandardInterfaces classes that are part of the QtDBus API and consists of a single .h file, + which should not be edited. The latter consists of both a C++ header and a source file, which + are meant to be edited and adapted to your needs. + + The \p %dbusidl2dcpp tool is not meant to be run every time you compile your + application. Instead, it's meant to be used when developing the code or when the interface + changes. + + The adaptor classes generated by \p %dbusidl2cpp are just a skeleton that must be completed. It + generates, by default, calls to slots with the same name on the object the adaptor is attached + to. However, you may modify those slots or the property accessor functions to suit your needs. +*/ -- cgit