bs4.diagnose Namespace Reference

Classes
class	AnnouncingParser

Functions
None	diagnose ("_IncomingMarkup" data)
None	lxml_trace ("_IncomingMarkup" data, bool html=True, **Any kwargs)
None	htmlparser_trace (str data)
str	rword (int length=5)
str	rsentence (int length=4)
str	rdoc (int num_elements=1000)
None	benchmark_parsers (int num_elements=100000)
None	profile (int num_elements=100000, str parser="lxml")

Variables
str	_vowels = "aeiou"
str	_consonants = "bcdfghjklmnpqrstvwxyz"

Detailed Description

Diagnostic functions, mainly for use when doing tech support.

Function Documentation

benchmark_parsers()

None bs4.diagnose.benchmark_parsers

(

int

num_elements = 100000

)

Very basic head-to-head performance benchmark.

diagnose()

None bs4.diagnose.diagnose

(

"_IncomingMarkup"

data

)

Diagnostic suite for isolating common problems.

:param data: Some markup that needs to be explained.
:return: None; diagnostics are printed to standard output.

htmlparser_trace()

None bs4.diagnose.htmlparser_trace

(

str

data

)

Print out the HTMLParser events that occur during parsing.

This lets you see how HTMLParser parses a document when no
Beautiful Soup code is running.

:param data: Some markup.

lxml_trace()

None bs4.diagnose.lxml_trace	(	"_IncomingMarkup"	data,
		bool	html = True,
		**Any	kwargs
	)

Print out the lxml events that occur during parsing.

This lets you see how lxml parses a document when no Beautiful
Soup code is running. You can use this to determine whether
an lxml-specific problem is in Beautiful Soup's lxml tree builders
or in lxml itself.

:param data: Some markup.
:param html: If True, markup will be parsed with lxml's HTML parser.
   if False, lxml's XML parser will be used.

profile()

None bs4.diagnose.profile	(	int	num_elements = 100000,
		str	parser = "lxml"
	)

Use Python's profiler on a randomly generated document.

rdoc()

str bs4.diagnose.rdoc

(

int

num_elements = 1000

)

Randomly generate an invalid HTML document.

:meta private:

rsentence()

str bs4.diagnose.rsentence

(

int

length = 4

)

Generate a random sentence-like string.

:meta private:

rword()

str bs4.diagnose.rword

(

int

length = 5

)

Generate a random word-like string.

:meta private: