doc/Trackerific/UPS.html in trackerific-0.3.1 vs doc/Trackerific/UPS.html in trackerific-0.3.2

- old
+ new

@@ -132,35 +132,10 @@ <ul class="summary"> <li class="public "> <span class="summary_signature"> - <a href="#required_options-instance_method" title="#required_options (instance method)">- (Array) <strong>required_options</strong> </a> - - - - </span> - - - - - - - - - <span class="summary_desc"><div class='inline'><p> -The required options for tracking a UPS package are :key, :user_id, and -:password. -</p> -</div></span> - -</li> - - - <li class="public "> - <span class="summary_signature"> - <a href="#track_package-instance_method" title="#track_package (instance method)">- (Trackerific::Details) <strong>track_package</strong>(package_id) </a> </span> @@ -205,87 +180,60 @@ <div id="instance_method_details" class="method_details_list"> <h2>Instance Method Details</h2> <div class="method_details first"> - <p class="signature first" id="required_options-instance_method"> + <p class="signature first" id="track_package-instance_method"> - - (<tt>Array</tt>) <strong>required_options</strong> + - (<tt><span class='object_link'><a href="Details.html" title="Trackerific::Details (class)">Trackerific::Details</a></span></tt>) <strong>track_package</strong>(package_id) </p><div class="docstring"> <div class="discussion"> <p> -The required options for tracking a UPS package are :key, :user_id, and -:password. +Tracks a UPS package </p> </div> </div> <div class="tags"> - <h3>Returns:</h3> -<ul class="return"> + <div class="examples"> + <h3>Examples:</h3> + + <h4><div class='inline'><p> +Track a package +</p> +</div></h4> + <pre class="example code"><span class='id ups'>ups</span> <span class='op'>=</span> <span class='const'>Trackerific</span><span class='op'>::</span><span class='const'>UPS</span><span class='period'>.</span><span class='id new'>new</span> <span class='label'>key:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>api key</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>user_id:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>user</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>password:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>secret</span><span class='tstring_end'>'</span></span> +<span class='id details'>details</span> <span class='op'>=</span> <span class='id ups'>ups</span><span class='period'>.</span><span class='id track_package'>track_package</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1Z12345E0291980793</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span></pre> + + </div> +<h3>Parameters:</h3> +<ul class="param"> + <li> + <span class='name'>package_id</span> - <span class='type'>(<tt>Array</tt>)</span> + <span class='type'>(<tt>String</tt>)</span> + &mdash; <div class='inline'><p> -the required options for tracking a UPS package. +the package identifier </p> </div> </li> </ul> - -</div><table class="source_code"> - <tr> - <td> - <pre class="lines"> - - -19 -20 -21</pre> - </td> - <td> - <pre class="code"><span class="info file"># File 'lib/ups.rb', line 19</span> - -<span class='kw'>def</span> <span class='id required_options'>required_options</span> - <span class='lbracket'>[</span><span class='symbol'>:key</span><span class='comma'>,</span> <span class='symbol'>:user_id</span><span class='comma'>,</span> <span class='symbol'>:password</span><span class='rbracket'>]</span> -<span class='kw'>end</span></pre> - </td> - </tr> -</table> -</div> - - <div class="method_details "> - <p class="signature " id="track_package-instance_method"> - - - (<tt><span class='object_link'><a href="Details.html" title="Trackerific::Details (class)">Trackerific::Details</a></span></tt>) <strong>track_package</strong>(package_id) - - - -</p><div class="docstring"> - <div class="discussion"> - <p> -Tracks a UPS package. A Trackerific::Error is raised when a package cannot -be tracked. -</p> - - - </div> -</div> -<div class="tags"> - <h3>Returns:</h3> +<h3>Returns:</h3> <ul class="return"> <li> @@ -300,17 +248,38 @@ </div> </li> </ul> +<h3>Raises:</h3> +<ul class="raise"> + + <li> + + + <span class='type'>(<tt><span class='object_link'><a href="Error.html" title="Trackerific::Error (class)">Trackerific::Error</a></span></tt>)</span> + + + + &mdash; + <div class='inline'><p> +raised when the server returns an error (invalid credentials, tracking +package, etc.) +</p> +</div> + + </li> + +</ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> +25 26 27 28 29 30 @@ -319,15 +288,14 @@ 33 34 35 36 37 -38 -39</pre> +38</pre> </td> <td> - <pre class="code"><span class="info file"># File 'lib/ups.rb', line 26</span> + <pre class="code"><span class="info file"># File 'lib/ups.rb', line 25</span> <span class='kw'>def</span> <span class='id track_package'>track_package</span><span class='lparen'>(</span><span class='id package_id'>package_id</span><span class='rparen'>)</span> <span class='kw'>super</span> <span class='comment'># connect to UPS via HTTParty </span> <span class='id http_response'>http_response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id class'>class</span><span class='period'>.</span><span class='id post'>post</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/Track</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='symbol'>:body</span> <span class='op'>=&gt;</span> <span class='id build_xml_request'>build_xml_request</span><span class='rparen'>)</span> @@ -349,10 +317,10 @@ </div> </div> <div id="footer"> - Generated on Mon Jun 13 14:22:51 2011 by + Generated on Mon Jun 13 16:20:05 2011 by <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a> 0.7.1 (ruby-1.9.2). </div> </body> \ No newline at end of file