#!/usr/bin/env python """ convert PEP's to (X)HTML - courtesy of /F Syntax: pep2html [-n] [sf_username] The user name 'sf_username' is used to upload the converted files to the web pages at source forge. If -n is given, the script doesn't actually try to install the generated HTML at SourceForge. """ import cgi, glob, os, re, sys # this doesn't validate -- you cannot use
and

inside
# tags.  but if I change that, the result doesn't look very nice...

HOST = "shell.sourceforge.net" # host for update
HDIR = "/home/groups/python/htdocs/peps" # target host directory

DTD = ('')

fixpat = re.compile("((http|ftp):[-_a-zA-Z0-9/.+~:?#$=&]+)|(pep-\d+(.txt)?)|.")

def fixanchor(current, match):
    text = match.group(0)
    link = None
    if text[:5] == "http:" or text[:4] == "ftp:":
        link = text
    elif text[:4] == "pep-" and text != current:
        link = os.path.splitext(text)[0] + ".html"
    if link:
        return "%s" % (link, cgi.escape(text))
    return cgi.escape(match.group(0)) # really slow, but it works...

def fixfile(infile, outfile):
    # convert plain text pep to minimal XHTML markup
    fi = open(infile)
    fo = open(outfile, "w")
    fo.write(DTD + "\n\n\n")
    # head
    header = []
    pep = ""
    title = ""
    while 1:
        line = fi.readline()
        if not line.strip():
            break
        if line[0].strip():
            if ":" not in line:
                break
            key, value = line.split(":", 1)
            value = value.strip()
            header.append((key, value))
        else:
            # continuation line
            key, value = header[-1]
            value = value + line
            header[-1] = key, value
        if key.lower() == "title":
            title = value
        elif key.lower() == "pep":
            pep = value
    if pep:
        title = "PEP " + pep + " -- " + title
    if title:
        fo.write("  %s\n"
                 '  \n'
                 % cgi.escape(title))
    fo.write("\n")
    # body
    fo.write('\n'
             '\n'
             '
\n\n') for k, v in header: fo.write(" \n" % (cgi.escape(k), cgi.escape(v))) title = 0 fo.write("
%s:%s
\n
\n
\n" "
")
    while 1:
        line = fi.readline()
        if not line:
            break
        if line[0] != "\f":
            if line[0].strip():
                if line.strip() == "Local Variables:":
                    break
                fo.write("
\n

%s

\n
" % line.strip())
                title = 0
            else:
                line = fixpat.sub(lambda x, c=infile: fixanchor(c, x), line)
                fo.write(line)
    fo.write("
\n" "\n" "\n") fo.close() os.chmod(outfile, 0664) def main(): update = 1 for file in glob.glob("pep-*.txt"): print file, "..." fixfile(file, os.path.splitext(file)[0] + ".html") if len(sys.argv) > 1 and sys.argv[1] == "-n": update = 0 del sys.argv[1] if len(sys.argv) == 1: username = "" elif len(sys.argv) == 2: username = sys.argv[1]+"@" else: raise "Syntax: "+sys.argv[0]+" [-n] [sf_username]" if update: os.system("scp pep-*.html style.css " + username + HOST + ":" + HDIR) os.system("ssh " + username + HOST + " chmod 664 " + HDIR + "/*") if __name__ == "__main__": main()