tag:www.jasongarber.com,2005:Typo Typo 2006-10-31T11:26:49-08:00 Jason Garber urn:uuid:e51a761d-5582-4569-86cd-17742928af59 2006-10-24T16:59:00-07:00 2006-10-31T11:26:49-08:00

With the <a href="http://code.google.com/p/form-test-helper/">form_test_helper</a> Rails plugin, your functional and integration tests can work more like the browser. No longer do you need to feed params to an action: <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">post</span> <span class="symbol">:create</span><span class="punct">,</span> <span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">',</span> <span class="symbol">:category</span> <span class="punct">=&gt;</span> <span class="number">1</span><span class="punct">,</span> <span class="symbol">:out_of_print</span> <span class="punct">=&gt;</span> <span class="number">0</span> <span class="ident">assert_response</span> <span class="symbol">:success</span></code></pre></div> ... and then watch it silently break when you change your form but forget to change the test. With <a href="http://code.google.com/p/form-test-helper/">form_test_helper</a>, you just call up the form, change the fields you want, and submit it. <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">get</span> <span class="symbol">:new</span> <span class="ident">submit_form</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">form</span><span class="punct">|</span> <span class="ident">form</span><span class="punct">['</span><span class="string">name</span><span class="punct">']</span> <span class="punct">=</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">'</span> <span class="ident">form</span><span class="punct">['</span><span class="string">category</span><span class="punct">']</span> <span class="punct">=</span> <span class="punct">&quot;</span><span class="string">Programming</span><span class="punct">&quot;</span> <span class="ident">form</span><span class="punct">['</span><span class="string">out_of_print</span><span class="punct">'].</span><span class="ident">uncheck</span> <span class="keyword">end</span> <span class="ident">assert_response</span> <span class="symbol">:success</span></code></pre></div> ...or simply: <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">submit_form</span> <span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">',</span> <span class="symbol">:category</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Programming</span><span class="punct">',</span> <span class="symbol">:out_of_print</span> <span class="punct">=&gt;</span> <span class="constant">false</span></code></pre></div> <p>This is advantageous because it uses the action and method of the form, verifies that the form and the fields you specify are present and not misspelled, and it preserves any hidden or default values that may be in the form, like in <a href="http://code.google.com/p/form-spam-protection/">form_spam_protection</a>.</p> <h3>Features</h3> <ul> <li>Can select_form by dom_id or url&#8212;or call without arguments if there&#8217;s only one form</li> <li>Specifying a field name that doesn&#8217;t exist raises an exception</li> <li>Fields that are selects (dropdowns) won&#8217;t let you set a value that&#8217;s not in its options</li> <li>Selects can set using the option label or the option value</li> <li>Inspect/verify the options for selects and radio buttons</li> <li>Works with RESTful links and forms &#8211; :method =&gt; :put, :delete&#8230;</li> <li>Checks for the presence of a submit button when you submit the form</li> <li>Works in functional and integration tests</li> <li>You can pass #submit a hash and it will update the form accordingly. Submitting a form with new values can be as simple as: <code>select_form.submit {:username =&gt; 'bob', :password =&gt; 'opensesame'}</code></li> <li>Assert presence of and follow links</li> <li>See tests for more goodies!</li> </ul> <h3>Installing</h3> <div class="typocode"><pre><code class="typocode_default ">./script/plugin install -x http://form-test-helper.googlecode.com/svn/form_test_helper/</code></pre></div> <p>Requires <a href="http://wiki.rubyonrails.com/rails/pages/EdgeRails">EdgeRails</a> or the <a href="http://www.agilewebdevelopment.com/plugins/assert_select">assert_select</a> plugin</p> <h3>Bugs/Suggestions</h3> <p>You can e-mail me with my first and last initials at this domain or post &#8220;issues&#8221; on <a href="http://code.google.com/p/form-test-helper">http://code.google.com/p/form-test-helper</a></p>

With the <a href="http://code.google.com/p/form-test-helper/">form_test_helper</a> Rails plugin, your functional and integration tests can work more like the browser. No longer do you need to feed params to an action: <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">post</span> <span class="symbol">:create</span><span class="punct">,</span> <span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">',</span> <span class="symbol">:category</span> <span class="punct">=&gt;</span> <span class="number">1</span><span class="punct">,</span> <span class="symbol">:out_of_print</span> <span class="punct">=&gt;</span> <span class="number">0</span> <span class="ident">assert_response</span> <span class="symbol">:success</span></code></pre></div> ... and then watch it silently break when you change your form but forget to change the test. With <a href="http://code.google.com/p/form-test-helper/">form_test_helper</a>, you just call up the form, change the fields you want, and submit it. <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">get</span> <span class="symbol">:new</span> <span class="ident">submit_form</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">form</span><span class="punct">|</span> <span class="ident">form</span><span class="punct">['</span><span class="string">name</span><span class="punct">']</span> <span class="punct">=</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">'</span> <span class="ident">form</span><span class="punct">['</span><span class="string">category</span><span class="punct">']</span> <span class="punct">=</span> <span class="punct">&quot;</span><span class="string">Programming</span><span class="punct">&quot;</span> <span class="ident">form</span><span class="punct">['</span><span class="string">out_of_print</span><span class="punct">'].</span><span class="ident">uncheck</span> <span class="keyword">end</span> <span class="ident">assert_response</span> <span class="symbol">:success</span></code></pre></div> ...or simply: <div class="typocode"><pre><code class="typocode_ruby "><span class="ident">submit_form</span> <span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Pickaxe</span><span class="punct">',</span> <span class="symbol">:category</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">Programming</span><span class="punct">',</span> <span class="symbol">:out_of_print</span> <span class="punct">=&gt;</span> <span class="constant">false</span></code></pre></div> <p>This is advantageous because it uses the action and method of the form, verifies that the form and the fields you specify are present and not misspelled, and it preserves any hidden or default values that may be in the form, like in <a href="http://code.google.com/p/form-spam-protection/">form_spam_protection</a>.</p> <h3>Features</h3> <ul> <li>Can select_form by dom_id or url&#8212;or call without arguments if there&#8217;s only one form</li> <li>Specifying a field name that doesn&#8217;t exist raises an exception</li> <li>Fields that are selects (dropdowns) won&#8217;t let you set a value that&#8217;s not in its options</li> <li>Selects can set using the option label or the option value</li> <li>Inspect/verify the options for selects and radio buttons</li> <li>Works with RESTful links and forms &#8211; :method =&gt; :put, :delete&#8230;</li> <li>Checks for the presence of a submit button when you submit the form</li> <li>Works in functional and integration tests</li> <li>You can pass #submit a hash and it will update the form accordingly. Submitting a form with new values can be as simple as: <code>select_form.submit {:username =&gt; 'bob', :password =&gt; 'opensesame'}</code></li> <li>Assert presence of and follow links</li> <li>See tests for more goodies!</li> </ul> <h3>Installing</h3> <div class="typocode"><pre><code class="typocode_default ">./script/plugin install -x http://form-test-helper.googlecode.com/svn/form_test_helper/</code></pre></div> <p>Requires <a href="http://wiki.rubyonrails.com/rails/pages/EdgeRails">EdgeRails</a> or the <a href="http://www.agilewebdevelopment.com/plugins/assert_select">assert_select</a> plugin</p> <h3>Bugs/Suggestions</h3> <p>You can e-mail me with my first and last initials at this domain or post &#8220;issues&#8221; on <a href="http://code.google.com/p/form-test-helper">http://code.google.com/p/form-test-helper</a></p>