Merged the wxPy_newswig branch into the HEAD branch (main trunk)

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@24541 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

wxPython/wx/tools/helpviewer.py

@@ -1,8 +1,80 @@
+#----------------------------------------------------------------------
+# Name:        wxPython.tools.helpviewer
+# Purpose:     HTML Help viewer
+#
+# Author:      Robin Dunn
+#
+# Created:     11-Dec-2002
+# RCS-ID:      $Id$
+# Copyright:   (c) 2002 by Total Control Software
+# Licence:     wxWindows license
+#----------------------------------------------------------------------
 
-"""Renamer stub: provides a way to drop the wx prefix from wxPython objects."""
+"""
+helpviewer.py   --  Displays HTML Help in a wxHtmlHelpController window.
 
-from wx import _rename
-from wxPython.tools import helpviewer
-_rename(globals(), helpviewer.__dict__, modulename='tools.helpviewer')
-del helpviewer
-del _rename
+Usage:
+    helpviewer [--cache=path] helpfile [helpfile(s)...]
+
+    Where helpfile is the path to either a .hhp file or a .zip file
+    which contians a .hhp file.  The .hhp files are the same as those
+    used by Microsoft's HTML Help Workshop for creating CHM files.
+"""
+
+
+import sys, os
+
+#---------------------------------------------------------------------------
+
+def main(args=sys.argv):
+    if len(args) < 2:
+        print __doc__
+        return
+
+    args = args[1:]
+    cachedir = None
+    if args[0][:7] == '--cache':
+        cachedir = os.path.expanduser(args[0].split('=')[1])
+        args = args[1:]
+
+    if len(args) == 0:
+        print __doc__
+        return
+
+    from wxPython.wx import wxPySimpleApp, wxConfigBase_Get, \
+         wxLog_SetActiveTarget, wxLogStderr, \
+         wxLog_SetLogLevel, wxLOG_Error, \
+         wxFileSystem_AddHandler, wxZipFSHandler
+    import wxPython.html
+    from wxPython.htmlhelp import wxHtmlHelpController
+
+
+    app = wxPySimpleApp()
+    #wxLog_SetActiveTarget(wxLogStderr())
+    wxLog_SetLogLevel(wxLOG_Error)
+
+    # Set up the default config so the htmlhelp frame can save its preferences
+    app.SetVendorName('wxWindows')
+    app.SetAppName('helpviewer')
+    cfg = wxConfigBase_Get()
+
+    # Add the Zip filesystem
+    wxFileSystem_AddHandler(wxZipFSHandler())
+
+    # Create the viewer
+    helpctrl = wxHtmlHelpController()
+    if cachedir:
+        helpctrl.SetTempDir(cachedir)
+
+    # and add the books
+    for helpfile in args:
+        print "Adding %s..." % helpfile
+        helpctrl.AddBook(helpfile, 1)
+
+    # start it up!
+    helpctrl.DisplayContents()
+    app.MainLoop()
+
+
+if __name__ == '__main__':
+    main()