/* Copyright (C) 2015 Srivats P. This file is part of "Ostinato" This 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 3 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, see */ #include "pythonfileformat.h" #include #include #include #include #include using google::protobuf::Message; using google::protobuf::Reflection; using google::protobuf::FieldDescriptor; PythonFileFormat pythonFileFormat; extern char *version; extern char *revision; PythonFileFormat::PythonFileFormat() { // Nothing to do } PythonFileFormat::~PythonFileFormat() { // Nothing to do } bool PythonFileFormat::open(const QString /*fileName*/, OstProto::StreamConfigList &/*streams*/, QString &/*error*/) { // NOT SUPPORTED! return false; } bool PythonFileFormat::save(const OstProto::StreamConfigList streams, const QString fileName, QString &error) { QFile file(fileName); QTextStream out(&file); QSet imports; if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate)) goto _open_fail; // import standard modules emit status("Writing imports ..."); emit target(0); writeStandardImports(out); emit target(streams.stream_size()); // import protocols from respective modules // build the import list using a QSet to eliminate duplicates for (int i = 0; i < streams.stream_size(); i++) { const OstProto::Stream &stream = streams.stream(i); for (int j = 0 ; j < stream.protocol_size(); j++) { const OstProto::Protocol &protocol = stream.protocol(j); const Reflection *refl = protocol.GetReflection(); std::vector fields; refl->ListFields(protocol, &fields); for (uint k = 0; k < fields.size(); k++) { // skip non extension fields if (!fields.at(k)->is_extension()) continue; if (fields.at(k)->file()->name() != fields.at(k)->message_type()->file()->name()) { imports.insert( QString("%1 import %2").arg( QString(fields.at(k)->message_type() ->file()->name().c_str()) .replace(".proto", "_pb2"), fields.at(k)->message_type()->name().c_str())); imports.insert( QString("%1 import %2").arg( QString(fields.at(k) ->file()->name().c_str()) .replace(".proto", "_pb2"), fields.at(k)->name().c_str())); } else { imports.insert( QString("%1 import %2, %3").arg( QString(fields.at(k)->file()->name().c_str()) .replace(".proto", "_pb2"), fields.at(k)->message_type()->name().c_str(), fields.at(k)->name().c_str())); } } } emit progress(i); } // write the import statements out << "# import ostinato modules\n"; out << "from ostinato.core import DroneProxy, ost_pb\n"; foreach (QString str, imports) out << "from ostinato.protocols." << str << "\n"; out << "\n"; // start of script - init, connect to drone etc. emit status("Writing prologue ..."); emit target(0); writePrologue(out); // Add streams emit status("Writing stream adds ..."); emit target(streams.stream_size()); out << " # ------------#\n"; out << " # add streams #\n"; out << " # ------------#\n"; out << " stream_id = ost_pb.StreamIdList()\n"; out << " stream_id.port_id.id = tx_port_number\n"; for (int i = 0; i < streams.stream_size(); i++) { out << " stream_id.stream_id.add().id = " << streams.stream(i).stream_id().id() << "\n"; emit progress(i); } out << " drone.addStream(stream_id)\n"; out << "\n"; // Configure streams with actual values emit status("Writing stream configuration ..."); emit target(streams.stream_size()); out << " # ------------------#\n"; out << " # configure streams #\n"; out << " # ------------------#\n"; out << " stream_cfg = ost_pb.StreamConfigList()\n"; out << " stream_cfg.port_id.id = tx_port_number\n"; for (int i = 0; i < streams.stream_size(); i++) { const OstProto::Stream &stream = streams.stream(i); const Reflection *refl; std::vector fields; out << "\n"; out << " # stream " << stream.stream_id().id() << " " << stream.core().name().c_str() << "\n"; out << " s = stream_cfg.stream.add()\n"; out << " s.stream_id.id = " << stream.stream_id().id() << "\n"; // Stream Core values refl = stream.core().GetReflection(); refl->ListFields(stream.core(), &fields); for (uint j = 0; j < fields.size(); j++) { writeFieldAssignment(out, QString(" s.core.") .append(fields.at(j)->name().c_str()), stream.core(), refl, fields.at(j)); } // Stream Control values refl = stream.control().GetReflection(); refl->ListFields(stream.control(), &fields); for (uint j = 0; j < fields.size(); j++) { writeFieldAssignment(out, QString(" s.control.") .append(fields.at(j)->name().c_str()), stream.control(), refl, fields.at(j)); } // Protocols for (int j = 0 ; j < stream.protocol_size(); j++) { const OstProto::Protocol &protocol = stream.protocol(j); out << "\n" << " p = s.protocol.add()\n" << " p.protocol_id.id = " << QString(OstProto::Protocol_k_descriptor() ->FindValueByNumber(protocol.protocol_id().id()) ->full_name().c_str()) .replace("OstProto", "ost_pb"); out << "\n"; refl = protocol.GetReflection(); refl->ListFields(protocol, &fields); for (uint k = 0; k < fields.size(); k++) { // skip protocol_id field if (fields.at(k)->number() == OstProto::Protocol::kProtocolIdFieldNumber) continue; QString pfx(" p.Extensions[X]"); pfx.replace(fields.at(k)->is_extension()? "X": "Extensions[X]", fields.at(k)->name().c_str()); writeFieldAssignment(out, pfx, protocol, refl, fields.at(k)); } } emit progress(i); } out << "\n"; out << " drone.modifyStream(stream_cfg)\n"; // end of script - transmit streams, disconnect from drone etc. emit status("Writing epilogue ..."); emit target(0); writeEpilogue(out); out.flush(); file.close(); return true; _open_fail: error = QString(tr("Error opening %1 (Error Code = %2)")) .arg(fileName) .arg(file.error()); return false; } bool PythonFileFormat::isMyFileFormat(const QString /*fileName*/) { // isMyFileFormat() is used for file open case to detect // file format - Open not supported for Python Scripts return false; } bool PythonFileFormat::isMyFileType(const QString fileType) { if (fileType.startsWith("PythonScript")) return true; else return false; } // // Private Member Functions // void PythonFileFormat::writeStandardImports(QTextStream &out) { out << "#! /usr/bin/env python\n"; out << "\n"; out << "# This script was programmatically generated\n" << "# by Ostinato version " << version << " revision " << revision << "\n" << "# The script should work out of the box mostly,\n" << "# but occassionally might need minor tweaking\n" << "# Please report any bugs at https://ostinato.org\n"; out << "\n"; out << "# standard modules\n"; out << "import logging\n"; out << "import os\n"; out << "import sys\n"; out << "import time\n"; out << "\n"; } void PythonFileFormat::writePrologue(QTextStream &out) { out << "# initialize the below variables appropriately " << "to avoid manual input\n"; out << "host_name = ''\n"; out << "tx_port_number = -1\n"; out << "\n"; out << "# setup logging\n"; out << "log = logging.getLogger(__name__)\n"; out << "logging.basicConfig(level=logging.INFO)\n"; out << "\n"; out << "# get inputs, if required\n"; out << "while len(host_name) == 0:\n"; out << " host_name = input('Drone\\'s Hostname/IP: ')\n"; out << "while tx_port_number < 0:\n"; out << " tx_port_number = int(input('Tx Port Number: '))\n"; out << "\n"; out << "drone = DroneProxy(host_name)\n"; out << "\n"; out << "try:\n"; out << " # connect to drone\n"; out << " log.info('connecting to drone(%s:%d)' \n"; out << " % (drone.hostName(), drone.portNumber()))\n"; out << " drone.connect()\n"; out << "\n"; out << " # setup tx port list\n"; out << " tx_port = ost_pb.PortIdList()\n"; out << " tx_port.port_id.add().id = tx_port_number;\n"; out << "\n"; } void PythonFileFormat::writeEpilogue(QTextStream &out) { out << " # clear tx/rx stats\n"; out << " log.info('clearing tx stats')\n"; out << " drone.clearStats(tx_port)\n"; out << "\n"; out << " log.info('starting transmit')\n"; out << " drone.startTransmit(tx_port)\n"; out << "\n"; out << " # wait for transmit to finish\n"; out << " log.info('waiting for transmit to finish ...')\n"; out << " while True:\n"; out << " try:\n"; out << " time.sleep(5)\n"; out << " tx_stats = drone.getStats(tx_port)\n"; out << " if tx_stats.port_stats[0].state.is_transmit_on" " == False:\n"; out << " break\n"; out << " except KeyboardInterrupt:\n"; out << " log.info('transmit interrupted by user')\n"; out << " break\n"; out << "\n"; out << " # stop transmit and capture\n"; out << " log.info('stopping transmit')\n"; out << " drone.stopTransmit(tx_port)\n"; out << "\n"; out << " # get tx stats\n"; out << " log.info('retreiving stats')\n"; out << " tx_stats = drone.getStats(tx_port)\n"; out << "\n"; out << " log.info('tx pkts = %d' % (tx_stats.port_stats[0].tx_pkts))\n"; out << "\n"; out << " # delete streams\n"; out << " log.info('deleting tx_streams')\n"; out << " drone.deleteStream(stream_id)\n"; out << "\n"; out << " # bye for now\n"; out << " drone.disconnect()\n"; out << "\n"; out << "except Exception as ex:\n"; out << " log.exception(ex)\n"; out << " sys.exit(1)\n"; } void PythonFileFormat::writeFieldAssignment( QTextStream &out, QString fieldName, const Message &msg, const Reflection *refl, const FieldDescriptor *fieldDesc, int index) { // for a repeated field, // if index < 0 => we are writing a repeated aggregate // if index >= 0 => we are writing a repeated element if (fieldDesc->is_repeated() && (index < 0)) { int n = refl->FieldSize(msg, fieldDesc); QString var = singularize(fieldDesc->name().c_str()); for (int i = 0; i < n; i++) { out << " " << var << " = " << fieldName.trimmed() << ".add()\n"; writeFieldAssignment(out, QString(" ").append(var), msg, refl, fieldDesc, i); } return; } // Ideally fields should not be set if they have the same // value as the default value - but currently protocols don't // check this when setting values in the protobuf data object // so here we check that explicitly for each field and if true // we don't output anything switch(fieldDesc->cpp_type()) { case FieldDescriptor::CPPTYPE_INT32: { qint32 val = fieldDesc->is_repeated() ? refl->GetRepeatedInt32(msg, fieldDesc, index) : refl->GetInt32(msg, fieldDesc); if (val != fieldDesc->default_value_int32()) out << fieldName << " = " << val << "\n"; break; } case FieldDescriptor::CPPTYPE_INT64: { qint64 val = fieldDesc->is_repeated() ? refl->GetRepeatedInt64(msg, fieldDesc, index) : refl->GetInt64(msg, fieldDesc); if (val != fieldDesc->default_value_int64()) out << fieldName << " = " << val << "\n"; break; } case FieldDescriptor::CPPTYPE_UINT32: { quint32 val = fieldDesc->is_repeated() ? refl->GetRepeatedUInt32(msg, fieldDesc, index) : refl->GetUInt32(msg, fieldDesc); QString valStr; if (useDecimalBase(fieldName)) valStr.setNum(val); else valStr.setNum(val, 16).prepend("0x"); if (val != fieldDesc->default_value_uint32()) out << fieldName << " = " << valStr << "\n"; break; } case FieldDescriptor::CPPTYPE_UINT64: { quint64 val = fieldDesc->is_repeated() ? refl->GetRepeatedUInt64(msg, fieldDesc, index) : refl->GetUInt64(msg, fieldDesc); QString valStr; if (useDecimalBase(fieldName)) valStr.setNum(val); else valStr.setNum(val, 16).prepend("0x"); if (val != fieldDesc->default_value_uint64()) out << fieldName << " = " << valStr << "\n"; break; } case FieldDescriptor::CPPTYPE_DOUBLE: { double val = fieldDesc->is_repeated() ? refl->GetRepeatedDouble(msg, fieldDesc, index) : refl->GetDouble(msg, fieldDesc); if (val != fieldDesc->default_value_double()) out << fieldName << " = " << val << "\n"; break; } case FieldDescriptor::CPPTYPE_FLOAT: { float val = fieldDesc->is_repeated() ? refl->GetRepeatedFloat(msg, fieldDesc, index) : refl->GetFloat(msg, fieldDesc); if (val != fieldDesc->default_value_float()) out << fieldName << " = " << val << "\n"; break; } case FieldDescriptor::CPPTYPE_BOOL: { bool val = fieldDesc->is_repeated() ? refl->GetRepeatedBool(msg, fieldDesc, index) : refl->GetBool(msg, fieldDesc); if (val != fieldDesc->default_value_bool()) out << fieldName << " = " << (refl->GetBool(msg, fieldDesc) ? "True" : "False") << "\n"; break; } case FieldDescriptor::CPPTYPE_STRING: { std::string val = fieldDesc->is_repeated() ? refl->GetRepeatedStringReference(msg, fieldDesc, index, &val) : refl->GetStringReference(msg, fieldDesc, &val); QString escVal = escapeString(QString::fromStdString(val)); if (val != fieldDesc->default_value_string()) out << fieldName << " = '" << escVal << "'\n"; break; } case FieldDescriptor::CPPTYPE_ENUM: { // Fields defined in protocol.proto are within ost_pb scope QString module = fieldDesc->file()->name() == "protocol.proto" ? "ost_pb." : ""; std::string val = fieldDesc->is_repeated() ? refl->GetRepeatedEnum(msg, fieldDesc, index)->full_name() : refl->GetEnum(msg, fieldDesc)->full_name(); if (val != fieldDesc->default_value_enum()->full_name()) out << fieldName << " = " << QString::fromStdString(val) .replace("OstProto.", module) << "\n"; break; } case FieldDescriptor::CPPTYPE_MESSAGE: { QString pfxStr(fieldName); const Message &msg2 = fieldDesc->is_repeated() ? refl->GetRepeatedMessage(msg, fieldDesc, index) : refl->GetMessage(msg, fieldDesc); const Reflection *refl2 = msg2.GetReflection(); std::vector fields2; QList autoFields; refl2->ListFields(msg2, &fields2); // Unfortunately, auto-calculated fields such as cksum, length // and protocol-type etc. may be set in the protobuf even if // they are not being overridden; // Intelligence regarding them is inside the respective protocol // implementation, not inside the protobuf objects - the latter // is all we have available here to work with; // We attempt a crude hack here to detect such fields and avoid // writing assignment statements for them for (uint i = 0; i < fields2.size(); i++) { std::string name = fields2.at(i)->name(); if ((fields2.at(i)->cpp_type() == FieldDescriptor::CPPTYPE_BOOL) && (name.find("is_override_") == 0) && (refl2->GetBool(msg2, fields2.at(i)) == false)) { name.erase(0, sizeof("is_override_") - 1); autoFields.append(name); } } for (uint i = 0 ; i < fields2.size(); i++) { // skip auto fields that are not overridden if (autoFields.contains(fields2.at(i)->name())) continue; writeFieldAssignment(out, QString("%1.%2").arg(pfxStr, fields2.at(i)->name().c_str()), msg2, refl2, fields2.at(i)); } break; } default: qWarning("unable to write field of unsupported type %d", fieldDesc->cpp_type()); } } QString PythonFileFormat::singularize(QString plural) { QString singular = plural; // Apply some heuristics if (plural.endsWith("ies")) singular.replace(singular.length()-3, 3, "y"); else if (plural.endsWith("ses")) singular.chop(2); else if (plural.endsWith("s")) singular.chop(1); return singular; } QString PythonFileFormat::escapeString(QString str) { QString escStr = ""; for (int i=0; i < str.length(); i++) { uchar c = str[i].cell(); if ((c < 128) && isprint(c)) { if (c == '\'') escStr.append("\\'"); else escStr.append(str[i]); } else escStr.append(QString("\\x%1").arg(int(c), 2, 16, QChar('0'))); } return escStr; } bool PythonFileFormat::useDecimalBase(QString fieldName) { // Heuristic - use Hex base for all except for the following return fieldName.endsWith("count") || fieldName.endsWith("length") || fieldName.endsWith("len") || fieldName.endsWith("time"); }