"""
This module is called when the Parser encounters psp tokens.  It creates a generator to handle the psp
token.  When the PSP source file is fully parsed, this module calls all of the generators in turn to
output their source code.


-----------------------------------------------------------------------------------------------------
    (c) Copyright by Jay Love, 2000 (mailto:jsliv@jslove.net)

    Permission to use, copy, modify, and distribute this software and its
    documentation for any purpose and without fee or royalty is hereby granted,
    provided that the above copyright notice appear in all copies and that
    both that copyright notice and this permission notice appear in
    supporting documentation or portions thereof, including modifications,
    that you make.

    THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO
    THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
    FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL,
    INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
    FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
    NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
    WITH THE USE OR PERFORMANCE OF THIS SOFTWARE !

    This software is based in part on work done by the Jakarta group.

"""


from Generators import *
import string




class ParseEventHandler:
    """This is a key class.  It implements the handling of all the parsing elements.  Note:  This files JSP cousin is called ParseEventListener, I don\'t know why, but Handler seemed more appropriate to me."""

    aspace=' '
    defaults = {'BASE_CLASS':'WebKit.Page',
                'BASE_METHOD':'writeHTML',
                'imports':{'filename':'classes'},
                'threadSafe':'no',
                'instanceSafe':'yes',
                'indent':int(4),
                'gobbleWhitespace':1,
                'formatter':'str',
                }

    def __init__(self, ctxt, parser):

        self._ctxt = ctxt

        self._gens=[]

        self._reader = ctxt.getReader()
        self._writer = ctxt.getServletWriter()
        self._parser = parser

        self._imports=[]
        self._importedSymbols = []
        self._baseMethod = self.defaults['BASE_METHOD']
        self._baseClasses = [self.defaults['BASE_CLASS']]
        self._threadSafe = self.defaults['threadSafe']
        self._instanceSafe = self.defaults['instanceSafe']
        self._indent=self.defaults['indent']
        self._gobbleWhitespace=self.defaults['gobbleWhitespace']
        self._formatter=self.defaults['formatter']

    def addGenerator(self, gen):
        self._gens.append(gen)


    def handleExpression(self, start, stop, attrs):
        """Flush any template data into a CharGen and then create a new Expression Gen"""
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        exp = ExpressionGenerator(self._reader.getChars(start,stop))
        self.addGenerator(exp)

    def handleCharData(self, start, stop, chars):
        """flush character data into a chargen"""
        if chars !='' or '\n':
            gen = CharDataGenerator(chars)
            self.addGenerator(gen)


    def handleComment(self, start, stop):
        """Comments get swallowed into nothing"""
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        return #just eats the comment


    def handleInclude(self, attrs,param):
        """
        this is for includes of the form <psp:include ...>
        This function essentially forwards the request to the specified URL and includes that output.
        """
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = IncludeGenerator(attrs, param,self._ctxt)
        self.addGenerator(gen)

    def handleInsert(self, attrs,param):
        """ this is for includes of the form <psp:insert ...>
        This type of include is not parsed, it is just inserted in the output stream."""
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = InsertGenerator(attrs, param,self._ctxt)
        self.addGenerator(gen)


    def importHandler(self, imports, start, stop):
        importlist = string.split(imports,',')
        for i in importlist:
            if string.find(i,':') != -1:
                module, symbol = string.split(i, ':')[:2]
                self._importedSymbols.append(string.strip(symbol))
                implist = "from " + module + " import " + symbol
                self._imports.append(implist)
            else:
                self._imports.append('import '+string.strip(i))

    def extendsHandler(self,bc,start,stop):
        """extends is a page directive.  It sets the base class (or multiple base classes) for the class that this class
        will generate.  The choice of base class affects the choice of a method to override with
        the BaseMethod page directive.  The default base class is PSPPage.  PSPPage inherits from Page.py."""
        self._baseClasses = map(string.strip, string.split(bc, ','))

    def mainMethodHandler(self, method, start, stop):
        """BaseMethod is a page directive.  It sets the class method that the main body
        of this PSP page over-rides.  The default is WriteHTML. This value should be set to either WriteHTML
        or writeBody.  See the PSPPage.py and Page.py servlet classes for more information."""
        self._baseMethod=method

    def threadSafeHandler(self, bool, start, stop):
        """isThreadSafe is a page directive.  The value can be "yes" or "no".  Default is no because the default base class,
        PAge.py, isn't thread safe."""
        self._threadSafe=bool

    def instanceSafeHandler(self, bool, start, stop):
        """isInstanceSafe tells the Servlet Engine whether it is safe to use object instances of this page
    multiple times. The default is "yes".  Saying "no" here hurts performance."""
        self._instanceSafe=bool

    def indentTypeHandler(self,type,start, stop):
        """Use tabs to indent source code?"""
        type = string.lower(type)

        if type !="tabs" and type !="spaces" and type !="braces":
            raise "Invalid Indentation Type"
        self._writer.setIndentType(type)


    def indentSpacesHandler(self,amount,start,stop):
        """set number of spaces used to indent in generated source"""
        self._indentSpaces=int(amount)#don't really need this
        self._writer.setIndentSpaces(int(amount))

    def gobbleWhitespaceHandler(self, value, start, stop):
        """  Should we gobble up whitespace between script tags"""
        if string.upper(value) == "NO" or value=="0":
            self._gobbleWhitespace=0

    def formatterHandler(self, value, start, stop):
        """ set an alternate formatter function to use instead of str() """
        self._formatter = value


    directiveHandlers = {'imports':importHandler,
                        'import':importHandler,
                         'extends':extendsHandler,
                         'method':mainMethodHandler,
                         'isThreadSafe':threadSafeHandler,
                         'isInstanceSafe':instanceSafeHandler,
                         'BaseClass':extendsHandler,
                         'indentSpaces':indentSpacesHandler,
                         'indentType':indentTypeHandler,
                         'gobbleWhitespace':gobbleWhitespaceHandler,
                         'formatter':formatterHandler}


    def handleDirective(self, directive, start, stop, attrs):
        validDirectives = ['page','include']
        """Flush any template data into a CharGen and then create a new Directive Gen"""
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        #big switch

        if directive == 'page':
            e = attrs.keys()
            for i in e:
                if self.directiveHandlers.has_key(i):
                    self.directiveHandlers[i](self,attrs[i],start,stop)
                else:
                    print i
                    raise 'No Page Directive Handler'

        elif directive == 'include':
            try:
                filenm = attrs['file']
                encoding = attrs['encoding']
            except KeyError:
                if filenm !=None:
                    encoding = None
                else:
                    raise KeyError
            try:
                self._reader.pushFile(filenm, encoding)
            except 'File Not Found':
                raise 'PSP Error: Include File not Found'
        else:
            print directive
            raise "Invalid Directive"



    def handleScript(self, start, stop, attrs):
        """handling scripting elements"""
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = ScriptGenerator(self._reader.getChars(start, stop),attrs)
        self.addGenerator(gen)

    def handleEndBlock(self):
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = EndBlockGenerator()
        self.addGenerator(gen)

    def handleMethod(self, start, stop, attrs):
        self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = MethodGenerator(self._reader.getChars(start, stop),attrs)
        self.addGenerator(gen)

    def handleMethodEnd(self, start, stop, attrs):
        #self._parser.flushCharData(self.tmplStart, self.tmplStop)
        gen = MethodEndGenerator(self._reader.getChars(start, stop),attrs)
        self.addGenerator(gen)

    #####################################################################
    ##The generation of the page begins here
    ####################################################################3

    def beginProcessing(self):
        pass

    def endProcessing(self):
        self.generateHeader()
        self.generateDeclarations() #I'll overwrite this later when I can handle extends
        self.generateInitPSP()
        self.generateAll('Declarations')
        self._writer.println('\n')
        self.generateMainMethod()
        self.optimizeCharData()
        if self._gobbleWhitespace:
            self.gobbleWhitespace()
        self.generateAll('Service')
        self._writer.println()
        self.generateFooter()

    def setTemplateInfo(self, start, stop):
        """marks non code data"""
        self.tmplStart = start
        self.tmplStop = stop

    def generateHeader(self):
        for i in self._imports:
            self._writer.println(i)
##      self._writer.println('try:\n')
##      self._writer.pushIndent()
        #self._writer.println('from ' +self._baseClass+ ' import ' +self._baseClass +'\n')
        self._writer.println('import WebKit')
        self._writer.println('from WebKit import Page')
        for baseClass in self._baseClasses:
            if string.find(baseClass,'.')<0 and baseClass not in self._importedSymbols:
                self._writer.println('import ' + baseClass)
##      self._writer.popIndent()
##      self._writer.println('except:\n')
##      self._writer.pushIndent()
##      self._writer.println('pass\n')
##      self._writer.popIndent()
        self._writer.println("__orig_file__ = '%s'" % self._ctxt.getFullPspFileName())

    def generateDeclarations(self):
        # The PSP "extends" directive allows you to use a shortcut -- if the module name
        # is the same as the class name, you can say "Classname" instead of "ClassName.ClassName".
        # But we can't tell right now which names are actually class names, and which
        # names are really module names that contain a class of the same name.
        # So we have to generate code that checks at runtime.
        self._writer.println()
        self._writer.println('import types')
        self._writer.println('_baseClasses = []')
        for baseClass in self._baseClasses:
            className = string.split(baseClass, '.')[-1]
            self._writer.println('if isinstance(%s, types.ModuleType):' % baseClass)
            self._writer.pushIndent()
            self._writer.println('_baseClasses.append(%s.%s)' % (baseClass, className))
            self._writer.popIndent()
            self._writer.println('else:')
            self._writer.pushIndent()
            self._writer.println('_baseClasses.append(%s)' % baseClass)
            self._writer.popIndent()
        self._writer.println()
        # Now write the class line
        self._writer.printChars('class ')
        self._writer.printChars(self._ctxt.getServletClassName())
        self._writer.printChars('(')
        for i in range(len(self._baseClasses)):
            if i > 0:
                self._writer.printChars(',')
            self._writer.printChars('_baseClasses[%d]' % i)
        self._writer.printChars('):')
        #self._writer.printChars('('+self._baseClass+'):')
        self._writer.printChars('\n')

        self._writer.pushIndent()
        self._writer.println('def canBeThreaded(self):') # I Hope to take this out soon!
        self._writer.pushIndent()
        if string.lower(self._threadSafe) == 'no':
            self._writer.println('return 0')
        else:
            self._writer.println('return 1')
        self._writer.popIndent()
        self._writer.println()

        self._writer.println('def canBeReused(self):') # I Hope to take this out soon!
        self._writer.pushIndent()
        if string.lower(self._instanceSafe) == 'no':
            self._writer.println('return 0')
        else:
            self._writer.println('return 1')
        self._writer.popIndent()
        self._writer.println()

        if not AwakeCreated:
            self._writer.println('def awake(self,trans):')
            self._writer.pushIndent()
            self._writer.println('for baseclass in self.__class__.__bases__:')
            self._writer.pushIndent()
            self._writer.println('if hasattr(baseclass, "awake"):')
            self._writer.pushIndent()
            self._writer.println('baseclass.awake(self, trans)')
            self._writer.println('break\n')
            self._writer.popIndent() # end if statement
            self._writer.popIndent() # end for statement

##commented out for new awake version per conversation w/ chuck
##      self._writer.println('if "init" in dir(self) and type(self.init) == type(self.__init__):\n')
##      self._writer.pushIndent()
##      self._writer.println('self.init()\n')
##      self._writer.popIndent()
            self._writer.println('self.initPSP()\n')
            self._writer.println()
            self._writer.popIndent()
            self._writer.println()

        self._writer.println('def __includeFile(self, filename):')
        self._writer.pushIndent()
        self._writer.println('self.write(open(filename).read())')
        self._writer.popIndent()
        self._writer.println()

        return

    def generateInitPSP(self):
        self._writer.println('def initPSP(self):\n')
        self._writer.pushIndent()
        self._writer.println('pass\n') #nothing for now
        self._writer.popIndent()
        self._writer.println()

    def generateMainMethod(self):
        self._writer.printIndent()
        self._writer.printChars('def ')
        self._writer.printChars(self._baseMethod) #method we're creating
        self._writer.printChars('(self, transaction=None):\n')
        self._writer.pushIndent()
        self._writer.println('trans = self._transaction')
        self._writer.println(ResponseObject+ '= trans.response()')
        self._writer.println('req = trans.request()')
        self._writer.println('_formatter = %s' % self._formatter)

    #self._writer.println('app = trans.application()')

    def generateFooter(self):
        """cant decide if this is in the class or outside.  Guess Ill know when Im done"""
        self._writer.popIndent()
        self._writer.println('##footer')

    def generateAll(self,phase):
        for i in self._gens:
            if i.phase == phase:
                i.generate(self._writer)

    def optimizeCharData(self):
        """ Too many char data generators make the Servlet Slow.  If the current Generator and the next are both CharData type, merge their data."""
        gens=self._gens
        count=0
        gencount = len(gens)

        while count < gencount-1:
            if isinstance(gens[count],CharDataGenerator) and isinstance(gens[count+1],CharDataGenerator):
                gens[count].mergeData(gens[count+1])
                gens.remove(gens[count+1])
                gencount = gencount-1
            else:
                count = count+1


    def gobbleWhitespace(self):
        """
        This method looks for a character block between two psp blocks that contains only whitespace.
        If it finds one, it deletes it.
        This is necessary so that a write()  line can't sneek in between a if/else, try/except etc.
        """
        debug=0
        gens=self._gens
        sideClasses=(ScriptGenerator, EndBlockGenerator)##, ExpressionGenerator)
        count=1
        gencount = len(gens)
        if debug:
            for i in gens:
                print "Generator type=%s" % i.__class__
        while count < gencount-1:
            if isinstance(gens[count],CharDataGenerator) and gens[count+1].__class__ in sideClasses and gens[count-1].__class__ in sideClasses:
                if checkForTextHavingOnlyGivenChars(gens[count].chars):
                    gens.remove(gens[count])
                    gencount=gencount-1
            count = count+1
        

def checkForTextHavingOnlyGivenChars(text, ws=string.whitespace):
    """ Does the given text contain anything other than the ws characters?
    Return true if text is only ws characters
    Should redo this as a regex.
    """
    for i in text:
        if i not in ws:
            return 0
    return 1