#!/usr/bin/env python2
#
usage="""usage: %prog [options] url

Get the documentation package out of the repository and install it on
a web page.
"""

import os
import re
import sys
import optparse
import commands

def System(command, forcerun=False):
    """Run a command if this isn't a dry run.  The dryrun argument """
    if options.trace: print "Trace: " + command
    if not options.DryRun or forcerun: os.system(command)
    
def CommandOutput(command, forcerun=False):
    """Run a command if this isn't a dry run."""
    if options.trace: print "Trace: " + command
    if not options.DryRun or forcerun:
        return commands.getoutput(command)
    
def CMTGetVersion(package,output):
    """Return the available version of a package.  The most recent is first"""
    version = None
    if output == None:
        try: 
            versions = os.listdir("./" + package)
            versions.sort()
            version = versions.pop(0)
        except:
            version = None
    else:
        print output
        match = re.search(r"^# ==* .* version ([\w]*)",output)
        version=match.group(1)
    return version

def CMTCheckout(package,version=None):
    if version == '': version = None
    if version == None:
        output = CommandOutput("cmt checkout %s" % (package) )
    else:
        output = CommandOutput("cmt checkout -r %s %s" %(version,package))
    version = CMTGetVersion(package,output)
    if version == None:
        print "**** Package %s not found" % (package)
    else:
        print "Using package %s version %s" %(package,version)
    return version

def CMTGetRequirements(package,version):
    """Return a list of the requirements for a package.  This only
    returns the explicit requirements."""
    try:
        filename = "/".join((".",package,version,"cmt/requirements"))
        input = file(filename).read()
    except:
        input = ""
    requirements = re.findall(r"(?m)^ *use *([\w]*) *([\w]*).*$",input)
    return requirements

#############################################################
# START THE REAL SCRIPT

# Parse the options for this installation.

parser = optparse.OptionParser(usage=usage)
parser.add_option("-d","--dry-run", dest="DryRun",
                  action = "store_true", default=False,
                  help="do a dry run without running the actual commands")
parser.add_option("--trace",action="store_true",
                  dest="trace", default=True,
                  help="print commands before executing them")
parser.add_option("-t", "--no-trace",action="store_false",
                  dest="trace",
                  help="don't print commands before executing them")
parser.add_option("-V", "--version",
                  dest="version", default=None,
                  help="specify the version of the documentation")
(options, args) = parser.parse_args()

if 0<len(args):
    url = args[0]
else:
    url = os.getcwd()

# Set up the environment.
os.environ["CVSROOT"] = ":ext:anoncvs@repo.comet.org:/home/trt2kmgr/COMETRepository"
os.environ["CVS_RSH"] = "ssh"
os.environ["CMTPATH"] = os.getcwd()
os.unsetenv("CVS_SERVER")

# Get the "pilot package"
IcedustDocVersion = CMTCheckout("IcedustDoc",options.version)

# Be perverse and make sure that the documentation package is up to
# date.  This is in case a copy of the package had already existed in
# the directory.
System("(cd IcedustDoc/%s ; cvs update -d)" % IcedustDocVersion)

# Get a list of requirements for the current version.
requirements = CMTGetRequirements("IcedustDoc", IcedustDocVersion)

# Checkout all of the requirements.
for package, version in requirements:
    CMTCheckout(package,version)
    
# Do a cvs update to make sure everything is up to date.  This is in
# case a copy of a package had already existed in the directory (and
# was out of date).
cmd = "(cd IcedustDoc/%s/cmt ; cmt broadcast '(cd ..; cvs update -d)')" % \
      (IcedustDocVersion)
System(cmd)

# Make sure that the main IcedustDoc page will be rebuilt.
cmd = "(touch IcedustDoc/%s/doc/mainPage.dox)" % \
      (IcedustDocVersion)
System(cmd)

# Make the documentation and install it.
cmd = "(cd IcedustDoc/%s/cmt ; ../scripts/build-documentation.py %s)" % \
      (IcedustDocVersion,url)
System(cmd)

# Make a redirection page from the current directory to the main
# documentation page.
index = file("index.html",mode="w")
index.write("""<HTML>
<HEAD>
<TITLE>COMET Software Documentation</TITLE>
<META HTTP-EQUIV="Refresh"
      CONTENT="0; URL=IcedustDoc/%s/dox/index.html">
</HEAD>
<BODY>
This is a redirection to the main documentation page.  If this doesn't
update automatically, you can <A HREF=IcedustDoc/%s/dox/index.html>jump
directly</A> to the main page.
</BODY>
""" % (IcedustDocVersion,IcedustDocVersion))
index.close()