__init__ ( self,  debug_level=0 )

Initialize the scanner by setting up our caches.

Creating the parser takes a long time, so we want to cache it to reduce parsing time.

Arguments: o debug - The level of debugging that the parser should display. Level 0 is no debugging, Level 2 displays the most debugging info (but is much slower). See Martel documentation for more info on this.

feed (
        self,
        handle,
        consumer,
        )

Feeed a set of data into the scanner.

Arguments: o handle - A handle with the information to parse. o consumer - The consumer that should be informed of events.