[LyX/master] Add python lyxpaperview script

[Juergen Spitzmueller]

commit 935c9aad5ac999f74beb02703c40f7fdff36d116
Author: Juergen Spitzmueller <spitz at lyx.org>
Date:   Mon Aug 24 13:32:50 2020 +0200

    Add python lyxpaperview script
---
 lib/Makefile.am             |    1 +
 lib/configure.py            |    2 +-
 lib/scripts/lyxpaperview.py |  136 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 138 insertions(+), 1 deletions(-)

diff --git a/lib/Makefile.am b/lib/Makefile.am
index fdb7502..411ad88 100644
--- a/lib/Makefile.am
+++ b/lib/Makefile.am
@@ -2511,6 +2511,7 @@ dist_scripts_DATA += \
 	scripts/listerrors \
 	scripts/lyxpak.py \
 	scripts/lyxpaperview \
+	scripts/lyxpaperview.py \
 	scripts/lyxpreview2bitmap.py \
 	scripts/lyxpreview_tools.py \
 	scripts/lyx_batch.pl.in \
diff --git a/lib/configure.py b/lib/configure.py
index 856b82b..b708edf 100644
--- a/lib/configure.py
+++ b/lib/configure.py
@@ -1311,7 +1311,7 @@ def checkOtherEntries():
     checkProg('a python-pygments driver command', ['pygmentize'],
         rc_entry = [ r'\pygmentize_command "%%"' ])
     checkProg('external script for searching and showing citation sources',
-        ['lyxpaperview'], rc_entry = [ r'\citation_search_view "%%"' ])
+        ['lyxpaperview', 'lyxpaperview.py'], rc_entry = [ r'\citation_search_view "%%"' ])
     ## FIXME: OCTAVE is not used anywhere
     # path, OCTAVE = checkProg('Octave', ['octave'])
     ## FIXME: MAPLE is not used anywhere
diff --git a/lib/scripts/lyxpaperview.py b/lib/scripts/lyxpaperview.py
new file mode 100755
index 0000000..2b33434
--- /dev/null
+++ b/lib/scripts/lyxpaperview.py
@@ -0,0 +1,136 @@
+#! /usr/bin/python3
+# -*- coding: utf-8 -*-
+
+# file lyxpaperview.py
+# This file is part of LyX, the document processor.
+# Licence details can be found in the file COPYING.
+
+# author Jürgen Spitzmüller
+# Full author contact details are available in file CREDITS
+
+# This script searches the home directory for a PDF or PS
+# file with a name containing year and author. If found,
+# it opens the file in a viewer. 
+
+import getopt, os, sys, subprocess
+
+pdf_viewers = ('pdfview', 'kpdf', 'okular', 'qpdfview --unique',
+               'evince', 'xreader', 'kghostview', 'xpdf', 'SumatraPDF',
+               'acrobat', 'acroread', 'mupdf',
+               'gv', 'ghostview', 'AcroRd32', 'gsview64', 'gsview32')
+
+ps_viewers = ("kghostview", "okular", "qpdfview --unique",
+              "evince", "xreader", "gv", "ghostview -swap",
+              "gsview64", "gsview32")
+
+def message(message):
+    sys.stderr.write("lyxpaperview: %s\n" % message)
+
+def error(message):
+    sys.stderr.write("lyxpaperview error: %s\n" % message)
+    exit(1)
+
+def usage(prog_name):
+    msg = "Usage: %s [-v pdfviewer] [-w psviewer] year author"
+    return  msg % prog_name
+
+# Copied from lyxpreview_tools.py
+# PATH and PATHEXT environment variables
+path = os.environ["PATH"].split(os.pathsep)
+extlist = ['']
+if "PATHEXT" in os.environ:
+    extlist += os.environ["PATHEXT"].split(os.pathsep)
+extlist.append('.py')
+
+def find_exe(candidates):
+    global extlist, path
+
+    for command in candidates:
+        prog = command.split()[0]
+        for directory in path:
+            for ext in extlist:
+                full_path = os.path.join(directory, prog + ext)
+                if os.access(full_path, os.X_OK):
+                    # The thing is in the PATH already (or we wouldn't
+                    # have found it). Return just the basename to avoid
+                    # problems when the path to the executable contains
+                    # spaces.
+                    if full_path.lower().endswith('.py'):
+                        return command.replace(prog, '"%s" "%s"'
+                            % (sys.executable, full_path))
+                    return command
+
+    return None
+
+
+def find_exe_or_terminate(candidates):
+    exe = find_exe(candidates)
+    if exe == None:
+        error("Unable to find executable from '%s'" % " ".join(candidates))
+
+    return exe
+
+def find(year, author, path):
+    if os.name != 'nt':
+        # use locate if possible (faster)
+        if find_exe(['locate']):
+            p1 = subprocess.Popen(['locate', '-i', author], stdout=subprocess.PIPE)
+            p2 = subprocess.Popen(['grep', '-Ei', '\.pdf$|\.ps$'], stdin=p1.stdout, stdout=subprocess.PIPE)
+            p3 = subprocess.Popen(['grep', year], stdin=p2.stdout, stdout=subprocess.PIPE)
+            p4 = subprocess.Popen(['head', '-n 2'], stdin=p3.stdout, stdout=subprocess.PIPE)
+            p1.stdout.close()
+            output = p4.communicate()
+            return output[0].decode("utf8")[:-1]# strip trailing '\n'
+     # FIXME add something for windows as well?
+     # Maybe dir /s /b %WINDIR%\*author* | findstr .*year.*\."ps pdf"
+
+    for root, dirs, files in os.walk(path):
+        for fname in files:
+            lfname = fname.lower()
+            if lfname.endswith(('.pdf', '.ps')) and lfname.find(author) != -1 and lfname.find(year) != -1:
+                return os.path.join(root, fname)
+    return ""
+
+def main(argv):
+    progname = argv[0]
+    
+    opts, args = getopt.getopt(sys.argv[1:], "v:w:")
+    pdfviewer = ""
+    psviewer = ""
+    for o, v in opts:
+      if o == "-v":
+        pdfviewer = v
+      if o == "-w":
+        psviewer = v
+    
+    if len(args) != 2:
+      error(usage(progname))
+
+    year = args[0]
+    author = args[1]
+
+    result = find(year, author.lower(), path = os.environ["HOME"])
+    if result == "":
+        message("no document found!")
+        return 0
+    else:
+        message("found document %s" % result)
+
+    viewer = ""
+    if result.lower().endswith('.ps'):
+        if psviewer == "":
+            viewer = find_exe_or_terminate(ps_viewers)
+        else:
+            viewer = psviewer
+    else:
+        if pdfviewer == "":
+           viewer = find_exe_or_terminate(pdf_viewers)
+        else:
+            viewer = pdfviewer
+    
+    subprocess.call([viewer, result])
+    
+    return 0
+
+if __name__ == "__main__":
+    main(sys.argv)