add ellipsis on truncated text (longer than maxLength)

Author: Gemba

docs/CONFIGINI.md

@@ -638,7 +638,7 @@ Allowed in sections: `[main]`, `[<PLATFORM>]`
 
 #### maxLength
 
-Sets the maximum length of returned game descriptions. This is a convenience option if you feel like game descriptions are too long. By default it is set to 2500.
+Sets the maximum length of returned game descriptions. This is a convenience option if you feel like game descriptions are too long. By default it is set to 2500. Allowed range is 0 to 10000 characters. A truncated text will end with [...] (Ellipsis).
 
 Default value: `2500`  
 Allowed in sections: `[main]`, `[<PLATFORM>]`, `[<FRONTEND>]`, `[<SCRAPER>]`

src/attractmode.cpp

@@ -196,8 +196,10 @@ void AttractMode::assembleList(QString &finalOutput,
             QFile descFile(descDir.absolutePath() % "/" % entry.baseName %
                            ".txt");
             if (descFile.open(QIODevice::WriteOnly)) {
-                descFile.write(entry.description.trimmed().toUtf8().left(
-                    config->maxLength));
+                descFile.write(
+                    StrTools::shortenText(entry.description.trimmed(),
+                                          config->maxLength)
+                        .toUtf8());
                 descFile.close();
             }
         }

src/pegasus.cpp

@@ -284,7 +284,8 @@ void Pegasus::assembleList(QString &finalOutput,
                 QString::number((int)(entry.rating.toDouble() * 100)) % "%"));
         }
         if (!entry.description.isEmpty()) {
-            QString desc = entry.description.left(config->maxLength);
+            QString desc =
+                StrTools::shortenText(entry.description, config->maxLength);
             replaceColon(desc, entry.title);
             out.append(toPegasusFormat("description", desc));
         }

src/settings.cpp

@@ -546,7 +546,11 @@ void RuntimeCfg::applyConfigIni(CfgType type, QSettings *settings,
                 continue;
             }
             if (k == "maxLength") {
-                config->maxLength = v;
+                if (0 < v && v <= 10000) {
+                    config->maxLength = v;
+                } else {
+                    outOfRange(k, v);
+                }
                 continue;
             }
             if (k == "maxFails") {

src/strtools.cpp

@@ -401,3 +401,9 @@ QString StrTools::tidyText(QString text, bool ignoreBangs) {
     }
     return po.join("\n");
 }
+
+QString StrTools::shortenText(QString text, int maxLength) {
+    if (text.length() > maxLength && maxLength > 4)
+        return text.left(maxLength - 5) % "[...]";
+    return text;
+}

src/strtools.h

@@ -44,6 +44,7 @@ class StrTools : public QObject {
     static QString stripHtmlTags(QString str);
     static QString getMd5Sum(const QByteArray &data);
     static QString tidyText(QString text, bool ignoreBangs);
+    static QString shortenText(QString text, int maxLength);
 };
 
 #endif // STRTOOLS_H