mechanize 0.6.1 → 0.6.2

data/CHANGELOG

@@ -1,5 +1,13 @@
 = Mechanize CHANGELOG
 
+== 0.6.2
+
+* Added a yield to Page#form so that dealing with forms can be more DSL like.
+* Added the parsed page to the ResponseCodeError so that the parsed results
+  can be accessed even in the event of an error.
+  http://rubyforge.org/pipermail/mechanize-users/2006-September/000007.html
+* Updated documentation (Thanks to Paul Smith)
+
 == 0.6.1
 
 * Added a method to Form called "submit".  Now forms can be submitted by

data/GUIDE

@@ -34,19 +34,19 @@ Now that we've fetched google's homepage, lets try listing all of the links:
 We can list the links, but Mechanize gives a few shortcuts to help us find a
 link to click on.  Lets say we wanted to click the link whose text is 'News'.
 Normally, we would have to do this:
- page = agent.click page.links.find { |l| l.name == 'News' }
+ page = agent.click page.links.find { |l| l.text == 'News' }
 But Mechanize gives us a shortcut.  Instead we can say this:
- page = agent.click page.links.name('News')
+ page = agent.click page.links.text('News')
 That shortcut says "find all links with the name 'News'".  You're probably
 thinking "there could be multiple links with that text!", and you would be
 correct!  If you pass a list of links to the "click" method, Mechanize will
 click on the first one.  If you wanted to click on the second news link, you
 could do this:
- agent.click page.links.name('News')[1]
+ agent.click page.links.text('News')[1]
 We can even find a link with a certain href like so:
  page.links.href('/something')
 Or chain them together to find a link with certain text and certain href:
- page.links.name('News').href('/something')
+ page.links.text('News').href('/something')
 
 These shortcuts that mechanize provides are available on any list that you
 can fetch like frames, iframes, or forms.  Now that we know how to find and

data/NOTES

@@ -1,5 +1,22 @@
 = Mechanize Release Notes
 
+== 0.6.2 (Bridget)
+
+Mechanize 0.6.2 (Bridget) is a fairly small bug fix release.  You can now
+access the parsed page when a ResponseCodeError is thrown.  For example, this
+loads a page that doesn't exist, but gives you access to the parsed 404 page:
+  begin
+    WWW::Mechanize.new().get('http://google.com/asdfasdfadsf.html')
+  rescue WWW::Mechanize::ResponseCodeError => ex
+    puts ex.page
+  end
+Accessing forms is now more DSL like.  When manipulating a form, for example,
+you can use the following syntax:
+  page.form('formname') { |form|
+    form.first_name = "Aaron"
+  }.submit
+Documentation has also been updated thanks to Paul Smith.
+
 == 0.6.1 (Chuck)
 
 Mechanize version 0.6.1 (Chuck) is done, and is ready for you to use.  This

data/lib/mechanize/errors.rb

@@ -20,9 +20,15 @@ module WWW
     # Any other response code is up to the user to handle.
     class ResponseCodeError < RuntimeError
       attr_reader :response_code
+      attr_reader :page
     
-      def initialize(response_code)
-        @response_code = response_code
+      def initialize(page)
+        @page          = page
+        @response_code = page.code
+      end
+
+      def inspect
+        response_code
       end
     end
   end

data/lib/mechanize/mech_version.rb

@@ -1,5 +1,5 @@
 module WWW
   class Mechanize
-    Version = '0.6.1'
+    Version = '0.6.2'
   end
 end

data/lib/mechanize/page.rb

@@ -63,7 +63,9 @@ module WWW
       end
 
       def form(name)
-        forms.name(name).first
+        f = forms.name(name).first
+        yield f if block_given?
+        f
       end
     
       private

data/lib/mechanize.rb

@@ -410,7 +410,7 @@ class Mechanize
           request = fetch_request(abs_uri)
           return fetch_page(abs_uri, request, page)
         else
-          raise ResponseCodeError.new(page.code), "Unhandled response", caller
+          raise ResponseCodeError.new(page), "Unhandled response", caller
         end
       }
     }

data/test/tc_errors.rb

@@ -19,6 +19,14 @@ class MechErrorsTest < Test::Unit::TestCase
     }
   end
 
+  def test_non_exist
+    begin
+      page = @agent.get("http://localhost:#{PORT}/bad_form_test.html")
+    rescue RuntimeError => ex
+      assert_equal("404", ex.inspect)
+    end
+  end
+
   def test_too_many_radio
     page = @agent.get("http://localhost:#{PORT}/form_test.html")
     form = page.forms.name('post_form1').first

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: mechanize
 version: !ruby/object:Gem::Version 
-  version: 0.6.1
-date: 2006-09-23 00:00:00 -07:00
+  version: 0.6.2
+date: 2006-10-10 00:00:00 -07:00
 summary: Mechanize provides automated web-browsing
 require_paths: 
   - lib