From 4710c53dcad1ebf3755f3efb9e80ac24bd72a9b2 Mon Sep 17 00:00:00 2001 From: darylm503 Date: Mon, 16 Apr 2012 22:12:42 +0000 Subject: AppPkg/Applications/Python: Add Python 2.7.2 sources since the release of Python 2.7.3 made them unavailable from the python.org web site. These files are a subset of the python-2.7.2.tgz distribution from python.org. Changed files from PyMod-2.7.2 have been copied into the corresponding directories of this tree, replacing the original files in the distribution. Signed-off-by: daryl.mcdaniel@intel.com git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@13197 6f19259b-4bc3-4df7-8a09-765794883524 --- .../Python/Python-2.7.2/Tools/faqwiz/README | 114 +++ .../Python/Python-2.7.2/Tools/faqwiz/faqconf.py | 577 ++++++++++++++ .../Python/Python-2.7.2/Tools/faqwiz/faqcust.py | 1 + .../Python/Python-2.7.2/Tools/faqwiz/faqw.py | 33 + .../Python/Python-2.7.2/Tools/faqwiz/faqwiz.py | 841 +++++++++++++++++++++ .../Python-2.7.2/Tools/faqwiz/move-faqwiz.sh | 55 ++ 6 files changed, 1621 insertions(+) create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/README create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqconf.py create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqcust.py create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqw.py create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqwiz.py create mode 100644 AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/move-faqwiz.sh (limited to 'AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz') diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/README b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/README new file mode 100644 index 0000000000..e566e79de0 --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/README @@ -0,0 +1,114 @@ +FAQ Wizard +---------- + +Author: Guido van Rossum +Version: 1.0 +Date: 6 April 1998 + + +This is a CGI program that maintains a user-editable FAQ. It uses RCS +to keep track of changes to individual FAQ entries. It is fully +configurable; everything you might want to change when using this +program to maintain some other FAQ than the Python FAQ is contained in +the configuration module, faqconf.py. + +Note that the bulk of the code is not an executable script; it's an +importable module. The actual script in cgi-bin is minimal. + +Files: + +faqw.py executable script to be edited and installed in cgi-bin +faqwiz.py main module, lives in same directory as FAQ entry files +faqconf.py main configuration module +faqcust.py additional local customization module (optional) +move-faqwiz.sh Script to move faqwiz entries. + + +What's New? +----------- + +Version 1.0 corrects some minor bugs and uses tab-agnostic +indentation; it is otherwise unchanged from version 0.9.0. + +Version 0.9.0 uses the re module (Perl style regular expressions) for +all its regular expression needs, instead of the regex and regsub +modules (Emacs style). This affects the syntax for regular +expressions entered by the user as search strings (with "regular +expression" checked), hence the version number jump. + + +Setup Information +----------------- + +This assumes you are familiar with Python, with your http server, and +with running CGI scripts under your http server. You need Python 1.5 +or better. + +Select a place where the Python modules that constitute the FAQ wizard +will live (the directory where you unpacked it is an obvious choice). +This will be called the SRCDIR. This directory should not be writable +by other users of your system (since they would be able to execute +arbitrary code by invoking the FAQ wizard's CGI script). + +Create a dedicated working directory, preferably one that's not +directly reachable from your http server. This will be called the +FAQDIR. Create a subdirectory named RCS. Make both the working +directory and the RCS subdirectory wrld-writable. (This is essential, +since the FAQ wizard runs as use nobody, and needs to create +additional files here!) + +Edit faqconf.py to reflect your setup. You only need to edit the top +part, up till the line of all dashes. The comments should guide you +in your edits. (Actually, you can also choose to add your changes to +faqcust.py and leave faqconf.py alone. This is essential if you are +maintaining multiple FAQs; see below.) + +Don't forget to edit the SECTION_TITLES variables to reflect the set +of section titles for your FAQ! + +Next, edit faqw.py to reflect the pathname of your Python interpreter +and the values for SRCDIR and FAQDIR that you just chose. Then +install faqw.py in your cgi-bin directory. Make sure that it is +world-executable. You should now be able to connect to the FAQ wizard +by entering the following URL in your web client (subsituting the +appropriate host and port for "your.web.server", and perhaps +specifying a different directory for "cgi-bin" if local conventions so +dictate): + + http://your.web.server/cgi-bin/faqw.py + +If you are unable to get this working, check your server's error_log +file. The documentation for Python's cgi module in the Python Library +Reference Manual gives plentyu additional information about installing +and debugging CGI scripts, including setup debugging. This +documentation is repeated in the doc string in the cgi module; try +``import cgi; print cgi.__doc__''. + +Assuming this works, you should now be able to add the first entry to +your FAQ using the FAQ wizard interface. This creates a file +faq01.001.htp in your working directory and an RCS revision history +file faq01.001.htp,v in the RCS subdirectory. You can now exercise +the other FAQ wizard features (search, index, whole FAQ, what's new, +roulette, and so on). + + +Maintaining Multiple FAQs +------------------------- + +If you have multiple FAQs, you need a separate FAQDIR per FAQ, and a +different customization file per FAQ. The easiest thing to do would +be to have the faqcust.py for each FAQ live in the FAQDIR for that +FAQ, but that creates some security concerns, since the FAQDIR must be +world writable: *if* someone who breaks into your system (or a +legitimate user) manages to edit the faqcust.py file they can get +arbitrary code to execute through the FAQ wizard. Therefore, you will +need a more complex setup. + +The best way is probably to have a directory that is only writable by +you for each FAQ, where you place the copy of faqcust.py for that FAQ, +and have a world-writable subdirectory DATA for the data. You then +set FAQDIR to point to the DATA directory and change the faqw.py +bootstrap script to add FAQDIR/.. to sys.path (in front of SRCDIR, so +the dummy faqcust.py from SRCDIR is ignored). + +--Guido van Rossum (home page: http://www.python.org/~guido/) diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqconf.py b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqconf.py new file mode 100644 index 0000000000..915dfb4f70 --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqconf.py @@ -0,0 +1,577 @@ +"""FAQ Wizard customization module. + +Edit this file to customize the FAQ Wizard. For normal purposes, you +should only have to change the FAQ section titles and the small group +of parameters below it. + +""" + +# Titles of FAQ sections + +SECTION_TITLES = { + # SectionNumber : SectionTitle; need at least one entry + 1: "General information and availability", +} + +# Parameters you definitely want to change + +SHORTNAME = "Generic" # FAQ name with "FAQ" omitted +PASSWORD = "" # Password for editing +OWNERNAME = "FAQ owner" # Name for feedback +OWNEREMAIL = "nobody@anywhere.org" # Email for feedback +HOMEURL = "http://www.python.org" # Related home page +HOMENAME = "Python home" # Name of related home page +RCSBINDIR = "/usr/local/bin/" # Directory containing RCS commands + # (must end in a slash) + +# Parameters you can normally leave alone + +MAXHITS = 10 # Max #hits to be shown directly +COOKIE_LIFETIME = 28*24*3600 # Cookie expiration in seconds + # (28*24*3600 = 28 days = 4 weeks) +PROCESS_PREFORMAT = 1 # toggle whether preformatted text + # will replace urls and emails with + # HTML links + +# Markers appended to title to indicate recently change +# (may contain HTML, e.g. ); and corresponding + +MARK_VERY_RECENT = " **" # Changed very recently +MARK_RECENT = " *" # Changed recently +DT_VERY_RECENT = 24*3600 # 24 hours +DT_RECENT = 7*24*3600 # 7 days + +EXPLAIN_MARKS = """ +

(Entries marked with ** were changed within the last 24 hours; +entries marked with * were changed within the last 7 days.) +

+""" + +# Version -- don't change unless you edit faqwiz.py + +WIZVERSION = "1.0.4" # FAQ Wizard version + +import os, sys +if os.name in ['nt',]: + # On NT we'll probably be running python from a batch file, + # so sys.argv[0] is not helpful + FAQCGI = 'faq.bat' # Relative URL of the FAQ cgi script + # LOGNAME is not typically set on NT + os.environ[ 'LOGNAME' ] = "FAQWizard" +else: + # This parameter is normally overwritten with a dynamic value + FAQCGI = 'faqw.py' # Relative URL of the FAQ cgi script + FAQCGI = os.path.basename(sys.argv[0]) or FAQCGI +del os, sys + +# Perl (re module) style regular expression to recognize FAQ entry +# files: group(1) should be the section number, group(2) should be the +# question number. Both should be fixed width so simple-minded +# sorting yields the right order. + +OKFILENAME = r"^faq(\d\d)\.(\d\d\d)\.htp$" + +# Format to construct a FAQ entry file name + +NEWFILENAME = "faq%02d.%03d.htp" + +# Load local customizations on top of the previous parameters + +try: + from faqcust import * +except ImportError: + pass + +# Calculated parameter names + +COOKIE_NAME = SHORTNAME + "-FAQ-Wizard" # Name used for Netscape cookie +FAQNAME = SHORTNAME + " FAQ" # Name of the FAQ + +# ---------------------------------------------------------------------- + +# Anything below this point normally needn't be changed; you would +# change this if you were to create e.g. a French translation or if +# you just aren't happy with the text generated by the FAQ Wizard. + +# Most strings here are subject to substitution (string%dictionary) + +# RCS commands + +import os +if os.name in ['nt', ]: + SH_RLOG = RCSBINDIR + "rlog %(file)s < NUL" + SH_RLOG_H = RCSBINDIR + "rlog -h %(file)s < NUL" + SH_RDIFF = RCSBINDIR + "rcsdiff -r%(prev)s -r%(rev)s %(file)s < NUL" + SH_REVISION = RCSBINDIR + "co -p%(rev)s %(file)s < NUL" + ### Have to use co -l, or the file is not marked rw on NT + SH_LOCK = RCSBINDIR + "co -l %(file)s < NUL" + SH_CHECKIN = RCSBINDIR + "ci -u %(file)s < %(tfn)s" +else: + SH_RLOG = RCSBINDIR + "rlog %(file)s &1" + SH_RLOG_H = RCSBINDIR + "rlog -h %(file)s &1" + SH_RDIFF = RCSBINDIR + "rcsdiff -r%(prev)s -r%(rev)s %(file)s &1" + SH_REVISION = RCSBINDIR + "co -p%(rev)s %(file)s &1" + SH_LOCK = RCSBINDIR + "rcs -l %(file)s &1" + SH_CHECKIN = RCSBINDIR + "ci -u %(file)s <%(tfn)s 2>&1" +del os + +# Titles for various output pages (not subject to substitution) + +T_HOME = FAQNAME + " Wizard " + WIZVERSION +T_ERROR = "Sorry, an error occurred" +T_ROULETTE = FAQNAME + " Roulette" +T_ALL = "The Whole " + FAQNAME +T_INDEX = FAQNAME + " Index" +T_SEARCH = FAQNAME + " Search Results" +T_RECENT = "What's New in the " + FAQNAME +T_SHOW = FAQNAME + " Entry" +T_LOG = "RCS log for %s entry" % FAQNAME +T_REVISION = "RCS revision for %s entry" % FAQNAME +T_DIFF = "RCS diff for %s entry" % FAQNAME +T_ADD = "Add an entry to the " + FAQNAME +T_DELETE = "Deleting an entry from the " + FAQNAME +T_EDIT = FAQNAME + " Edit Wizard" +T_REVIEW = T_EDIT + " - Review Changes" +T_COMMITTED = T_EDIT + " - Changes Committed" +T_COMMITFAILED = T_EDIT + " - Commit Failed" +T_CANTCOMMIT = T_EDIT + " - Commit Rejected" +T_HELP = T_EDIT + " - Help" + +# Generic prologue and epilogue + +PROLOGUE = ''' + + +%(title)s + + + +

%(title)s

+''' + +EPILOGUE = ''' +
+%(HOMENAME)s / +%(FAQNAME)s Wizard %(WIZVERSION)s / +Feedback to %(OWNERNAME)s + + + +''' + +# Home page + +HOME = """ +

Search the %(FAQNAME)s:

+ +
+ +
+ +
+ + Simple string + / + + Regular expression + /
+ + Keywords (any) + / + + Keywords (all) +
+ + Fold case + / + + Case sensitive +
+ +
+ +
+ +
+ +

Other forms of %(FAQNAME)s access:

+ + +""" + +# Index formatting + +INDEX_SECTION = """ +

+

+

%(sec)s. %(title)s

+ +""" + +INDEX_ENTRY = """\ +
  • %(title)s +""" + +LOCAL_ENTRY = """\ +
  • %(title)s +""" + +# Entry formatting + +ENTRY_HEADER1 = """ +
    +

    %(title)s\ +""" + +ENTRY_HEADER2 = """\ +

    +""" + +ENTRY_FOOTER = """ +Edit this entry / +Log info +""" + +ENTRY_LOGINFO = """ +/ Last changed on %(last_changed_date)s by +%(last_changed_author)s +""" + +# Search + +NO_HITS = """ +No hits. +""" + +ONE_HIT = """ +Your search matched the following entry: +""" + +FEW_HITS = """ +Your search matched the following %(count)s entries: +""" + +MANY_HITS = """ +Your search matched more than %(MAXHITS)s entries. +The %(count)s matching entries are presented here ordered by section: +""" + +# RCS log and diff + +LOG = """ +Click on a revision line to see the diff between that revision and the +previous one. +""" + +REVISIONLINK = """\ +%(line)s\ +""" +DIFFLINK = """\ + (diff -r%(prev)s -r%(rev)s)\ +""" + +# Recently changed entries + +NO_RECENT = """ +
    +No %(FAQNAME)s entries were changed in the last %(period)s. +""" + +VIEW_MENU = """ +
    +View entries changed in the last... + +""" + +ONE_RECENT = VIEW_MENU + """ +The following %(FAQNAME)s entry was changed in the last %(period)s: +""" + +SOME_RECENT = VIEW_MENU + """ +The following %(count)s %(FAQNAME)s entries were changed +in the last %(period)s, most recently changed shown first: +""" + +TAIL_RECENT = VIEW_MENU + +# Last changed banner on "all" (strftime format) +LAST_CHANGED = "Last changed on %c %Z" + +# "Compat" command prologue (this has no tag) +COMPAT = """ +

    The whole %(FAQNAME)s

    +See also the %(FAQNAME)s Wizard. +

    +""" + +# Editing + +EDITHEAD = """ +Click for Help +""" + +REVIEWHEAD = EDITHEAD + + +EDITFORM1 = """ +

    + + + +
    +""" + +EDITFORM2 = """ +Title:
    +
    +Log message (reason for the change):
    +
    +Please provide the following information for logging purposes: + + + + +
    Name: + +
    Email: + +
    Password: + +
    + + +Click this button to preview your changes. +""" + +EDITFORM3 = """ +
    +""" + +COMMIT = """ + +Click this button to commit your changes. +
    +""" + +NOCOMMIT_HEAD = """ +To commit your changes, please correct the following errors in the +form below and click the Preview Edit button. +
      +""" +NOCOMMIT_TAIL = """ +
    +
    +""" + +CANTCOMMIT_HEAD = """ +Some required information is missing: +
      +""" +NEED_PASSWD = "
    • You must provide the correct password.\n" +NEED_AUTHOR = "
    • You must enter your name.\n" +NEED_EMAIL = "
    • You must enter your email address.\n" +NEED_LOG = "
    • You must enter a log message.\n" +CANTCOMMIT_TAIL = """ +
    +Please use your browser's Back command to correct the form and commit +again. +""" + +NEWCONFLICT = """ +

    +You are creating a new entry, but the entry number specified is not +correct. +

    +The two most common causes of this problem are: +

      +
    • After creating the entry yourself, you went back in your browser, + edited the entry some more, and clicked Commit again. +
    • Someone else started creating a new entry in the same section and + committed before you did. +
    +(It is also possible that the last entry in the section was physically +deleted, but this should not happen except through manual intervention +by the FAQ maintainer.) +

    +Click here to try +again. +

    +""" + +VERSIONCONFLICT = """ +

    +You edited version %(editversion)s but the current version is %(version)s. +

    +The two most common causes of this problem are: +

      +
    • After committing a change, you went back in your browser, + edited the entry some more, and clicked Commit again. +
    • Someone else started editing the same entry and committed + before you did. +
    +

    +Click here to reload +the entry and try again. +

    +""" + +CANTWRITE = """ +Can't write file %(file)s (%(why)s). +""" + +FILEHEADER = """\ +Title: %(title)s +Last-Changed-Date: %(date)s +Last-Changed-Author: %(author)s +Last-Changed-Email: %(email)s +Last-Changed-Remote-Host: %(REMOTE_HOST)s +Last-Changed-Remote-Address: %(REMOTE_ADDR)s +""" + +LOGHEADER = """\ +Last-Changed-Date: %(date)s +Last-Changed-Author: %(author)s +Last-Changed-Email: %(email)s +Last-Changed-Remote-Host: %(REMOTE_HOST)s +Last-Changed-Remote-Address: %(REMOTE_ADDR)s + +%(log)s +""" + +COMMITTED = """ +Your changes have been committed. +""" + +COMMITFAILED = """ +Exit status %(sts)s. +""" + +# Add/Delete + +ADD_HEAD = """ +At the moment, new entries can only be added at the end of a section. +This is because the entry numbers are also their +unique identifiers -- it's a bad idea to renumber entries. +

    +Click on the section to which you want to add a new entry: +

    +""" + +ROULETTE = """ +

    Hit your browser's Reload button to play again.

    +""" + +DELETE = """ +At the moment, there's no direct way to delete entries. +This is because the entry numbers are also their +unique identifiers -- it's a bad idea to renumber entries. +

    +If you really think an entry needs to be deleted, +change the title to "(deleted)" and make the body +empty (keep the entry number in the title though). +""" + +# Help file for the FAQ Edit Wizard + +HELP = """ +Using the %(FAQNAME)s Edit Wizard speaks mostly for itself. Here are +some answers to questions you are likely to ask: + +

    + +

    I can review an entry but I can't commit it.

    + +The commit button only appears if the following conditions are met: + +
      + +
    • The Name field is not empty. + +
    • The Email field contains at least an @ character. + +
    • The Log message box is not empty. + +
    • The Password field contains the proper password. + +
    + +

    + +

    What is the password?

    + +At the moment, only PSA members will be told the password. This is a +good time to join the PSA! See the PSA home page. + +

    + +

    Can I use HTML in the FAQ entry?

    + +Yes, if you include it in <HTML&rt; and </HTML> tags. +

    +Also, if you include a URL or an email address in the text it will +automatigally become an anchor of the right type. Also, *word* +is made italic (but only for single alphabetic words). + +

    + +

    How do I delineate paragraphs?

    + +Use blank lines to separate paragraphs. + +

    + +

    How do I enter example text?

    + +Any line that begins with a space or tab is assumed to be part of +literal text. Blocks of literal text delineated by blank lines are +placed inside <PRE>...</PRE>. +""" + +# Load local customizations again, in case they set some other variables + +try: + from faqcust import * +except ImportError: + pass diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqcust.py b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqcust.py new file mode 100644 index 0000000000..66c29dd0dd --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqcust.py @@ -0,0 +1 @@ +# Add your customizations here -- modified copies of what's in faqconf.py. diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqw.py b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqw.py new file mode 100644 index 0000000000..b9bb3d0cae --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqw.py @@ -0,0 +1,33 @@ +#!/usr/bin/env python + +"""FAQ wizard bootstrap.""" + +# This is a longer version of the bootstrap script given at the end of +# faqwin.py; it prints timing statistics at the end of the regular CGI +# script's output (so you can monitor how it is doing). + +# This script should be placed in your cgi-bin directory and made +# executable. + +# You need to edit the first line and the lines that define FAQDIR and +# SRCDIR, below: change /usr/local/bin/python to where your Python +# interpreter lives, change the value for FAQDIR to where your FAQ +# lives, and change the value for SRCDIR to where your faqwiz.py +# module lives. The faqconf.py and faqcust.py files live there, too. + +import os +t1 = os.times() # If this doesn't work, just get rid of the timing code! +try: + FAQDIR = "/usr/people/guido/python/FAQ" + SRCDIR = "/usr/people/guido/python/src/Tools/faqwiz" + import os, sys + os.chdir(FAQDIR) + sys.path.insert(0, SRCDIR) + import faqwiz +except SystemExit, n: + sys.exit(n) +except: + t, v, tb = sys.exc_info() + print + import cgi + cgi.print_exception(t, v, tb) diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqwiz.py b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqwiz.py new file mode 100644 index 0000000000..babb426582 --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/faqwiz.py @@ -0,0 +1,841 @@ +"""Generic FAQ Wizard. + +This is a CGI program that maintains a user-editable FAQ. It uses RCS +to keep track of changes to individual FAQ entries. It is fully +configurable; everything you might want to change when using this +program to maintain some other FAQ than the Python FAQ is contained in +the configuration module, faqconf.py. + +Note that this is not an executable script; it's an importable module. +The actual script to place in cgi-bin is faqw.py. + +""" + +import sys, time, os, stat, re, cgi, faqconf +from faqconf import * # This imports all uppercase names +now = time.time() + +class FileError: + def __init__(self, file): + self.file = file + +class InvalidFile(FileError): + pass + +class NoSuchSection(FileError): + def __init__(self, section): + FileError.__init__(self, NEWFILENAME %(section, 1)) + self.section = section + +class NoSuchFile(FileError): + def __init__(self, file, why=None): + FileError.__init__(self, file) + self.why = why + +def escape(s): + s = s.replace('&', '&') + s = s.replace('<', '<') + s = s.replace('>', '>') + return s + +def escapeq(s): + s = escape(s) + s = s.replace('"', '"') + return s + +def _interpolate(format, args, kw): + try: + quote = kw['_quote'] + except KeyError: + quote = 1 + d = (kw,) + args + (faqconf.__dict__,) + m = MagicDict(d, quote) + return format % m + +def interpolate(format, *args, **kw): + return _interpolate(format, args, kw) + +def emit(format, *args, **kw): + try: + f = kw['_file'] + except KeyError: + f = sys.stdout + f.write(_interpolate(format, args, kw)) + +translate_prog = None + +def translate(text, pre=0): + global translate_prog + if not translate_prog: + translate_prog = prog = re.compile( + r'\b(http|ftp|https)://\S+(\b|/)|\b[-.\w]+@[-.\w]+') + else: + prog = translate_prog + i = 0 + list = [] + while 1: + m = prog.search(text, i) + if not m: + break + j = m.start() + list.append(escape(text[i:j])) + i = j + url = m.group(0) + while url[-1] in '();:,.?\'"<>': + url = url[:-1] + i = i + len(url) + url = escape(url) + if not pre or (pre and PROCESS_PREFORMAT): + if ':' in url: + repl = '%s' % (url, url) + else: + repl = '%s' % (url, url) + else: + repl = url + list.append(repl) + j = len(text) + list.append(escape(text[i:j])) + return ''.join(list) + +def emphasize(line): + return re.sub(r'\*([a-zA-Z]+)\*', r'\1', line) + +revparse_prog = None + +def revparse(rev): + global revparse_prog + if not revparse_prog: + revparse_prog = re.compile(r'^(\d{1,3})\.(\d{1,4})$') + m = revparse_prog.match(rev) + if not m: + return None + [major, minor] = map(int, m.group(1, 2)) + return major, minor + +logon = 0 +def log(text): + if logon: + logfile = open("logfile", "a") + logfile.write(text + "\n") + logfile.close() + +def load_cookies(): + if not os.environ.has_key('HTTP_COOKIE'): + return {} + raw = os.environ['HTTP_COOKIE'] + words = [s.strip() for s in raw.split(';')] + cookies = {} + for word in words: + i = word.find('=') + if i >= 0: + key, value = word[:i], word[i+1:] + cookies[key] = value + return cookies + +def load_my_cookie(): + cookies = load_cookies() + try: + value = cookies[COOKIE_NAME] + except KeyError: + return {} + import urllib + value = urllib.unquote(value) + words = value.split('/') + while len(words) < 3: + words.append('') + author = '/'.join(words[:-2]) + email = words[-2] + password = words[-1] + return {'author': author, + 'email': email, + 'password': password} + +def send_my_cookie(ui): + name = COOKIE_NAME + value = "%s/%s/%s" % (ui.author, ui.email, ui.password) + import urllib + value = urllib.quote(value) + then = now + COOKIE_LIFETIME + gmt = time.gmtime(then) + path = os.environ.get('SCRIPT_NAME', '/cgi-bin/') + print "Set-Cookie: %s=%s; path=%s;" % (name, value, path), + print time.strftime("expires=%a, %d-%b-%y %X GMT", gmt) + +class MagicDict: + + def __init__(self, d, quote): + self.__d = d + self.__quote = quote + + def __getitem__(self, key): + for d in self.__d: + try: + value = d[key] + if value: + value = str(value) + if self.__quote: + value = escapeq(value) + return value + except KeyError: + pass + return '' + +class UserInput: + + def __init__(self): + self.__form = cgi.FieldStorage() + #log("\n\nbody: " + self.body) + + def __getattr__(self, name): + if name[0] == '_': + raise AttributeError + try: + value = self.__form[name].value + except (TypeError, KeyError): + value = '' + else: + value = value.strip() + setattr(self, name, value) + return value + + def __getitem__(self, key): + return getattr(self, key) + +class FaqEntry: + + def __init__(self, fp, file, sec_num): + self.file = file + self.sec, self.num = sec_num + if fp: + import rfc822 + self.__headers = rfc822.Message(fp) + self.body = fp.read().strip() + else: + self.__headers = {'title': "%d.%d. " % sec_num} + self.body = '' + + def __getattr__(self, name): + if name[0] == '_': + raise AttributeError + key = '-'.join(name.split('_')) + try: + value = self.__headers[key] + except KeyError: + value = '' + setattr(self, name, value) + return value + + def __getitem__(self, key): + return getattr(self, key) + + def load_version(self): + command = interpolate(SH_RLOG_H, self) + p = os.popen(command) + version = '' + while 1: + line = p.readline() + if not line: + break + if line[:5] == 'head:': + version = line[5:].strip() + p.close() + self.version = version + + def getmtime(self): + if not self.last_changed_date: + return 0 + try: + return os.stat(self.file)[stat.ST_MTIME] + except os.error: + return 0 + + def emit_marks(self): + mtime = self.getmtime() + if mtime >= now - DT_VERY_RECENT: + emit(MARK_VERY_RECENT, self) + elif mtime >= now - DT_RECENT: + emit(MARK_RECENT, self) + + def show(self, edit=1): + emit(ENTRY_HEADER1, self) + self.emit_marks() + emit(ENTRY_HEADER2, self) + pre = 0 + raw = 0 + for line in self.body.split('\n'): + # Allow the user to insert raw html into a FAQ answer + # (Skip Montanaro, with changes by Guido) + tag = line.rstrip().lower() + if tag == '': + raw = 1 + continue + if tag == '': + raw = 0 + continue + if raw: + print line + continue + if not line.strip(): + if pre: + print '' + pre = 0 + else: + print '

    ' + else: + if not line[0].isspace(): + if pre: + print '' + pre = 0 + else: + if not pre: + print '

    '
+                        pre = 1
+                if '/' in line or '@' in line:
+                    line = translate(line, pre)
+                elif '<' in line or '&' in line:
+                    line = escape(line)
+                if not pre and '*' in line:
+                    line = emphasize(line)
+                print line
+        if pre:
+            print '
    ' + pre = 0 + if edit: + print '

    ' + emit(ENTRY_FOOTER, self) + if self.last_changed_date: + emit(ENTRY_LOGINFO, self) + print '

    ' + +class FaqDir: + + entryclass = FaqEntry + + __okprog = re.compile(OKFILENAME) + + def __init__(self, dir=os.curdir): + self.__dir = dir + self.__files = None + + def __fill(self): + if self.__files is not None: + return + self.__files = files = [] + okprog = self.__okprog + for file in os.listdir(self.__dir): + if self.__okprog.match(file): + files.append(file) + files.sort() + + def good(self, file): + return self.__okprog.match(file) + + def parse(self, file): + m = self.good(file) + if not m: + return None + sec, num = m.group(1, 2) + return int(sec), int(num) + + def list(self): + # XXX Caller shouldn't modify result + self.__fill() + return self.__files + + def open(self, file): + sec_num = self.parse(file) + if not sec_num: + raise InvalidFile(file) + try: + fp = open(file) + except IOError, msg: + raise NoSuchFile(file, msg) + try: + return self.entryclass(fp, file, sec_num) + finally: + fp.close() + + def show(self, file, edit=1): + self.open(file).show(edit=edit) + + def new(self, section): + if not SECTION_TITLES.has_key(section): + raise NoSuchSection(section) + maxnum = 0 + for file in self.list(): + sec, num = self.parse(file) + if sec == section: + maxnum = max(maxnum, num) + sec_num = (section, maxnum+1) + file = NEWFILENAME % sec_num + return self.entryclass(None, file, sec_num) + +class FaqWizard: + + def __init__(self): + self.ui = UserInput() + self.dir = FaqDir() + + def go(self): + print 'Content-type: text/html' + req = self.ui.req or 'home' + mname = 'do_%s' % req + try: + meth = getattr(self, mname) + except AttributeError: + self.error("Bad request type %r." % (req,)) + else: + try: + meth() + except InvalidFile, exc: + self.error("Invalid entry file name %s" % exc.file) + except NoSuchFile, exc: + self.error("No entry with file name %s" % exc.file) + except NoSuchSection, exc: + self.error("No section number %s" % exc.section) + self.epilogue() + + def error(self, message, **kw): + self.prologue(T_ERROR) + emit(message, kw) + + def prologue(self, title, entry=None, **kw): + emit(PROLOGUE, entry, kwdict=kw, title=escape(title)) + + def epilogue(self): + emit(EPILOGUE) + + def do_home(self): + self.prologue(T_HOME) + emit(HOME) + + def do_debug(self): + self.prologue("FAQ Wizard Debugging") + form = cgi.FieldStorage() + cgi.print_form(form) + cgi.print_environ(os.environ) + cgi.print_directory() + cgi.print_arguments() + + def do_search(self): + query = self.ui.query + if not query: + self.error("Empty query string!") + return + if self.ui.querytype == 'simple': + query = re.escape(query) + queries = [query] + elif self.ui.querytype in ('anykeywords', 'allkeywords'): + words = filter(None, re.split('\W+', query)) + if not words: + self.error("No keywords specified!") + return + words = map(lambda w: r'\b%s\b' % w, words) + if self.ui.querytype[:3] == 'any': + queries = ['|'.join(words)] + else: + # Each of the individual queries must match + queries = words + else: + # Default to regular expression + queries = [query] + self.prologue(T_SEARCH) + progs = [] + for query in queries: + if self.ui.casefold == 'no': + p = re.compile(query) + else: + p = re.compile(query, re.IGNORECASE) + progs.append(p) + hits = [] + for file in self.dir.list(): + try: + entry = self.dir.open(file) + except FileError: + constants + for p in progs: + if not p.search(entry.title) and not p.search(entry.body): + break + else: + hits.append(file) + if not hits: + emit(NO_HITS, self.ui, count=0) + elif len(hits) <= MAXHITS: + if len(hits) == 1: + emit(ONE_HIT, count=1) + else: + emit(FEW_HITS, count=len(hits)) + self.format_all(hits, headers=0) + else: + emit(MANY_HITS, count=len(hits)) + self.format_index(hits) + + def do_all(self): + self.prologue(T_ALL) + files = self.dir.list() + self.last_changed(files) + self.format_index(files, localrefs=1) + self.format_all(files) + + def do_compat(self): + files = self.dir.list() + emit(COMPAT) + self.last_changed(files) + self.format_index(files, localrefs=1) + self.format_all(files, edit=0) + sys.exit(0) # XXX Hack to suppress epilogue + + def last_changed(self, files): + latest = 0 + for file in files: + entry = self.dir.open(file) + if entry: + mtime = mtime = entry.getmtime() + if mtime > latest: + latest = mtime + print time.strftime(LAST_CHANGED, time.localtime(latest)) + emit(EXPLAIN_MARKS) + + def format_all(self, files, edit=1, headers=1): + sec = 0 + for file in files: + try: + entry = self.dir.open(file) + except NoSuchFile: + continue + if headers and entry.sec != sec: + sec = entry.sec + try: + title = SECTION_TITLES[sec] + except KeyError: + title = "Untitled" + emit("\n

    \n

    %(sec)s. %(title)s

    \n", + sec=sec, title=title) + entry.show(edit=edit) + + def do_index(self): + self.prologue(T_INDEX) + files = self.dir.list() + self.last_changed(files) + self.format_index(files, add=1) + + def format_index(self, files, add=0, localrefs=0): + sec = 0 + for file in files: + try: + entry = self.dir.open(file) + except NoSuchFile: + continue + if entry.sec != sec: + if sec: + if add: + emit(INDEX_ADDSECTION, sec=sec) + emit(INDEX_ENDSECTION, sec=sec) + sec = entry.sec + try: + title = SECTION_TITLES[sec] + except KeyError: + title = "Untitled" + emit(INDEX_SECTION, sec=sec, title=title) + if localrefs: + emit(LOCAL_ENTRY, entry) + else: + emit(INDEX_ENTRY, entry) + entry.emit_marks() + if sec: + if add: + emit(INDEX_ADDSECTION, sec=sec) + emit(INDEX_ENDSECTION, sec=sec) + + def do_recent(self): + if not self.ui.days: + days = 1 + else: + days = float(self.ui.days) + try: + cutoff = now - days * 24 * 3600 + except OverflowError: + cutoff = 0 + list = [] + for file in self.dir.list(): + entry = self.dir.open(file) + if not entry: + continue + mtime = entry.getmtime() + if mtime >= cutoff: + list.append((mtime, file)) + list.sort() + list.reverse() + self.prologue(T_RECENT) + if days <= 1: + period = "%.2g hours" % (days*24) + else: + period = "%.6g days" % days + if not list: + emit(NO_RECENT, period=period) + elif len(list) == 1: + emit(ONE_RECENT, period=period) + else: + emit(SOME_RECENT, period=period, count=len(list)) + self.format_all(map(lambda (mtime, file): file, list), headers=0) + emit(TAIL_RECENT) + + def do_roulette(self): + import random + files = self.dir.list() + if not files: + self.error("No entries.") + return + file = random.choice(files) + self.prologue(T_ROULETTE) + emit(ROULETTE) + self.dir.show(file) + + def do_help(self): + self.prologue(T_HELP) + emit(HELP) + + def do_show(self): + entry = self.dir.open(self.ui.file) + self.prologue(T_SHOW) + entry.show() + + def do_add(self): + self.prologue(T_ADD) + emit(ADD_HEAD) + sections = SECTION_TITLES.items() + sections.sort() + for section, title in sections: + emit(ADD_SECTION, section=section, title=title) + emit(ADD_TAIL) + + def do_delete(self): + self.prologue(T_DELETE) + emit(DELETE) + + def do_log(self): + entry = self.dir.open(self.ui.file) + self.prologue(T_LOG, entry) + emit(LOG, entry) + self.rlog(interpolate(SH_RLOG, entry), entry) + + def rlog(self, command, entry=None): + output = os.popen(command).read() + sys.stdout.write('
    ')
+        athead = 0
+        lines = output.split('\n')
+        while lines and not lines[-1]:
+            del lines[-1]
+        if lines:
+            line = lines[-1]
+            if line[:1] == '=' and len(line) >= 40 and \
+               line == line[0]*len(line):
+                del lines[-1]
+        headrev = None
+        for line in lines:
+            if entry and athead and line[:9] == 'revision ':
+                rev = line[9:].split()
+                mami = revparse(rev)
+                if not mami:
+                    print line
+                else:
+                    emit(REVISIONLINK, entry, rev=rev, line=line)
+                    if mami[1] > 1:
+                        prev = "%d.%d" % (mami[0], mami[1]-1)
+                        emit(DIFFLINK, entry, prev=prev, rev=rev)
+                    if headrev:
+                        emit(DIFFLINK, entry, prev=rev, rev=headrev)
+                    else:
+                        headrev = rev
+                    print
+                athead = 0
+            else:
+                athead = 0
+                if line[:1] == '-' and len(line) >= 20 and \
+                   line == len(line) * line[0]:
+                    athead = 1
+                    sys.stdout.write('
    ')
+                else:
+                    print line
+        print '
    ' + + def do_revision(self): + entry = self.dir.open(self.ui.file) + rev = self.ui.rev + mami = revparse(rev) + if not mami: + self.error("Invalid revision number: %r." % (rev,)) + self.prologue(T_REVISION, entry) + self.shell(interpolate(SH_REVISION, entry, rev=rev)) + + def do_diff(self): + entry = self.dir.open(self.ui.file) + prev = self.ui.prev + rev = self.ui.rev + mami = revparse(rev) + if not mami: + self.error("Invalid revision number: %r." % (rev,)) + if prev: + if not revparse(prev): + self.error("Invalid previous revision number: %r." % (prev,)) + else: + prev = '%d.%d' % (mami[0], mami[1]) + self.prologue(T_DIFF, entry) + self.shell(interpolate(SH_RDIFF, entry, rev=rev, prev=prev)) + + def shell(self, command): + output = os.popen(command).read() + sys.stdout.write('
    ')
+        print escape(output)
+        print '
    ' + + def do_new(self): + entry = self.dir.new(section=int(self.ui.section)) + entry.version = '*new*' + self.prologue(T_EDIT) + emit(EDITHEAD) + emit(EDITFORM1, entry, editversion=entry.version) + emit(EDITFORM2, entry, load_my_cookie()) + emit(EDITFORM3) + entry.show(edit=0) + + def do_edit(self): + entry = self.dir.open(self.ui.file) + entry.load_version() + self.prologue(T_EDIT) + emit(EDITHEAD) + emit(EDITFORM1, entry, editversion=entry.version) + emit(EDITFORM2, entry, load_my_cookie()) + emit(EDITFORM3) + entry.show(edit=0) + + def do_review(self): + send_my_cookie(self.ui) + if self.ui.editversion == '*new*': + sec, num = self.dir.parse(self.ui.file) + entry = self.dir.new(section=sec) + entry.version = "*new*" + if entry.file != self.ui.file: + self.error("Commit version conflict!") + emit(NEWCONFLICT, self.ui, sec=sec, num=num) + return + else: + entry = self.dir.open(self.ui.file) + entry.load_version() + # Check that the FAQ entry number didn't change + if self.ui.title.split()[:1] != entry.title.split()[:1]: + self.error("Don't change the entry number please!") + return + # Check that the edited version is the current version + if entry.version != self.ui.editversion: + self.error("Commit version conflict!") + emit(VERSIONCONFLICT, entry, self.ui) + return + commit_ok = ((not PASSWORD + or self.ui.password == PASSWORD) + and self.ui.author + and '@' in self.ui.email + and self.ui.log) + if self.ui.commit: + if not commit_ok: + self.cantcommit() + else: + self.commit(entry) + return + self.prologue(T_REVIEW) + emit(REVIEWHEAD) + entry.body = self.ui.body + entry.title = self.ui.title + entry.show(edit=0) + emit(EDITFORM1, self.ui, entry) + if commit_ok: + emit(COMMIT) + else: + emit(NOCOMMIT_HEAD) + self.errordetail() + emit(NOCOMMIT_TAIL) + emit(EDITFORM2, self.ui, entry, load_my_cookie()) + emit(EDITFORM3) + + def cantcommit(self): + self.prologue(T_CANTCOMMIT) + print CANTCOMMIT_HEAD + self.errordetail() + print CANTCOMMIT_TAIL + + def errordetail(self): + if PASSWORD and self.ui.password != PASSWORD: + emit(NEED_PASSWD) + if not self.ui.log: + emit(NEED_LOG) + if not self.ui.author: + emit(NEED_AUTHOR) + if not self.ui.email: + emit(NEED_EMAIL) + + def commit(self, entry): + file = entry.file + # Normalize line endings in body + if '\r' in self.ui.body: + self.ui.body = re.sub('\r\n?', '\n', self.ui.body) + # Normalize whitespace in title + self.ui.title = ' '.join(self.ui.title.split()) + # Check that there were any changes + if self.ui.body == entry.body and self.ui.title == entry.title: + self.error("You didn't make any changes!") + return + + # need to lock here because otherwise the file exists and is not writable (on NT) + command = interpolate(SH_LOCK, file=file) + p = os.popen(command) + output = p.read() + + try: + os.unlink(file) + except os.error: + pass + try: + f = open(file, 'w') + except IOError, why: + self.error(CANTWRITE, file=file, why=why) + return + date = time.ctime(now) + emit(FILEHEADER, self.ui, os.environ, date=date, _file=f, _quote=0) + f.write('\n') + f.write(self.ui.body) + f.write('\n') + f.close() + + import tempfile + tf = tempfile.NamedTemporaryFile() + emit(LOGHEADER, self.ui, os.environ, date=date, _file=tf) + tf.flush() + tf.seek(0) + + command = interpolate(SH_CHECKIN, file=file, tfn=tf.name) + log("\n\n" + command) + p = os.popen(command) + output = p.read() + sts = p.close() + log("output: " + output) + log("done: " + str(sts)) + log("TempFile:\n" + tf.read() + "end") + + if not sts: + self.prologue(T_COMMITTED) + emit(COMMITTED) + else: + self.error(T_COMMITFAILED) + emit(COMMITFAILED, sts=sts) + print '
    %s
    ' % escape(output) + + try: + os.unlink(tf.name) + except os.error: + pass + + entry = self.dir.open(file) + entry.show() + +wiz = FaqWizard() +wiz.go() diff --git a/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/move-faqwiz.sh b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/move-faqwiz.sh new file mode 100644 index 0000000000..7d206c0219 --- /dev/null +++ b/AppPkg/Applications/Python/Python-2.7.2/Tools/faqwiz/move-faqwiz.sh @@ -0,0 +1,55 @@ +#!/bin/sh +# +# Christian Reis +# +# Moves +# +# Example: +# +# blackjesus:~> ./move-faqwiz.sh 2\.1 3\.2 +# Moving FAQ question 02.001 to 03.002 + +if [ x$2 = x ]; then + echo "Need 2 args: original_version final_version." + exit 2 +fi + +if [ ! -d data -o ! -d data/RCS ]; then + echo "Run this inside the faqwiz data/ directory's parent dir." + exit 2 +fi + +cut_n_pad() { + t=`echo $1 | cut -d. -f $2` + export $3=`echo $t | awk "{ tmp = \\$0; l = length(tmp); for (i = 0; i < $2-l+1; i++) { tmp = "0".tmp } print tmp }"` +} + +cut_n_pad $1 1 prefix1 +cut_n_pad $1 2 suffix1 +cut_n_pad $2 1 prefix2 +cut_n_pad $2 2 suffix2 +if which tempfile >/dev/null; then + tmpfile=$(tempfile -d .) +elif [ -n "$RANDOM" ]; then + tmpfile=tmp$RANDOM.tmp +else + tmpfile=tmp$$.tmp +fi +file1=faq$prefix1.$suffix1.htp +file2=faq$prefix2.$suffix2.htp + +echo "Moving FAQ question $prefix1.$suffix1 to $prefix2.$suffix2" + +sed -e "s/$1\./$2\./g" data/$file1 > ${tmpfile}1 +sed -e "s/$1\./$2\./g" data/RCS/$file1,v > ${tmpfile}2 + +if [ -f data/$file2 ]; then + echo "Target FAQ exists. Won't clobber." + exit 2 +fi + +mv ${tmpfile}1 data/$file2 +mv ${tmpfile}2 data/RCS/$file2,v +mv data/$file1 data/$file1.orig +mv data/RCS/$file1,v data/RCS/$file1,v.orig + -- cgit v1.2.3