"""Demonstrate how different parsers parse the same markup. Beautiful Soup can use any of a number of different parsers. Every parser should behave more or less the same on valid markup, and Beautiful Soup's unit tests make sure this is the case. But every parser handles invalid markup differently. Even different versions of the same parser handle invalid markup differently. So instead of unit tests I've created this educational demonstration script. The DEMO_MARKUP variable below contains many lines of HTML. This script tests each line of markup against every parser you have installed, and prints out how each parser sees that markup. This may help you choose a parser, or understand why Beautiful Soup presents your document the way it does. """ DEMO_MARKUP = """A bare string

A tag

A
tag that supposedly has contents.

AT&T

This numeric entity is missing the final semicolon:

, that attribute value was closed by the subsequent tag

a

This document contains (do you see it?)

This document ends with That attribute value was bogus

The doctype is invalid because it contains extra whitespace

That boolean attribute had no value

Here's a nonexistent entity: &#foo; (do you see it?)

This document ends before the entity finishes: >

Paragraphs shouldn't contain block display elements, but this one does:

you see?