libxml-ruby 2.9.0-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (211) hide show
  1. checksums.yaml +7 -0
  2. data/HISTORY +790 -0
  3. data/LICENSE +21 -0
  4. data/MANIFEST +166 -0
  5. data/README.rdoc +184 -0
  6. data/Rakefile +81 -0
  7. data/ext/libxml/extconf.h +4 -0
  8. data/ext/libxml/extconf.rb +57 -0
  9. data/ext/libxml/libxml.c +80 -0
  10. data/ext/libxml/libxml_ruby.def +35 -0
  11. data/ext/libxml/ruby_libxml.h +75 -0
  12. data/ext/libxml/ruby_xml.c +977 -0
  13. data/ext/libxml/ruby_xml.h +20 -0
  14. data/ext/libxml/ruby_xml_attr.c +333 -0
  15. data/ext/libxml/ruby_xml_attr.h +12 -0
  16. data/ext/libxml/ruby_xml_attr_decl.c +153 -0
  17. data/ext/libxml/ruby_xml_attr_decl.h +11 -0
  18. data/ext/libxml/ruby_xml_attributes.c +275 -0
  19. data/ext/libxml/ruby_xml_attributes.h +15 -0
  20. data/ext/libxml/ruby_xml_cbg.c +85 -0
  21. data/ext/libxml/ruby_xml_document.c +1133 -0
  22. data/ext/libxml/ruby_xml_document.h +11 -0
  23. data/ext/libxml/ruby_xml_dtd.c +261 -0
  24. data/ext/libxml/ruby_xml_dtd.h +9 -0
  25. data/ext/libxml/ruby_xml_encoding.c +262 -0
  26. data/ext/libxml/ruby_xml_encoding.h +19 -0
  27. data/ext/libxml/ruby_xml_error.c +996 -0
  28. data/ext/libxml/ruby_xml_error.h +12 -0
  29. data/ext/libxml/ruby_xml_html_parser.c +92 -0
  30. data/ext/libxml/ruby_xml_html_parser.h +10 -0
  31. data/ext/libxml/ruby_xml_html_parser_context.c +337 -0
  32. data/ext/libxml/ruby_xml_html_parser_context.h +10 -0
  33. data/ext/libxml/ruby_xml_html_parser_options.c +46 -0
  34. data/ext/libxml/ruby_xml_html_parser_options.h +10 -0
  35. data/ext/libxml/ruby_xml_input_cbg.c +191 -0
  36. data/ext/libxml/ruby_xml_input_cbg.h +20 -0
  37. data/ext/libxml/ruby_xml_io.c +52 -0
  38. data/ext/libxml/ruby_xml_io.h +10 -0
  39. data/ext/libxml/ruby_xml_namespace.c +153 -0
  40. data/ext/libxml/ruby_xml_namespace.h +10 -0
  41. data/ext/libxml/ruby_xml_namespaces.c +293 -0
  42. data/ext/libxml/ruby_xml_namespaces.h +9 -0
  43. data/ext/libxml/ruby_xml_node.c +1446 -0
  44. data/ext/libxml/ruby_xml_node.h +11 -0
  45. data/ext/libxml/ruby_xml_parser.c +94 -0
  46. data/ext/libxml/ruby_xml_parser.h +12 -0
  47. data/ext/libxml/ruby_xml_parser_context.c +999 -0
  48. data/ext/libxml/ruby_xml_parser_context.h +10 -0
  49. data/ext/libxml/ruby_xml_parser_options.c +66 -0
  50. data/ext/libxml/ruby_xml_parser_options.h +12 -0
  51. data/ext/libxml/ruby_xml_reader.c +1226 -0
  52. data/ext/libxml/ruby_xml_reader.h +17 -0
  53. data/ext/libxml/ruby_xml_relaxng.c +110 -0
  54. data/ext/libxml/ruby_xml_relaxng.h +10 -0
  55. data/ext/libxml/ruby_xml_sax2_handler.c +326 -0
  56. data/ext/libxml/ruby_xml_sax2_handler.h +10 -0
  57. data/ext/libxml/ruby_xml_sax_parser.c +120 -0
  58. data/ext/libxml/ruby_xml_sax_parser.h +10 -0
  59. data/ext/libxml/ruby_xml_schema.c +300 -0
  60. data/ext/libxml/ruby_xml_schema.h +809 -0
  61. data/ext/libxml/ruby_xml_schema_attribute.c +109 -0
  62. data/ext/libxml/ruby_xml_schema_attribute.h +15 -0
  63. data/ext/libxml/ruby_xml_schema_element.c +94 -0
  64. data/ext/libxml/ruby_xml_schema_element.h +14 -0
  65. data/ext/libxml/ruby_xml_schema_facet.c +52 -0
  66. data/ext/libxml/ruby_xml_schema_facet.h +13 -0
  67. data/ext/libxml/ruby_xml_schema_type.c +259 -0
  68. data/ext/libxml/ruby_xml_schema_type.h +9 -0
  69. data/ext/libxml/ruby_xml_version.h +9 -0
  70. data/ext/libxml/ruby_xml_writer.c +1136 -0
  71. data/ext/libxml/ruby_xml_writer.h +10 -0
  72. data/ext/libxml/ruby_xml_xinclude.c +16 -0
  73. data/ext/libxml/ruby_xml_xinclude.h +11 -0
  74. data/ext/libxml/ruby_xml_xpath.c +188 -0
  75. data/ext/libxml/ruby_xml_xpath.h +13 -0
  76. data/ext/libxml/ruby_xml_xpath_context.c +360 -0
  77. data/ext/libxml/ruby_xml_xpath_context.h +9 -0
  78. data/ext/libxml/ruby_xml_xpath_expression.c +81 -0
  79. data/ext/libxml/ruby_xml_xpath_expression.h +10 -0
  80. data/ext/libxml/ruby_xml_xpath_object.c +335 -0
  81. data/ext/libxml/ruby_xml_xpath_object.h +17 -0
  82. data/ext/libxml/ruby_xml_xpointer.c +99 -0
  83. data/ext/libxml/ruby_xml_xpointer.h +11 -0
  84. data/ext/vc/libxml_ruby.sln +26 -0
  85. data/lib/2.3/libxml_ruby.so +0 -0
  86. data/lib/libs/libiconv-2.dll +0 -0
  87. data/lib/libs/libxml2-2.dll +0 -0
  88. data/lib/libs/zlib1.dll +0 -0
  89. data/lib/libxml.rb +35 -0
  90. data/lib/libxml/attr.rb +123 -0
  91. data/lib/libxml/attr_decl.rb +80 -0
  92. data/lib/libxml/attributes.rb +14 -0
  93. data/lib/libxml/document.rb +194 -0
  94. data/lib/libxml/error.rb +95 -0
  95. data/lib/libxml/hpricot.rb +78 -0
  96. data/lib/libxml/html_parser.rb +96 -0
  97. data/lib/libxml/namespace.rb +62 -0
  98. data/lib/libxml/namespaces.rb +38 -0
  99. data/lib/libxml/node.rb +399 -0
  100. data/lib/libxml/ns.rb +22 -0
  101. data/lib/libxml/parser.rb +367 -0
  102. data/lib/libxml/properties.rb +23 -0
  103. data/lib/libxml/reader.rb +29 -0
  104. data/lib/libxml/sax_callbacks.rb +180 -0
  105. data/lib/libxml/sax_parser.rb +58 -0
  106. data/lib/libxml/schema.rb +67 -0
  107. data/lib/libxml/schema/attribute.rb +19 -0
  108. data/lib/libxml/schema/element.rb +27 -0
  109. data/lib/libxml/schema/type.rb +29 -0
  110. data/lib/libxml/tree.rb +29 -0
  111. data/lib/libxml/xpath_object.rb +16 -0
  112. data/lib/xml.rb +14 -0
  113. data/lib/xml/libxml.rb +10 -0
  114. data/libxml-ruby.gemspec +47 -0
  115. data/script/benchmark/depixelate +634 -0
  116. data/script/benchmark/hamlet.xml +9055 -0
  117. data/script/benchmark/parsecount +170 -0
  118. data/script/benchmark/sock_entries.xml +507 -0
  119. data/script/benchmark/throughput +41 -0
  120. data/script/test +6 -0
  121. data/setup.rb +1585 -0
  122. data/test/c14n/given/doc.dtd +1 -0
  123. data/test/c14n/given/example-1.xml +14 -0
  124. data/test/c14n/given/example-2.xml +11 -0
  125. data/test/c14n/given/example-3.xml +18 -0
  126. data/test/c14n/given/example-4.xml +9 -0
  127. data/test/c14n/given/example-5.xml +12 -0
  128. data/test/c14n/given/example-6.xml +2 -0
  129. data/test/c14n/given/example-7.xml +11 -0
  130. data/test/c14n/given/example-8.xml +11 -0
  131. data/test/c14n/given/example-8.xpath +10 -0
  132. data/test/c14n/given/world.txt +1 -0
  133. data/test/c14n/result/1-1-without-comments/example-1 +4 -0
  134. data/test/c14n/result/1-1-without-comments/example-2 +11 -0
  135. data/test/c14n/result/1-1-without-comments/example-3 +14 -0
  136. data/test/c14n/result/1-1-without-comments/example-4 +9 -0
  137. data/test/c14n/result/1-1-without-comments/example-5 +3 -0
  138. data/test/c14n/result/1-1-without-comments/example-6 +1 -0
  139. data/test/c14n/result/1-1-without-comments/example-7 +1 -0
  140. data/test/c14n/result/1-1-without-comments/example-8 +1 -0
  141. data/test/c14n/result/with-comments/example-1 +6 -0
  142. data/test/c14n/result/with-comments/example-2 +11 -0
  143. data/test/c14n/result/with-comments/example-3 +14 -0
  144. data/test/c14n/result/with-comments/example-4 +9 -0
  145. data/test/c14n/result/with-comments/example-5 +4 -0
  146. data/test/c14n/result/with-comments/example-6 +1 -0
  147. data/test/c14n/result/with-comments/example-7 +1 -0
  148. data/test/c14n/result/without-comments/example-1 +4 -0
  149. data/test/c14n/result/without-comments/example-2 +11 -0
  150. data/test/c14n/result/without-comments/example-3 +14 -0
  151. data/test/c14n/result/without-comments/example-4 +9 -0
  152. data/test/c14n/result/without-comments/example-5 +3 -0
  153. data/test/c14n/result/without-comments/example-6 +1 -0
  154. data/test/c14n/result/without-comments/example-7 +1 -0
  155. data/test/model/atom.xml +13 -0
  156. data/test/model/bands.iso-8859-1.xml +5 -0
  157. data/test/model/bands.utf-8.xml +5 -0
  158. data/test/model/bands.xml +5 -0
  159. data/test/model/books.xml +154 -0
  160. data/test/model/merge_bug_data.xml +58 -0
  161. data/test/model/ruby-lang.html +238 -0
  162. data/test/model/rubynet.xml +79 -0
  163. data/test/model/rubynet_project +1 -0
  164. data/test/model/shiporder.rnc +28 -0
  165. data/test/model/shiporder.rng +86 -0
  166. data/test/model/shiporder.xml +23 -0
  167. data/test/model/shiporder.xsd +40 -0
  168. data/test/model/soap.xml +27 -0
  169. data/test/model/xinclude.xml +5 -0
  170. data/test/tc_attr.rb +181 -0
  171. data/test/tc_attr_decl.rb +132 -0
  172. data/test/tc_attributes.rb +142 -0
  173. data/test/tc_canonicalize.rb +124 -0
  174. data/test/tc_deprecated_require.rb +12 -0
  175. data/test/tc_document.rb +125 -0
  176. data/test/tc_document_write.rb +195 -0
  177. data/test/tc_dtd.rb +128 -0
  178. data/test/tc_encoding.rb +126 -0
  179. data/test/tc_encoding_sax.rb +115 -0
  180. data/test/tc_error.rb +179 -0
  181. data/test/tc_html_parser.rb +161 -0
  182. data/test/tc_html_parser_context.rb +23 -0
  183. data/test/tc_namespace.rb +61 -0
  184. data/test/tc_namespaces.rb +209 -0
  185. data/test/tc_node.rb +215 -0
  186. data/test/tc_node_cdata.rb +50 -0
  187. data/test/tc_node_comment.rb +32 -0
  188. data/test/tc_node_copy.rb +41 -0
  189. data/test/tc_node_edit.rb +174 -0
  190. data/test/tc_node_pi.rb +39 -0
  191. data/test/tc_node_text.rb +70 -0
  192. data/test/tc_node_write.rb +107 -0
  193. data/test/tc_node_xlink.rb +28 -0
  194. data/test/tc_parser.rb +375 -0
  195. data/test/tc_parser_context.rb +204 -0
  196. data/test/tc_properties.rb +38 -0
  197. data/test/tc_reader.rb +399 -0
  198. data/test/tc_relaxng.rb +53 -0
  199. data/test/tc_sax_parser.rb +319 -0
  200. data/test/tc_schema.rb +161 -0
  201. data/test/tc_traversal.rb +152 -0
  202. data/test/tc_writer.rb +447 -0
  203. data/test/tc_xinclude.rb +20 -0
  204. data/test/tc_xml.rb +225 -0
  205. data/test/tc_xpath.rb +244 -0
  206. data/test/tc_xpath_context.rb +88 -0
  207. data/test/tc_xpath_expression.rb +37 -0
  208. data/test/tc_xpointer.rb +72 -0
  209. data/test/test_helper.rb +16 -0
  210. data/test/test_suite.rb +49 -0
  211. metadata +344 -0
data/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ Copyright (c) 2008-2013 Charlie Savage and contributors
2
+ Copyright (c) 2002-2007 Sean Chittenden and contributors
3
+ Copyright (c) 2001 Wai-Sun "Squidster" Chia
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
6
+ this software and associated documentation files (the "Software"), to deal in
7
+ the Software without restriction, including without limitation the rights to
8
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
9
+ of the Software, and to permit persons to whom the Software is furnished to do
10
+ so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,166 @@
1
+ #!mast -x doc/libxml-ruby/rdoc -i .gitignore ext doc lib script test [A-Z]*
2
+ ext/libxml/extconf.rb
3
+ ext/libxml/libxml.c
4
+ ext/libxml/ruby_libxml.h
5
+ ext/libxml/ruby_xml.c
6
+ ext/libxml/ruby_xml.h
7
+ ext/libxml/ruby_xml_attr.c
8
+ ext/libxml/ruby_xml_attr.h
9
+ ext/libxml/ruby_xml_attr_decl.c
10
+ ext/libxml/ruby_xml_attr_decl.h
11
+ ext/libxml/ruby_xml_attributes.c
12
+ ext/libxml/ruby_xml_attributes.h
13
+ ext/libxml/ruby_xml_cbg.c
14
+ ext/libxml/ruby_xml_document.c
15
+ ext/libxml/ruby_xml_document.h
16
+ ext/libxml/ruby_xml_dtd.c
17
+ ext/libxml/ruby_xml_dtd.h
18
+ ext/libxml/ruby_xml_encoding.c
19
+ ext/libxml/ruby_xml_encoding.h
20
+ ext/libxml/ruby_xml_error.c
21
+ ext/libxml/ruby_xml_error.h
22
+ ext/libxml/ruby_xml_html_parser.c
23
+ ext/libxml/ruby_xml_html_parser.h
24
+ ext/libxml/ruby_xml_html_parser_context.c
25
+ ext/libxml/ruby_xml_html_parser_context.h
26
+ ext/libxml/ruby_xml_html_parser_options.c
27
+ ext/libxml/ruby_xml_html_parser_options.h
28
+ ext/libxml/ruby_xml_input_cbg.c
29
+ ext/libxml/ruby_xml_input_cbg.h
30
+ ext/libxml/ruby_xml_io.c
31
+ ext/libxml/ruby_xml_io.h
32
+ ext/libxml/ruby_xml_namespace.c
33
+ ext/libxml/ruby_xml_namespace.h
34
+ ext/libxml/ruby_xml_namespaces.c
35
+ ext/libxml/ruby_xml_namespaces.h
36
+ ext/libxml/ruby_xml_node.c
37
+ ext/libxml/ruby_xml_node.h
38
+ ext/libxml/ruby_xml_parser.c
39
+ ext/libxml/ruby_xml_parser.h
40
+ ext/libxml/ruby_xml_parser_context.c
41
+ ext/libxml/ruby_xml_parser_context.h
42
+ ext/libxml/ruby_xml_parser_options.c
43
+ ext/libxml/ruby_xml_parser_options.h
44
+ ext/libxml/ruby_xml_reader.c
45
+ ext/libxml/ruby_xml_reader.h
46
+ ext/libxml/ruby_xml_relaxng.c
47
+ ext/libxml/ruby_xml_relaxng.h
48
+ ext/libxml/ruby_xml_sax2_handler.c
49
+ ext/libxml/ruby_xml_sax2_handler.h
50
+ ext/libxml/ruby_xml_sax_parser.c
51
+ ext/libxml/ruby_xml_sax_parser.h
52
+ ext/libxml/ruby_xml_schema.c
53
+ ext/libxml/ruby_xml_schema.h
54
+ ext/libxml/ruby_xml_version.h
55
+ ext/libxml/ruby_xml_xinclude.c
56
+ ext/libxml/ruby_xml_xinclude.h
57
+ ext/libxml/ruby_xml_xpath.c
58
+ ext/libxml/ruby_xml_xpath.h
59
+ ext/libxml/ruby_xml_xpath_context.c
60
+ ext/libxml/ruby_xml_xpath_context.h
61
+ ext/libxml/ruby_xml_xpath_expression.c
62
+ ext/libxml/ruby_xml_xpath_expression.h
63
+ ext/libxml/ruby_xml_xpath_object.c
64
+ ext/libxml/ruby_xml_xpath_object.h
65
+ ext/libxml/ruby_xml_xpointer.c
66
+ ext/libxml/ruby_xml_xpointer.h
67
+ ext/mingw/Rakefile
68
+ ext/mingw/build.rake
69
+ ext/mingw/libiconv-2.dll
70
+ ext/mingw/libxml2-2.dll
71
+ ext/mingw/libxml_ruby.dll.a
72
+ ext/mingw/libxml_ruby.so
73
+ ext/vc/libxml_ruby.sln
74
+ ext/vc/libxml_ruby_18/libxml_ruby.vcproj
75
+ ext/vc/libxml_ruby_19/libxml_ruby_19.vcproj
76
+ doc/.htaccess
77
+ doc/.rsync-filter
78
+ lib/libxml/attr.rb
79
+ lib/libxml/attr_decl.rb
80
+ lib/libxml/attributes.rb
81
+ lib/libxml/document.rb
82
+ lib/libxml/error.rb
83
+ lib/libxml/hpricot.rb
84
+ lib/libxml/html_parser.rb
85
+ lib/libxml/namespace.rb
86
+ lib/libxml/namespaces.rb
87
+ lib/libxml/node.rb
88
+ lib/libxml/ns.rb
89
+ lib/libxml/parser.rb
90
+ lib/libxml/properties.rb
91
+ lib/libxml/reader.rb
92
+ lib/libxml/sax_callbacks.rb
93
+ lib/libxml/sax_parser.rb
94
+ lib/libxml/tree.rb
95
+ lib/libxml/xpath_object.rb
96
+ lib/libxml.rb
97
+ lib/xml/libxml.rb
98
+ lib/xml.rb
99
+ script/benchmark/depixelate
100
+ script/benchmark/hamlet.xml
101
+ script/benchmark/parsecount
102
+ script/benchmark/sock_entries.xml
103
+ script/benchmark/throughput
104
+ script/test
105
+ test/etc_doc_to_s.rb
106
+ test/ets_doc_file.rb
107
+ test/ets_doc_to_s.rb
108
+ test/ets_gpx.rb
109
+ test/ets_node_gc.rb
110
+ test/ets_test.xml
111
+ test/ets_tsr.rb
112
+ test/model/atom.xml
113
+ test/model/bands.xml
114
+ test/model/books.xml
115
+ test/model/merge_bug_data.xml
116
+ test/model/ruby-lang.html
117
+ test/model/rubynet.xml
118
+ test/model/rubynet_project
119
+ test/model/shiporder.rnc
120
+ test/model/shiporder.rng
121
+ test/model/shiporder.xml
122
+ test/model/shiporder.xsd
123
+ test/model/soap.xml
124
+ test/model/xinclude.xml
125
+ test/tc_attr.rb
126
+ test/tc_attr_decl.rb
127
+ test/tc_attributes.rb
128
+ test/tc_deprecated_require.rb
129
+ test/tc_document.rb
130
+ test/tc_document_write.rb
131
+ test/tc_dtd.rb
132
+ test/tc_error.rb
133
+ test/tc_html_parser.rb
134
+ test/tc_namespace.rb
135
+ test/tc_namespaces.rb
136
+ test/tc_node.rb
137
+ test/tc_node_cdata.rb
138
+ test/tc_node_comment.rb
139
+ test/tc_node_copy.rb
140
+ test/tc_node_edit.rb
141
+ test/tc_node_pi.rb
142
+ test/tc_node_text.rb
143
+ test/tc_node_write.rb
144
+ test/tc_node_xlink.rb
145
+ test/tc_parser.rb
146
+ test/tc_parser_context.rb
147
+ test/tc_properties.rb
148
+ test/tc_reader.rb
149
+ test/tc_relaxng.rb
150
+ test/tc_sax_parser.rb
151
+ test/tc_schema.rb
152
+ test/tc_traversal.rb
153
+ test/tc_xinclude.rb
154
+ test/tc_xml.rb
155
+ test/tc_xpath.rb
156
+ test/tc_xpath_context.rb
157
+ test/tc_xpath_expression.rb
158
+ test/tc_xpointer.rb
159
+ test/test_suite.rb
160
+ Rakefile
161
+ HISTORY.rdoc
162
+ PROFILE
163
+ TODO
164
+ LICENSE
165
+ README.rdoc
166
+ VERSION
@@ -0,0 +1,184 @@
1
+ = LibXML Ruby
2
+
3
+ == Overview
4
+ The libxml gem provides Ruby language bindings for GNOME's Libxml2
5
+ XML toolkit. It is free software, released under the MIT License.
6
+
7
+ We think libxml-ruby is the best XML library for Ruby because:
8
+
9
+ * Speed - Its much faster than REXML and Hpricot
10
+ * Features - It provides an amazing number of featues
11
+ * Conformance - It passes all 1800+ tests from the OASIS XML Tests Suite
12
+
13
+ == Requirements
14
+ libxml-ruby requires Ruby 1.8.4 or higher. It is dependent on
15
+ the following libraries to function properly:
16
+
17
+ * libm (math routines: very standard)
18
+ * libz (zlib)
19
+ * libiconv
20
+ * libxml2
21
+
22
+ If you are running Linux or Unix you'll need a C compiler so the
23
+ extension can be compiled when it is installed. If you are running
24
+ Windows, then install the Windows specific RubyGem which
25
+ includes an already built extension.
26
+
27
+ == INSTALLATION
28
+ The easiest way to install libxml-ruby is via Ruby Gems. To install:
29
+
30
+ <tt>gem install libxml-ruby</tt>
31
+
32
+ If you are running Windows, make sure to install the Win32 RubyGem
33
+ which includes prebuilt extensions for Ruby 1.8, 1.9 and 2.0 preview. These
34
+ extensions are built using MinGW64 and libxml2 version 2.9.3,
35
+ iconv version 1.14 and zlib version 1.2.8. Note these binaries
36
+ are available in the lib\libs directory. To use them, put them
37
+ someplace on your path.
38
+
39
+ The gem also includes a Microsoft VC++ 2012 solution (useful for debugging).
40
+
41
+ libxml-ruby's source codes lives on Github at https://github.com/xml4r/libxml-ruby.
42
+
43
+ == Getting Started
44
+ Using libxml is easy. First decide what parser you want to use:
45
+
46
+ * Generally you'll want to use the LibXML::XML::Parser which provides a tree based API.
47
+ * For larger documents that don't fit into memory, or if you prefer an input based API, use the LibXML::XML::Reader.
48
+ * To parse HTML files use LibXML::XML::HTMLParser.
49
+ * If you are masochistic, then use the LibXML::XML::SaxParser, which provides a callback API.
50
+
51
+ Once you have chosen a parser, choose a datasource. Libxml can parse files, strings, URIs
52
+ and IO streams. For each data source you can specify an LibXML::XML::Encoding, a base uri and
53
+ various parser options. For more information, refer the LibXML::XML::Parser.document,
54
+ LibXML::XML::Parser.file, LibXML::XML::Parser.io or LibXML:::XML::Parser.string methods (the
55
+ same methods are defined on all four parser classes).
56
+
57
+ == Advanced Functionality
58
+ Beyond the basics of parsing and processing XML and HTML documents,
59
+ libxml provides a wealth of additional functionality.
60
+
61
+ Most commonly, you'll want to use its LibXML::XML::XPath support, which makes
62
+ it easy to find data inside a XML document. Although not as popular,
63
+ LibXML::XML::XPointer provides another API for finding data inside an XML document.
64
+
65
+ Often times you'll need to validate data before processing it. For example,
66
+ if you accept user generated content submitted over the Web, you'll
67
+ want to verify that it does not contain malicious code such as embedded scripts.
68
+ This can be done using libxml's powerful set of validators:
69
+
70
+ * DTDs (LibXML::XML::Dtd)
71
+ * Relax Schemas (LibXML::XML::RelaxNG)
72
+ * XML Schema (LibXML::XML::Schema)
73
+
74
+ Finally, if you'd like to use XSL Transformations to process data,
75
+ then install the libxslt gem which is available at
76
+ https://github.com/xml4r/libxslt-ruby.
77
+
78
+ == Usage
79
+ For information about using libxml-ruby please refer to its documentation at
80
+ http://xml4r.github.com/libxml-ruby/rdoc/index.html. Some tutorials are also
81
+ available at https://github.com/xml4r/libxml-ruby/wiki.
82
+
83
+ All libxml classes are in the LibXML::XML module. The easiest
84
+ way to use libxml is to require 'xml'. This will mixin
85
+ the LibXML module into the global namespace, allowing you to
86
+ write code like this:
87
+
88
+ require 'xml'
89
+ document = XML::Document.new
90
+
91
+ However, when creating an application or library you plan to
92
+ redistribute, it is best to not add the LibXML module to the global
93
+ namespace, in which case you can either write your code like this:
94
+
95
+ require 'libxml'
96
+ document = LibXML::XML::Document.new
97
+
98
+ Or you can utilize a namespace for your own work and include LibXML into it.
99
+ For example:
100
+
101
+ require 'libxml'
102
+
103
+ module MyApplication
104
+ include LibXML
105
+
106
+ class MyClass
107
+ def some_method
108
+ document = XML::Document.new
109
+ end
110
+ end
111
+ end
112
+
113
+ For simplicity's sake, the documentation uses the xml module in its examples.
114
+
115
+ == Memory Management
116
+ libxml-ruby automatically manages memory associated with the
117
+ underlying libxml2 library. There is however one corner case that
118
+ your code must handle. If a node is imported into a document, but not
119
+ added to the document, a segmentation fault may occur on program termination.
120
+
121
+ # Do NOT do this
122
+ require 'xml'
123
+ doc1 = XML::Document.string("test1")
124
+ doc2 = XML::Document.string("test2")
125
+ node = doc2.import(doc1.root)
126
+
127
+ If doc2 is freed before the node a segmentation fault will occur since
128
+ the node references the document. To avoid this, simply make sure to add the
129
+ node to the document:
130
+
131
+ # DO this instead
132
+ doc1 = XML::Document.string("test1")
133
+ doc2 = XML::Document.string("test2")
134
+ doc2.root << doc2.import(doc1.root)
135
+
136
+ Alternatively, you can call node.remove! to disassociate the node from doc2.
137
+
138
+ == Threading
139
+ libxml-ruby fully supports native, background Ruby threads. This of course
140
+ only applies to Ruby 1.9.x and higher since earlier versions of Ruby do not
141
+ support native threads.
142
+
143
+ == Performance
144
+ In addition to being feature rich and conformation, the main reason
145
+ people use libxml-ruby is for performance. Here are the results
146
+ of a couple simple benchmarks recently blogged about on the
147
+ Web (you can find them in the benchmark directory of the
148
+ libxml distribution).
149
+
150
+ From http://depixelate.com/2008/4/23/ruby-xml-parsing-benchmarks
151
+
152
+ user system total real
153
+ libxml 0.032000 0.000000 0.032000 ( 0.031000)
154
+ Hpricot 0.640000 0.031000 0.671000 ( 0.890000)
155
+ REXML 1.813000 0.047000 1.860000 ( 2.031000)
156
+
157
+ From https://svn.concord.org/svn/projects/trunk/common/ruby/xml_benchmarks/
158
+
159
+ user system total real
160
+ libxml 0.641000 0.031000 0.672000 ( 0.672000)
161
+ hpricot 5.359000 0.062000 5.421000 ( 5.516000)
162
+ rexml 22.859000 0.047000 22.906000 ( 23.203000)
163
+
164
+
165
+ == Documentation
166
+ Documentation is available via rdoc, and is installed automatically with the
167
+ gem.
168
+
169
+ libxml-ruby's online documentation is generated using Hanna, which is a
170
+ development gem dependency.
171
+
172
+ Note that older versions of Rdoc, which ship with Ruby 1.8.x, will report
173
+ a number of errors. To avoid them, install Rdoc 2.1 or higher. Once you have
174
+ installed the gem, you'll have to disable the version of Rdoc that Ruby 1.8.x
175
+ includes. An easy way to do that is rename the directory ruby/lib/ruby/1.8/rdoc to
176
+ ruby/lib/ruby/1.8/rdoc_old.
177
+
178
+ == Support
179
+
180
+ If you have any questions about using libxml-ruby, please report them to
181
+ Git Hub at https://github.com/xml4r/libxml-ruby/issues
182
+
183
+ == License
184
+ See LICENSE for license information.
@@ -0,0 +1,81 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require "rubygems"
4
+ require "rake/extensiontask"
5
+ require "rake/testtask"
6
+ require "rubygems/package_task"
7
+ require "rdoc/task"
8
+ require "yaml"
9
+
10
+ GEM_NAME = "libxml-ruby"
11
+ SO_NAME = "libxml_ruby"
12
+
13
+ # Read the spec file
14
+ spec = Gem::Specification.load("#{GEM_NAME}.gemspec")
15
+
16
+ task :default => [:test]
17
+
18
+ # Setup compile tasks
19
+ Rake::ExtensionTask.new do |ext|
20
+ ext.gem_spec = spec
21
+ ext.name = SO_NAME
22
+ ext.ext_dir = "ext/libxml"
23
+ ext.lib_dir = "lib/#{RUBY_VERSION.sub(/\.\d$/, '')}"
24
+ ext.config_options << "--with-xml2-include=C:/msys64/mingw64/include/libxml2"
25
+ ext.config_options << "--with-zlib-dir=C:/msys64/mingw64"
26
+ end
27
+
28
+ # Setup generic gem
29
+ Gem::PackageTask.new(spec) do |pkg|
30
+ pkg.package_dir = 'pkg'
31
+ pkg.need_tar = false
32
+ end
33
+
34
+ # Setup Windows Gem
35
+ if RUBY_PLATFORM.match(/win32|mingw32/)
36
+ binaries = (FileList['lib/**/*.so',
37
+ 'lib/**/*dll'])
38
+
39
+ # Windows specification
40
+ win_spec = spec.clone
41
+ win_spec.platform = Gem::Platform::CURRENT
42
+ win_spec.files += binaries.to_a
43
+ win_spec.instance_variable_set(:@cache_file, nil)
44
+
45
+ # Unset extensions
46
+ win_spec.extensions = nil
47
+
48
+ # Rake task to build the windows package
49
+ Gem::PackageTask.new(win_spec) do |pkg|
50
+ pkg.package_dir = 'pkg'
51
+ pkg.need_tar = false
52
+ end
53
+ end
54
+
55
+ # RDoc Task
56
+ desc 'Generate rdoc documentation'
57
+ RDoc::Task.new("rdoc") do |rdoc|
58
+ rdoc.rdoc_dir = 'website/_site/rdoc'
59
+ rdoc.title = 'LibXML'
60
+ rdoc.generator = 'hanna'
61
+
62
+ # Show source inline with line numbers
63
+ rdoc.options << '--line-numbers'
64
+ rdoc.options << '--charset=utf-8'
65
+ # Make the readme file the start page for the generated html
66
+ rdoc.main = 'README.rdoc'
67
+ rdoc.rdoc_files.include('doc/*.rdoc',
68
+ 'ext/**/libxml.c',
69
+ 'ext/**/ruby_xml.c',
70
+ 'ext/**/*.c',
71
+ 'lib/**/*.rb',
72
+ 'README.rdoc',
73
+ 'HISTORY',
74
+ 'LICENSE')
75
+ end
76
+
77
+ # Test Task
78
+ Rake::TestTask.new do |t|
79
+ t.libs << "test"
80
+ t.verbose = true
81
+ end