EmbeddedPkg: Extend NvVarStoreFormattedLib LIBRARY_CLASS

[mirror_edk2.git] / AppPkg / Applications / Python / Python-2.7.2 / Tools / scripts / logmerge.py

#! /usr/bin/env python\r
\r
"""Consolidate a bunch of CVS or RCS logs read from stdin.\r
\r
Input should be the output of a CVS or RCS logging command, e.g.\r
\r
    cvs log -rrelease14:\r
\r
which dumps all log messages from release1.4 upwards (assuming that\r
release 1.4 was tagged with tag 'release14').  Note the trailing\r
colon!\r
\r
This collects all the revision records and outputs them sorted by date\r
rather than by file, collapsing duplicate revision record, i.e.,\r
records with the same message for different files.\r
\r
The -t option causes it to truncate (discard) the last revision log\r
entry; this is useful when using something like the above cvs log\r
command, which shows the revisions including the given tag, while you\r
probably want everything *since* that tag.\r
\r
The -r option reverses the output (oldest first; the default is oldest\r
last).\r
\r
The -b tag option restricts the output to *only* checkin messages\r
belonging to the given branch tag.  The form -b HEAD restricts the\r
output to checkin messages belonging to the CVS head (trunk).  (It\r
produces some output if tag is a non-branch tag, but this output is\r
not very useful.)\r
\r
-h prints this message and exits.\r
\r
XXX This code was created by reverse engineering CVS 1.9 and RCS 5.7\r
from their output.\r
"""\r
\r
import sys, errno, getopt, re\r
\r
sep1 = '='*77 + '\n'                    # file separator\r
sep2 = '-'*28 + '\n'                    # revision separator\r
\r
def main():\r
    """Main program"""\r
    truncate_last = 0\r
    reverse = 0\r
    branch = None\r
    opts, args = getopt.getopt(sys.argv[1:], "trb:h")\r
    for o, a in opts:\r
        if o == '-t':\r
            truncate_last = 1\r
        elif o == '-r':\r
            reverse = 1\r
        elif o == '-b':\r
            branch = a\r
        elif o == '-h':\r
            print __doc__\r
            sys.exit(0)\r
    database = []\r
    while 1:\r
        chunk = read_chunk(sys.stdin)\r
        if not chunk:\r
            break\r
        records = digest_chunk(chunk, branch)\r
        if truncate_last:\r
            del records[-1]\r
        database[len(database):] = records\r
    database.sort()\r
    if not reverse:\r
        database.reverse()\r
    format_output(database)\r
\r
def read_chunk(fp):\r
    """Read a chunk -- data for one file, ending with sep1.\r
\r
    Split the chunk in parts separated by sep2.\r
\r
    """\r
    chunk = []\r
    lines = []\r
    while 1:\r
        line = fp.readline()\r
        if not line:\r
            break\r
        if line == sep1:\r
            if lines:\r
                chunk.append(lines)\r
            break\r
        if line == sep2:\r
            if lines:\r
                chunk.append(lines)\r
                lines = []\r
        else:\r
            lines.append(line)\r
    return chunk\r
\r
def digest_chunk(chunk, branch=None):\r
    """Digest a chunk -- extract working file name and revisions"""\r
    lines = chunk[0]\r
    key = 'Working file:'\r
    keylen = len(key)\r
    for line in lines:\r
        if line[:keylen] == key:\r
            working_file = line[keylen:].strip()\r
            break\r
    else:\r
        working_file = None\r
    if branch is None:\r
        pass\r
    elif branch == "HEAD":\r
        branch = re.compile(r"^\d+\.\d+$")\r
    else:\r
        revisions = {}\r
        key = 'symbolic names:\n'\r
        found = 0\r
        for line in lines:\r
            if line == key:\r
                found = 1\r
            elif found:\r
                if line[0] in '\t ':\r
                    tag, rev = line.split()\r
                    if tag[-1] == ':':\r
                        tag = tag[:-1]\r
                    revisions[tag] = rev\r
                else:\r
                    found = 0\r
        rev = revisions.get(branch)\r
        branch = re.compile(r"^<>$") # <> to force a mismatch by default\r
        if rev:\r
            if rev.find('.0.') >= 0:\r
                rev = rev.replace('.0.', '.')\r
                branch = re.compile(r"^" + re.escape(rev) + r"\.\d+$")\r
    records = []\r
    for lines in chunk[1:]:\r
        revline = lines[0]\r
        dateline = lines[1]\r
        text = lines[2:]\r
        words = dateline.split()\r
        author = None\r
        if len(words) >= 3 and words[0] == 'date:':\r
            dateword = words[1]\r
            timeword = words[2]\r
            if timeword[-1:] == ';':\r
                timeword = timeword[:-1]\r
            date = dateword + ' ' + timeword\r
            if len(words) >= 5 and words[3] == 'author:':\r
                author = words[4]\r
                if author[-1:] == ';':\r
                    author = author[:-1]\r
        else:\r
            date = None\r
            text.insert(0, revline)\r
        words = revline.split()\r
        if len(words) >= 2 and words[0] == 'revision':\r
            rev = words[1]\r
        else:\r
            # No 'revision' line -- weird...\r
            rev = None\r
            text.insert(0, revline)\r
        if branch:\r
            if rev is None or not branch.match(rev):\r
                continue\r
        records.append((date, working_file, rev, author, text))\r
    return records\r
\r
def format_output(database):\r
    prevtext = None\r
    prev = []\r
    database.append((None, None, None, None, None)) # Sentinel\r
    for (date, working_file, rev, author, text) in database:\r
        if text != prevtext:\r
            if prev:\r
                print sep2,\r
                for (p_date, p_working_file, p_rev, p_author) in prev:\r
                    print p_date, p_author, p_working_file, p_rev\r
                sys.stdout.writelines(prevtext)\r
            prev = []\r
        prev.append((date, working_file, rev, author))\r
        prevtext = text\r
\r
if __name__ == '__main__':\r
    try:\r
        main()\r
    except IOError, e:\r
        if e.errno != errno.EPIPE:\r
            raise\r