On Nov 28, Anton81 wrote:
I've written a python script and added short docstrings. Now I'd
like to create a short overview of commands the user can use.
However I don't want the internal stuff that I also commented. Is
there a way to create a fancy documentation (e.g. pydoc) of certain
functions only?
You can use the leading underscores convention
<URL:http://docs.python.org/ref/id-classes.html> to "hide" the
intended invisible names. pydoc and epydoc both honor this...
$ cat foo.py
"""Foo test mod.
"""
def spam():
"Like ham."
pass
def _secret():
"Can't see this docstring."
pass
class Mustard(object):
__name1 = 1
_name2 = 2
name3 = 3
$ pydoc foo
Help on module foo:
NAME
foo - Foo test mod.
CLASSES
...
class Mustard(__builtin__.object)
...
| name3 = 3
FUNCTIONS
spam()
Like ham.
--
_ _ ___
|V|icah |- lliott <><
md*@micah.elliott.name
" " """