nokogumbo 0.6 → 0.7

data/README.md

@@ -3,7 +3,8 @@ Nokogumbo - a Nokogiri interface to the Gumbo HTML5 parser.
 
 Nokogumbo provides the ability for a Ruby program to invoke the 
 [Gumbo HTML5 parser](https://github.com/google/gumbo-parser#readme)
-and to access the result as a Nokogiri parsed document.
+and to access the result as a
+[Nokogiri::HTML::Document](http://nokogiri.org/Nokogiri/HTML/Document.html).
 
 Usage:
 -----
@@ -25,10 +26,12 @@ Notes:
 
 * The `Nokogiri::HTML5.parse` function takes a string and passes it to the
 <code>gumbo_parse_with_options</code> method, using the default options.
-The resulting Gumbo parse tree is the walked, producing a libxml2 parse tree.
+The resulting Gumbo parse tree is the walked, producing a 
+[libxml2](http://xmlsoft.org/html/)
+[xmlDoc](http://xmlsoft.org/html/libxml-tree.html#xmlDoc).
 The original Gumbo parse tree is then destroyed, and single Nokogiri Ruby
-object is constructed to wrap the libxml2 parse tree.  Nokogiri only produces
-Ruby objects as necessary, so all scanning is done using the underlying
+object is constructed to wrap the xmlDoc structure.  Nokogiri only produces
+Ruby objects as necessary, so all searching is done using the underlying
 libxml2 libraries.
 
 * The `Nokogiri::HTML5.get` function takes care of following redirects,

data/lib/nokogumbo.rb

@@ -2,11 +2,15 @@ require 'nokogiri'
 require 'nokogumboc'
 
 module Nokogiri
+  # Parse an HTML document.  +string+ contains the document.  +string+
+  # may also be an IO-like object.  Returns a +Nokogiri::HTML::Document+.
   def self.HTML5(string)
     Nokogiri::HTML5.parse(string)
   end
 
   module HTML5
+    # Parse an HTML document.  +string+ contains the document.  +string+
+    # may also be an IO-like object.  Returns a +Nokogiri::HTML::Document+.
     def self.parse(string)
       if string.respond_to? :read
         string = string.read
@@ -20,6 +24,10 @@ module Nokogiri
       Nokogumbo.parse(string)
     end
 
+    # Fetch and parse a HTML document from the web, following redirects,
+    # handling https, and determining the character encoding using HTML5
+    # rules.  +uri+ may be a +String+ or a +URI+.  +limit+ controls the
+    # number of redirects that will be followed.
     def self.get(uri, limit=10)
       require 'net/http'
       uri = URI(uri) unless URI === uri
@@ -82,7 +90,7 @@ module Nokogiri
         if not encoding
           data = body[0..1023].gsub(/<!--.*?(-->|\Z)/m, '')
           data.scan(/<meta.*?>/m).each do |meta|
-            encoding ||= meta[/charset="?(.*?)($|"|\s|>)/im, 1]
+            encoding ||= meta[/charset=["']?([^>]*?)($|["'\s>])/im, 1]
           end
         end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nokogumbo
 version: !ruby/object:Gem::Version
-  version: '0.6'
+  version: '0.7'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-22 00:00:00.000000000 Z
+date: 2013-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri