Changeset View
Standalone View
Modules/about-distro/src/Module.cpp
| Show All 15 Lines | 1 | /* | |||
|---|---|---|---|---|---|
| 16 | 16 | | |||
| 17 | You should have received a copy of the GNU General Public License | 17 | You should have received a copy of the GNU General Public License | ||
| 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. | ||
| 19 | */ | 19 | */ | ||
| 20 | 20 | | |||
| 21 | #include "Module.h" | 21 | #include "Module.h" | ||
| 22 | #include "ui_Module.h" | 22 | #include "ui_Module.h" | ||
| 23 | 23 | | |||
| 24 | #include <QClipboard> | ||||
| 25 | #include <QMenu> | ||||
| 26 | #include <KHelpMenu> | ||||
| 27 | | ||||
| 24 | #include <QIcon> | 28 | #include <QIcon> | ||
| 25 | #include <QStandardPaths> | 29 | #include <QStandardPaths> | ||
| 26 | 30 | | |||
| 27 | #include <kcoreaddons_version.h> | 31 | #include <kcoreaddons_version.h> | ||
| 28 | #include <KAboutData> | 32 | #include <KAboutData> | ||
| 29 | #if KCOREADDONS_VERSION >= QT_VERSION_CHECK(5,20,0) | | |||
ngraham: Is this necessary for this patch? If not, let's address it in a different patch or commit. | |||||
This was a suggestion from the discussion on ReviewBoard. Is there an obvious way to tell arc to do this in a separate commit? Otherwise I'll try to separate this somehow manually. gregormi: This was a suggestion from the discussion on ReviewBoard. Is there an obvious way to tell arc… | |||||
I just saw that this change was already done with 8193488408011c4971711b81b782bb003ffd1c3d gregormi: I just saw that this change was already done with 8193488408011c4971711b81b782bb003ffd1c3d | |||||
| 30 | #include <KCoreAddons> | 33 | #include <KCoreAddons> | ||
| 31 | #endif | | |||
| 32 | #include <KConfig> | 34 | #include <KConfig> | ||
| 33 | #include <KConfigGroup> | 35 | #include <KConfigGroup> | ||
| 34 | #include <KDesktopFile> | 36 | #include <KDesktopFile> | ||
| 35 | #include <KFormat> | 37 | #include <KFormat> | ||
| 36 | #include <KLocalizedString> | 38 | #include <KLocalizedString> | ||
| 37 | #include <KSharedConfig> | 39 | #include <KSharedConfig> | ||
| 38 | 40 | | |||
| 39 | #include <solid/device.h> | 41 | #include <solid/device.h> | ||
| ▲ Show 20 Lines • Show All 76 Lines • ▼ Show 20 Line(s) | |||||
| 116 | { | 118 | { | ||
| 117 | delete ui; | 119 | delete ui; | ||
| 118 | } | 120 | } | ||
| 119 | 121 | | |||
| 120 | void Module::load() | 122 | void Module::load() | ||
| 121 | { | 123 | { | ||
| 122 | loadSoftware(); | 124 | loadSoftware(); | ||
| 123 | loadHardware(); | 125 | loadHardware(); | ||
| 126 | | ||||
| 127 | auto menu = new QMenu(this); | ||||
| 128 | ui->pushButtonActionMenu->setMenu(menu); | ||||
| 129 | | ||||
| 130 | auto actionCopyToClipboard = new QAction(i18n("Copy to Clipboard"), this); | ||||
| 131 | menu->addAction(actionCopyToClipboard); | ||||
| 132 | connect(actionCopyToClipboard, &QAction::triggered, this, &Module::copyToClipboard); | ||||
| 133 | | ||||
| 134 | auto helpMenu = new KHelpMenu(); | ||||
| 135 | menu->addAction(helpMenu->action(KHelpMenu::MenuId::menuAboutKDE)); | ||||
| 136 | | ||||
| 137 | // WIP TODO: remove: | ||||
| 138 | //menu->addAction(KStandardAction::aboutKDE(this, SLOT(aboutKDE()), this)); // this does not show the About KDE dialog | ||||
| 124 | } | 139 | } | ||
| 125 | 140 | | |||
| 126 | void Module::save() | 141 | void Module::save() | ||
| 127 | { | 142 | { | ||
| 128 | } | 143 | } | ||
| 129 | 144 | | |||
| 130 | void Module::defaults() | 145 | void Module::defaults() | ||
| 131 | { | 146 | { | ||
| 132 | } | 147 | } | ||
| 133 | 148 | | |||
| 134 | void Module::loadSoftware() | 149 | void Module::loadSoftware() | ||
| 135 | { | 150 | { | ||
| 136 | // NOTE: do not include globals, otherwise kdeglobals could provide values | 151 | // NOTE: do not include globals, otherwise kdeglobals could provide values | ||
| 137 | // even though we only explicitly want them from our own config. | 152 | // even though we only explicitly want them from our own config. | ||
| 138 | KSharedConfig::Ptr config = KSharedConfig::openConfig(QStringLiteral("kcm-about-distrorc"), | 153 | KSharedConfig::Ptr config = KSharedConfig::openConfig(QStringLiteral("kcm-about-distrorc"), | ||
| 139 | KConfig::NoGlobals); | 154 | KConfig::NoGlobals); | ||
| 140 | KConfigGroup cg = KConfigGroup(config, "General"); | 155 | KConfigGroup cg = KConfigGroup(config, "General"); | ||
| 141 | 156 | | |||
| 142 | QString logoPath = cg.readEntry("LogoPath", QString()); | 157 | const QString logoPath = cg.readEntry("LogoPath", QString()); | ||
| 143 | QPixmap logo; | 158 | QPixmap logo; | ||
| 144 | if (logoPath.isEmpty()) { | 159 | if (logoPath.isEmpty()) { | ||
| 145 | logo = QIcon::fromTheme(QStringLiteral("start-here-kde")).pixmap(128, 128); | 160 | logo = QIcon::fromTheme(QStringLiteral("start-here-kde")).pixmap(128, 128); | ||
| 146 | } else { | 161 | } else { | ||
| 147 | logo = QPixmap(logoPath); | 162 | logo = QPixmap(logoPath); | ||
| 148 | } | 163 | } | ||
| 149 | ui->logoLabel->setPixmap(logo); | 164 | ui->logoLabel->setPixmap(logo); | ||
| 150 | 165 | | |||
| 151 | OSRelease os; | 166 | OSRelease os; | ||
| 152 | // We allow overriding of the OS name for branding purposes. | 167 | // We allow overriding of the OS name for branding purposes. | ||
| 153 | // For example OS Ubuntu may be rebranded as Kubuntu. Also Kubuntu Active | 168 | // For example OS Ubuntu may be rebranded as Kubuntu. Also Kubuntu Active | ||
| 154 | // as a product brand is different from Kubuntu. | 169 | // as a product brand is different from Kubuntu. | ||
| 155 | QString distroName = cg.readEntry("Name", os.name); | 170 | const QString distroName = cg.readEntry("Name", os.name); | ||
| 156 | QString versionId = cg.readEntry("Version", os.versionId); | 171 | const QString versionId = cg.readEntry("Version", os.versionId); | ||
| 172 | collectedData["4_Distro"] = distroName + " " + versionId; | ||||
| 157 | ui->nameVersionLabel->setText(QStringLiteral("%1 %2").arg(distroName, versionId)); | 173 | ui->nameVersionLabel->setText(QStringLiteral("%1 %2").arg(distroName, versionId)); | ||
| 158 | 174 | | |||
| 159 | QString variant = cg.readEntry("Variant", QString()); | 175 | const QString variant = cg.readEntry("Variant", QString()); | ||
rkflx: You could add a `const`. | |||||
dhaumann: Is "Distro" a proper English term? Should it meaybe read "Distribution"? | |||||
"Distro" is slang, but very common. I'm not sure "Distribution" is much better if were considering average people. They would consider the software on their computer to be an "Operating System." For that matter, distros themselves might appreciate being referred to as operating systems here. Perhaps we should use that term instead. ngraham: "Distro" is slang, but very common. I'm not sure "Distribution" is much better if were… | |||||
| 160 | if (variant.isEmpty()) { | 176 | if (variant.isEmpty()) { | ||
| 161 | ui->variantLabel->hide(); | 177 | ui->variantLabel->hide(); | ||
| 162 | } else { | 178 | } else { | ||
| 163 | ui->variantLabel->setText(variant); | 179 | ui->variantLabel->setText(variant); | ||
| 164 | } | 180 | } | ||
| 165 | 181 | | |||
| 166 | QString url = cg.readEntry("Website", os.homeUrl); | 182 | const QString url = cg.readEntry("Website", os.homeUrl); | ||
| 167 | if (url.isEmpty()) { | 183 | if (url.isEmpty()) { | ||
| 168 | ui->urlLabel->hide(); | 184 | ui->urlLabel->hide(); | ||
| 169 | } else { | 185 | } else { | ||
| 170 | ui->urlLabel->setText(QStringLiteral("<a href='%1'>%1</a>").arg(url)); | 186 | ui->urlLabel->setText(QStringLiteral("<a href='%1'>%1</a>").arg(url)); | ||
| 171 | } | 187 | } | ||
| 172 | 188 | | |||
| 173 | // Since Plasma version detection isn't based on a library query it can fail | 189 | // Since Plasma version detection isn't based on a library query it can fail | ||
| 174 | // in weird cases; instead of admiting defeat we simply hide everything :P | 190 | // in weird cases; instead of admiting defeat we simply hide everything :P | ||
| 175 | QString plasma = plasmaVersion(); | 191 | const QString plasma = plasmaVersion(); | ||
| 176 | if (plasma.isEmpty()) { | 192 | if (plasma.isEmpty()) { | ||
| 177 | ui->plasma->hide(); | 193 | ui->plasma->hide(); | ||
| 178 | ui->plasmaLabel->hide(); | 194 | ui->plasmaLabel->hide(); | ||
| 179 | } else { | 195 | } else { | ||
| 196 | collectedData["1_Plasma Version"] = plasma; | ||||
| 180 | ui->plasmaLabel->setText(plasma); | 197 | ui->plasmaLabel->setText(plasma); | ||
| 181 | } | 198 | } | ||
| 182 | 199 | | |||
| 183 | ui->qtLabel->setText(qVersion()); | 200 | const QString qversion = qVersion(); | ||
| 184 | 201 | collectedData["3_Qt Version"] = qversion; | |||
| 185 | #if KCOREADDONS_VERSION >= QT_VERSION_CHECK(5,20,0) | 202 | ui->qtLabel->setText(qversion); | ||
| 186 | ui->frameworksLabel->setText(KCoreAddons::versionString()); | 203 | | ||
| 187 | #else | 204 | const QString frameworksVersion = KCoreAddons::versionString(); | ||
| 188 | ui->frameworksLabelKey->setVisible(false); | 205 | collectedData["2_KDE Frameworks Version"] = frameworksVersion; | ||
| 189 | ui->frameworksLabel->setVisible(false); | 206 | ui->frameworksLabel->setText(frameworksVersion); | ||
| 190 | #endif | | |||
| 191 | } | 207 | } | ||
| 192 | 208 | | |||
| 193 | void Module::loadHardware() | 209 | void Module::loadHardware() | ||
| 194 | { | 210 | { | ||
| 195 | struct utsname utsName; | 211 | struct utsname utsName; | ||
| 196 | if(uname(&utsName) != 0) { | 212 | if(uname(&utsName) != 0) { | ||
| 197 | ui->kernel->hide(); | 213 | ui->kernel->hide(); | ||
| 198 | ui->kernelLabel->hide(); | 214 | ui->kernelLabel->hide(); | ||
| 199 | } else { | 215 | } else { | ||
| 216 | collectedData["4_Kernel"] = utsName.release; | ||||
| 200 | ui->kernelLabel->setText(utsName.release); | 217 | ui->kernelLabel->setText(utsName.release); | ||
| 201 | } | 218 | } | ||
| 202 | 219 | | |||
| 203 | const int bits = QT_POINTER_SIZE == 8 ? 64 : 32; | 220 | const int bits = QT_POINTER_SIZE == 8 ? 64 : 32; | ||
| 221 | const QString bitsStr = QString::number(bits); | ||||
| 222 | collectedData["5_OS Type"] = bitsStr + " bit"; | ||||
| 204 | ui->bitsLabel->setText(i18nc("@label %1 is the CPU bit width (e.g. 32 or 64)", | 223 | ui->bitsLabel->setText(i18nc("@label %1 is the CPU bit width (e.g. 32 or 64)", | ||
| 205 | "%1-bit", QString::number(bits))); | 224 | "%1-bit", bitsStr)); | ||
| 206 | 225 | | |||
| 207 | const QList<Solid::Device> list = Solid::Device::listFromType(Solid::DeviceInterface::Processor); | 226 | const QList<Solid::Device> list = Solid::Device::listFromType(Solid::DeviceInterface::Processor); | ||
| 208 | ui->processor->setText(i18np("Processor:", "Processors:", list.count())); | 227 | ui->processor->setText(i18np("Processor:", "Processors:", list.count())); | ||
| 209 | // Format processor string | 228 | // Format processor string | ||
| 210 | // Group by processor name | 229 | // Group by processor name | ||
| 211 | QMap<QString, int> processorMap; | 230 | QMap<QString, int> processorMap; | ||
| 212 | Q_FOREACH(const Solid::Device &device, list) { | 231 | Q_FOREACH(const Solid::Device &device, list) { | ||
| 213 | const QString name = device.product(); | 232 | const QString name = device.product(); | ||
| Show All 9 Lines | |||||
| 223 | for (auto it = processorMap.constBegin(); it != processorMap.constEnd(); ++it) { | 242 | for (auto it = processorMap.constBegin(); it != processorMap.constEnd(); ++it) { | ||
| 224 | const int count = it.value(); | 243 | const int count = it.value(); | ||
| 225 | QString name = it.key(); | 244 | QString name = it.key(); | ||
| 226 | name.replace(QStringLiteral("(TM)"), QChar(8482)); | 245 | name.replace(QStringLiteral("(TM)"), QChar(8482)); | ||
| 227 | name.replace(QStringLiteral("(R)"), QChar(174)); | 246 | name.replace(QStringLiteral("(R)"), QChar(174)); | ||
| 228 | name = name.simplified(); | 247 | name = name.simplified(); | ||
| 229 | names.append(QStringLiteral("%1 × %2").arg(count).arg(name)); | 248 | names.append(QStringLiteral("%1 × %2").arg(count).arg(name)); | ||
| 230 | } | 249 | } | ||
| 231 | ui->processorLabel->setText(names.join(QStringLiteral(", "))); | 250 | | ||
| 251 | const QString processorLabel = names.join(QStringLiteral(", ")); | ||||
| 252 | collectedData["6_Processors"] = processorLabel; | ||||
| 253 | ui->processorLabel->setText(processorLabel); | ||||
| 232 | if (ui->processorLabel->text().isEmpty()) { | 254 | if (ui->processorLabel->text().isEmpty()) { | ||
| 233 | ui->processor->setHidden(true); | 255 | ui->processor->setHidden(true); | ||
| 234 | ui->processorLabel->setHidden(true); | 256 | ui->processorLabel->setHidden(true); | ||
| 235 | } | 257 | } | ||
| 236 | 258 | | |||
| 237 | const qlonglong totalRam = calculateTotalRam(); | 259 | const qlonglong totalRam = calculateTotalRam(); | ||
| 238 | ui->memoryLabel->setText(totalRam > 0 | 260 | const QString memoryLabel = totalRam > 0 | ||
| 239 | ? i18nc("@label %1 is the formatted amount of system memory (e.g. 7,7 GiB)", | 261 | ? i18nc("@label %1 is the formatted amount of system memory (e.g. 7,7 GiB)", | ||
| 240 | "%1 of RAM", KFormat().formatByteSize(totalRam)) | 262 | "%1 of RAM", KFormat().formatByteSize(totalRam)) | ||
| 241 | : i18nc("Unknown amount of RAM", "Unknown")); | 263 | : i18nc("Unknown amount of RAM", "Unknown"); | ||
| 264 | collectedData["7_Memory"] = memoryLabel; | ||||
| 265 | ui->memoryLabel->setText(memoryLabel); | ||||
| 266 | } | ||||
| 267 | | ||||
Probably not strictly required for this patch, but it would be nicer to refactor this in such a way that adding another string to the UI does not require adding it here too. Perhaps this can be achieved by creating a list of label/version pairs, and then iterating through that list both when creating the UI and when generating the text to copy. rkflx: Probably not strictly required for this patch, but it would be nicer to refactor this in such a… | |||||
Yes, I also had the list idea in an earlier stage of the patch< but without reusing the translated label text. I don't expect the information labels to change often, so I think such a refactoring can be done at a later point in time. gregormi: Yes, I also had the list idea in an earlier stage of the patch< but without reusing the… | |||||
I changed my mind. With all the i18nc comments, I decided it is better to do the refactoring now. gregormi: I changed my mind. With all the i18nc comments, I decided it is better to do the refactoring… | |||||
| 268 | void Module::copyToClipboard() | ||||
| 269 | { | ||||
| 270 | auto clipboard = QGuiApplication::clipboard(); | ||||
Nitpicking: Why do you declare the clipboard here, when you use it only 10 lines later? :-) Better would be: QGuiApplication::clipboard()->setText(text); So just one line at the end. dhaumann: Nitpicking: Why do you declare the clipboard here, when you use it only 10 lines later? :-)… | |||||
gregormi: Good question :). I'll fix that. | |||||
| 271 | QMapIterator<QString, QString> i(collectedData); | ||||
ngraham: Is "Distro" not a translated string? | |||||
| 272 | QString text; | ||||
Maybe you could avoid this special case if you added a hidden label in loadSoftware? Also, "label in … the button" sounds a bit odd. Perhaps "label" would be enough, or use @title:row? (See https://api.kde.org/frameworks/ki18n/html/prg_guide.html) rkflx: Maybe you could avoid this special case if you added a hidden label in `loadSoftware`?
Also… | |||||
gregormi: Good idea. DONE. | |||||
I'm afraid you missed the "hidden" part, so it shows up right in front of the distro logo ;) Adding dummyDistroDescriptionLabel->hide(); where you are creating the label solves the issue for me. rkflx: I'm afraid you missed the "hidden" part, so it shows up right in front of the distro logo ;)… | |||||
gregormi: dummy hide: Oh sorry, I should have seen that myself. Fixed it. | |||||
Coming back to this after a month, I now wonder what p stands for, which might indicate that variable could get a better name… rkflx: Coming back to this after a month, I now wonder what `p` stands for, which might indicate that… | |||||
gregormi: p stands for labelPair: renaming is a good idea. Done. | |||||
| 273 | while (i.hasNext()) { | ||||
| 274 | i.next(); | ||||
@dhaumann I wonder why you suggested to use i18n here too, as text() should already give you the translated text. How do you expect translators to translate "%1 %2"? The only challenge is to account for RTL languages, but this could be detected to swap the order (and possibly add an RTL BOM?). Do we have experts who could advice on that? rkflx: @dhaumann I wonder why you suggested to use `i18n` here too, as `text()` should already give… | |||||
The reason for this is that in a right-to-left language, you would translated "%1 %2" by using the reverse, e.g. "%2 %1". The problem here is that a translator will not know what to do with this. So what would help is to give translators context, i.g. i18nc("reverse order in rtl languages", ...). Does that make sense? dhaumann: The reason for this is that in a right-to-left language, you would translated "%1 %2" by using… | |||||
It does, and it's probably easier for @gregormi to implement. rkflx: > `i18nc("reverse order in rtl languages", ...)`. Does that make sense?
It does, and it's… | |||||
Please don't write (just) "do this in this case", but explain what the placeholders are meant to be. Leave it to the speakers of the language the decision about the order. ltoscano: Please don't write (just) "do this in this case", but explain what the placeholders are meant… | |||||
I will do it like this: i18nc("one line in the information that goes to the clipboard", "%1 %2", ... I see one problem: %1 contains a trailing colon (:). So just reversing to "%2 %1" would result in "openSUSE Tumbleweed Distro:". One solution would be to strip the colon from the %1 string and put it here: "%1: %2". gregormi: I will do it like this:
i18nc("one line in the information that goes to the clipboard", "%1… | |||||
| 275 | // "1_", "2_" etc. at the beginning of the key is for the ordering | ||||
I'd use the C++11 for ( : ) here, and add qAsConst to the second argument since we can depend on Qt 5.7. rkflx: I'd use the C++11 `for ( : )` here, and add `qAsConst` to the second argument since we can… | |||||
| 276 | // in the map and will not be part of the text for the clipboard | ||||
| 277 | text += i.key().mid(2) + ": " + i.value(); | ||||
| 278 | text += "\n"; | ||||
| 279 | } | ||||
| 280 | clipboard->setText(text); | ||||
Is endsWith RTL aware? If not, it might be better to also check startsWith, however that assumes in most languages : is kept intact, which I'm not sure about. Thinking about this again, why not
rkflx: Is `endsWith` RTL aware? If not, it might be better to also check `startsWith`, however that… | |||||
| 242 | } | 281 | } | ||
| 243 | 282 | | |||
| 244 | QString Module::plasmaVersion() const | 283 | QString Module::plasmaVersion() const | ||
I suspect @ltoscano meant something like this: %1 is a label, %2 is a corresponding value "One line" is meaningless unless the translator also knows the other lines, and whether it is saved to the clipboard or a text file is probably also more confusing than helping. rkflx: > explain what the placeholders are meant to be. Leave it to the speakers of the language the… | |||||
| 245 | { | 284 | { | ||
| 246 | const QStringList &filePaths = QStandardPaths::locateAll(QStandardPaths::GenericDataLocation, | 285 | const QStringList &filePaths = QStandardPaths::locateAll(QStandardPaths::GenericDataLocation, | ||
| 247 | QStringLiteral("xsessions/plasma.desktop")); | 286 | QStringLiteral("xsessions/plasma.desktop")); | ||
| 248 | 287 | | |||
| 249 | if (filePaths.length() < 1) { | 288 | if (filePaths.length() < 1) { | ||
| 250 | return QString(); | 289 | return QString(); | ||
| 251 | } | 290 | } | ||
| 252 | 291 | | |||
| 253 | // Despite the fact that there can be multiple desktop files we simply take | 292 | // Despite the fact that there can be multiple desktop files we simply take | ||
| 254 | // the first one as users usually don't have xsessions/ in their $HOME | 293 | // the first one as users usually don't have xsessions/ in their $HOME | ||
| 255 | // data location, so the first match should (usually) be the only one and | 294 | // data location, so the first match should (usually) be the only one and | ||
| 256 | // reflect the plasma session run. | 295 | // reflect the plasma session run. | ||
| 257 | KDesktopFile desktopFile(filePaths.first()); | 296 | KDesktopFile desktopFile(filePaths.first()); | ||
| 258 | return desktopFile.desktopGroup().readEntry("X-KDE-PluginInfo-Version", QString()); | 297 | return desktopFile.desktopGroup().readEntry("X-KDE-PluginInfo-Version", QString()); | ||
| 259 | } | 298 | } | ||
Is this necessary for this patch? If not, let's address it in a different patch or commit.