@@ -104,7 +104,7 @@ file GENERATED_TOKENIZER => "lib/nokogiri/css/tokenizer.rex" do |t| begin sh "frex --independent -o #{t.name} #{t.prerequisites.first}" rescue - abort "need frex, sudo gem install aaronp-frex -s http://gems.github.com" + abort "need frex, sudo gem install tenderlove-frex -s http://gems.github.com" end end @@ -261,7 +261,7 @@ namespace :install do end task :frex do - sh "sudo gem install aaronp-frex -s http://gems.github.com" + sh "sudo gem install tenderlove-frex -s http://gems.github.com" end end Rakefile @@ -15,6 +15,31 @@ require 'nokogiri/css' require 'nokogiri/html/builder' require 'nokogiri/hpricot' +# Nokogiri parses and searches XML/HTML very quickly, and also has +# correctly implemented CSS3 selector support as well as XPath support. +# +# Parsing a document returns either a Nokogiri::XML::Document, or a +# Nokogiri::HTML::Document depending on the kind of document you parse. +# +# Here is an example: +# +# require 'nokogiri' +# require 'open-uri' +# +# # Get a Nokogiri::HTML:Document for the page we’re interested in... +# +# doc = Nokogiri::HTML(open('http://www.google.com/search?q=tenderlove')) +# +# # Do funky things with it using Nokogiri::XML::Node methods... +# +# #### +# # Search for nodes by css +# doc.css('h3.r a.l').each do |link| +# puts link.content +# end +# +# See Nokogiri::XML::Node#css for more information about CSS searching. +# See Nokogiri::XML::Node#xpath for more information about XPath searching. module Nokogiri class << self ### lib/nokogiri.rb @@ -1,10 +1,16 @@ module Nokogiri module XML + #### + # A NodeSet contains a list of Nokogiri::XML::Node objects. Typically + # a NodeSet is return as a result of searching a Document via + # Nokogiri::XML::Node#css or Nokogiri::XML::Node#xpath class NodeSet include Enumerable + # The Document this NodeSet is associated with attr_accessor :document + # Create a NodeSet with +document+ defaulting to +list+ def initialize document, list = [] @document = document list.each { |x| self << x } @@ -46,6 +52,9 @@ module Nokogiri ### # Search this document for +paths+ + # + # For more information see Nokogiri::XML::Node#css and + # Nokogiri::XML::Node#xpath def search *paths ns = paths.last.is_a?(Hash) ? paths.pop : document.root.namespaces sub_set = NodeSet.new(document) lib/nokogiri/xml/node_set.rb ffbfc73420c753352eb50e7fcc85a387bfcae348 Aaron Patterson aaron.patterson@gmail.com http://github.com/tenderlove/nokogiri/commit/9d4a78eb96c33a32a93a209c1e17b77a76092dc0 9d4a78eb96c33a32a93a209c1e17b77a76092dc0 2009-03-13T15:12:50-07:00 2009-03-13T15:12:50-07:00 adding some documentation, updating frex requirement e93340743a1a3ae3a823ebd1c0df8a59db9c4567 Aaron Patterson aaron.patterson@gmail.com