/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */ /* * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "Socket.hpp" #include "common/FileUtil.hpp" #include #include #include #include #include #include #include #include #include #ifndef TDOC #error TDOC must be defined (see Makefile.am) #endif // Sometimes we need to retry some commands as they can (due to timing or load) soft-fail. constexpr int COMMAND_RETRY_COUNT = 5; /// Common helper testing functions. /// Avoid the temptation to reuse from COOL code! /// These are supposed to be testing the latter. namespace helpers { inline std::vector genRandomData(const size_t size) { std::vector v(size); v.resize(size); char* data = v.data(); for (size_t i = 0; i < size; ++i) { data[i] = static_cast(Util::rng::getNext()); } return v; } inline std::string genRandomString(const size_t size) { std::string text; text.reserve(size); for (size_t i = 0; i < size; ++i) { // Sensible characters only, avoiding 0x7f DEL text += static_cast('!' + Util::rng::getNext() % 94); } return text; } inline std::vector readDataFromFile(const std::string& filename) { std::ifstream ifs(Poco::Path(TDOC, filename).toString(), std::ios::binary); // Apparently std::ios::binary is not good // enough to stop eating new-line chars! ifs.unsetf(std::ios::skipws); std::istream_iterator start(ifs); std::istream_iterator end; return std::vector(start, end); } inline std::vector readDataFromFile(std::unique_ptr& file) { file->seekg(0, std::ios_base::end); const std::streamsize size = file->tellg(); std::vector v; v.resize(size); file->seekg(0, std::ios_base::beg); file->read(v.data(), size); return v; } inline void getDocumentPathAndURL(const std::string& docFilename, std::string& documentPath, std::string& documentURL, std::string prefix) { const std::string testname = prefix; static std::mutex lock; std::unique_lock guard(lock); std::replace(prefix.begin(), prefix.end(), ' ', '_'); documentPath = FileUtil::getTempFileCopyPath(TDOC, docFilename, prefix); std::string encodedUri; Poco::URI::encode("file://" + Poco::Path(documentPath).makeAbsolute().toString(), ":/?", encodedUri); documentURL = "cool/" + encodedUri + "/ws"; TST_LOG("Test file: " << documentPath); } inline void sendTextFrame(COOLWebSocket& socket, const std::string& string, const std::string& testname) { TST_LOG("Sending " << string.size() << " bytes: " << COOLProtocol::getAbbreviatedMessage(string)); socket.sendFrame(string.data(), string.size()); } inline void sendTextFrame(const std::shared_ptr& socket, const std::string& string, const std::string& name = "") { sendTextFrame(*socket, string, name); } inline void sendTextFrame(const std::shared_ptr& ws, const std::string& string, const std::string& testname = std::string()) { TST_LOG("Sending " << string.size() << " bytes: " << COOLProtocol::getAbbreviatedMessage(string)); ws->sendMessage(string); } inline std::unique_ptr createSession(const Poco::URI& uri) { #if ENABLE_SSL if (uri.getScheme() == "https" || uri.getScheme() == "wss") return Util::make_unique(uri.getHost(), uri.getPort()); #endif return Util::make_unique(uri.getHost(), uri.getPort()); } /// Uses Poco to make an HTTP GET from the given URI. inline std::pair, std::string> pocoGet(const Poco::URI& uri) { LOG_INF("pocoGet: " << uri.toString()); std::unique_ptr session(helpers::createSession(uri)); Poco::Net::HTTPRequest request(Poco::Net::HTTPRequest::HTTP_GET, uri.getPathAndQuery(), Poco::Net::HTTPMessage::HTTP_1_1); session->sendRequest(request); auto response = std::make_shared(); std::istream& rs = session->receiveResponse(*response); LOG_DBG("pocoGet response for [" << uri.toString() << "]: " << response->getStatus() << ' ' << response->getReason() << ", hasContentLength: " << response->hasContentLength() << ", ContentLength: " << response->getContentLength64()); for (const auto& pair : *response) { LOG_TRC(pair.first << '=' << pair.second); } std::string responseString; try { std::ostringstream outputStringStream; Poco::StreamCopier::copyStream(rs, outputStringStream); responseString = outputStringStream.str(); LOG_DBG("pocoGet [" << uri.toString() << "]: " << responseString); } catch (const std::exception& ex) { LOG_ERR("Exception while reading Poco stream: " << ex.what()); } return std::make_pair(response, responseString); } /// Uses Poco to make an HTTP GET from the given URI. /// And optionally retries up to @retry times with /// @delayMs between attempts. inline std::pair, std::string> pocoGetRetry(const Poco::URI& uri, int retry = 3, std::chrono::milliseconds delayMs = std::chrono::seconds(1)) { for (int attempt = 1; attempt <= retry; ++attempt) { try { LOG_INF("pocoGet #" << attempt << ": " << uri.toString()); return pocoGet(uri); } catch (const std::exception& ex) { LOG_ERR("pocoGet #" << attempt << " failed for [" << uri.toString() << "]: " << ex.what()); if (attempt == retry) throw; std::this_thread::sleep_for(delayMs); } } auto response = std::make_shared(); std::string responseString; return std::make_pair(response, responseString); } /// Uses Poco to make an HTTP GET from the given URI components. inline std::pair, std::string> pocoGet(bool secure, const std::string& host, const int port, const std::string& url) { const char* scheme = (secure ? "https://" : "http://"); Poco::URI uri(scheme + host + ':' + std::to_string(port) + url); return pocoGet(uri); } inline std::shared_ptr createRawSocket() { return #if ENABLE_SSL std::make_shared #else std::make_shared #endif (Poco::Net::SocketAddress("127.0.0.1", ClientPortNumber)); } // Sets read / write timeout for the given file descriptor. inline void setSocketTimeOut(int socketFD, int timeMS) { struct timeval tv; tv.tv_sec = (float)timeMS / (float)1000; tv.tv_usec = timeMS; setsockopt(socketFD, SOL_SOCKET, SO_RCVTIMEO, (const char*)&tv, sizeof tv); } // Sets socket's blocking mode. true for blocking, false for non blocking. inline void setSocketBlockingMode(int socketFD, bool blocking) { ioctl(socketFD, FIONBIO, blocking == true ? 0: 1); } // Creates a socket and connects it to a local server. Returns the file descriptor. inline int connectToLocalServer(int portNumber, int socketTimeOutMS, bool blocking) { int socketFD = 0; struct sockaddr_in serv_addr; if ((socketFD = socket(AF_INET, SOCK_STREAM, 0)) < 0) { LOG_ERR("helpers::connectToLocalServer: Server client could not be created."); return -1; } else { serv_addr.sin_family = AF_INET; serv_addr.sin_port = htons(portNumber); if(inet_pton(AF_INET, "127.0.0.1", &serv_addr.sin_addr) <= 0) { LOG_ERR("helpers::connectToLocalServer: Invalid address."); close(socketFD); return -1; } else { if (connect(socketFD, (sockaddr*)&serv_addr, sizeof(serv_addr)) < 0) { LOG_ERR("helpers::connectToLocalServer: Connection failed."); close(socketFD); return -1; } else { setSocketTimeOut(socketFD, socketTimeOutMS); setSocketBlockingMode(socketFD, blocking); return socketFD; } } } } /// Returns true iff built with SSL and it is successfully initialized. inline bool haveSsl() { #if ENABLE_SSL return ssl::Manager::isClientContextInitialized(); #else return false; #endif } /// Return a fully-qualified URI, with schema, to the test loopback server. inline std::string const& getTestServerURI() { static std::string serverURI( (haveSsl() && config::isSslEnabled() ? "https://127.0.0.1:" : "http://127.0.0.1:") + std::to_string(ClientPortNumber)); return serverURI; } inline int getErrorCode(COOLWebSocket& ws, std::string& message, const std::string& testname) { int flags = 0; int bytes = 0; Poco::UInt16 statusCode = -1; Poco::Buffer buffer(READ_BUFFER_SIZE); message.clear(); ws.setReceiveTimeout(Poco::Timespan(5000000)); do { // Read next WS frame and log it. bytes = ws.receiveFrame(buffer.begin(), READ_BUFFER_SIZE, flags, testname); std::this_thread::sleep_for(std::chrono::milliseconds(50)); } while (bytes > 0 && (flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE); if (bytes > 0) { TST_LOG("Got Close Frame: " << COOLWebSocket::getAbbreviatedFrameDump(buffer.begin(), bytes, flags)); Poco::MemoryBinaryReader reader(buffer, Poco::BinaryReader::NETWORK_BYTE_ORDER); reader >> statusCode; if (static_cast(bytes) > sizeof(statusCode)) { // An optional message after the status code. message.append(buffer.begin() + sizeof(statusCode), bytes - sizeof(statusCode)); } } return statusCode; } inline int getErrorCode(const std::shared_ptr& ws, std::string& message, const std::string& testname) { return getErrorCode(*ws, message, testname); } inline std::vector getResponseMessage(COOLWebSocket& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { try { int flags = 0; std::vector response; auto endTime = std::chrono::steady_clock::now() + timeoutMs; ws.setReceiveTimeout(0); do { auto now = std::chrono::steady_clock::now(); if (now > endTime) // timedout { TST_LOG("Timeout waiting for [" << prefix << "] after " << timeoutMs); break; } long waitTimeUs = std::chrono::duration_cast(endTime - now).count(); if (ws.poll(Poco::Timespan(waitTimeUs), Poco::Net::Socket::SELECT_READ)) { response.resize(READ_BUFFER_SIZE * 8); const int bytes = ws.receiveFrame(response.data(), response.size(), flags, testname); response.resize(std::max(bytes, 0)); const auto message = COOLProtocol::getFirstLine(response); if (bytes > 0 && (flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE) { if (COOLProtocol::matchPrefix(prefix, message)) { TST_LOG('[' << prefix << "] Matched " << COOLWebSocket::getAbbreviatedFrameDump(response.data(), bytes, flags)); return response; } } else { response.resize(0); } if (bytes <= 0) { // Try again, timeout will be handled above. continue; } if ((flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE) { // Don't ignore errors. if (COOLProtocol::matchPrefix("error:", message)) { throw std::runtime_error(message); } TST_LOG('[' << prefix << "] Ignored " << COOLWebSocket::getAbbreviatedFrameDump(response.data(), bytes, flags)); } } } while ((flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE); } catch (const Poco::Net::WebSocketException& exc) { TST_LOG('[' << prefix << "] ERROR in helpers::getResponseMessage: " << exc.message()); } return std::vector(); } inline std::vector getResponseMessage(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { return ws->waitForMessage(prefix, timeoutMs, testname); } inline std::string getResponseString(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { const std::vector response = ws->waitForMessage(prefix, timeoutMs, testname); return std::string(response.data(), response.size()); } inline std::string assertResponseString(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { auto res = getResponseString(ws, prefix, testname, timeoutMs); LOK_ASSERT_EQUAL(prefix, res.substr(0, prefix.length())); return res; } inline int countMessages(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { int count = 0; while (!getResponseMessage(ws, prefix, testname, timeoutMs).empty()) ++count; return count; } inline std::vector getResponseMessage(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { return getResponseMessage(*ws, prefix, testname, timeoutMs); } template std::string getResponseString(T& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { const auto response = getResponseMessage(ws, prefix, testname, timeoutMs); return std::string(response.data(), response.size()); } template std::string assertResponseString(T& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { auto res = getResponseString(ws, prefix, testname, timeoutMs); LOK_ASSERT_EQUAL(prefix, res.substr(0, prefix.length())); return res; } /// Assert that we don't get a response with the given prefix. template std::string assertNotInResponse(T& ws, const std::string& prefix, const std::string& testname) { const auto res = getResponseString(ws, prefix, testname, std::chrono::milliseconds(1000)); LOK_ASSERT_MESSAGE(testname + "Did not expect getting message [" + res + "].", res.empty()); return res; } inline int countMessages(COOLWebSocket& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { int count = 0; while (!getResponseMessage(ws, prefix, testname, timeoutMs).empty()) ++count; return count; } inline int countMessages(const std::shared_ptr& ws, const std::string& prefix, const std::string& testname, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { return countMessages(*ws, prefix, testname, timeoutMs); } inline bool isDocumentLoaded(COOLWebSocket& ws, const std::string& testname, bool isView = true) { const std::string prefix = isView ? "status:" : "statusindicatorfinish:"; std::chrono::seconds timeout(60); #if defined(__has_feature) #if __has_feature(address_sanitizer) timeout = std::chrono::seconds(120); #endif #endif const auto message = getResponseString(ws, prefix, testname, timeout); bool success = COOLProtocol::matchPrefix(prefix, message); if (!success) TST_LOG("ERR: Timed out loading document after " << timeout); return success; } inline bool isDocumentLoaded(std::shared_ptr& ws, const std::string& testname, bool isView = true) { return isDocumentLoaded(*ws, testname, isView); } inline bool isDocumentLoaded(const std::shared_ptr& ws, const std::string& testname, bool isView = true) { const std::string prefix = isView ? "status:" : "statusindicatorfinish:"; constexpr auto timeout = std::chrono::seconds(20); // Allow 20 secs to load const std::string message = getResponseString(ws, prefix, testname, timeout); const bool success = COOLProtocol::matchPrefix(prefix, message); if (!success) TST_LOG("ERROR: Timed out loading document. Did not get [" << prefix << "] in time."); return success; } // Connecting to a Kit process is managed by document broker, that it does several // jobs to establish the bridge connection between the Client and Kit process, // The result, it is mostly time outs to get messages in the unit test and it could fail. // connectLOKit ensures the websocket is connected to a kit process. inline std::shared_ptr connectLOKit(const Poco::URI& uri, Poco::Net::HTTPRequest& request, Poco::Net::HTTPResponse& response, const std::string& testname) { TST_LOG("Connecting to " << uri.toString()); constexpr int max_retries = 11; int retries = max_retries - 1; do { try { std::unique_ptr session(createSession(uri)); TST_LOG("Connection to " << uri.toString() << " is " << (session->secure() ? "secure" : "plain")); auto ws = std::make_shared(*session, request, response); const char* expected_response = "statusindicator: ready"; TST_LOG("Connected to " << uri.toString() << ", waiting for response [" << expected_response << "]"); if (getResponseString(ws, expected_response, testname) == expected_response) { return ws; } TST_LOG("ERROR: Reconnecting (retry #" << (max_retries - retries) << ") to " << uri.toString()); } catch (const std::exception& ex) { TST_LOG("ERROR: Failed to connect to " << uri.toString() << ": " << ex.what()); } std::this_thread::sleep_for(std::chrono::microseconds(POLL_TIMEOUT_MICRO_S)); } while (retries--); TST_LOG("ERROR: Giving up connecting to " << uri.toString()); throw std::runtime_error("Cannot connect to [" + uri.toString() + "]."); } // Connecting to a Kit process is managed by document broker, that it does several // jobs to establish the bridge connection between the Client and Kit process, // The result, it is mostly time outs to get messages in the unit test and it could fail. // connectLOKit ensures the websocket is connected to a kit process. inline std::shared_ptr connectLOKit(std::shared_ptr socketPoll, const Poco::URI& uri, const std::string& url, const std::string& testname) { TST_LOG("Connecting to " << uri.toString()); constexpr int max_retries = 11; int retries = max_retries - 1; do { try { // Load a document and get its status. auto ws = http::WebSocketSession::create(uri.toString()); TST_LOG("Connection to " << uri.toString() << " is " << (ws->secure() ? "secure" : "plain")); http::Request req(url); ws->asyncRequest(req, std::move(socketPoll)); const char* expected_response = "statusindicator: ready"; TST_LOG("Connected to " << uri.toString() << ", waiting for response [" << expected_response << "]"); if (getResponseString(ws, expected_response, testname) == expected_response) { return ws; } TST_LOG("ERROR: Reconnecting (retry #" << (max_retries - retries) << ") to " << uri.toString()); } catch (const std::exception& ex) { TST_LOG("ERROR: Failed to connect to " << uri.toString() << ": " << ex.what()); } std::this_thread::sleep_for(std::chrono::microseconds(POLL_TIMEOUT_MICRO_S)); } while (retries--); TST_LOG("ERROR: Giving up connecting to " << uri.toString()); throw std::runtime_error("Cannot connect to [" + uri.toString() + "]."); } inline std::shared_ptr loadDocAndGetSocket(const Poco::URI& uri, const std::string& documentURL, const std::string& testname, bool isView = true, bool isAssert = true) { try { // Load a document and get its status. Poco::Net::HTTPRequest request(Poco::Net::HTTPRequest::HTTP_GET, documentURL); Poco::Net::HTTPResponse response; std::shared_ptr socket = connectLOKit(uri, request, response, testname); sendTextFrame(socket, "load url=" + documentURL, testname); bool isLoaded = isDocumentLoaded(*socket, testname, isView); if (!isLoaded && !isAssert) { return nullptr; } LOK_ASSERT_MESSAGE("Failed to load the document " + documentURL, isLoaded); TST_LOG("Loaded document [" << documentURL << "]."); return socket; } catch (const Poco::Exception& exc) { LOK_ASSERT_FAIL(exc.displayText()); } // Really couldn't reach here, but the compiler doesn't know any better. return nullptr; } inline std::shared_ptr loadDocAndGetSocket(const std::string& docFilename, const Poco::URI& uri, const std::string& testname, bool isView = true, bool isAssert = true) { try { std::string documentPath, documentURL; getDocumentPathAndURL(docFilename, documentPath, documentURL, testname); return loadDocAndGetSocket(uri, documentURL, testname, isView, isAssert); } catch (const Poco::Exception& exc) { LOK_ASSERT_FAIL(exc.displayText()); } // Really couldn't reach here, but the compiler doesn't know any better. return nullptr; } inline std::shared_ptr loadDocAndGetSession(std::shared_ptr socketPoll, const Poco::URI& uri, const std::string& documentURL, const std::string& testname, bool isView = true, bool isAssert = true, const std::string &loadParams = "") { try { // Load a document and get its status. auto ws = http::WebSocketSession::create(uri.toString()); http::Request req(documentURL); ws->asyncRequest(req, std::move(socketPoll)); sendTextFrame(ws, "load url=" + documentURL + loadParams, testname); const bool isLoaded = isDocumentLoaded(ws, testname, isView); if (!isLoaded && !isAssert) { return nullptr; } LOK_ASSERT_MESSAGE("Failed to load the document " + documentURL, isLoaded); TST_LOG("Loaded document [" << documentURL << "]."); return ws; } catch (const Poco::Exception& ex) { LOK_ASSERT_FAIL(ex.displayText()); } catch (const std::exception& ex) { LOK_ASSERT_FAIL(ex.what()); } // Really can't reach here, but the compiler doesn't know better. return nullptr; } inline std::shared_ptr loadDocAndGetSession(std::shared_ptr socketPoll, const std::string& docFilename, const Poco::URI& uri, const std::string& testname, bool isView = true, bool isAssert = true) { try { std::string documentPath, documentURL; getDocumentPathAndURL(docFilename, documentPath, documentURL, testname); return loadDocAndGetSession(std::move(socketPoll), uri, documentURL, testname, isView, isAssert); } catch (const std::exception& ex) { LOK_ASSERT_FAIL(ex.what()); } // Really couldn't reach here, but the compiler doesn't know any better. return nullptr; } inline void SocketProcessor(const std::string& testname, const std::shared_ptr& socket, const std::function& handler, const std::chrono::milliseconds timeoutMs = std::chrono::seconds(10)) { socket->setReceiveTimeout(0); const Poco::Timespan waitTime(std::chrono::microseconds(timeoutMs).count()); int flags = 0; int n = 0; char buffer[READ_BUFFER_SIZE * 8]; do { if (!socket->poll(waitTime, Poco::Net::Socket::SELECT_READ)) { TST_LOG("Timeout polling."); break; } n = socket->receiveFrame(buffer, sizeof(buffer), flags, testname); TST_LOG("Got " << COOLWebSocket::getAbbreviatedFrameDump(buffer, n, flags)); if (n > 0 && (flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE) { if (!handler(std::string(buffer, n))) { break; } } } while (n > 0 && (flags & Poco::Net::WebSocket::FRAME_OP_BITMASK) != Poco::Net::WebSocket::FRAME_OP_CLOSE); } inline void SocketProcessor(const std::string& testname, const std::shared_ptr& ws, const std::function& handler, const std::chrono::milliseconds timeout = std::chrono::milliseconds(10000)) { ws->poll( [&](const std::vector& message) { return !handler(std::string(message.data(), message.size())); }, timeout, testname); } inline void parseDocSize(const std::string& message, const std::string& type, int& part, int& parts, int& width, int& height, int& viewid, const std::string& testname) { StringVector tokens(StringVector::tokenize(message, ' ')); // Expected format is something like 'type= parts= current= width= height='. const std::string text = tokens[0].substr(std::string("type=").size()); parts = std::stoi(tokens[1].substr(std::string("parts=").size())); part = std::stoi(tokens[2].substr(std::string("current=").size())); width = std::stoi(tokens[3].substr(std::string("width=").size())); height = std::stoi(tokens[4].substr(std::string("height=").size())); viewid = std::stoi(tokens[5].substr(std::string("viewid=").size())); LOK_ASSERT_EQUAL(type, text); LOK_ASSERT(parts > 0); LOK_ASSERT(part >= 0); LOK_ASSERT(width > 0); LOK_ASSERT(height > 0); LOK_ASSERT(viewid >= 0); } inline std::vector getTileMessage(const std::shared_ptr& ws, const std::string& testname) { return getResponseMessage(ws, "tile", testname); } inline std::vector getTileMessage(COOLWebSocket& ws, const std::string& testname) { return getResponseMessage(ws, "tile", testname); } inline std::vector assertTileMessage(COOLWebSocket& ws, const std::string& testname) { const std::vector response = getTileMessage(ws, testname); const std::string firstLine = COOLProtocol::getFirstLine(response); StringVector tileTokens(StringVector::tokenize(firstLine, ' ')); LOK_ASSERT_EQUAL(std::string("tile:"), tileTokens[0]); LOK_ASSERT_EQUAL(std::string("part="), tileTokens[1].substr(0, std::string("part=").size())); LOK_ASSERT_EQUAL(std::string("width="), tileTokens[2].substr(0, std::string("width=").size())); LOK_ASSERT_EQUAL(std::string("height="), tileTokens[3].substr(0, std::string("height=").size())); LOK_ASSERT_EQUAL(std::string("tileposx="), tileTokens[4].substr(0, std::string("tileposx=").size())); LOK_ASSERT_EQUAL(std::string("tileposy="), tileTokens[5].substr(0, std::string("tileposy=").size())); LOK_ASSERT_EQUAL(std::string("tilewidth="), tileTokens[6].substr(0, std::string("tilewidth=").size())); LOK_ASSERT_EQUAL(std::string("tileheight="), tileTokens[7].substr(0, std::string("tileheight=").size())); return response; } inline std::vector assertTileMessage(const std::shared_ptr& ws, const std::string& testname) { return assertTileMessage(*ws, testname); } enum SpecialKey { skNone=0, skShift=0x1000, skCtrl=0x2000, skAlt=0x4000 }; inline int getCharChar(char ch, SpecialKey specialKeys) { // Some primitive code just suitable to basic needs of specific test. // TODO: improve as appropriate. if (specialKeys & (skCtrl | skAlt)) return 0; switch (ch) { case '\x0a': // Enter return 13; default: return ch; } } inline int getCharKey(char ch, SpecialKey specialKeys) { // Some primitive code just suitable to basic needs of specific test. // TODO: improve as appropriate. int result; switch (ch) { case '\x0a': // Enter result = 1280; break; default: result = ch; } return result | specialKeys; } inline void sendKeyEvent(std::shared_ptr& socket, const char* type, int chr, int key, const std::string& testname) { std::ostringstream ssIn; ssIn << "key type=" << type << " char=" << chr << " key=" << key; sendTextFrame(socket, ssIn.str(), testname); } inline void sendKeyPress(std::shared_ptr& socket, int chr, int key, const std::string& testname) { sendKeyEvent(socket, "input", chr, key, testname); sendKeyEvent(socket, "up", chr, key, testname); } inline void sendChar(std::shared_ptr& socket, char ch, SpecialKey specialKeys, const std::string& testname) { sendKeyPress(socket, getCharChar(ch, specialKeys), getCharKey(ch, specialKeys), testname); } inline void sendText(std::shared_ptr& socket, const std::string& text, const std::string& testname) { for (char ch : text) { sendChar(socket, ch, skNone, testname); } } inline void sendKeyEvent(std::shared_ptr& socket, const char* type, int chr, int key, const std::string& testname) { std::ostringstream ssIn; ssIn << "key type=" << type << " char=" << chr << " key=" << key; sendTextFrame(socket, ssIn.str(), testname); } inline void sendKeyPress(std::shared_ptr& socket, int chr, int key, const std::string& testname) { sendKeyEvent(socket, "input", chr, key, testname); sendKeyEvent(socket, "up", chr, key, testname); } inline void sendChar(std::shared_ptr& socket, char ch, SpecialKey specialKeys, const std::string& testname) { sendKeyPress(socket, getCharChar(ch, specialKeys), getCharKey(ch, specialKeys), testname); } inline void sendText(std::shared_ptr& socket, const std::string& text, const std::string& testname) { for (char ch : text) { sendChar(socket, ch, skNone, testname); } } inline void saveTileAs(const std::vector &tileResponse, const std::string &filename, const std::string &testname) { const std::string firstLine = COOLProtocol::getFirstLine(tileResponse); std::vector res(tileResponse.begin() + firstLine.size() + 1, tileResponse.end()); std::stringstream streamRes; std::copy(res.begin(), res.end(), std::ostream_iterator(streamRes)); std::fstream outStream(filename, std::ios::out); outStream.write(res.data(), res.size()); outStream.close(); TST_LOG("Saved [" << firstLine << "] to [" << filename << ']'); } inline std::vector getTileAndSave(std::shared_ptr& socket, const std::string& req, const std::string& filename, const std::string& testname) { TST_LOG("Requesting: " << req); sendTextFrame(socket, req, testname); const std::vector tile = getResponseMessage(socket, "tile:", testname); TST_LOG(" Tile PNG size: " << tile.size()); const std::string firstLine = COOLProtocol::getFirstLine(tile); std::vector res(tile.begin() + firstLine.size() + 1, tile.end()); std::stringstream streamRes; std::copy(res.begin(), res.end(), std::ostream_iterator(streamRes)); if (!filename.empty()) saveTileAs(tile, filename, testname); return res; } inline void getServerVersion(COOLWebSocket& socket, int& major, int& minor, const std::string& testname) { const std::string clientVersion = "coolclient 0.1"; sendTextFrame(socket, clientVersion, testname); std::vector loVersion = getResponseMessage(socket, "lokitversion", testname); std::string line = COOLProtocol::getFirstLine(loVersion.data(), loVersion.size()); line = line.substr(strlen("lokitversion ")); Poco::JSON::Parser parser; Poco::Dynamic::Var loVersionVar = parser.parse(line); const Poco::SharedPtr& loVersionObject = loVersionVar.extract(); std::string loProductVersion = loVersionObject->get("ProductVersion").toString(); std::istringstream stream(loProductVersion); stream >> major; if (stream.get() == '.') { stream >> minor; } else { minor = 0; } TST_LOG("Client [" << major << '.' << minor << "]."); } inline void getServerVersion(std::shared_ptr& socket, int& major, int& minor, const std::string& testname) { getServerVersion(*socket, major, minor, testname); } inline bool svgMatch(const std::string& testname, const std::vector& response, const char* templateFile) { const std::vector expectedSVG = helpers::readDataFromFile(templateFile); if (expectedSVG != response) { TST_LOG_BEGIN("Svg mismatch: response is\n"); if(response.empty()) TST_LOG_APPEND(""); else TST_LOG_APPEND(std::string(response.data(), response.size())); TST_LOG_APPEND("\nvs. expected (from '" << templateFile << "' :\n"); TST_LOG_APPEND(std::string(expectedSVG.data(), expectedSVG.size())); std::string newName = templateFile; newName += ".new"; TST_LOG_APPEND("Updated template writing to: " << newName << '\n'); TST_LOG_END; FILE *of = fopen(Poco::Path(TDOC, newName).toString().c_str(), "w"); LOK_ASSERT(fwrite(response.data(), response.size(), 1, of) == response.size()); fclose(of); return false; } return true; } /// Select all and wait for the text selection update. inline void selectAll(const std::shared_ptr& socket, const std::string& testname, int repeat = COMMAND_RETRY_COUNT) { for (int i = 0; i < repeat; ++i) { sendTextFrame(socket, "uno .uno:SelectAll", testname); if (!getResponseString(socket, "textselection:", testname).empty()) break; } } /// Sends a command and waits for an event in response, with retrying. inline void sendAndWait(const std::shared_ptr& ws, const std::string& testname, const std::string& command, const std::string& response, std::chrono::milliseconds timeoutPerAttempt = std::chrono::seconds(10), int repeat = COMMAND_RETRY_COUNT) { for (int i = 1; i <= repeat; ++i) { TST_LOG("Sending [" << command << "], waiting for [" << response << "], attempt #" << i); sendTextFrame(ws, command, testname); if (!getResponseString(ws, response, testname, timeoutPerAttempt).empty()) break; } } /// Sends a command and drain an event in response. /// We expect @response within the given @timeoutResponse and /// we drain all messages to get a steady-state. /// Draining happens for @timeoutDrain. inline bool sendAndDrain(const std::shared_ptr& ws, const std::string& testname, const std::string& command, const std::string& response, std::chrono::milliseconds timeoutResponse = std::chrono::seconds(10), std::chrono::milliseconds timeoutDrain = std::chrono::milliseconds(300)) { TST_LOG("Sending [" << command << "], waiting for [" << response << "], and draining the events."); sendTextFrame(ws, command, testname); const std::string res = getResponseString(ws, response, testname, timeoutResponse); if (res.empty()) { TST_LOG("Timed-out waiting for [" << response << "] after sending [" << command << "]."); return false; } while (!getResponseString(ws, response, testname, timeoutDrain).empty()) ; // Skip. return true; } /// Select all and wait for the text selection update. inline void selectAll(const std::shared_ptr& ws, const std::string& testname, std::chrono::milliseconds timeoutPerAttempt = std::chrono::seconds(10), int repeat = COMMAND_RETRY_COUNT) { sendAndWait(ws, testname, "uno .uno:SelectAll", "textselection:", timeoutPerAttempt, repeat); } /// Delete all and wait for the text selection update. inline void deleteAll(const std::shared_ptr& ws, const std::string& testname, std::chrono::milliseconds timeoutPerAttempt = std::chrono::seconds(10), int repeat = COMMAND_RETRY_COUNT) { selectAll(ws, testname, timeoutPerAttempt, repeat); sendAndWait(ws, testname, "uno .uno:Delete", "textselection:", timeoutPerAttempt, repeat); } inline std::string getAllText(const std::shared_ptr& socket, const std::string& testname, const std::string& expected = std::string(), int retry = COMMAND_RETRY_COUNT) { static const std::string prefix = "textselectioncontent: "; for (int i = 1; i <= retry; ++i) { TST_LOG("getAllText attempt #" << i); selectAll(socket, testname); sendTextFrame(socket, "gettextselection mimetype=text/plain;charset=utf-8", testname); std::string text = getResponseString(socket, prefix, testname); if (!text.empty()) { if (expected.empty() || (prefix + expected) == text) return text; } } return std::string(); } /// Delete all and wait for the text selection update. inline void deleteAll(const std::shared_ptr& socket, const std::string& testname, int repeat = COMMAND_RETRY_COUNT) { selectAll(socket, testname); for (int i = 0; i < repeat; ++i) { sendTextFrame(socket, "uno .uno:Delete", testname); if (!getResponseString(socket, "textselection:", testname).empty()) break; } } inline std::string getAllText(const std::shared_ptr& socket, const std::string& testname, const std::string& expected = std::string(), int retry = COMMAND_RETRY_COUNT) { static const std::string prefix = "textselectioncontent: "; for (int i = 0; i < retry; ++i) { selectAll(socket, testname); sendTextFrame(socket, "gettextselection mimetype=text/plain;charset=utf-8", testname); std::string text = getResponseString(socket, prefix, testname); if (!text.empty()) { if (expected.empty() || (prefix + expected) == text) return text; } } return std::string(); } } /* vim:set shiftwidth=4 softtabstop=4 expandtab: */