libxml-ruby 0.9.4 → 0.9.5

data/ext/libxml/ruby_xml_state.c

@@ -7,36 +7,34 @@ VALUE LIBXML_STATE = Qnil;
 
 static int dummy = 0;
 
-static void
-rxml_state_free(int dummy) {
+static void rxml_state_free(int dummy)
+{
   xmlCleanupParser();
   LIBXML_STATE = Qnil;
 }
 
-static VALUE
-rxml_state_alloc(VALUE klass) {
-  #ifdef DEBUG
+static VALUE rxml_state_alloc(VALUE klass)
+{
+#ifdef DEBUG
   fprintf(stderr, "Allocating state");
-  #endif
-  
+#endif
+
   xmlInitParser();
-  
-  return Data_Wrap_Struct(cXMLState,
-			  NULL, rxml_state_free,
-			  &dummy);
+
+  return Data_Wrap_Struct(cXMLState, NULL, rxml_state_free, &dummy);
 }
 
-// Rdoc needs to know 
+// Rdoc needs to know
 #ifdef RDOC_NEVER_DEFINED
-  mLibXML = rb_define_module("LibXML");
-  mXML = rb_define_module_under(mLibXML, "XML");
+mLibXML = rb_define_module("LibXML");
+mXML = rb_define_module_under(mLibXML, "XML");
 #endif
 
-void
-ruby_init_state(void) {	
+void ruby_init_state(void)
+{
   VALUE rb_mSingleton;
   cXMLState = rb_define_class_under(mXML, "State", rb_cObject);
-  
+
   /* Mixin singleton so only one xml state object can be created. */
   rb_require("singleton");
   rb_mSingleton = rb_const_get(rb_cObject, rb_intern("Singleton"));
@@ -45,9 +43,9 @@ ruby_init_state(void) {
   rb_define_alloc_func(cXMLState, rxml_state_alloc);
 
   /* Create one instance of the state object that is used
-     to initalize and cleanup libxml. Then register it with
-     the garbage collector so its not freed until the process
-     exists.*/
+   to initalize and cleanup libxml. Then register it with
+   the garbage collector so its not freed until the process
+   exists.*/
   LIBXML_STATE = rb_class_new_instance(0, NULL, cXMLState);
-  rb_global_variable(&LIBXML_STATE);  
+  rb_global_variable(&LIBXML_STATE);
 }

data/ext/libxml/ruby_xml_xinclude.c

@@ -1,25 +1,24 @@
-/* $Id: rxml_xinclude.c 566 2008-11-18 06:53:36Z cfis $ */
-
-#include "ruby_libxml.h"
-#include "ruby_xml_xinclude.h"
-
-VALUE cXMLXInclude;
-
-/*
-* Document-class: LibXML::XML::XInclude
-*
-* The ruby bindings do not currently expose libxml's 
-* XInclude fuctionality.
-*/
-
-
-// Rdoc needs to know 
-#ifdef RDOC_NEVER_DEFINED
-  mLibXML = rb_define_module("LibXML");
-  mXML = rb_define_module_under(mLibXML, "XML");
-#endif
-
-void
-ruby_init_xml_xinclude(void) {
-  cXMLXInclude = rb_define_class_under(mXML, "XInclude", rb_cObject);
-}
+/* $Id: ruby_xml_xinclude.c 650 2008-11-30 03:40:22Z cfis $ */
+
+#include "ruby_libxml.h"
+#include "ruby_xml_xinclude.h"
+
+VALUE cXMLXInclude;
+
+/*
+ * Document-class: LibXML::XML::XInclude
+ *
+ * The ruby bindings do not currently expose libxml's
+ * XInclude fuctionality.
+ */
+
+// Rdoc needs to know
+#ifdef RDOC_NEVER_DEFINED
+mLibXML = rb_define_module("LibXML");
+mXML = rb_define_module_under(mLibXML, "XML");
+#endif
+
+void ruby_init_xml_xinclude(void)
+{
+  cXMLXInclude = rb_define_class_under(mXML, "XInclude", rb_cObject);
+}

data/ext/libxml/ruby_xml_xpath.c

@@ -1,108 +1,108 @@
-/* $Id: rxml_xpath.c 566 2008-11-18 06:53:36Z cfis $ */
-
-/* Please see the LICENSE file for copyright and distribution information */
-
-#include "ruby_libxml.h"
-#include "ruby_xml_xpath.h"
-#include "ruby_xml_xpath_context.h"
-
-/*
- * Document-class: LibXML::XML::XPath
- * 
- * The XML::XPath module is used to query XML documents. It is 
- * usually accessed via the XML::Document#find or 
- * XML::Node#find methods.  For example:
- *
- *  document.find('/foo', namespaces) -> XML::XPath::Object
- *
- * The optional namespaces parameter can be a string, array or
- * hash table.
- *
- *   document.find('/foo', 'xlink:http://www.w3.org/1999/xlink')
- *   document.find('/foo', ['xlink:http://www.w3.org/1999/xlink',
- *                          'xi:http://www.w3.org/2001/XInclude')
- *   document.find('/foo', 'xlink' => 'http://www.w3.org/1999/xlink',
- *                             'xi' => 'http://www.w3.org/2001/XInclude')
- *
- *
- * === Working With Default Namespaces
- *
- * Finding namespaced elements and attributes can be tricky.  
- * Lets work through an example of a document with a default
- * namespace:
- *
- *  <?xml version="1.0" encoding="utf-8"?>
- *  <feed xmlns="http://www.w3.org/2005/Atom">
- *    <title type="text">Phil Bogle's Contacts</title>
- *  </feed>
- *
- * To find nodes you must define the atom namespace for
- * libxml.  One way to do this is:
- *
- *   node = doc.find('atom:title', 'atom:http://www.w3.org/2005/Atom')
- *
- * Alternatively, you can register the default namespace like this:
- *
- *   doc.root.register_default_namespace('atom')
- *   node = doc.find('atom:title')
- *
- * === More Complex Namespace Examples
- *
- * Lets work through some more complex examples using the 
- * following xml document:
- *
- *  <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
- *    <soap:Body>
- *      <getManufacturerNamesResponse xmlns="http://services.somewhere.com">
- *        <IDAndNameList xmlns="http://services.somewhere.com">
- *          <ns1:IdAndName xmlns:ns1="http://domain.somewhere.com"/>
- *        </IDAndNameList>
- *      </getManufacturerNamesResponse>
- *  </soap:Envelope>
- *
- *  # Since the soap namespace is defined on the root 
- *  # node we can directly use it.
- *  doc.find('/soap:Envelope')
- *
- *  # Since the ns1 namespace is not defined on the root node
- *  # we have to first register it with the xpath engine.
- *  doc.find('//ns1:IdAndName', 
- *           'ns1:http://domain.somewhere.com')
- *             
- *  # Since the getManufacturerNamesResponse element uses a default 
- *  # namespace we first have to give it a prefix and register
- *  # it with the xpath engine.
- *  doc.find('//ns:getManufacturerNamesResponse', 
- *            'ns:http://services.somewhere.com')
- *
- *  # Here is an example showing a complex namespace aware
- *  # xpath expression.
- *  doc.find('/soap:Envelope/soap:Body/ns0:getManufacturerNamesResponse/ns0:IDAndNameList/ns1:IdAndName', 
-             ['ns0:http://services.somewhere.com', 'ns1:http://domain.somewhere.com'])
- */
-
-VALUE mXPath;
-
-// Rdoc needs to know 
-#ifdef RDOC_NEVER_DEFINED
-  mLibXML = rb_define_module("LibXML");
-  mXML = rb_define_module_under(mLibXML, "XML");
-#endif
-
-void
-ruby_init_xml_xpath(void) {
-  mXPath = rb_define_module_under(mXML, "XPath");
-
-  rb_define_const(mXPath, "UNDEFINED", INT2NUM(XPATH_UNDEFINED));
-  rb_define_const(mXPath, "NODESET", INT2NUM(XPATH_NODESET));
-  rb_define_const(mXPath, "BOOLEAN", INT2NUM(XPATH_BOOLEAN));
-  rb_define_const(mXPath, "NUMBER", INT2NUM(XPATH_NUMBER));
-  rb_define_const(mXPath, "STRING", INT2NUM(XPATH_STRING));
-  rb_define_const(mXPath, "POINT", INT2NUM(XPATH_POINT));
-  rb_define_const(mXPath, "RANGE", INT2NUM(XPATH_RANGE));
-  rb_define_const(mXPath, "LOCATIONSET", INT2NUM(XPATH_LOCATIONSET));
-  rb_define_const(mXPath, "USERS", INT2NUM(XPATH_USERS));
-  rb_define_const(mXPath, "XSLT_TREE", INT2NUM(XPATH_XSLT_TREE));
-
-  ruby_init_xml_xpath_object();
-}
+/* $Id: ruby_xml_xpath.c 650 2008-11-30 03:40:22Z cfis $ */
+
+/* Please see the LICENSE file for copyright and distribution information */
+
+#include "ruby_libxml.h"
+#include "ruby_xml_xpath.h"
+#include "ruby_xml_xpath_context.h"
+
+/*
+ * Document-class: LibXML::XML::XPath
+ *
+ * The XML::XPath module is used to query XML documents. It is
+ * usually accessed via the XML::Document#find or
+ * XML::Node#find methods.  For example:
+ *
+ *  document.find('/foo', namespaces) -> XML::XPath::Object
+ *
+ * The optional namespaces parameter can be a string, array or
+ * hash table.
+ *
+ *   document.find('/foo', 'xlink:http://www.w3.org/1999/xlink')
+ *   document.find('/foo', ['xlink:http://www.w3.org/1999/xlink',
+ *                          'xi:http://www.w3.org/2001/XInclude')
+ *   document.find('/foo', 'xlink' => 'http://www.w3.org/1999/xlink',
+ *                             'xi' => 'http://www.w3.org/2001/XInclude')
+ *
+ *
+ * === Working With Default Namespaces
+ *
+ * Finding namespaced elements and attributes can be tricky.
+ * Lets work through an example of a document with a default
+ * namespace:
+ *
+ *  <?xml version="1.0" encoding="utf-8"?>
+ *  <feed xmlns="http://www.w3.org/2005/Atom">
+ *    <title type="text">Phil Bogle's Contacts</title>
+ *  </feed>
+ *
+ * To find nodes you must define the atom namespace for
+ * libxml.  One way to do this is:
+ *
+ *   node = doc.find('atom:title', 'atom:http://www.w3.org/2005/Atom')
+ *
+ * Alternatively, you can register the default namespace like this:
+ *
+ *   doc.root.register_default_namespace('atom')
+ *   node = doc.find('atom:title')
+ *
+ * === More Complex Namespace Examples
+ *
+ * Lets work through some more complex examples using the
+ * following xml document:
+ *
+ *  <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+ *    <soap:Body>
+ *      <getManufacturerNamesResponse xmlns="http://services.somewhere.com">
+ *        <IDAndNameList xmlns="http://services.somewhere.com">
+ *          <ns1:IdAndName xmlns:ns1="http://domain.somewhere.com"/>
+ *        </IDAndNameList>
+ *      </getManufacturerNamesResponse>
+ *  </soap:Envelope>
+ *
+ *  # Since the soap namespace is defined on the root
+ *  # node we can directly use it.
+ *  doc.find('/soap:Envelope')
+ *
+ *  # Since the ns1 namespace is not defined on the root node
+ *  # we have to first register it with the xpath engine.
+ *  doc.find('//ns1:IdAndName',
+ *           'ns1:http://domain.somewhere.com')
+ *
+ *  # Since the getManufacturerNamesResponse element uses a default
+ *  # namespace we first have to give it a prefix and register
+ *  # it with the xpath engine.
+ *  doc.find('//ns:getManufacturerNamesResponse',
+ *            'ns:http://services.somewhere.com')
+ *
+ *  # Here is an example showing a complex namespace aware
+ *  # xpath expression.
+ *  doc.find('/soap:Envelope/soap:Body/ns0:getManufacturerNamesResponse/ns0:IDAndNameList/ns1:IdAndName',
+ ['ns0:http://services.somewhere.com', 'ns1:http://domain.somewhere.com'])
+ */
+
+VALUE mXPath;
+
+// Rdoc needs to know
+#ifdef RDOC_NEVER_DEFINED
+mLibXML = rb_define_module("LibXML");
+mXML = rb_define_module_under(mLibXML, "XML");
+#endif
+
+void ruby_init_xml_xpath(void)
+{
+  mXPath = rb_define_module_under(mXML, "XPath");
+
+  rb_define_const(mXPath, "UNDEFINED", INT2NUM(XPATH_UNDEFINED));
+  rb_define_const(mXPath, "NODESET", INT2NUM(XPATH_NODESET));
+  rb_define_const(mXPath, "BOOLEAN", INT2NUM(XPATH_BOOLEAN));
+  rb_define_const(mXPath, "NUMBER", INT2NUM(XPATH_NUMBER));
+  rb_define_const(mXPath, "STRING", INT2NUM(XPATH_STRING));
+  rb_define_const(mXPath, "POINT", INT2NUM(XPATH_POINT));
+  rb_define_const(mXPath, "RANGE", INT2NUM(XPATH_RANGE));
+  rb_define_const(mXPath, "LOCATIONSET", INT2NUM(XPATH_LOCATIONSET));
+  rb_define_const(mXPath, "USERS", INT2NUM(XPATH_USERS));
+  rb_define_const(mXPath, "XSLT_TREE", INT2NUM(XPATH_XSLT_TREE));
+
+  ruby_init_xml_xpath_object();
+}

data/ext/libxml/ruby_xml_xpath_context.c

@@ -1,293 +1,305 @@
-/* $Id: ruby_xml_xpath_context.c 612 2008-11-21 08:01:29Z cfis $ */
-
-/* Please see the LICENSE file for copyright and distribution information */
-
-#include "ruby_libxml.h"
-#include "ruby_xml_xpath_context.h"
-#include "ruby_xml_xpath_expression.h"
-#include <st.h>
-
-
-/*
- * Document-class: LibXML::XML::XPath::Context
- * 
- * The XML::XPath::Context class is used to evaluate XPath
- * expressions.  Generally, you should not directly use this class,
- * but instead use the XML::Document#find and XML::Node#find methods.
- *
- *  doc = XML::Document.string('<header>content</header>')
- *  context = XPath::Context.new(doc)
- *  context.node = doc.root  
- *  context.register_namespaces_from_node(doc.root)
- *  nodes = context.find('/header')
- */
-
-VALUE cXMLXPathContext;
-
-static void
-rxml_xpath_context_free(xmlXPathContextPtr ctxt) {
-  xmlXPathFreeContext(ctxt);
-}
-
-
-static VALUE
-rxml_xpath_context_alloc(VALUE klass) {
-  return Data_Wrap_Struct(cXMLXPathContext,
-			  NULL,
-			  rxml_xpath_context_free,
-			  NULL);
-}
-
-/* call-seq:
- *    XPath::Context.new(node) -> XPath::Context
- * 
- * Creates a new XPath context for the specified document.  The
- * context can then be used to evaluate an XPath expression.
- *
- *  doc = XML::Document.string('<header><first>hi</first></header>')
- *  context = XPath::Context.new(doc)
- *  nodes = XPath::Object.new('//first', context)
- *  nodes.length == 1
- */
-static VALUE
-rxml_xpath_context_initialize(VALUE self, VALUE node) {
-  xmlDocPtr xdoc;
-  VALUE document;
-  #ifndef LIBXML_XPATH_ENABLED
-  rb_raise(rb_eTypeError, "libxml was not compiled with XPath support.");
-  #endif
-
-  if (rb_obj_is_kind_of(node, cXMLNode) == Qtrue)
-  {
-    document = rb_funcall(node, rb_intern("doc"), 0);
-    if NIL_P(document)
-      rb_raise(rb_eTypeError, "Supplied node must belong to a document.");
-  }
-  else if (rb_obj_is_kind_of(node, cXMLDocument) == Qtrue)
-  {
-    document = node;
-  }
-  else
-  {
-    rb_raise(rb_eTypeError, "Supplied argument must be a document or node.");
-  }
-  
-  Data_Get_Struct(document, xmlDoc, xdoc);
-  DATA_PTR(self) = xmlXPathNewContext(xdoc);
-  
-  /* Save the doc as an attribute, this will expose it to Ruby's GC. */
-  rb_iv_set(self, "@doc", document);    
-
-  return self;
-}
-
-
-/*
- * call-seq:
- *    context.register_namespace(prefix, uri) -> (true|false)
- * 
- * Register the specified namespace URI with the specified prefix
- * in this context.
- 
- *   context.register_namespace('xi', 'http://www.w3.org/2001/XInclude')
- */
-static VALUE
-rxml_xpath_context_register_namespace(VALUE self, VALUE prefix, VALUE uri) {
-  xmlXPathContextPtr ctxt;
-
-  Data_Get_Struct(self, xmlXPathContext, ctxt);
-  if (xmlXPathRegisterNs(ctxt, 
-                         (xmlChar*)StringValuePtr(prefix), 
-                         (xmlChar*)StringValuePtr(uri))
-      == 0) {
-    return(Qtrue);
-  } else {
-    /* Should raise an exception, IMHO (whose?, why shouldnt it? -danj)*/
-    rb_warning("register namespace failed");
-    return(Qfalse);
-  }
-}
-
-/* call-seq:
- *    context.register_namespaces_from_node(node) -> self
- * 
- * Helper method to read in namespaces defined on a node.
- *
- *  doc = XML::Document.string('<header><first>hi</first></header>')
- *  context = XPath::Context.new(doc)
- *  context.register_namespaces_from_node(doc.root)
- */
-static VALUE
-rxml_xpath_context_register_namespaces_from_node(VALUE self, VALUE node) {
-  xmlXPathContextPtr xctxt;
-  xmlNodePtr xnode;
-  xmlNsPtr *xnsArr;
-
-  Data_Get_Struct(self, xmlXPathContext, xctxt);
-  
-  if (rb_obj_is_kind_of(node, cXMLDocument) == Qtrue)
-  {
-    xmlDocPtr xdoc;
-    Data_Get_Struct(node, xmlDoc, xdoc);
-    xnode = xmlDocGetRootElement(xdoc);
-  }
-  else if (rb_obj_is_kind_of(node, cXMLNode) == Qtrue)
-  {
-    Data_Get_Struct(node, xmlNode, xnode);
-  }
-  else
-  {
-    rb_raise(rb_eTypeError, "The first argument must be a document or node.");
-  } 
-  
-  xnsArr = xmlGetNsList(xnode->doc, xnode);
-  
-  if (xnsArr)
-  {
-    xmlNsPtr xns = *xnsArr;
-    
-    while (xns) {
-      /* If there is no prefix, then this is the default namespace.
-         Skip it for now. */
-      if (xns->prefix)
-      {
-        VALUE prefix = rb_str_new2(xns->prefix);
-        VALUE uri = rb_str_new2(xns->href);
-        rxml_xpath_context_register_namespace(self, prefix, uri);
-      }
-      xns = xns->next;
-    }
-    xmlFree(xnsArr);
-  }
-    
-  return self;
-}
-
-static int
-iterate_ns_hash(st_data_t prefix, st_data_t uri, st_data_t self)
-{
-  rxml_xpath_context_register_namespace(self, prefix, uri);
-  return ST_CONTINUE;
-}
-
-
-/*
- * call-seq:
- *    context.register_namespaces(["prefix:uri"]) -> self
- * 
- * Register the specified namespaces in this context.
- *
- *   context.register_namespaces('xi:http://www.w3.org/2001/XInclude')
- *   context.register_namespaces(['xlink:http://www.w3.org/1999/xlink',
- *                                'xi:http://www.w3.org/2001/XInclude')
- *   context.register_namespaces('xlink' => 'http://www.w3.org/1999/xlink',
- *                                  'xi' => 'http://www.w3.org/2001/XInclude')
- */
-static VALUE
-rxml_xpath_context_register_namespaces(VALUE self, VALUE nslist) {
-  char *cp;
-  long i;
-  VALUE rprefix, ruri;
-
-  /* Need to loop through the 2nd argument and iterate through the
-   * list of namespaces that we want to allow */
-  switch (TYPE(nslist)) {
-  case T_STRING:
-    cp = strchr(StringValuePtr(nslist), (int)':');
-    if (cp == NULL) {
-      rprefix = nslist;
-      ruri = Qnil;
-    } else {
-      rprefix = rb_str_new(StringValuePtr(nslist), (int)((long)cp - (long)StringValuePtr(nslist)));
-      ruri = rb_str_new2(&cp[1]);
-    }
-    /* Should test the results of this */
-    rxml_xpath_context_register_namespace(self, rprefix, ruri);
-    break;
-  case T_ARRAY:
-    for (i = 0; i < RARRAY(nslist)->len; i++) {
-      rxml_xpath_context_register_namespaces(self, RARRAY(nslist)->ptr[i]);
-    }
-    break;
-  case T_HASH:
-    st_foreach(RHASH(nslist)->tbl, iterate_ns_hash, self);
-    break;
-  default:
-    rb_raise(rb_eArgError, "Invalid argument type, only accept string, array of strings, or an array of arrays");
-  }
-  return self;
-}
-
-/*
- * call-seq:
- *    context.node = node
- * 
- * Set the current node used by the XPath engine
- 
- *  doc = XML::Document.string('<header><first>hi</first></header>')
- *  context.node = doc.root.first
- */
-static VALUE
-rxml_xpath_context_node_set(VALUE self, VALUE node) {
-  xmlXPathContextPtr xctxt;
-  xmlNodePtr xnode;
-  
-  Data_Get_Struct(self, xmlXPathContext, xctxt);
-  Data_Get_Struct(node, xmlNode, xnode);
-  xctxt->node = xnode;
-  return node;
-}
-
-/*
- * call-seq:
- *    context.find("xpath") -> XML::XPath::Object
- * 
- * Find nodes matching the specified XPath expression
- */
-static VALUE
-rxml_xpath_context_find(VALUE self, VALUE xpath_expr) {
-  xmlXPathContextPtr xctxt;
-  xmlXPathObjectPtr xobject;
-  xmlXPathCompExprPtr xcompexpr;
-  VALUE result;
-
-  Data_Get_Struct(self, xmlXPathContext, xctxt);
-
-  if (TYPE(xpath_expr) == T_STRING) {
-    VALUE expression = rb_check_string_type(xpath_expr);
-	  xobject = xmlXPathEval((xmlChar*)StringValueCStr(expression), xctxt);  
-  }
-  else if (rb_obj_is_kind_of(xpath_expr, cXMLXPathExpression)) {
-	  Data_Get_Struct(xpath_expr, xmlXPathCompExpr, xcompexpr);
-	  xobject = xmlXPathCompiledEval(xcompexpr, xctxt);	
-  }
-  else {
-	  rb_raise(rb_eTypeError, "Argument should be an intance of a String or XPath::Expression");
-  }  
-  
-  if (xobject == NULL)
-  {
-    /* xmlLastError is different than xctxt->lastError.  Use 
-       xmlLastError since it has the message set while xctxt->lastError
-       does not. */
-    xmlErrorPtr xerror = xmlGetLastError();
-    rxml_raise(xerror);
-  }
-    
-  result = rxml_xpath_object_wrap(xobject);
-  rb_iv_set(result, "@context", self);
-  return result;  
-}
-
-void
-ruby_init_xml_xpath_context(void) {
-  cXMLXPathContext = rb_define_class_under(mXPath, "Context", rb_cObject);
-  rb_define_alloc_func(cXMLXPathContext, rxml_xpath_context_alloc);
-  rb_define_attr(cXMLXPathContext, "doc", 1, 0);
-  rb_define_method(cXMLXPathContext, "initialize", rxml_xpath_context_initialize, 1);
-  rb_define_method(cXMLXPathContext, "register_namespaces", rxml_xpath_context_register_namespaces, 1);
-  rb_define_method(cXMLXPathContext, "register_namespaces_from_node", rxml_xpath_context_register_namespaces_from_node, 1);
-  rb_define_method(cXMLXPathContext, "register_namespace", rxml_xpath_context_register_namespace, 2);
-  rb_define_method(cXMLXPathContext, "node=", rxml_xpath_context_node_set, 1);
-  rb_define_method(cXMLXPathContext, "find", rxml_xpath_context_find, 1);
-}
+/* $Id: ruby_xml_xpath_context.c 650 2008-11-30 03:40:22Z cfis $ */
+
+/* Please see the LICENSE file for copyright and distribution information */
+
+#include "ruby_libxml.h"
+#include "ruby_xml_xpath_context.h"
+#include "ruby_xml_xpath_expression.h"
+#include <st.h>
+
+/*
+ * Document-class: LibXML::XML::XPath::Context
+ *
+ * The XML::XPath::Context class is used to evaluate XPath
+ * expressions.  Generally, you should not directly use this class,
+ * but instead use the XML::Document#find and XML::Node#find methods.
+ *
+ *  doc = XML::Document.string('<header>content</header>')
+ *  context = XPath::Context.new(doc)
+ *  context.node = doc.root
+ *  context.register_namespaces_from_node(doc.root)
+ *  nodes = context.find('/header')
+ */
+
+VALUE cXMLXPathContext;
+
+static void rxml_xpath_context_free(xmlXPathContextPtr ctxt)
+{
+  xmlXPathFreeContext(ctxt);
+}
+
+static VALUE rxml_xpath_context_alloc(VALUE klass)
+{
+  return Data_Wrap_Struct(cXMLXPathContext, NULL, rxml_xpath_context_free, NULL);
+}
+
+/* call-seq:
+ *    XPath::Context.new(node) -> XPath::Context
+ *
+ * Creates a new XPath context for the specified document.  The
+ * context can then be used to evaluate an XPath expression.
+ *
+ *  doc = XML::Document.string('<header><first>hi</first></header>')
+ *  context = XPath::Context.new(doc)
+ *  nodes = XPath::Object.new('//first', context)
+ *  nodes.length == 1
+ */
+static VALUE rxml_xpath_context_initialize(VALUE self, VALUE node)
+{
+  xmlDocPtr xdoc;
+  VALUE document;
+#ifndef LIBXML_XPATH_ENABLED
+  rb_raise(rb_eTypeError, "libxml was not compiled with XPath support.");
+#endif
+
+  if (rb_obj_is_kind_of(node, cXMLNode) == Qtrue)
+  {
+    document = rb_funcall(node, rb_intern("doc"), 0);
+if  NIL_P(document)
+  rb_raise(rb_eTypeError, "Supplied node must belong to a document.");
+}
+else if (rb_obj_is_kind_of(node, cXMLDocument) == Qtrue)
+{
+  document = node;
+}
+else
+{
+  rb_raise(rb_eTypeError, "Supplied argument must be a document or node.");
+}
+
+Data_Get_Struct(document, xmlDoc, xdoc);
+DATA_PTR(self) = xmlXPathNewContext(xdoc);
+
+/* Save the doc as an attribute, this will expose it to Ruby's GC. */
+rb_iv_set(self, "@doc", document);
+
+return self;
+}
+
+/*
+ * call-seq:
+ *    context.register_namespace(prefix, uri) -> (true|false)
+ *
+ * Register the specified namespace URI with the specified prefix
+ * in this context.
+
+ *   context.register_namespace('xi', 'http://www.w3.org/2001/XInclude')
+ */
+static VALUE rxml_xpath_context_register_namespace(VALUE self, VALUE prefix,
+    VALUE uri)
+{
+  xmlXPathContextPtr ctxt;
+
+  Data_Get_Struct(self, xmlXPathContext, ctxt);
+  if (xmlXPathRegisterNs(ctxt, (xmlChar*) StringValuePtr(prefix),
+      (xmlChar*) StringValuePtr(uri)) == 0)
+  {
+    return (Qtrue);
+  }
+  else
+  {
+    /* Should raise an exception, IMHO (whose?, why shouldnt it? -danj)*/
+    rb_warning("register namespace failed");
+    return (Qfalse);
+  }
+}
+
+/* call-seq:
+ *    context.register_namespaces_from_node(node) -> self
+ *
+ * Helper method to read in namespaces defined on a node.
+ *
+ *  doc = XML::Document.string('<header><first>hi</first></header>')
+ *  context = XPath::Context.new(doc)
+ *  context.register_namespaces_from_node(doc.root)
+ */
+static VALUE rxml_xpath_context_register_namespaces_from_node(VALUE self,
+    VALUE node)
+{
+  xmlXPathContextPtr xctxt;
+  xmlNodePtr xnode;
+  xmlNsPtr *xnsArr;
+
+  Data_Get_Struct(self, xmlXPathContext, xctxt);
+
+  if (rb_obj_is_kind_of(node, cXMLDocument) == Qtrue)
+  {
+    xmlDocPtr xdoc;
+    Data_Get_Struct(node, xmlDoc, xdoc);
+    xnode = xmlDocGetRootElement(xdoc);
+  }
+  else if (rb_obj_is_kind_of(node, cXMLNode) == Qtrue)
+  {
+    Data_Get_Struct(node, xmlNode, xnode);
+  }
+  else
+  {
+    rb_raise(rb_eTypeError, "The first argument must be a document or node.");
+  }
+
+  xnsArr = xmlGetNsList(xnode->doc, xnode);
+
+  if (xnsArr)
+  {
+    xmlNsPtr xns = *xnsArr;
+
+    while (xns)
+    {
+      /* If there is no prefix, then this is the default namespace.
+       Skip it for now. */
+      if (xns->prefix)
+      {
+        VALUE prefix = rb_str_new2(xns->prefix);
+        VALUE uri = rb_str_new2(xns->href);
+        rxml_xpath_context_register_namespace(self, prefix, uri);
+      }
+      xns = xns->next;
+    }
+    xmlFree(xnsArr);
+  }
+
+  return self;
+}
+
+static int iterate_ns_hash(st_data_t prefix, st_data_t uri, st_data_t self)
+{
+  rxml_xpath_context_register_namespace(self, prefix, uri);
+  return ST_CONTINUE;
+}
+
+/*
+ * call-seq:
+ *    context.register_namespaces(["prefix:uri"]) -> self
+ *
+ * Register the specified namespaces in this context.
+ *
+ *   context.register_namespaces('xi:http://www.w3.org/2001/XInclude')
+ *   context.register_namespaces(['xlink:http://www.w3.org/1999/xlink',
+ *                                'xi:http://www.w3.org/2001/XInclude')
+ *   context.register_namespaces('xlink' => 'http://www.w3.org/1999/xlink',
+ *                                  'xi' => 'http://www.w3.org/2001/XInclude')
+ */
+static VALUE rxml_xpath_context_register_namespaces(VALUE self, VALUE nslist)
+{
+  char *cp;
+  long i;
+  VALUE rprefix, ruri;
+
+  /* Need to loop through the 2nd argument and iterate through the
+   * list of namespaces that we want to allow */
+  switch (TYPE(nslist))
+  {
+  case T_STRING:
+    cp = strchr(StringValuePtr(nslist), (int) ':');
+    if (cp == NULL)
+    {
+      rprefix = nslist;
+      ruri = Qnil;
+    }
+    else
+    {
+      rprefix = rb_str_new(StringValuePtr(nslist), (int) ((long) cp
+          - (long) StringValuePtr(nslist)));
+      ruri = rb_str_new2(&cp[1]);
+    }
+    /* Should test the results of this */
+    rxml_xpath_context_register_namespace(self, rprefix, ruri);
+    break;
+  case T_ARRAY:
+    for (i = 0; i < RARRAY_LEN(nslist); i++)
+    {
+      rxml_xpath_context_register_namespaces(self, RARRAY_PTR(nslist)[i]);
+    }
+    break;
+  case T_HASH:
+    st_foreach(RHASH(nslist)->tbl, iterate_ns_hash, self);
+    break;
+  default:
+    rb_raise(
+        rb_eArgError,
+        "Invalid argument type, only accept string, array of strings, or an array of arrays");
+  }
+  return self;
+}
+
+/*
+ * call-seq:
+ *    context.node = node
+ *
+ * Set the current node used by the XPath engine
+
+ *  doc = XML::Document.string('<header><first>hi</first></header>')
+ *  context.node = doc.root.first
+ */
+static VALUE rxml_xpath_context_node_set(VALUE self, VALUE node)
+{
+  xmlXPathContextPtr xctxt;
+  xmlNodePtr xnode;
+
+  Data_Get_Struct(self, xmlXPathContext, xctxt);
+  Data_Get_Struct(node, xmlNode, xnode);
+  xctxt->node = xnode;
+  return node;
+}
+
+/*
+ * call-seq:
+ *    context.find("xpath") -> XML::XPath::Object
+ *
+ * Find nodes matching the specified XPath expression
+ */
+static VALUE rxml_xpath_context_find(VALUE self, VALUE xpath_expr)
+{
+  xmlXPathContextPtr xctxt;
+  xmlXPathObjectPtr xobject;
+  xmlXPathCompExprPtr xcompexpr;
+  VALUE result;
+
+  Data_Get_Struct(self, xmlXPathContext, xctxt);
+
+  if (TYPE(xpath_expr) == T_STRING)
+  {
+    VALUE expression = rb_check_string_type(xpath_expr);
+    xobject = xmlXPathEval((xmlChar*) StringValueCStr(expression), xctxt);
+  }
+  else if (rb_obj_is_kind_of(xpath_expr, cXMLXPathExpression))
+  {
+    Data_Get_Struct(xpath_expr, xmlXPathCompExpr, xcompexpr);
+    xobject = xmlXPathCompiledEval(xcompexpr, xctxt);
+  }
+  else
+  {
+    rb_raise(rb_eTypeError,
+        "Argument should be an intance of a String or XPath::Expression");
+  }
+
+  if (xobject == NULL)
+  {
+    /* xmlLastError is different than xctxt->lastError.  Use
+     xmlLastError since it has the message set while xctxt->lastError
+     does not. */
+    xmlErrorPtr xerror = xmlGetLastError();
+    rxml_raise(xerror);
+  }
+
+  result = rxml_xpath_object_wrap(xobject);
+  rb_iv_set(result, "@context", self);
+  return result;
+}
+
+void ruby_init_xml_xpath_context(void)
+{
+  cXMLXPathContext = rb_define_class_under(mXPath, "Context", rb_cObject);
+  rb_define_alloc_func(cXMLXPathContext, rxml_xpath_context_alloc);
+  rb_define_attr(cXMLXPathContext, "doc", 1, 0);
+  rb_define_method(cXMLXPathContext, "initialize",
+      rxml_xpath_context_initialize, 1);
+  rb_define_method(cXMLXPathContext, "register_namespaces",
+      rxml_xpath_context_register_namespaces, 1);
+  rb_define_method(cXMLXPathContext, "register_namespaces_from_node",
+      rxml_xpath_context_register_namespaces_from_node, 1);
+  rb_define_method(cXMLXPathContext, "register_namespace",
+      rxml_xpath_context_register_namespace, 2);
+  rb_define_method(cXMLXPathContext, "node=", rxml_xpath_context_node_set, 1);
+  rb_define_method(cXMLXPathContext, "find", rxml_xpath_context_find, 1);
+}