#!/usr/bin/env python

"Make the API documentation."

import pydoc

import os, sys

_apache = """

"Placeholder for the real _apache module exported within the server itself."

def log_error(s, x=None): pass

def config_tree(): pass

def server_root(): pass

def mpm_query(i): pass

def parse_qs(s, x): pass

def parse_qsl(s, x): pass

table = None

SERVER_RETURN = None

"""

http = """

"Placeholder for javax.servlet.http."

class Cookie:

    def __init__(self, *args):

        pass

"""

internet = """

"Placeholder for javax.mail.internet."

class MimeMessage:

    def __init__(self, *args):

        pass

"""

mail = """

"Placeholder for javax.mail."

class Session:

    pass

"""

util = """

"Placeholder for java.util."

class Properties:

    pass

"""

net = """

"Placeholder for java.net."

class URLDecoder:

    pass

"""

if __name__ == "__main__":

    # The list of packages should coincide with that found in setup.py.

    names = [

        "WebStack", "WebStack.__init__",

        "WebStack.BaseHTTPRequestHandler", "WebStack.CGI", "WebStack.Generic",

        "WebStack.JavaServlet", "WebStack.ModPython", "WebStack.Twisted",

        "WebStack.Webware", "WebStack.Zope",

        "WebStack.Adapters", "WebStack.Adapters.__init__",

        "WebStack.Adapters.BaseHTTPRequestHandler", "WebStack.Adapters.CGI",

        "WebStack.Adapters.JavaServlet", "WebStack.Adapters.ModPython",

        "WebStack.Adapters.Twisted", "WebStack.Adapters.Webware",

        "WebStack.Adapters.Zope",

        "WebStack.Helpers", "WebStack.Helpers.__init__",

        "WebStack.Helpers.Auth", "WebStack.Helpers.Environment",

        "WebStack.Helpers.Request", "WebStack.Helpers.Response",

        "WebStack.Helpers.Session",

        "WebStack.Resources", "WebStack.Resources.__init__",

        "WebStack.Resources.Login", "WebStack.Resources.LoginRedirect"

        ]

    dirname = "apidocs"

    # Set the PYTHONPATH to find the WebStack package and others.

    sys.path.insert(0, os.getcwd())

    sys.path.insert(1, os.path.join(os.path.abspath(".."), "Zope", "lib", "python"))

    sys.path.insert(2, os.path.join(os.path.abspath(".."), "Webware"))

    # Make the documentation directory if necessary.

    if not os.path.exists(dirname):

        print "Making", dirname

        os.mkdir(dirname)

    # Change into the directory - pydoc.writedoc depends on that.

    os.chdir(dirname)

    # Fake some modules.

    f = open("_apache.py", "w")

    f.write(_apache)

    f.close()

    os.mkdir("javax")

    f = open(os.path.join("javax", "__init__.py"), "w")

    f.close()

    os.mkdir(os.path.join("javax", "servlet"))

    f = open(os.path.join("javax", "servlet", "__init__.py"), "w")

    f.close()

    f = open(os.path.join("javax", "servlet", "http.py"), "w")

    f.write(http)

    f.close()

    os.mkdir(os.path.join("javax", "mail"))

    f = open(os.path.join("javax", "mail", "internet.py"), "w")

    f.write(internet)

    f.close()

    f = open(os.path.join("javax", "mail", "__init__.py"), "w")

    f.write(mail)

    f.close()

    os.mkdir("java")

    f = open(os.path.join("java", "__init__.py"), "w")

    f.close()

    f = open(os.path.join("java", "util.py"), "w")

    f.write(util)

    f.close()

    f = open(os.path.join("java", "net.py"), "w")

    f.write(net)

    f.close()

    # Add the faked modules to the path.

    sys.path.insert(0, os.getcwd())

    for name in names:

        pydoc.writedoc(name, forceload=1)

    # Remove the faked modules.

    os.remove("_apache.py")

    os.remove("_apache.pyc")

    os.remove(os.path.join("javax", "__init__.py"))

    os.remove(os.path.join("javax", "__init__.pyc"))

    os.remove(os.path.join("javax", "servlet", "__init__.py"))

    os.remove(os.path.join("javax", "servlet", "__init__.pyc"))

    os.remove(os.path.join("javax", "servlet", "http.py"))

    os.remove(os.path.join("javax", "servlet", "http.pyc"))

    os.remove(os.path.join("javax", "mail", "internet.py"))

    os.remove(os.path.join("javax", "mail", "internet.pyc"))

    os.remove(os.path.join("javax", "mail", "__init__.py"))

    os.remove(os.path.join("javax", "mail", "__init__.pyc"))

    os.remove(os.path.join("java", "__init__.py"))

    os.remove(os.path.join("java", "__init__.pyc"))

    os.remove(os.path.join("java", "util.py"))

    os.remove(os.path.join("java", "util.pyc"))

    os.remove(os.path.join("java", "net.py"))

    os.remove(os.path.join("java", "net.pyc"))

    os.rmdir(os.path.join("javax", "servlet"))

    os.rmdir(os.path.join("javax", "mail"))

    os.rmdir("javax")

    os.rmdir("java")

# vim: tabstop=4 expandtab shiftwidth=4