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'>"</span><span class='tstring_content'>1Z12345E0291980793</span><span class='tstring_end'>"</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>
+
—
<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>
+
+
+
+ —
+ <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'>=></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