BeautifulSoup Namespace Reference

Classes
class	BeautifulSOAP
class	BeautifulSoup
class	BeautifulStoneSoup
class	CData
class	Comment
class	Declaration
class	ICantBelieveItsBeautifulSoup
class	MinimalSoup
class	NavigableString
class	PageElement
class	ProcessingInstruction
class	ResultSet
class	RobustHTMLParser
class	RobustInsanelyWackAssHTMLParser
class	RobustWackAssHTMLParser
class	RobustXMLParser
class	SimplifyingSOAPParser
class	SoupStrainer
class	StopParsing
class	Tag
class	UnicodeDammit
Functions
def	buildTagMap
def	isList
def	isString
Variables
string	__author__ = "Leonard Richardson (leonardr@segfault.org)"
string	__copyright__ = "Copyright (c) 2004-2007 Leonard Richardson"
string	__license__ = "PSF"
string	__version__ = "3.0.4"
	chardet = None
string	DEFAULT_OUTPUT_ENCODING = "utf-8"
dictionary	name2codepoint = {}
tuple	soup = BeautifulSoup(sys.stdin.read())

---

Detailed Description

Beautiful Soup
Elixir and Tonic
"The Screen-Scraper's Friend"
http://www.crummy.com/software/BeautifulSoup/

Beautiful Soup parses a (possibly invalid) XML or HTML document into a
tree representation. It provides methods and Pythonic idioms that make
it easy to navigate, search, and modify the tree.

A well-formed XML/HTML document yields a well-formed data
structure. An ill-formed XML/HTML document yields a correspondingly
ill-formed data structure. If your document is only locally
well-formed, you can use this library to find and process the
well-formed part of it. The BeautifulSoup class 

Beautiful Soup works with Python 2.2 and up. It has no external
dependencies, but you'll have more success at converting data to UTF-8
if you also install these three packages:

* chardet, for auto-detecting character encodings
  http://chardet.feedparser.org/
* cjkcodecs and iconv_codec, which add more encodings to the ones supported
  by stock Python.
  http://cjkpython.i18n.org/

Beautiful Soup defines classes for two main parsing strategies:
    
 * BeautifulStoneSoup, for parsing XML, SGML, or your domain-specific
   language that kind of looks like XML.

 * BeautifulSoup, for parsing run-of-the-mill HTML code, be it valid
   or invalid. This class has web browser-like heuristics for
   obtaining a sensible parse tree in the face of common HTML errors.

Beautiful Soup also defines a class (UnicodeDammit) for autodetecting
the encoding of an HTML or XML document, and converting it to
Unicode. Much of this code is taken from Mark Pilgrim's Universal Feed Parser.

For more than you ever wanted to know about Beautiful Soup, see the
documentation:
http://www.crummy.com/software/BeautifulSoup/documentation.html

---

Function Documentation

def BeautifulSoup.buildTagMap	(		default,
			args
	)

Turns a list of maps, lists, or scalars into a single map.
Used to build the SELF_CLOSING_TAGS, NESTABLE_TAGS, and
NESTING_RESET_TAGS maps out of lists and partial maps.

Definition at line 842 of file BeautifulSoup.py.

def BeautifulSoup.isList

(

l

)

Convenience method that works with all 2.x versions of Python
to determine whether or not something is listlike.

Definition at line 828 of file BeautifulSoup.py.

def BeautifulSoup.isString

(

s

)

Convenience method that works with all 2.x versions of Python
to determine whether or not something is stringlike.

Definition at line 834 of file BeautifulSoup.py.

---

Variable Documentation

string BeautifulSoup::__author__ = "Leonard Richardson (leonardr@segfault.org)"

Definition at line 46 of file BeautifulSoup.py.

string BeautifulSoup::__copyright__ = "Copyright (c) 2004-2007 Leonard Richardson"

Definition at line 48 of file BeautifulSoup.py.

string BeautifulSoup::__license__ = "PSF"

Definition at line 49 of file BeautifulSoup.py.

string BeautifulSoup::__version__ = "3.0.4"

Definition at line 47 of file BeautifulSoup.py.

BeautifulSoup::chardet = None

Definition at line 1498 of file BeautifulSoup.py.

string BeautifulSoup::DEFAULT_OUTPUT_ENCODING = "utf-8"

Definition at line 64 of file BeautifulSoup.py.

dictionary BeautifulSoup::name2codepoint = {}

Definition at line 59 of file BeautifulSoup.py.

tuple BeautifulSoup::soup = BeautifulSoup(sys.stdin.read())

Definition at line 1766 of file BeautifulSoup.py.