[Python-checkins] CVS: python/dist/src/Tools/scripts pydoc,1.1,1.2
Ka-Ping Yee
ping@users.sourceforge.net
Wed, 28 Feb 2001 16:25:42 -0800
Update of /cvsroot/python/python/dist/src/Tools/scripts
In directory usw-pr-cvs1:/tmp/cvs-serv21366
Modified Files:
pydoc
Log Message:
Call main routine in pydoc module (pydoc.cli).
Index: pydoc
===================================================================
RCS file: /cvsroot/python/python/dist/src/Tools/scripts/pydoc,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** pydoc 2001/02/28 20:55:10 1.1
--- pydoc 2001/03/01 00:25:40 1.2
***************
*** 1,78 ****
#!/usr/bin/env python
! # -------------------------------------------------- command-line interface
!
! import sys, os, pydoc
! from string import lower
!
! if __name__ == '__main__':
! import getopt
! class BadUsage: pass
!
! try:
! opts, args = getopt.getopt(sys.argv[1:], 'k:p:w')
! writing = 0
!
! for opt, val in opts:
! if opt == '-k':
! pydoc.apropos(lower(val))
! break
! if opt == '-p':
! try:
! port = int(val)
! except ValueError:
! raise BadUsage
! def ready(port=port):
! print 'server ready at http://127.0.0.1:%d/' % port
! pydoc.serve(('127.0.0.1', port), ready)
! break
! if opt == '-w':
! if not args: raise BadUsage
! writing = 1
! else:
! if args:
! for arg in args:
! try:
! if os.path.isfile(arg):
! arg = pydoc.importfile(arg)
! if writing:
! if os.path.isdir(arg): pydoc.writedocs(arg)
! else: pydoc.writedoc(arg)
! else: pydoc.man(arg)
! except pydoc.DocImportError, value:
! print 'problem in %s - %s' % (
! value.filename, value.args)
! else:
! if sys.platform in ['mac', 'win', 'win32', 'nt']:
! # GUI platforms with threading
! import threading
! ready = threading.Event()
! address = ('127.0.0.1', 12346)
! threading.Thread(
! target=pydoc.serve, args=(address, ready.set)).start()
! ready.wait()
! import webbrowser
! webbrowser.open('http://127.0.0.1:12346/')
! else:
! raise BadUsage
!
! except (getopt.error, BadUsage):
! print """%s <name> ...
! Show documentation on something.
! <name> may be the name of a Python function, module, or package,
! or a dotted reference to a class or function within a module or
! module in a package, or the filename of a Python module to import.
!
! %s -k <keyword>
! Search for a keyword in the synopsis lines of all modules.
!
! %s -p <port>
! Start an HTTP server on the given port on the local machine.
!
! %s -w <module> ...
! Write out the HTML documentation for a module to a file.
!
! %s -w <moduledir>
! Write out the HTML documentation for all modules in the tree
! under a given directory to files in the current directory.
! """ % ((sys.argv[0],) * 5)
--- 1,4 ----
#!/usr/bin/env python
! import pydoc
! pydoc.cli()