superfeedr-nokogiri 1.4.0.20091116183308

Sign up to get free protection for your applications and to get access to all the features.
Files changed (270) hide show
  1. data/.autotest +27 -0
  2. data/CHANGELOG.ja.rdoc +330 -0
  3. data/CHANGELOG.rdoc +314 -0
  4. data/Manifest.txt +269 -0
  5. data/README.ja.rdoc +105 -0
  6. data/README.rdoc +118 -0
  7. data/Rakefile +244 -0
  8. data/bin/nokogiri +49 -0
  9. data/ext/nokogiri/extconf.rb +145 -0
  10. data/ext/nokogiri/html_document.c +145 -0
  11. data/ext/nokogiri/html_document.h +10 -0
  12. data/ext/nokogiri/html_element_description.c +272 -0
  13. data/ext/nokogiri/html_element_description.h +10 -0
  14. data/ext/nokogiri/html_entity_lookup.c +32 -0
  15. data/ext/nokogiri/html_entity_lookup.h +8 -0
  16. data/ext/nokogiri/html_sax_parser_context.c +92 -0
  17. data/ext/nokogiri/html_sax_parser_context.h +11 -0
  18. data/ext/nokogiri/nokogiri.c +89 -0
  19. data/ext/nokogiri/nokogiri.h +145 -0
  20. data/ext/nokogiri/xml_attr.c +92 -0
  21. data/ext/nokogiri/xml_attr.h +9 -0
  22. data/ext/nokogiri/xml_attribute_decl.c +67 -0
  23. data/ext/nokogiri/xml_attribute_decl.h +9 -0
  24. data/ext/nokogiri/xml_cdata.c +54 -0
  25. data/ext/nokogiri/xml_cdata.h +9 -0
  26. data/ext/nokogiri/xml_comment.c +52 -0
  27. data/ext/nokogiri/xml_comment.h +9 -0
  28. data/ext/nokogiri/xml_document.c +388 -0
  29. data/ext/nokogiri/xml_document.h +24 -0
  30. data/ext/nokogiri/xml_document_fragment.c +46 -0
  31. data/ext/nokogiri/xml_document_fragment.h +10 -0
  32. data/ext/nokogiri/xml_dtd.c +192 -0
  33. data/ext/nokogiri/xml_dtd.h +10 -0
  34. data/ext/nokogiri/xml_element_content.c +123 -0
  35. data/ext/nokogiri/xml_element_content.h +10 -0
  36. data/ext/nokogiri/xml_element_decl.c +69 -0
  37. data/ext/nokogiri/xml_element_decl.h +9 -0
  38. data/ext/nokogiri/xml_entity_decl.c +97 -0
  39. data/ext/nokogiri/xml_entity_decl.h +10 -0
  40. data/ext/nokogiri/xml_entity_reference.c +50 -0
  41. data/ext/nokogiri/xml_entity_reference.h +9 -0
  42. data/ext/nokogiri/xml_io.c +31 -0
  43. data/ext/nokogiri/xml_io.h +11 -0
  44. data/ext/nokogiri/xml_namespace.c +74 -0
  45. data/ext/nokogiri/xml_namespace.h +12 -0
  46. data/ext/nokogiri/xml_node.c +1060 -0
  47. data/ext/nokogiri/xml_node.h +13 -0
  48. data/ext/nokogiri/xml_node_set.c +397 -0
  49. data/ext/nokogiri/xml_node_set.h +9 -0
  50. data/ext/nokogiri/xml_processing_instruction.c +54 -0
  51. data/ext/nokogiri/xml_processing_instruction.h +9 -0
  52. data/ext/nokogiri/xml_reader.c +593 -0
  53. data/ext/nokogiri/xml_reader.h +10 -0
  54. data/ext/nokogiri/xml_relax_ng.c +159 -0
  55. data/ext/nokogiri/xml_relax_ng.h +9 -0
  56. data/ext/nokogiri/xml_sax_parser.c +286 -0
  57. data/ext/nokogiri/xml_sax_parser.h +43 -0
  58. data/ext/nokogiri/xml_sax_parser_context.c +155 -0
  59. data/ext/nokogiri/xml_sax_parser_context.h +10 -0
  60. data/ext/nokogiri/xml_sax_push_parser.c +114 -0
  61. data/ext/nokogiri/xml_sax_push_parser.h +9 -0
  62. data/ext/nokogiri/xml_schema.c +156 -0
  63. data/ext/nokogiri/xml_schema.h +9 -0
  64. data/ext/nokogiri/xml_syntax_error.c +261 -0
  65. data/ext/nokogiri/xml_syntax_error.h +13 -0
  66. data/ext/nokogiri/xml_text.c +48 -0
  67. data/ext/nokogiri/xml_text.h +9 -0
  68. data/ext/nokogiri/xml_xpath.c +53 -0
  69. data/ext/nokogiri/xml_xpath.h +11 -0
  70. data/ext/nokogiri/xml_xpath_context.c +239 -0
  71. data/ext/nokogiri/xml_xpath_context.h +9 -0
  72. data/ext/nokogiri/xslt_stylesheet.c +131 -0
  73. data/ext/nokogiri/xslt_stylesheet.h +9 -0
  74. data/lib/nokogiri.rb +116 -0
  75. data/lib/nokogiri/css.rb +25 -0
  76. data/lib/nokogiri/css/generated_parser.rb +646 -0
  77. data/lib/nokogiri/css/generated_tokenizer.rb +142 -0
  78. data/lib/nokogiri/css/node.rb +99 -0
  79. data/lib/nokogiri/css/parser.rb +82 -0
  80. data/lib/nokogiri/css/parser.y +227 -0
  81. data/lib/nokogiri/css/syntax_error.rb +7 -0
  82. data/lib/nokogiri/css/tokenizer.rb +7 -0
  83. data/lib/nokogiri/css/tokenizer.rex +54 -0
  84. data/lib/nokogiri/css/xpath_visitor.rb +162 -0
  85. data/lib/nokogiri/decorators/slop.rb +33 -0
  86. data/lib/nokogiri/ffi/html/document.rb +28 -0
  87. data/lib/nokogiri/ffi/html/element_description.rb +85 -0
  88. data/lib/nokogiri/ffi/html/entity_lookup.rb +16 -0
  89. data/lib/nokogiri/ffi/html/sax/parser_context.rb +38 -0
  90. data/lib/nokogiri/ffi/io_callbacks.rb +42 -0
  91. data/lib/nokogiri/ffi/libxml.rb +356 -0
  92. data/lib/nokogiri/ffi/structs/common_node.rb +26 -0
  93. data/lib/nokogiri/ffi/structs/html_elem_desc.rb +24 -0
  94. data/lib/nokogiri/ffi/structs/html_entity_desc.rb +13 -0
  95. data/lib/nokogiri/ffi/structs/xml_alloc.rb +16 -0
  96. data/lib/nokogiri/ffi/structs/xml_attr.rb +19 -0
  97. data/lib/nokogiri/ffi/structs/xml_attribute.rb +27 -0
  98. data/lib/nokogiri/ffi/structs/xml_buffer.rb +16 -0
  99. data/lib/nokogiri/ffi/structs/xml_document.rb +108 -0
  100. data/lib/nokogiri/ffi/structs/xml_dtd.rb +28 -0
  101. data/lib/nokogiri/ffi/structs/xml_element.rb +26 -0
  102. data/lib/nokogiri/ffi/structs/xml_element_content.rb +17 -0
  103. data/lib/nokogiri/ffi/structs/xml_entity.rb +32 -0
  104. data/lib/nokogiri/ffi/structs/xml_enumeration.rb +12 -0
  105. data/lib/nokogiri/ffi/structs/xml_node.rb +28 -0
  106. data/lib/nokogiri/ffi/structs/xml_node_set.rb +53 -0
  107. data/lib/nokogiri/ffi/structs/xml_notation.rb +11 -0
  108. data/lib/nokogiri/ffi/structs/xml_ns.rb +15 -0
  109. data/lib/nokogiri/ffi/structs/xml_parser_context.rb +19 -0
  110. data/lib/nokogiri/ffi/structs/xml_relax_ng.rb +14 -0
  111. data/lib/nokogiri/ffi/structs/xml_sax_handler.rb +51 -0
  112. data/lib/nokogiri/ffi/structs/xml_sax_push_parser_context.rb +15 -0
  113. data/lib/nokogiri/ffi/structs/xml_schema.rb +13 -0
  114. data/lib/nokogiri/ffi/structs/xml_syntax_error.rb +31 -0
  115. data/lib/nokogiri/ffi/structs/xml_text_reader.rb +12 -0
  116. data/lib/nokogiri/ffi/structs/xml_xpath_context.rb +37 -0
  117. data/lib/nokogiri/ffi/structs/xml_xpath_object.rb +35 -0
  118. data/lib/nokogiri/ffi/structs/xml_xpath_parser_context.rb +20 -0
  119. data/lib/nokogiri/ffi/structs/xslt_stylesheet.rb +13 -0
  120. data/lib/nokogiri/ffi/xml/attr.rb +41 -0
  121. data/lib/nokogiri/ffi/xml/attribute_decl.rb +27 -0
  122. data/lib/nokogiri/ffi/xml/cdata.rb +19 -0
  123. data/lib/nokogiri/ffi/xml/comment.rb +18 -0
  124. data/lib/nokogiri/ffi/xml/document.rb +135 -0
  125. data/lib/nokogiri/ffi/xml/document_fragment.rb +21 -0
  126. data/lib/nokogiri/ffi/xml/dtd.rb +69 -0
  127. data/lib/nokogiri/ffi/xml/element_content.rb +43 -0
  128. data/lib/nokogiri/ffi/xml/element_decl.rb +19 -0
  129. data/lib/nokogiri/ffi/xml/entity_decl.rb +27 -0
  130. data/lib/nokogiri/ffi/xml/entity_reference.rb +19 -0
  131. data/lib/nokogiri/ffi/xml/namespace.rb +44 -0
  132. data/lib/nokogiri/ffi/xml/node.rb +444 -0
  133. data/lib/nokogiri/ffi/xml/node_set.rb +133 -0
  134. data/lib/nokogiri/ffi/xml/processing_instruction.rb +20 -0
  135. data/lib/nokogiri/ffi/xml/reader.rb +227 -0
  136. data/lib/nokogiri/ffi/xml/relax_ng.rb +85 -0
  137. data/lib/nokogiri/ffi/xml/sax/parser.rb +142 -0
  138. data/lib/nokogiri/ffi/xml/sax/parser_context.rb +67 -0
  139. data/lib/nokogiri/ffi/xml/sax/push_parser.rb +39 -0
  140. data/lib/nokogiri/ffi/xml/schema.rb +92 -0
  141. data/lib/nokogiri/ffi/xml/syntax_error.rb +91 -0
  142. data/lib/nokogiri/ffi/xml/text.rb +18 -0
  143. data/lib/nokogiri/ffi/xml/xpath.rb +19 -0
  144. data/lib/nokogiri/ffi/xml/xpath_context.rb +135 -0
  145. data/lib/nokogiri/ffi/xslt/stylesheet.rb +47 -0
  146. data/lib/nokogiri/html.rb +35 -0
  147. data/lib/nokogiri/html/builder.rb +35 -0
  148. data/lib/nokogiri/html/document.rb +88 -0
  149. data/lib/nokogiri/html/document_fragment.rb +15 -0
  150. data/lib/nokogiri/html/element_description.rb +23 -0
  151. data/lib/nokogiri/html/entity_lookup.rb +13 -0
  152. data/lib/nokogiri/html/sax/parser.rb +48 -0
  153. data/lib/nokogiri/html/sax/parser_context.rb +16 -0
  154. data/lib/nokogiri/syntax_error.rb +4 -0
  155. data/lib/nokogiri/version.rb +33 -0
  156. data/lib/nokogiri/version_warning.rb +11 -0
  157. data/lib/nokogiri/xml.rb +67 -0
  158. data/lib/nokogiri/xml/attr.rb +14 -0
  159. data/lib/nokogiri/xml/attribute_decl.rb +18 -0
  160. data/lib/nokogiri/xml/builder.rb +405 -0
  161. data/lib/nokogiri/xml/cdata.rb +11 -0
  162. data/lib/nokogiri/xml/character_data.rb +7 -0
  163. data/lib/nokogiri/xml/document.rb +131 -0
  164. data/lib/nokogiri/xml/document_fragment.rb +69 -0
  165. data/lib/nokogiri/xml/dtd.rb +11 -0
  166. data/lib/nokogiri/xml/element_content.rb +36 -0
  167. data/lib/nokogiri/xml/element_decl.rb +13 -0
  168. data/lib/nokogiri/xml/entity_decl.rb +15 -0
  169. data/lib/nokogiri/xml/fragment_handler.rb +71 -0
  170. data/lib/nokogiri/xml/namespace.rb +13 -0
  171. data/lib/nokogiri/xml/node.rb +665 -0
  172. data/lib/nokogiri/xml/node/save_options.rb +42 -0
  173. data/lib/nokogiri/xml/node_set.rb +307 -0
  174. data/lib/nokogiri/xml/notation.rb +6 -0
  175. data/lib/nokogiri/xml/parse_options.rb +85 -0
  176. data/lib/nokogiri/xml/pp.rb +2 -0
  177. data/lib/nokogiri/xml/pp/character_data.rb +18 -0
  178. data/lib/nokogiri/xml/pp/node.rb +56 -0
  179. data/lib/nokogiri/xml/processing_instruction.rb +8 -0
  180. data/lib/nokogiri/xml/reader.rb +74 -0
  181. data/lib/nokogiri/xml/relax_ng.rb +32 -0
  182. data/lib/nokogiri/xml/sax.rb +4 -0
  183. data/lib/nokogiri/xml/sax/document.rb +160 -0
  184. data/lib/nokogiri/xml/sax/parser.rb +115 -0
  185. data/lib/nokogiri/xml/sax/parser_context.rb +16 -0
  186. data/lib/nokogiri/xml/sax/push_parser.rb +60 -0
  187. data/lib/nokogiri/xml/schema.rb +61 -0
  188. data/lib/nokogiri/xml/syntax_error.rb +38 -0
  189. data/lib/nokogiri/xml/xpath.rb +10 -0
  190. data/lib/nokogiri/xml/xpath/syntax_error.rb +8 -0
  191. data/lib/nokogiri/xml/xpath_context.rb +16 -0
  192. data/lib/nokogiri/xslt.rb +48 -0
  193. data/lib/nokogiri/xslt/stylesheet.rb +25 -0
  194. data/lib/xsd/xmlparser/nokogiri.rb +71 -0
  195. data/tasks/test.rb +100 -0
  196. data/test/css/test_nthiness.rb +159 -0
  197. data/test/css/test_parser.rb +277 -0
  198. data/test/css/test_tokenizer.rb +183 -0
  199. data/test/css/test_xpath_visitor.rb +76 -0
  200. data/test/ffi/test_document.rb +35 -0
  201. data/test/files/2ch.html +108 -0
  202. data/test/files/address_book.rlx +12 -0
  203. data/test/files/address_book.xml +10 -0
  204. data/test/files/bar/bar.xsd +4 -0
  205. data/test/files/dont_hurt_em_why.xml +422 -0
  206. data/test/files/exslt.xml +8 -0
  207. data/test/files/exslt.xslt +35 -0
  208. data/test/files/foo/foo.xsd +4 -0
  209. data/test/files/po.xml +32 -0
  210. data/test/files/po.xsd +66 -0
  211. data/test/files/shift_jis.html +10 -0
  212. data/test/files/shift_jis.xml +5 -0
  213. data/test/files/snuggles.xml +3 -0
  214. data/test/files/staff.dtd +10 -0
  215. data/test/files/staff.xml +59 -0
  216. data/test/files/staff.xslt +32 -0
  217. data/test/files/tlm.html +850 -0
  218. data/test/files/valid_bar.xml +2 -0
  219. data/test/helper.rb +136 -0
  220. data/test/html/sax/test_parser.rb +64 -0
  221. data/test/html/sax/test_parser_context.rb +48 -0
  222. data/test/html/test_builder.rb +164 -0
  223. data/test/html/test_document.rb +390 -0
  224. data/test/html/test_document_encoding.rb +77 -0
  225. data/test/html/test_document_fragment.rb +132 -0
  226. data/test/html/test_element_description.rb +94 -0
  227. data/test/html/test_named_characters.rb +14 -0
  228. data/test/html/test_node.rb +228 -0
  229. data/test/html/test_node_encoding.rb +27 -0
  230. data/test/test_convert_xpath.rb +135 -0
  231. data/test/test_css_cache.rb +45 -0
  232. data/test/test_gc.rb +15 -0
  233. data/test/test_memory_leak.rb +77 -0
  234. data/test/test_nokogiri.rb +134 -0
  235. data/test/test_reader.rb +358 -0
  236. data/test/test_xslt_transforms.rb +131 -0
  237. data/test/xml/node/test_save_options.rb +20 -0
  238. data/test/xml/node/test_subclass.rb +44 -0
  239. data/test/xml/sax/test_parser.rb +307 -0
  240. data/test/xml/sax/test_parser_context.rb +56 -0
  241. data/test/xml/sax/test_push_parser.rb +131 -0
  242. data/test/xml/test_attr.rb +38 -0
  243. data/test/xml/test_attribute_decl.rb +82 -0
  244. data/test/xml/test_builder.rb +167 -0
  245. data/test/xml/test_cdata.rb +38 -0
  246. data/test/xml/test_comment.rb +29 -0
  247. data/test/xml/test_document.rb +607 -0
  248. data/test/xml/test_document_encoding.rb +26 -0
  249. data/test/xml/test_document_fragment.rb +138 -0
  250. data/test/xml/test_dtd.rb +82 -0
  251. data/test/xml/test_dtd_encoding.rb +33 -0
  252. data/test/xml/test_element_content.rb +56 -0
  253. data/test/xml/test_element_decl.rb +73 -0
  254. data/test/xml/test_entity_decl.rb +83 -0
  255. data/test/xml/test_entity_reference.rb +21 -0
  256. data/test/xml/test_namespace.rb +68 -0
  257. data/test/xml/test_node.rb +889 -0
  258. data/test/xml/test_node_attributes.rb +34 -0
  259. data/test/xml/test_node_encoding.rb +107 -0
  260. data/test/xml/test_node_set.rb +531 -0
  261. data/test/xml/test_parse_options.rb +52 -0
  262. data/test/xml/test_processing_instruction.rb +30 -0
  263. data/test/xml/test_reader_encoding.rb +126 -0
  264. data/test/xml/test_relax_ng.rb +60 -0
  265. data/test/xml/test_schema.rb +89 -0
  266. data/test/xml/test_syntax_error.rb +27 -0
  267. data/test/xml/test_text.rb +30 -0
  268. data/test/xml/test_unparented_node.rb +381 -0
  269. data/test/xml/test_xpath.rb +106 -0
  270. metadata +430 -0
@@ -0,0 +1,16 @@
1
+ module Nokogiri
2
+ module HTML
3
+ module SAX
4
+ ###
5
+ # Context for HTML SAX parsers. This class is usually not instantiated
6
+ # by the user. Instead, you should be looking at
7
+ # Nokogiri::HTML::SAX::Parser
8
+ class ParserContext < Nokogiri::XML::SAX::ParserContext
9
+ def self.new thing, encoding = 'UTF-8'
10
+ [:read, :close].all? { |x| thing.respond_to?(x) } ? super :
11
+ memory(thing, encoding)
12
+ end
13
+ end
14
+ end
15
+ end
16
+ end
@@ -0,0 +1,4 @@
1
+ module Nokogiri
2
+ class SyntaxError < ::StandardError
3
+ end
4
+ end
@@ -0,0 +1,33 @@
1
+ module Nokogiri
2
+ # The version of Nokogiri you are using
3
+ VERSION = '1.4.0'
4
+
5
+ # More complete version information about libxml
6
+ VERSION_INFO = {}
7
+ VERSION_INFO['warnings'] = []
8
+ VERSION_INFO['nokogiri'] = VERSION
9
+ if defined?(LIBXML_VERSION)
10
+ VERSION_INFO['libxml'] = {}
11
+ VERSION_INFO['libxml']['binding'] = 'extension'
12
+ VERSION_INFO['libxml']['compiled'] = LIBXML_VERSION
13
+ VERSION_INFO['libxml']['loaded'] = LIBXML_PARSER_VERSION.scan(/^(.*)(..)(..)$/).first.collect{|j|j.to_i}.join(".")
14
+
15
+ if VERSION_INFO['libxml']['compiled'] != VERSION_INFO['libxml']['loaded']
16
+ warning = "Nokogiri was built against LibXML version #{VERSION_INFO['libxml']['compiled']}, but has dynamically loaded #{VERSION_INFO['libxml']['loaded']}"
17
+ VERSION_INFO['warnings'] << warning
18
+ warn "WARNING: #{warning}"
19
+ end
20
+ end
21
+
22
+ def self.uses_libxml? # :nodoc:
23
+ !Nokogiri::VERSION_INFO['libxml'].nil?
24
+ end
25
+
26
+ def self.ffi? # :nodoc:
27
+ uses_libxml? && Nokogiri::VERSION_INFO['libxml']['binding'] == 'ffi'
28
+ end
29
+
30
+ def self.is_2_6_16? # :nodoc:
31
+ Nokogiri::VERSION_INFO['libxml']['loaded'] <= '2.6.16'
32
+ end
33
+ end
@@ -0,0 +1,11 @@
1
+ module Nokogiri
2
+ if self.is_2_6_16? && !defined?(I_KNOW_I_AM_USING_AN_OLD_AND_BUGGY_VERSION_OF_LIBXML2)
3
+ warn <<-eom
4
+ HI. You're using libxml2 version 2.6.16 which is over 4 years old and has
5
+ plenty of bugs. We suggest that for maximum HTML/XML parsing pleasure, you
6
+ upgrade your version of libxml2 and re-install nokogiri. If you like using
7
+ libxml2 version 2.6.16, but don't like this warning, please define the constant
8
+ I_KNOW_I_AM_USING_AN_OLD_AND_BUGGY_VERSION_OF_LIBXML2 before requring nokogiri.
9
+ eom
10
+ end
11
+ end
@@ -0,0 +1,67 @@
1
+ require 'nokogiri/xml/pp'
2
+ require 'nokogiri/xml/parse_options'
3
+ require 'nokogiri/xml/sax'
4
+ require 'nokogiri/xml/fragment_handler'
5
+ require 'nokogiri/xml/node'
6
+ require 'nokogiri/xml/attribute_decl'
7
+ require 'nokogiri/xml/element_decl'
8
+ require 'nokogiri/xml/element_content'
9
+ require 'nokogiri/xml/character_data'
10
+ require 'nokogiri/xml/namespace'
11
+ require 'nokogiri/xml/attr'
12
+ require 'nokogiri/xml/dtd'
13
+ require 'nokogiri/xml/cdata'
14
+ require 'nokogiri/xml/document'
15
+ require 'nokogiri/xml/document_fragment'
16
+ require 'nokogiri/xml/processing_instruction'
17
+ require 'nokogiri/xml/node_set'
18
+ require 'nokogiri/xml/syntax_error'
19
+ require 'nokogiri/xml/xpath'
20
+ require 'nokogiri/xml/xpath_context'
21
+ require 'nokogiri/xml/builder'
22
+ require 'nokogiri/xml/reader'
23
+ require 'nokogiri/xml/notation'
24
+ require 'nokogiri/xml/entity_decl'
25
+ require 'nokogiri/xml/schema'
26
+ require 'nokogiri/xml/relax_ng'
27
+
28
+ module Nokogiri
29
+ class << self
30
+ ###
31
+ # Parse XML. Convenience method for Nokogiri::XML::Document.parse
32
+ def XML thing, url = nil, encoding = nil, options = XML::ParseOptions::DEFAULT_XML, &block
33
+ Nokogiri::XML::Document.parse(thing, url, encoding, options, &block)
34
+ end
35
+ end
36
+
37
+ module XML
38
+ class << self
39
+ ###
40
+ # Parse an XML document using the Nokogiri::XML::Reader API. See
41
+ # Nokogiri::XML::Reader for mor information
42
+ def Reader string_or_io, url = nil, encoding = nil, options = ParseOptions::STRICT
43
+
44
+ options = Nokogiri::XML::ParseOptions.new(options) if Fixnum === options
45
+ # Give the options to the user
46
+ yield options if block_given?
47
+
48
+ if string_or_io.respond_to? :read
49
+ return Reader.from_io(string_or_io, url, encoding, options.to_i)
50
+ end
51
+ Reader.from_memory(string_or_io, url, encoding, options.to_i)
52
+ end
53
+
54
+ ###
55
+ # Parse XML. Convenience method for Nokogiri::XML::Document.parse
56
+ def parse thing, url = nil, encoding = nil, options = ParseOptions::DEFAULT_XML, &block
57
+ Document.parse(thing, url, encoding, options, &block)
58
+ end
59
+
60
+ ####
61
+ # Parse a fragment from +string+ in to a NodeSet.
62
+ def fragment string
63
+ XML::DocumentFragment.parse(string)
64
+ end
65
+ end
66
+ end
67
+ end
@@ -0,0 +1,14 @@
1
+ module Nokogiri
2
+ module XML
3
+ class Attr < Node
4
+ alias :value :content
5
+ alias :to_s :content
6
+ alias :content= :value=
7
+
8
+ private
9
+ def inspect_attributes
10
+ [:name, :namespace, :value]
11
+ end
12
+ end
13
+ end
14
+ end
@@ -0,0 +1,18 @@
1
+ module Nokogiri
2
+ module XML
3
+ ###
4
+ # Represents an attribute declaration in a DTD
5
+ class AttributeDecl < Nokogiri::XML::Node
6
+ undef_method :attribute_nodes
7
+ undef_method :attributes
8
+ undef_method :content
9
+ undef_method :namespace
10
+ undef_method :namespace_definitions
11
+ undef_method :line
12
+
13
+ def inspect
14
+ "#<#{self.class.name}:#{sprintf("0x%x", object_id)} #{to_s.inspect}>"
15
+ end
16
+ end
17
+ end
18
+ end
@@ -0,0 +1,405 @@
1
+ module Nokogiri
2
+ module XML
3
+ ###
4
+ # Nokogiri builder can be used for building XML and HTML documents.
5
+ #
6
+ # == Synopsis:
7
+ #
8
+ # builder = Nokogiri::XML::Builder.new do |xml|
9
+ # xml.root {
10
+ # xml.products {
11
+ # xml.widget {
12
+ # xml.id_ "10"
13
+ # xml.name "Awesome widget"
14
+ # }
15
+ # }
16
+ # }
17
+ # end
18
+ # puts builder.to_xml
19
+ #
20
+ # Will output:
21
+ #
22
+ # <?xml version="1.0"?>
23
+ # <root>
24
+ # <products>
25
+ # <widget>
26
+ # <id>10</id>
27
+ # <name>Awesome widget</name>
28
+ # </widget>
29
+ # </products>
30
+ # </root>
31
+ #
32
+ #
33
+ # === Builder scope
34
+ #
35
+ # The builder allows two forms. When the builder is supplied with a block
36
+ # that has a parameter, the outside scope is maintained. This means you
37
+ # can access variables that are outside your builder. If you don't need
38
+ # outside scope, you can use the builder without the "xml" prefix like
39
+ # this:
40
+ #
41
+ # builder = Nokogiri::XML::Builder.new do
42
+ # root {
43
+ # products {
44
+ # widget {
45
+ # id_ "10"
46
+ # name "Awesome widget"
47
+ # }
48
+ # }
49
+ # }
50
+ # end
51
+ #
52
+ # == Special Tags
53
+ #
54
+ # The builder works by taking advantage of method_missing. Unfortunately
55
+ # some methods are defined in ruby that are difficult or dangerous to
56
+ # remove. You may want to create tags with the name "type", "class", and
57
+ # "id" for example. In that case, you can use an underscore to
58
+ # disambiguate your tag name from the method call.
59
+ #
60
+ # Here is an example of using the underscore to disambiguate tag names from
61
+ # ruby methods:
62
+ #
63
+ # @objects = [Object.new, Object.new, Object.new]
64
+ #
65
+ # builder = Nokogiri::XML::Builder.new do |xml|
66
+ # xml.root {
67
+ # xml.objects {
68
+ # @objects.each do |o|
69
+ # xml.object {
70
+ # xml.type_ o.type
71
+ # xml.class_ o.class.name
72
+ # xml.id_ o.id
73
+ # }
74
+ # end
75
+ # }
76
+ # }
77
+ # end
78
+ # puts builder.to_xml
79
+ #
80
+ # The underscore may be used with any tag name, and the last underscore
81
+ # will just be removed. This code will output the following XML:
82
+ #
83
+ # <?xml version="1.0"?>
84
+ # <root>
85
+ # <objects>
86
+ # <object>
87
+ # <type>Object</type>
88
+ # <class>Object</class>
89
+ # <id>48390</id>
90
+ # </object>
91
+ # <object>
92
+ # <type>Object</type>
93
+ # <class>Object</class>
94
+ # <id>48380</id>
95
+ # </object>
96
+ # <object>
97
+ # <type>Object</type>
98
+ # <class>Object</class>
99
+ # <id>48370</id>
100
+ # </object>
101
+ # </objects>
102
+ # </root>
103
+ #
104
+ # == Tag Attributes
105
+ #
106
+ # Tag attributes may be supplied as method arguments. Here is our
107
+ # previous example, but using attributes rather than tags:
108
+ #
109
+ # @objects = [Object.new, Object.new, Object.new]
110
+ #
111
+ # builder = Nokogiri::XML::Builder.new do |xml|
112
+ # xml.root {
113
+ # xml.objects {
114
+ # @objects.each do |o|
115
+ # xml.object(:type => o.type, :class => o.class, :id => o.id)
116
+ # end
117
+ # }
118
+ # }
119
+ # end
120
+ # puts builder.to_xml
121
+ #
122
+ # === Tag Attribute Short Cuts
123
+ #
124
+ # A couple attribute short cuts are available when building tags. The
125
+ # short cuts are available by special method calls when building a tag.
126
+ #
127
+ # This example builds an "object" tag with the class attribute "classy"
128
+ # and the id of "thing":
129
+ #
130
+ # builder = Nokogiri::XML::Builder.new do |xml|
131
+ # xml.root {
132
+ # xml.objects {
133
+ # xml.object.classy.thing!
134
+ # }
135
+ # }
136
+ # end
137
+ # puts builder.to_xml
138
+ #
139
+ # Which will output:
140
+ #
141
+ # <?xml version="1.0"?>
142
+ # <root>
143
+ # <objects>
144
+ # <object class="classy" id="thing"/>
145
+ # </objects>
146
+ # </root>
147
+ #
148
+ # All other options are still supported with this syntax, including
149
+ # blocks and extra tag attributes.
150
+ #
151
+ # == Namespaces
152
+ #
153
+ # Namespaces are added similarly to attributes. Nokogiri::XML::Builder
154
+ # assumes that when an attribute starts with "xmlns", it is meant to be
155
+ # a namespace:
156
+ #
157
+ # builder = Nokogiri::XML::Builder.new { |xml|
158
+ # xml.root('xmlns' => 'default', 'xmlns:foo' => 'bar') do
159
+ # xml.tenderlove
160
+ # end
161
+ # }
162
+ # puts builder.to_xml
163
+ #
164
+ # Will output XML like this:
165
+ #
166
+ # <?xml version="1.0"?>
167
+ # <root xmlns:foo="bar" xmlns="default">
168
+ # <tenderlove/>
169
+ # </root>
170
+ #
171
+ # === Referencing declared namespaces
172
+ #
173
+ # Tags that reference non-default namespaces (i.e. a tag "foo:bar") can be
174
+ # built by using the Nokogiri::XML::Builder#[] method.
175
+ #
176
+ # For example:
177
+ #
178
+ # builder = Nokogiri::XML::Builder.new do |xml|
179
+ # xml.root('xmlns:foo' => 'bar') {
180
+ # xml.objects {
181
+ # xml['foo'].object.classy.thing!
182
+ # }
183
+ # }
184
+ # end
185
+ # puts builder.to_xml
186
+ #
187
+ # Will output this XML:
188
+ #
189
+ # <?xml version="1.0"?>
190
+ # <root xmlns:foo="bar">
191
+ # <objects>
192
+ # <foo:object class="classy" id="thing"/>
193
+ # </objects>
194
+ # </root>
195
+ #
196
+ # Note the "foo:object" tag.
197
+ class Builder
198
+ # The current Document object being built
199
+ attr_accessor :doc
200
+
201
+ # The parent of the current node being built
202
+ attr_accessor :parent
203
+
204
+ # A context object for use when the block has no arguments
205
+ attr_accessor :context
206
+
207
+ attr_accessor :arity # :nodoc:
208
+
209
+ ###
210
+ # Create a builder with an existing root object. This is for use when
211
+ # you have an existing document that you would like to augment with
212
+ # builder methods. The builder context created will start with the
213
+ # given +root+ node.
214
+ #
215
+ # For example:
216
+ #
217
+ # doc = Nokogiri::XML(open('somedoc.xml'))
218
+ # Nokogiri::XML::Builder.with(doc.at('some_tag')) do |xml|
219
+ # # ... Use normal builder methods here ...
220
+ # xml.awesome # add the "awesome" tag below "some_tag"
221
+ # end
222
+ #
223
+ def self.with root, &block
224
+ builder = self.new({}, root, &block)
225
+ end
226
+
227
+ ###
228
+ # Create a new Builder object. +options+ are sent to the top level
229
+ # Document that is being built.
230
+ #
231
+ # Building a document with a particular encoding for example:
232
+ #
233
+ # Nokogiri::XML::Builder.new(:encoding => 'UTF-8') do |xml|
234
+ # ...
235
+ # end
236
+ def initialize options = {}, root = nil, &block
237
+
238
+ if root
239
+ @doc = root.document
240
+ @parent = root
241
+ else
242
+ namespace = self.class.name.split('::')
243
+ namespace[-1] = 'Document'
244
+ @doc = eval(namespace.join('::')).new
245
+ @parent = @doc
246
+ end
247
+
248
+ @context = nil
249
+ @arity = nil
250
+ @ns = nil
251
+
252
+ options.each do |k,v|
253
+ @doc.send(:"#{k}=", v)
254
+ end
255
+
256
+ return unless block_given?
257
+
258
+ @arity = block.arity
259
+ if @arity <= 0
260
+ @context = eval('self', block.binding)
261
+ instance_eval(&block)
262
+ else
263
+ yield self
264
+ end
265
+
266
+ @parent = @doc
267
+ end
268
+
269
+ ###
270
+ # Create a Text Node with content of +string+
271
+ def text string
272
+ insert @doc.create_text_node string
273
+ end
274
+
275
+ ###
276
+ # Create a CDATA Node with content of +string+
277
+ def cdata string
278
+ node = Nokogiri::XML::CDATA.new(@doc, string.to_s)
279
+ insert(node)
280
+ end
281
+
282
+ ###
283
+ # Build a tag that is associated with namespace +ns+. Raises an
284
+ # ArgumentError if +ns+ has not been defined higher in the tree.
285
+ def [] ns
286
+ @ns = @parent.namespace_definitions.find { |x| x.prefix == ns.to_s }
287
+ return self if @ns
288
+
289
+ @parent.ancestors.each do |a|
290
+ next if a == doc
291
+ @ns = a.namespace_definitions.find { |x| x.prefix == ns.to_s }
292
+ return self if @ns
293
+ end
294
+
295
+ raise ArgumentError, "Namespace #{ns} has not been defined"
296
+ end
297
+
298
+ ###
299
+ # Convert this Builder object to XML
300
+ def to_xml(*args)
301
+ @doc.to_xml(*args)
302
+ end
303
+
304
+ ###
305
+ # Append the given raw XML +string+ to the document
306
+ def << string
307
+ @doc.fragment(string).children.each { |x| insert(x) }
308
+ end
309
+
310
+ def method_missing method, *args, &block # :nodoc:
311
+ if @context && @context.respond_to?(method)
312
+ @context.send(method, *args, &block)
313
+ else
314
+ node = @doc.create_element(method.to_s.sub(/[_!]$/, '')) { |n|
315
+ # Set up the namespace
316
+ if @ns
317
+ n.namespace = @ns
318
+ @ns = nil
319
+ end
320
+
321
+ args.each do |arg|
322
+ case arg
323
+ when Hash
324
+ arg.each { |k,v|
325
+ key = k.to_s
326
+ if key =~ /^xmlns(:\w+)?$/
327
+ ns_name = key.split(":", 2)[1]
328
+ n.add_namespace_definition ns_name, v
329
+ next
330
+ end
331
+ n[k.to_s] = v.to_s
332
+ }
333
+ else
334
+ n.content = arg
335
+ end
336
+ end
337
+ }
338
+ insert(node, &block)
339
+ end
340
+ end
341
+
342
+ private
343
+ ###
344
+ # Insert +node+ as a child of the current Node
345
+ def insert(node, &block)
346
+ node.parent = @parent
347
+ if block_given?
348
+ @parent = node
349
+ @arity ||= block.arity
350
+ if @arity <= 0
351
+ instance_eval(&block)
352
+ else
353
+ block.call(self)
354
+ end
355
+ @parent = node.parent
356
+ end
357
+ NodeBuilder.new(node, self)
358
+ end
359
+
360
+ class NodeBuilder # :nodoc:
361
+ def initialize node, doc_builder
362
+ @node = node
363
+ @doc_builder = doc_builder
364
+ end
365
+
366
+ def []= k, v
367
+ @node[k] = v
368
+ end
369
+
370
+ def [] k
371
+ @node[k]
372
+ end
373
+
374
+ def method_missing(method, *args, &block)
375
+ opts = args.last.is_a?(Hash) ? args.pop : {}
376
+ case method.to_s
377
+ when /^(.*)!$/
378
+ @node['id'] = $1
379
+ @node.content = args.first if args.first
380
+ when /^(.*)=/
381
+ @node[$1] = args.first
382
+ else
383
+ @node['class'] =
384
+ ((@node['class'] || '').split(/\s/) + [method.to_s]).join(' ')
385
+ @node.content = args.first if args.first
386
+ end
387
+
388
+ # Assign any extra options
389
+ opts.each do |k,v|
390
+ @node[k.to_s] = ((@node[k.to_s] || '').split(/\s/) + [v]).join(' ')
391
+ end
392
+
393
+ if block_given?
394
+ old_parent = @doc_builder.parent
395
+ @doc_builder.parent = @node
396
+ value = @doc_builder.instance_eval(&block)
397
+ @doc_builder.parent = old_parent
398
+ return value
399
+ end
400
+ self
401
+ end
402
+ end
403
+ end
404
+ end
405
+ end