blob: 4160076a1c7834db65b5fddb2bcc3051bbd944f5 (plain)

ofs	hex dump	ascii
0000	42 0d 0d 0a 00 00 00 00 fb 0a 3f 5d 08 0e 00 00 e3 00 00 00 00 00 00 00 00 00 00 00 00 03 00 00	B.........?]....................
0020	00 40 00 00 00 73 36 00 00 00 64 00 5a 00 64 01 64 02 6c 01 6d 02 5a 02 6d 03 5a 03 6d 04 5a 04	.@...s6...d.Z.d.d.l.m.Z.m.Z.m.Z.
0040	01 00 64 03 64 04 6c 05 6d 06 5a 06 01 00 69 00 5a 07 64 08 64 06 64 07 84 01 5a 08 64 05 53 00	..d.d.l.m.Z...i.Z.d.d.d...Z.d.S.
0060	29 09 61 29 05 00 00 41 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 6d 6f 64 75 6c 65 73 20 66	).a)...A.collection.of.modules.f
0080	6f 72 20 62 75 69 6c 64 69 6e 67 20 64 69 66 66 65 72 65 6e 74 20 6b 69 6e 64 73 20 6f 66 20 74	or.building.different.kinds.of.t
00a0	72 65 65 73 20 66 72 6f 6d 20 48 54 4d 4c 0a 64 6f 63 75 6d 65 6e 74 73 2e 0a 0a 54 6f 20 63 72	rees.from.HTML.documents...To.cr
00c0	65 61 74 65 20 61 20 74 72 65 65 62 75 69 6c 64 65 72 20 66 6f 72 20 61 20 6e 65 77 20 74 79 70	eate.a.treebuilder.for.a.new.typ
00e0	65 20 6f 66 20 74 72 65 65 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 64 6f 0a 69 6d 70 6c 65 6d	e.of.tree,.you.need.to.do.implem
0100	65 6e 74 20 73 65 76 65 72 61 6c 20 74 68 69 6e 67 73 3a 0a 0a 31 2e 20 41 20 73 65 74 20 6f 66	ent.several.things:..1..A.set.of
0120	20 63 6c 61 73 73 65 73 20 66 6f 72 20 76 61 72 69 6f 75 73 20 74 79 70 65 73 20 6f 66 20 65 6c	.classes.for.various.types.of.el
0140	65 6d 65 6e 74 73 3a 20 44 6f 63 75 6d 65 6e 74 2c 20 44 6f 63 74 79 70 65 2c 20 43 6f 6d 6d 65	ements:.Document,.Doctype,.Comme
0160	6e 74 2c 0a 20 20 20 45 6c 65 6d 65 6e 74 2e 20 54 68 65 73 65 20 6d 75 73 74 20 69 6d 70 6c 65	nt,....Element..These.must.imple
0180	6d 65 6e 74 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 6f 66 20 60 60 62 61 73 65 2e 74 72 65	ment.the.interface.of.``base.tre
01a0	65 62 75 69 6c 64 65 72 73 2e 4e 6f 64 65 60 60 0a 20 20 20 28 61 6c 74 68 6f 75 67 68 20 63 6f	ebuilders.Node``....(although.co
01c0	6d 6d 65 6e 74 20 6e 6f 64 65 73 20 68 61 76 65 20 61 20 64 69 66 66 65 72 65 6e 74 20 73 69 67	mment.nodes.have.a.different.sig
01e0	6e 61 74 75 72 65 20 66 6f 72 20 74 68 65 69 72 20 63 6f 6e 73 74 72 75 63 74 6f 72 2c 0a 20 20	nature.for.their.constructor,...
0200	20 73 65 65 20 60 60 74 72 65 65 62 75 69 6c 64 65 72 73 2e 65 74 72 65 65 2e 43 6f 6d 6d 65 6e	.see.``treebuilders.etree.Commen
0220	74 60 60 29 20 54 65 78 74 75 61 6c 20 63 6f 6e 74 65 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65	t``).Textual.content.may.also.be
0240	20 69 6d 70 6c 65 6d 65 6e 74 65 64 0a 20 20 20 61 73 20 61 6e 6f 74 68 65 72 20 6e 6f 64 65 20	.implemented....as.another.node.
0260	74 79 70 65 2c 20 6f 72 20 6e 6f 74 2c 20 61 73 20 79 6f 75 72 20 74 72 65 65 20 69 6d 70 6c 65	type,.or.not,.as.your.tree.imple
0280	6d 65 6e 74 61 74 69 6f 6e 20 72 65 71 75 69 72 65 73 2e 0a 0a 32 2e 20 41 20 74 72 65 65 62 75	mentation.requires...2..A.treebu
02a0	69 6c 64 65 72 20 6f 62 6a 65 63 74 20 28 63 61 6c 6c 65 64 20 60 60 54 72 65 65 42 75 69 6c 64	ilder.object.(called.``TreeBuild
02c0	65 72 60 60 20 62 79 20 63 6f 6e 76 65 6e 74 69 6f 6e 29 20 74 68 61 74 20 69 6e 68 65 72 69 74	er``.by.convention).that.inherit
02e0	73 0a 20 20 20 66 72 6f 6d 20 60 60 74 72 65 65 62 75 69 6c 64 65 72 73 2e 62 61 73 65 2e 54 72	s....from.``treebuilders.base.Tr
0300	65 65 42 75 69 6c 64 65 72 60 60 2e 20 54 68 69 73 20 68 61 73 20 34 20 72 65 71 75 69 72 65 64	eeBuilder``..This.has.4.required
0320	20 61 74 74 72 69 62 75 74 65 73 3a 0a 0a 20 20 20 2a 20 60 60 64 6f 63 75 6d 65 6e 74 43 6c 61	.attributes:.....*.``documentCla
0340	73 73 60 60 20 2d 20 74 68 65 20 63 6c 61 73 73 20 74 6f 20 75 73 65 20 66 6f 72 20 74 68 65 20	ss``.-.the.class.to.use.for.the.
0360	62 6f 74 74 6f 6d 6d 6f 73 74 20 6e 6f 64 65 20 6f 66 20 61 20 64 6f 63 75 6d 65 6e 74 0a 20 20	bottommost.node.of.a.document...
0380	20 2a 20 60 60 65 6c 65 6d 65 6e 74 43 6c 61 73 73 60 60 20 2d 20 74 68 65 20 63 6c 61 73 73 20	.*.``elementClass``.-.the.class.
03a0	74 6f 20 75 73 65 20 66 6f 72 20 48 54 4d 4c 20 45 6c 65 6d 65 6e 74 73 0a 20 20 20 2a 20 60 60	to.use.for.HTML.Elements....*.``
03c0	63 6f 6d 6d 65 6e 74 43 6c 61 73 73 60 60 20 2d 20 74 68 65 20 63 6c 61 73 73 20 74 6f 20 75 73	commentClass``.-.the.class.to.us
03e0	65 20 66 6f 72 20 63 6f 6d 6d 65 6e 74 73 0a 20 20 20 2a 20 60 60 64 6f 63 74 79 70 65 43 6c 61	e.for.comments....*.``doctypeCla
0400	73 73 60 60 20 2d 20 74 68 65 20 63 6c 61 73 73 20 74 6f 20 75 73 65 20 66 6f 72 20 64 6f 63 74	ss``.-.the.class.to.use.for.doct
0420	79 70 65 73 0a 0a 20 20 20 49 74 20 61 6c 73 6f 20 68 61 73 20 6f 6e 65 20 72 65 71 75 69 72 65	ypes.....It.also.has.one.require
0440	64 20 6d 65 74 68 6f 64 3a 0a 0a 20 20 20 2a 20 60 60 67 65 74 44 6f 63 75 6d 65 6e 74 60 60 20	d.method:.....*.``getDocument``.
0460	2d 20 52 65 74 75 72 6e 73 20 74 68 65 20 72 6f 6f 74 20 6e 6f 64 65 20 6f 66 20 74 68 65 20 63	-.Returns.the.root.node.of.the.c
0480	6f 6d 70 6c 65 74 65 20 64 6f 63 75 6d 65 6e 74 20 74 72 65 65 0a 0a 33 2e 20 49 66 20 79 6f 75	omplete.document.tree..3..If.you
04a0	20 77 69 73 68 20 74 6f 20 72 75 6e 20 74 68 65 20 75 6e 69 74 20 74 65 73 74 73 2c 20 79 6f 75	.wish.to.run.the.unit.tests,.you
04c0	20 6d 75 73 74 20 61 6c 73 6f 20 63 72 65 61 74 65 20 61 20 60 60 74 65 73 74 53 65 72 69 61 6c	.must.also.create.a.``testSerial
04e0	69 7a 65 72 60 60 0a 20 20 20 6d 65 74 68 6f 64 20 6f 6e 20 79 6f 75 72 20 74 72 65 65 62 75 69	izer``....method.on.your.treebui
0500	6c 64 65 72 20 77 68 69 63 68 20 61 63 63 65 70 74 73 20 61 20 6e 6f 64 65 20 61 6e 64 20 72 65	lder.which.accepts.a.node.and.re
0520	74 75 72 6e 73 20 61 20 73 74 72 69 6e 67 0a 20 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20 4e 6f 64	turns.a.string....containing.Nod
0540	65 20 61 6e 64 20 69 74 73 20 63 68 69 6c 64 72 65 6e 20 73 65 72 69 61 6c 69 7a 65 64 20 61 63	e.and.its.children.serialized.ac
0560	63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 66 6f 72 6d 61 74 20 75 73 65 64 20 69 6e 0a 20 20	cording.to.the.format.used.in...
0580	20 74 68 65 20 75 6e 69 74 74 65 73 74 73 0a 0a e9 00 00 00 00 29 03 da 0f 61 62 73 6f 6c 75 74	.the.unittests.......)...absolut
05a0	65 5f 69 6d 70 6f 72 74 da 08 64 69 76 69 73 69 6f 6e da 10 75 6e 69 63 6f 64 65 5f 6c 69 74 65	e_import..division..unicode_lite
05c0	72 61 6c 73 e9 02 00 00 00 29 01 da 0d 64 65 66 61 75 6c 74 5f 65 74 72 65 65 4e 63 02 00 00 00	rals.....)...default_etreeNc....
05e0	00 00 00 00 07 00 00 00 03 00 00 00 4b 00 00 00 73 b2 00 00 00 7c 00 a0 00 a1 00 7d 00 7c 00 74	............K...s....|.....}.|.t
0600	01 6b 07 72 a8 7c 00 64 01 6b 02 72 4c 64 02 64 03 6c 02 6d 03 7d 03 01 00 7c 01 64 04 6b 08 72	.k.r.|.d.k.rLd.d.l.m.}...|.d.k.r
0620	3c 64 05 64 06 6c 04 6d 05 7d 04 01 00 7c 04 7d 01 7c 03 6a 06 7c 01 66 01 7c 02 8e 01 6a 07 53	<d.d.l.m.}...|.}.|.j.|.f.|...j.S
0640	00 7c 00 64 07 6b 02 72 6c 64 02 64 08 6c 02 6d 08 7d 05 01 00 7c 05 6a 07 74 01 7c 00 3c 00 6e	.|.d.k.rld.d.l.m.}...|.j.t.|.<.n
0660	3c 7c 00 64 09 6b 02 72 9c 64 02 64 0a 6c 02 6d 09 7d 06 01 00 7c 01 64 04 6b 08 72 8c 74 0a 7d	<|.d.k.r.d.d.l.m.}...|.d.k.r.t.}
0680	01 7c 06 6a 0b 7c 01 66 01 7c 02 8e 01 6a 07 53 00 74 0c 64 0b 7c 00 16 00 83 01 82 01 74 01 a0	.|.j.|.f.|...j.S.t.d.|.......t..
06a0	0d 7c 00 a1 01 53 00 29 0c 61 03 04 00 00 47 65 74 20 61 20 54 72 65 65 42 75 69 6c 64 65 72 20	.|...S.).a....Get.a.TreeBuilder.
06c0	63 6c 61 73 73 20 66 6f 72 20 76 61 72 69 6f 75 73 20 74 79 70 65 73 20 6f 66 20 74 72 65 65 73	class.for.various.types.of.trees
06e0	20 77 69 74 68 20 62 75 69 6c 74 2d 69 6e 20 73 75 70 70 6f 72 74 0a 0a 20 20 20 20 3a 61 72 67	.with.built-in.support......:arg
0700	20 74 72 65 65 54 79 70 65 3a 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 72 65 65 20	.treeType:.the.name.of.the.tree.
0720	74 79 70 65 20 72 65 71 75 69 72 65 64 20 28 63 61 73 65 2d 69 6e 73 65 6e 73 69 74 69 76 65 29	type.required.(case-insensitive)
0740	2e 20 53 75 70 70 6f 72 74 65 64 0a 20 20 20 20 20 20 20 20 76 61 6c 75 65 73 20 61 72 65 3a 0a	..Supported.........values.are:.
0760	0a 20 20 20 20 20 20 20 20 2a 20 22 64 6f 6d 22 20 2d 20 41 20 67 65 6e 65 72 69 63 20 62 75 69	.........*."dom".-.A.generic.bui
0780	6c 64 65 72 20 66 6f 72 20 44 4f 4d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2c 20 64 65	lder.for.DOM.implementations,.de
07a0	66 61 75 6c 74 69 6e 67 20 74 6f 20 61 0a 20 20 20 20 20 20 20 20 20 20 78 6d 6c 2e 64 6f 6d 2e	faulting.to.a...........xml.dom.
07c0	6d 69 6e 69 64 6f 6d 20 62 61 73 65 64 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 20 20	minidom.based.implementation....
07e0	20 20 20 20 20 20 2a 20 22 65 74 72 65 65 22 20 2d 20 41 20 67 65 6e 65 72 69 63 20 62 75 69 6c	......*."etree".-.A.generic.buil
0800	64 65 72 20 66 6f 72 20 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 65 78 70	der.for.tree.implementations.exp
0820	6f 73 69 6e 67 20 61 6e 0a 20 20 20 20 20 20 20 20 20 20 45 6c 65 6d 65 6e 74 54 72 65 65 2d 6c	osing.an...........ElementTree-l
0840	69 6b 65 20 69 6e 74 65 72 66 61 63 65 2c 20 64 65 66 61 75 6c 74 69 6e 67 20 74 6f 20 78 6d 6c	ike.interface,.defaulting.to.xml
0860	2e 65 74 72 65 65 2e 63 45 6c 65 6d 65 6e 74 54 72 65 65 20 69 66 0a 20 20 20 20 20 20 20 20 20	.etree.cElementTree.if..........
0880	20 61 76 61 69 6c 61 62 6c 65 20 61 6e 64 20 78 6d 6c 2e 65 74 72 65 65 2e 45 6c 65 6d 65 6e 74	.available.and.xml.etree.Element
08a0	54 72 65 65 20 69 66 20 6e 6f 74 2e 0a 20 20 20 20 20 20 20 20 2a 20 22 6c 78 6d 6c 22 20 2d 20	Tree.if.not..........*."lxml".-.
08c0	41 20 65 74 72 65 65 2d 62 61 73 65 64 20 62 75 69 6c 64 65 72 20 66 6f 72 20 6c 78 6d 6c 2e 65	A.etree-based.builder.for.lxml.e
08e0	74 72 65 65 2c 20 68 61 6e 64 6c 69 6e 67 20 6c 69 6d 69 74 61 74 69 6f 6e 73 0a 20 20 20 20 20	tree,.handling.limitations......
0900	20 20 20 20 20 6f 66 20 6c 78 6d 6c 27 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 0a	.....of.lxml's.implementation...
0920	20 20 20 20 3a 61 72 67 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 3a 20 28 43 75 72 72 65 6e	....:arg.implementation:.(Curren
0940	74 6c 79 20 61 70 70 6c 69 65 73 20 74 6f 20 74 68 65 20 22 65 74 72 65 65 22 20 61 6e 64 20 22	tly.applies.to.the."etree".and."
0960	64 6f 6d 22 20 74 72 65 65 0a 20 20 20 20 20 20 20 20 74 79 70 65 73 29 2e 20 41 20 6d 6f 64 75	dom".tree.........types)..A.modu
0980	6c 65 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 74 72 65 65 20 74 79 70 65 20 65 2e	le.implementing.the.tree.type.e.
09a0	67 2e 20 78 6d 6c 2e 65 74 72 65 65 2e 45 6c 65 6d 65 6e 74 54 72 65 65 0a 20 20 20 20 20 20 20	g..xml.etree.ElementTree........
09c0	20 6f 72 20 78 6d 6c 2e 65 74 72 65 65 2e 63 45 6c 65 6d 65 6e 74 54 72 65 65 2e 0a 0a 20 20 20	.or.xml.etree.cElementTree......
09e0	20 3a 61 72 67 20 6b 77 61 72 67 73 3a 20 41 6e 79 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 70 74	.:arg.kwargs:.Any.additional.opt
0a00	69 6f 6e 73 20 74 6f 20 70 61 73 73 20 74 6f 20 74 68 65 20 54 72 65 65 42 75 69 6c 64 65 72 20	ions.to.pass.to.the.TreeBuilder.
0a20	77 68 65 6e 0a 20 20 20 20 20 20 20 20 63 72 65 61 74 69 6e 67 20 69 74 2e 0a 0a 20 20 20 20 45	when.........creating.it.......E
0a40	78 61 6d 70 6c 65 3a 0a 0a 20 20 20 20 3e 3e 3e 20 66 72 6f 6d 20 68 74 6d 6c 35 6c 69 62 2e 74	xample:......>>>.from.html5lib.t
0a60	72 65 65 62 75 69 6c 64 65 72 73 20 69 6d 70 6f 72 74 20 67 65 74 54 72 65 65 42 75 69 6c 64 65	reebuilders.import.getTreeBuilde
0a80	72 0a 20 20 20 20 3e 3e 3e 20 62 75 69 6c 64 65 72 20 3d 20 67 65 74 54 72 65 65 42 75 69 6c 64	r.....>>>.builder.=.getTreeBuild
0aa0	65 72 28 27 65 74 72 65 65 27 29 0a 0a 20 20 20 20 da 03 64 6f 6d e9 01 00 00 00 29 01 72 07 00	er('etree')........dom.....).r..
0ac0	00 00 4e 72 01 00 00 00 29 01 da 07 6d 69 6e 69 64 6f 6d da 04 6c 78 6d 6c 29 01 da 0a 65 74 72	..Nr....)...minidom..lxml)...etr
0ae0	65 65 5f 6c 78 6d 6c da 05 65 74 72 65 65 29 01 72 0c 00 00 00 7a 1e 55 6e 72 65 63 6f 67 6e 69	ee_lxml..etree).r....z.Unrecogni
0b00	73 65 64 20 74 72 65 65 62 75 69 6c 64 65 72 20 22 25 73 22 20 29 0e da 05 6c 6f 77 65 72 da 10	sed.treebuilder."%s".)...lower..
0b20	74 72 65 65 42 75 69 6c 64 65 72 43 61 63 68 65 da 00 72 07 00 00 00 da 07 78 6d 6c 2e 64 6f 6d	treeBuilderCache..r......xml.dom
0b40	72 09 00 00 00 da 0c 67 65 74 44 6f 6d 4d 6f 64 75 6c 65 da 0b 54 72 65 65 42 75 69 6c 64 65 72	r......getDomModule..TreeBuilder
0b60	72 0b 00 00 00 72 0c 00 00 00 72 06 00 00 00 da 0e 67 65 74 45 54 72 65 65 4d 6f 64 75 6c 65 da	r....r....r......getETreeModule.
0b80	0a 56 61 6c 75 65 45 72 72 6f 72 da 03 67 65 74 29 07 da 08 74 72 65 65 54 79 70 65 da 0e 69 6d	.ValueError..get)...treeType..im
0ba0	70 6c 65 6d 65 6e 74 61 74 69 6f 6e da 06 6b 77 61 72 67 73 72 07 00 00 00 72 09 00 00 00 72 0b	plementation..kwargsr....r....r.
0bc0	00 00 00 72 0c 00 00 00 a9 00 72 19 00 00 00 fa 4b 2f 74 6d 70 2f 70 69 70 2d 69 6e 73 74 61 6c	...r......r.....K/tmp/pip-instal
0be0	6c 2d 33 6a 75 73 61 76 66 76 2f 70 69 70 2f 70 69 70 2f 5f 76 65 6e 64 6f 72 2f 68 74 6d 6c 35	l-3jusavfv/pip/pip/_vendor/html5
0c00	6c 69 62 2f 74 72 65 65 62 75 69 6c 64 65 72 73 2f 5f 5f 69 6e 69 74 5f 5f 2e 70 79 da 0e 67 65	lib/treebuilders/__init__.py..ge
0c20	74 54 72 65 65 42 75 69 6c 64 65 72 27 00 00 00 73 24 00 00 00 00 1c 08 01 08 01 08 01 0c 02 08	tTreeBuilder'...s$..............
0c40	01 0c 01 04 02 10 01 08 01 0c 01 0c 01 08 01 0c 01 08 01 04 02 10 02 0c 01 72 1b 00 00 00 29 01	.........................r....).
0c60	4e 29 09 da 07 5f 5f 64 6f 63 5f 5f da 0a 5f 5f 66 75 74 75 72 65 5f 5f 72 02 00 00 00 72 03 00	N)...__doc__..__future__r....r..
0c80	00 00 72 04 00 00 00 da 06 5f 75 74 69 6c 73 72 06 00 00 00 72 0e 00 00 00 72 1b 00 00 00 72 19	..r......_utilsr....r....r....r.
0ca0	00 00 00 72 19 00 00 00 72 19 00 00 00 72 1a 00 00 00 da 08 3c 6d 6f 64 75 6c 65 3e 1e 00 00 00	...r....r....r......<module>....
0cc0	73 08 00 00 00 04 02 14 02 0c 02 04 03	s............