nokolexbor 0.3.4 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53cb1f54e475a0b10fc7773259866fe675e761d0ca204c5f685f4ed8dd60294a
-  data.tar.gz: 0e697320eae75b41e16ac431c6c679159507013b5e3a9858959377eb969355b2
+  metadata.gz: 29411076a95eae20060101aa8a270bfe53a48eda3b6e58cfad6ebe22b184049c
+  data.tar.gz: 920536ad4f69a635cfec9a6dea4d8bbe746c7c97d74c1b1daa6b22c41856d201
 SHA512:
-  metadata.gz: 609b453f596331b53ab13b403c274cde9472e119307c0af63da19be28f0475603705ef285332c94f8b39a47b6850dfc138694ccee0ede531acffd67e31e915a9
-  data.tar.gz: 9f6d2c3ceba6d98bc8f87d59c846bd6c41fc2758681b66481c72de1027078d30e62344267cfe63ce58209e23f6749502750fa05f4365112275d79cee11641e9d
+  metadata.gz: d6ca49aa873ee254caf034600fbbb9384a2a4efaa86422e992a7fbb7970107af20541c4309e582c6f8863353209d36cd6e5d56fdb19b52fd54a233a4419202ea
+  data.tar.gz: f4c9413c2cd8683e6cf111d1c966a8511d4d605ec30008f595d2c05b402b028dc8f889c9480d3ff43b0f380e84861b2384c915f9f9cca68b6ad8f510a58a0b0a

data/ext/nokolexbor/extconf.rb

@@ -5,6 +5,10 @@ if ENV["CC"]
   RbConfig::CONFIG["CC"] = RbConfig::MAKEFILE_CONFIG["CC"] = ENV["CC"]
 end
 
+def windows?
+  RbConfig::CONFIG["target_os"].match?(/mingw|mswin/)
+end
+
 # From: https://stackoverflow.com/questions/2108727
 # Cross-platform way of finding an executable in the $PATH.
 #
@@ -23,9 +27,9 @@ end
 cmake_flags = [ ENV["CMAKE_FLAGS"] ]
 cmake_flags << "-DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY"
 # Set system name explicitly when cross-compiling
-cmake_flags << "-DCMAKE_SYSTEM_NAME=Windows -DWIN32=1" if Gem.win_platform?
+cmake_flags << "-DCMAKE_SYSTEM_NAME=Windows -DWIN32=1" if windows?
 # On Windows, Ruby-DevKit is MSYS-based, so ensure to use MSYS Makefiles.
-cmake_flags << "-G \"MSYS Makefiles\"" if Gem.win_platform? && !ENV['NOKOLEXBOR_CROSS_COMPILE']
+cmake_flags << "-G \"MSYS Makefiles\"" if windows? && !ENV['NOKOLEXBOR_CROSS_COMPILE']
 
 if ENV['NOKOLEXBOR_CROSS_COMPILE']
   # use the same toolchain for cross-compiling lexbor
@@ -74,7 +78,7 @@ end
 
 def self.run_cmake(timeout, args)
   # Set to process group so we can kill it and its children
-  pgroup = (Gem.win_platform? && !ENV['NOKOLEXBOR_CROSS_COMPILE']) ? :new_pgroup : :pgroup
+  pgroup = (windows? && !ENV['NOKOLEXBOR_CROSS_COMPILE']) ? :new_pgroup : :pgroup
   pid = Process.spawn("cmake #{args}", pgroup => true)
 
   Timeout.timeout(timeout) do
@@ -104,7 +108,7 @@ def apply_patch(patch_file, chdir)
 end
 
 
-MAKE = if Gem.win_platform?
+MAKE = if windows?
   # On Windows, Ruby-DevKit only has 'make'.
   find_executable('make')
 else
@@ -143,7 +147,7 @@ Dir.chdir(EXT_DIR) do
   Dir.mkdir("build") if !Dir.exist?("build")
 
   Dir.chdir("build") do
-    run_cmake(10 * 60, ".. #{cmake_flags.join(' ')} #{Gem.win_platform? ? "-DLIBXML2_WITH_THREADS=OFF" : ""}")
+    run_cmake(10 * 60, ".. #{cmake_flags.join(' ')} #{windows? ? "-DLIBXML2_WITH_THREADS=OFF" : ""}")
   end
 end
 

data/ext/nokolexbor/nl_attribute.c

@@ -4,6 +4,15 @@ VALUE cNokolexborAttribute;
 extern VALUE mNokolexbor;
 extern VALUE cNokolexborNode;
 
+/**
+ * call-seq:
+ *   new(document, name) -> Attribute
+ *
+ * Create a new Attribute on the +document+ with +name+.
+ *
+ * @param document [Document]
+ * @param name [String]
+ */
 static VALUE
 nl_attribute_new(int argc, VALUE *argv, VALUE klass)
 {
@@ -38,6 +47,11 @@ nl_attribute_new(int argc, VALUE *argv, VALUE klass)
   return rb_node;
 }
 
+/**
+ * Get the name of the Attribute.
+ *
+ * @return [String]
+ */
 static VALUE
 nl_attribute_name(VALUE self)
 {
@@ -50,6 +64,12 @@ nl_attribute_name(VALUE self)
   return rb_utf8_str_new(name, len);
 }
 
+/**
+ * call-seq:
+ *   name=(name) -> String
+ *
+ * Set the name of the Attribute.
+ */
 static VALUE
 nl_attribute_set_name(VALUE self, VALUE rb_name)
 {
@@ -67,6 +87,11 @@ nl_attribute_set_name(VALUE self, VALUE rb_name)
   return rb_name;
 }
 
+/**
+ * Get the value of the Attribute.
+ *
+ * @return [String]
+ */
 static VALUE
 nl_attribute_value(VALUE self)
 {
@@ -79,6 +104,12 @@ nl_attribute_value(VALUE self)
   return rb_utf8_str_new(value, len);
 }
 
+/**
+ * call-seq:
+ *   value=(value) -> String
+ *
+ * Set the value of the Attribute.
+ */
 static VALUE
 nl_attribute_set_value(VALUE self, VALUE rb_content)
 {
@@ -96,6 +127,11 @@ nl_attribute_set_value(VALUE self, VALUE rb_content)
   return rb_content;
 }
 
+/**
+ * Get the owner Node of the Attribute.
+ *
+ * @return [Node]
+ */
 static VALUE
 nl_attribute_parent(VALUE self)
 {
@@ -108,6 +144,11 @@ nl_attribute_parent(VALUE self)
   return nl_rb_node_create(attr->owner, nl_rb_document_get(self));
 }
 
+/**
+ * Get the previous Attribute.
+ *
+ * @return [Attribute]
+ */
 static VALUE
 nl_attribute_previous(VALUE self)
 {
@@ -120,6 +161,11 @@ nl_attribute_previous(VALUE self)
   return nl_rb_node_create(attr->prev, nl_rb_document_get(self));
 }
 
+/**
+ * Get the next Attribute.
+ *
+ * @return [Attribute]
+ */
 static VALUE
 nl_attribute_next(VALUE self)
 {

data/ext/nokolexbor/nl_cdata.c

@@ -4,6 +4,14 @@ VALUE cNokolexborCData;
 extern VALUE cNokolexborText;
 extern VALUE mNokolexbor;
 
+/**
+ * call-seq:
+ *   new(content, document) { |CDATA| ... } -> CDATA
+ *
+ * Create a new CDATA from +content+.
+ *
+ * @return [CDATA]
+ */
 static VALUE
 nl_cdata_new(int argc, VALUE *argv, VALUE klass)
 {

data/ext/nokolexbor/nl_comment.c

@@ -4,6 +4,12 @@ VALUE cNokolexborComment;
 extern VALUE cNokolexborCharacterData;
 extern VALUE mNokolexbor;
 
+/**
+ * call-seq:
+ *   new(content, document) { |Comment| ... } -> Comment
+ *
+ * Create a new Comment from +content+.
+ */
 static VALUE
 nl_comment_new(int argc, VALUE *argv, VALUE klass)
 {

data/ext/nokolexbor/nl_document.c

@@ -21,6 +21,16 @@ const rb_data_type_t nl_document_type = {
     RUBY_TYPED_FREE_IMMEDIATELY,
 };
 
+/**
+ * call-seq:
+ *   parse(string_or_io) -> Document
+ *
+ * Parse HTML into a {Document}.
+ *
+ * @param string_or_io [String, #read]
+ *   The HTML to be parsed. It may be a String, or any object that
+ *   responds to #read such as an IO, or StringIO.
+ */
 static VALUE
 nl_document_parse(VALUE self, VALUE rb_string_or_io)
 {
@@ -51,6 +61,11 @@ nl_document_parse(VALUE self, VALUE rb_string_or_io)
   return TypedData_Wrap_Struct(cNokolexborDocument, &nl_document_type, document);
 }
 
+/**
+ * Create a new document.
+ *
+ * @return [Document]
+ */
 static VALUE
 nl_document_new(VALUE self)
 {
@@ -65,21 +80,51 @@ nl_rb_document_unwrap(VALUE rb_doc)
   return doc;
 }
 
-VALUE
-nl_document_get_title(VALUE rb_doc)
+/**
+ * Get the title of this document.
+ *
+ * @return [String]
+ */
+static VALUE
+nl_document_get_title(VALUE self)
 {
   size_t len;
-  lxb_char_t *str = lxb_html_document_title(nl_rb_document_unwrap(rb_doc), &len);
+  lxb_char_t *str = lxb_html_document_title(nl_rb_document_unwrap(self), &len);
   return str == NULL ? rb_str_new("", 0) : rb_utf8_str_new(str, len);
 }
 
-VALUE
-nl_document_set_title(VALUE rb_doc, VALUE rb_title)
+/**
+ * call-seq:
+ *   title=(text) -> String
+ *
+ * Set the title of this document.
+ *
+ * If a title element is already present, its content is replaced
+ * with the given text.
+ *
+ * Otherwise, this method tries to create one inside <head>.
+ *
+ * @return [String]
+ */
+static VALUE
+nl_document_set_title(VALUE self, VALUE rb_title)
 {
   const char *c_title = StringValuePtr(rb_title);
   size_t len = RSTRING_LEN(rb_title);
-  lxb_char_t *str = lxb_html_document_title_set(nl_rb_document_unwrap(rb_doc), (const lxb_char_t *)c_title, len);
-  return Qnil;
+  lxb_char_t *str = lxb_html_document_title_set(nl_rb_document_unwrap(self), (const lxb_char_t *)c_title, len);
+  return rb_title;
+}
+
+/**
+ * Get the root node for this document.
+ *
+ * @return [Node]
+ */
+static VALUE
+nl_document_root(VALUE self)
+{
+  lxb_dom_document_t *doc = nl_rb_document_unwrap(self);
+  return nl_rb_node_create(lxb_dom_document_root(doc), self);
 }
 
 void Init_nl_document(void)
@@ -89,4 +134,5 @@ void Init_nl_document(void)
   rb_define_singleton_method(cNokolexborDocument, "parse", nl_document_parse, 1);
   rb_define_method(cNokolexborDocument, "title", nl_document_get_title, 0);
   rb_define_method(cNokolexborDocument, "title=", nl_document_set_title, 1);
+  rb_define_method(cNokolexborDocument, "root", nl_document_root, 0);
 }

data/ext/nokolexbor/nl_document_fragment.c

@@ -4,6 +4,15 @@ VALUE cNokolexborDocumentFragment;
 extern VALUE cNokolexborNode;
 extern VALUE mNokolexbor;
 
+/**
+ * call-seq:
+ *   new(document, tags = nil, ctx = nil) -> DocumentFragment
+ *
+ * Create a {DocumentFragment} from +tags+.
+ *
+ * If +ctx+ is present, it is used as a context node for the
+ * subtree created.
+ */
 static VALUE
 nl_document_fragment_new(int argc, VALUE *argv, VALUE klass)
 {

data/ext/nokolexbor/nl_error.c

@@ -1,5 +1,6 @@
 #include "nokolexbor.h"
 
+VALUE mLexbor;
 VALUE eLexborError;
 VALUE eLexborMemoryAllocationError;
 VALUE eLexborSmallBufferError;
@@ -71,23 +72,24 @@ void nl_raise_lexbor_error(lxb_status_t error)
 
 void Init_nl_error(void)
 {
-  eLexborError = rb_define_class_under(mNokolexbor, "LexborError", rb_eStandardError);
-  eLexborMemoryAllocationError = rb_define_class_under(mNokolexbor, "LexborMemoryAllocationError", eLexborError);
-  eLexborSmallBufferError = rb_define_class_under(mNokolexbor, "LexborSmallBufferError", eLexborError);
-  eLexborObjectIsNullError = rb_define_class_under(mNokolexbor, "LexborObjectIsNullError", eLexborError);
-  eLexborIncompleteObjectError = rb_define_class_under(mNokolexbor, "LexborIncompleteObjectError", eLexborError);
-  eLexborNoFreeSlotError = rb_define_class_under(mNokolexbor, "LexborNoFreeSlotError", eLexborError);
-  eLexborTooSmallSizeError = rb_define_class_under(mNokolexbor, "LexborTooSmallSizeError", eLexborError);
-  eLexborNotExistsError = rb_define_class_under(mNokolexbor, "LexborNotExistsError", eLexborError);
-  eLexborWrongArgsError = rb_define_class_under(mNokolexbor, "LexborWrongArgsError", eLexborError);
-  eLexborWrongStageError = rb_define_class_under(mNokolexbor, "LexborWrongStageError", eLexborError);
-  eLexborUnexpectedResultError = rb_define_class_under(mNokolexbor, "LexborUnexpectedResultError", eLexborError);
-  eLexborUnexpectedDataError = rb_define_class_under(mNokolexbor, "LexborUnexpectedDataError", eLexborError);
-  eLexborOverflowError = rb_define_class_under(mNokolexbor, "LexborOverflowError", eLexborError);
-  eLexborContinueStatus = rb_define_class_under(mNokolexbor, "LexborContinueStatus", eLexborError);
-  eLexborSmallBufferStatus = rb_define_class_under(mNokolexbor, "LexborSmallBufferStatus", eLexborError);
-  eLexborAbortedStatus = rb_define_class_under(mNokolexbor, "LexborAbortedStatus", eLexborError);
-  eLexborStoppedStatus = rb_define_class_under(mNokolexbor, "LexborStoppedStatus", eLexborError);
-  eLexborNextStatus = rb_define_class_under(mNokolexbor, "LexborNextStatus", eLexborError);
-  eLexborStopStatus = rb_define_class_under(mNokolexbor, "LexborStopStatus", eLexborError);
+  mLexbor = rb_define_module_under(mNokolexbor, "Lexbor");
+  eLexborError = rb_define_class_under(mLexbor, "Error", rb_eStandardError);
+  eLexborMemoryAllocationError = rb_define_class_under(mLexbor, "MemoryAllocationError", eLexborError);
+  eLexborSmallBufferError = rb_define_class_under(mLexbor, "SmallBufferError", eLexborError);
+  eLexborObjectIsNullError = rb_define_class_under(mLexbor, "ObjectIsNullError", eLexborError);
+  eLexborIncompleteObjectError = rb_define_class_under(mLexbor, "IncompleteObjectError", eLexborError);
+  eLexborNoFreeSlotError = rb_define_class_under(mLexbor, "NoFreeSlotError", eLexborError);
+  eLexborTooSmallSizeError = rb_define_class_under(mLexbor, "TooSmallSizeError", eLexborError);
+  eLexborNotExistsError = rb_define_class_under(mLexbor, "NotExistsError", eLexborError);
+  eLexborWrongArgsError = rb_define_class_under(mLexbor, "WrongArgsError", eLexborError);
+  eLexborWrongStageError = rb_define_class_under(mLexbor, "WrongStageError", eLexborError);
+  eLexborUnexpectedResultError = rb_define_class_under(mLexbor, "UnexpectedResultError", eLexborError);
+  eLexborUnexpectedDataError = rb_define_class_under(mLexbor, "UnexpectedDataError", eLexborError);
+  eLexborOverflowError = rb_define_class_under(mLexbor, "OverflowError", eLexborError);
+  eLexborContinueStatus = rb_define_class_under(mLexbor, "ContinueStatus", eLexborError);
+  eLexborSmallBufferStatus = rb_define_class_under(mLexbor, "SmallBufferStatus", eLexborError);
+  eLexborAbortedStatus = rb_define_class_under(mLexbor, "AbortedStatus", eLexborError);
+  eLexborStoppedStatus = rb_define_class_under(mLexbor, "StoppedStatus", eLexborError);
+  eLexborNextStatus = rb_define_class_under(mLexbor, "NextStatus", eLexborError);
+  eLexborStopStatus = rb_define_class_under(mLexbor, "StopStatus", eLexborError);
 }