Add a "Check for Updates" dialog (#863)

* Add basic dialog for Updates check
* Add GitHub API call and processing
* Finalise the update dialog
* Improve test coverage

nw/dialogs/__init__.py

@@ -27,6 +27,7 @@ from nw.dialogs.preferences import GuiPreferences
 from nw.dialogs.projload import GuiProjectLoad
 from nw.dialogs.projsettings import GuiProjectSettings
 from nw.dialogs.quotes import GuiQuoteSelect
+from nw.dialogs.updates import GuiUpdates
 from nw.dialogs.wordlist import GuiWordList
 
 __all__ = [
@@ -38,5 +39,6 @@ __all__ = [
     "GuiProjectLoad",
     "GuiProjectSettings",
     "GuiQuoteSelect",
+    "GuiUpdates",
     "GuiWordList",
 ]

nw/dialogs/updates.py

@@ -0,0 +1,170 @@
+"""
+novelWriter – GUI Updates
+=========================
+A dialog box for checking for latest updates
+
+File History:
+Created: 2021-08-21 [1.5-alpah0]
+
+This file is a part of novelWriter
+Copyright 2018–2021, Veronica Berglyd Olsen
+
+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 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 <https://www.gnu.org/licenses/>.
+"""
+
+import nw
+import json
+import logging
+
+from datetime import datetime
+from urllib.request import Request, urlopen
+
+from PyQt5.QtGui import QCursor
+from PyQt5.QtCore import Qt
+from PyQt5.QtWidgets import (
+    qApp, QDialog, QHBoxLayout, QVBoxLayout, QDialogButtonBox, QLabel
+)
+
+from nw.common import logException
+
+logger = logging.getLogger(__name__)
+
+
+class GuiUpdates(QDialog):
+
+    def __init__(self, theParent):
+        QDialog.__init__(self, theParent)
+
+        logger.debug("Initialising GuiUpdates ...")
+        self.setObjectName("GuiUpdates")
+
+        self.mainConf  = nw.CONFIG
+        self.theParent = theParent
+
+        self.setWindowTitle(self.tr("Check for Updates"))
+
+        nPx = self.mainConf.pxInt(96)
+        sPx = self.mainConf.pxInt(16)
+        tPx = self.mainConf.pxInt(8)
+        mPx = self.mainConf.pxInt(4)
+
+        # Left Box
+        self.nwIcon = QLabel()
+        self.nwIcon.setPixmap(self.theParent.theTheme.getPixmap("novelwriter", (nPx, nPx)))
+
+        self.leftBox = QVBoxLayout()
+        self.leftBox.addWidget(self.nwIcon)
+        self.leftBox.addStretch(1)
+
+        # Right Box
+        self.currentLabel = QLabel(self.tr("Current Release"))
+        self.currentValue = QLabel(self.tr(
+            "novelWriter {0} released on {1}"
+        ).format(
+            "v%s" % nw.__version__,
+            datetime.strptime(nw.__date__, "%Y-%m-%d").strftime("%x"))
+        )
+
+        self.latestLabel = QLabel(self.tr("Latest Release"))
+        self.latestValue = QLabel(self.tr("Checking ..."))
+        self.latestLink = QLabel("")
+        self.latestLink.setOpenExternalLinks(True)
+
+        self.rightBox = QVBoxLayout()
+        self.rightBox.addWidget(self.currentLabel)
+        self.rightBox.addWidget(self.currentValue)
+        self.rightBox.addSpacing(tPx)
+        self.rightBox.addWidget(self.latestLabel)
+        self.rightBox.addWidget(self.latestValue)
+        self.rightBox.addSpacing(tPx)
+        self.rightBox.addWidget(self.latestLink)
+        self.rightBox.setSpacing(mPx)
+
+        hFont = self.currentLabel.font()
+        hFont.setBold(True)
+        self.currentLabel.setFont(hFont)
+        self.latestLabel.setFont(hFont)
+
+        # Buttons
+        self.buttonBox = QDialogButtonBox(QDialogButtonBox.Ok)
+        self.buttonBox.accepted.connect(self._doClose)
+
+        # Assemble
+        self.innerBox = QHBoxLayout()
+        self.innerBox.addLayout(self.leftBox)
+        self.innerBox.addLayout(self.rightBox)
+        self.innerBox.setSpacing(sPx)
+
+        self.outerBox = QVBoxLayout()
+        self.outerBox.addLayout(self.innerBox)
+        self.outerBox.addWidget(self.buttonBox)
+        self.outerBox.setSpacing(sPx)
+
+        self.setLayout(self.outerBox)
+
+        logger.debug("GuiUpdates initialisation complete")
+
+        return
+
+    def checkLatest(self):
+        """Check for latest release.
+        """
+        qApp.setOverrideCursor(QCursor(Qt.WaitCursor))
+
+        urlReq = Request("https://api.github.com/repos/vkbo/novelwriter/releases/latest")
+        urlReq.add_header("User-Agent", "Mozilla/5.0 (compatible; novelWriter (Python))")
+        urlReq.add_header("Accept", "application/vnd.github.v3+json")
+
+        rawData = {}
+        try:
+            urlData = urlopen(urlReq, timeout=10)
+            rawData = json.loads(urlData.read().decode())
+        except Exception:
+            logger.error("Failed to contact GitHub API")
+            logException()
+
+        relVersion = rawData.get("tag_name", "Unknown")
+        relDate = rawData.get("created_at", None)
+
+        try:
+            relDate = datetime.strptime(relDate[:10], "%Y-%m-%d").strftime("%x")
+        except Exception:
+            relDate = "Unknown"
+            logException()
+
+        self.latestValue.setText(self.tr(
+            "novelWriter {0} released on {1}"
+        ).format(
+            relVersion, relDate
+        ))
+
+        self.latestLink.setText(self.tr(
+            "Download: {0}"
+        ).format(
+            f'<a href="{nw.__url__}">{nw.__url__}</a>'
+        ))
+
+        qApp.restoreOverrideCursor()
+
+        return
+
+    ##
+    #  Internal Functions
+    ##
+
+    def _doClose(self):
+        self.close()
+        return
+
+# END Class GuiUpdates

nw/gui/mainmenu.py

@@ -1125,14 +1125,6 @@ class GuiMainMenu(QMenuBar):
         self.aQuestion.triggered.connect(lambda: self._openWebsite(nw.__helpurl__))
         self.helpMenu.addAction(self.aQuestion)
 
-        # Document > Latest Release
-        self.aRelease = QAction(self.tr("Latest Release (GitHub)"), self)
-        self.aRelease.setStatusTip(
-            self.tr("Open the Releases page on GitHub at {0}").format(nw.__releaseurl__)
-        )
-        self.aRelease.triggered.connect(lambda: self._openWebsite(nw.__releaseurl__))
-        self.helpMenu.addAction(self.aRelease)
-
         # Document > Main Website
         self.aWebsite = QAction(self.tr("The novelWriter Website"), self)
         self.aWebsite.setStatusTip(
@@ -1141,6 +1133,15 @@ class GuiMainMenu(QMenuBar):
         self.aWebsite.triggered.connect(lambda: self._openWebsite(nw.__url__))
         self.helpMenu.addAction(self.aWebsite)
 
+        # Help > Separator
+        self.helpMenu.addSeparator()
+
+        # Document > Check for Updates
+        self.aUpdates = QAction(self.tr("Check for New Release"), self)
+        self.aUpdates.setStatusTip(self.tr("Check for latest release of novelWriter"))
+        self.aUpdates.triggered.connect(lambda: self.theParent.showUpdatesDialog())
+        self.helpMenu.addAction(self.aUpdates)
+
         return
 
 # END Class GuiMainMenu

nw/guimain.py

@@ -44,7 +44,7 @@ from nw.gui import (
 )
 from nw.dialogs import (
     GuiAbout, GuiDocMerge, GuiDocSplit, GuiItemEditor, GuiPreferences,
-    GuiProjectLoad, GuiProjectSettings, GuiWordList
+    GuiProjectLoad, GuiProjectSettings, GuiUpdates, GuiWordList
 )
 from nw.tools import GuiBuildNovel, GuiProjectWizard, GuiWritingStats
 from nw.core import NWProject, NWIndex
@@ -289,7 +289,7 @@ class GuiMain(QMainWindow):
 
         logger.debug("GUI initialisation complete")
 
-        if nw.__hexversion__[-2] == "a":
+        if nw.__hexversion__[-2] == "a" and logger.getEffectiveLevel() > logging.DEBUG:
             self.makeAlert(self.tr(
                 "You are running an untested development version of novelWriter. "
                 "Please be careful when working on a live project "
@@ -1096,6 +1096,21 @@ class GuiMain(QMainWindow):
         msgBox.aboutQt(self, "About Qt")
         return
 
+    def showUpdatesDialog(self):
+        """Show the updates dialog for novelWriter.
+        """
+        dlgUpdate = getGuiItem("GuiUpdates")
+        if dlgUpdate is None:
+            dlgUpdate = GuiUpdates(self)
+
+        dlgUpdate.setModal(True)
+        dlgUpdate.show()
+        dlgUpdate.raise_()
+        qApp.processEvents()
+        dlgUpdate.checkLatest()
+
+        return
+
     def makeAlert(self, theMessage, theLevel=nwAlert.INFO):
         """Alert both the user and the logger at the same time. Message
         can be either a string or an array of strings.