[HappyDoc-discuss] Errors encountered using happy doc 3.0

[Nitin S. <nit...@go...>]

Hello,

I downloaded the latest available version of happydoc 3.0 and unpacked the
tar file. Since there's not setup.py file I tried to use the happydoc script
directly from the extracted code. I get the following errors when I do
../../../Desktop/HappyDoc3-r3_0_a1/happydoc pyDocSample.py


--- Plugin Module Error in happydoclib.docstring.docstring_PlainText ---
Traceback (most recent call last):
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/pluginloader.py",
line 177, in __init__
    _module = __import__( _import_name )
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/docstring_PlainText.py",
line 66, in ?
    import happydoclib.docstring.StructuredText
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/__init__.py",
line 14, in ?
    import HTMLClass, DocumentClass
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/HTMLClass.py",
line 15, in ?
    import re, sys, ST
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/ST.py",
line 14, in ?
    import re, STDOM
SyntaxError: Invalid syntax.  Assignment to None. (STDOM.py, line 343)
---------------------------


--- Plugin Module Error in happydoclib.docstring.docstring_StructuredText---
Traceback (most recent call last):
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/pluginloader.py",
line 177, in __init__
    _module = __import__( _import_name )
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/docstring_StructuredText.py",
line 62, in ?
    import happydoclib.docstring.StructuredText
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/__init__.py",
line 14, in ?
    import HTMLClass, DocumentClass
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/HTMLClass.py",
line 15, in ?
    import re, sys, ST
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/StructuredText/ST.py",
line 14, in ?
    import re, STDOM
SyntaxError: Invalid syntax.  Assignment to None. (STDOM.py, line 343)
---------------------------


--- Plugin Module Error in happydoclib.docset.docset_TAL ---
Traceback (most recent call last):
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/pluginloader.py",
line 177, in __init__
    _module = __import__( _import_name )
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/docset_TAL/__init__.py",
line 66, in ?
    from happydoclib.docset.docset_TAL.templateset import TemplateSet
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/docset_TAL/templateset.py",
line 66, in ?
    from happydoclib.docset.docset_TAL.templatefile import TemplateFile
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/docset_TAL/templatefile.py",
line 64, in ?
    from happydoclib.docset.docset_TAL import hdExpressions
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/docset_TAL/hdExpressions.py",
line 27, in ?
    from hdTALES import Engine, CompilerError, _valid_name, NAME_RE, \
SyntaxError: Invalid syntax.  Assignment to None. (hdTALES.py, line 282)
---------------------------

HappyDoc version 3.0.a1
Scanning...
Parsing: pyDocSample.py
Done
Initializing documentation set HappyDoc Generated Documentation
NEED TO HANDLE extraParameters in DocSetBase
Writing...
Documenting: "pyDocSample.py"
         to: "doc/pyDocSample.html"
Wanted: "StructuredText"
Have  : ['RawText', 'ClassicStructuredText']
Traceback (most recent call last):
  File "../../../Desktop/HappyDoc3-r3_0_a1/happydoc", line 61, in ?
    HappyDoc().run()
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/CommandLineApp.py",
line 314, in run
    exit_code = apply(self.main, tuple(self.remainingOpts))
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/appclass.py", line
492, in main
    docset.write()
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/base.py",
line 322, in write
    self.scanner.walk(self.writeCB)
  File "/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/scanner.py",
line 227, in walk
    tree.walk(callback)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/packagetree.py",
line 443, in walk
    callback(self)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/base.py",
line 315, in writeCB
    writer(packageTreeNode)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/docset_MultiHTMLFile.py",
line 1076, in processPythonFile
    self.writeText(output, readme_text, text_format)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/base.py",
line 615, in writeText
    html = self.formatText(text, textFormat)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docset/base.py",
line 582, in formatText
    converter_factory = getConverterFactory(textFormat)
  File
"/home/nitinshukla/Desktop/HappyDoc3-r3_0_a1/happydoclib/docstring/__init__.py",
line 183, in getConverterFactory
    raise ValueError('Unrecognized docstring format type "%s"' % formatType)
ValueError: Unrecognized docstring format type "StructuredText"


Can anyone help me identify what's going wrong here and help generate
documentation for the python code I have.

Nitin