RubyGems - shep - Versions diffs - 0.1.0.pre.alpha0 → 0.2.0.pre.alpha0 - Mend

shep 0.1.0.pre.alpha0 → 0.2.0.pre.alpha0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

checksums.yaml +4 -4
data/README.md +5 -1
data/Rakefile +1 -0
data/doc/Shep/Entity/Account.html +22 -37
data/doc/Shep/Entity/Context.html +8 -9
data/doc/Shep/Entity/CustomEmoji.html +11 -15
data/doc/Shep/Entity/MediaAttachment.html +13 -19
data/doc/Shep/Entity/Notification.html +11 -15
data/doc/Shep/Entity/Status.html +34 -61
data/doc/Shep/Entity/StatusSource.html +9 -11
data/doc/Shep/Entity/Status_Application.html +11 -10
data/doc/Shep/Entity/Status_Mention.html +10 -13
data/doc/Shep/Entity/Status_Tag.html +8 -9
data/doc/Shep/Entity.html +156 -141
data/doc/Shep/Error/Caller.html +4 -4
data/doc/Shep/Error/Http.html +13 -13
data/doc/Shep/Error/RateLimit.html +176 -0
data/doc/Shep/Error/Remote.html +3 -4
data/doc/Shep/Error/Server.html +5 -4
data/doc/Shep/Error/Type.html +6 -8
data/doc/Shep/Error.html +5 -5
data/doc/Shep/Session.html +895 -570
data/doc/Shep.html +20 -5
data/doc/_index.html +10 -3
data/doc/class_list.html +1 -1
data/doc/file.README.html +52 -33
data/doc/file_list.html +1 -1
data/doc/index.html +117 -239
data/doc/method_list.html +9 -1
data/doc/top-level-namespace.html +2 -2
data/lib/shep/entity_base.rb +6 -1
data/lib/shep/exceptions.rb +5 -0
data/lib/shep/session.rb +292 -146
data/lib/shep/version.rb +4 -0
data/lib/shep.rb +1 -1
data/run_rake_test.example.sh +12 -5
data/shep.gemspec +4 -2
data/spec/session_reader_1_unauth_spec.rb +20 -17
data/spec/session_reader_2_auth_spec.rb +17 -19
data/spec/session_writer_spec.rb +4 -11
data/spec/session_zzz_tricky_spec.rb +136 -0
data/spec/spec_helper.rb +12 -3
metadata +12 -9

data/doc/Shep/Session.html CHANGED Viewed

@@ -101,26 +101,81 @@
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-<p>Represents a connection to a Mastodon (or equivalent) server.</p>
+    <p>Represents a connection to a Mastodon (or equivalent) server.</p>
+<h2 id="conventions">Conventions</h2>
-<h2 id="label-Conventions">Conventions</h2>
+<p><code>fetch_*</code> methods retrieve a single Mastodon object, an <code>Entity</code>
+subinstance.</p>
-<p><code>fetch_*</code> methods retrieve a single Mastodon object, an <code>Entity</code> subinstance.</p>
+<p><code>each_*</code> methods retrieve multiple objects, also <code>Entity</code>
+subinstances.  If called with a block, the block is evaluated on
+each item in turn and the block&#39;s result is ignored.  Otherwise,
+it returns an <code>Enumerator</code> which can be used in the usual ways.</p>
-<p><code>each_*</code> methods retrieve multiple objects, also <code>Entity</code> subinstances. If called with a block, the block is evaluated on each item in turn and the block’s result is ignored. Otherwise, it returns an <code>Enumerator</code> which can be used in the usual ways.</p>
+<p>Some examples:</p>
-<p><code>each_*</code> will automatically paginate through the available items; for example,</p>
+<pre class="code ruby"><code class="ruby">    <span class='comment'># Evaluate a block on each status
+</span>    <span class='id identifier rubyid_session'>session</span><span class='period'>.</span><span class='id identifier rubyid_each_status'>each_status</span><span class='lparen'>(</span><span class='id identifier rubyid_account'>account</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_status'>status</span><span class='op'>|</span> <span class='id identifier rubyid_do_thing'>do_thing</span><span class='lparen'>(</span><span class='id identifier rubyid_status'>status</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-<pre class="code ruby"><code class="ruby">    <span class='id identifier rubyid_statuses'>statuses</span> <span class='op'>=</span> <span class='id identifier rubyid_session'>session</span><span class='period'>.</span><span class='id identifier rubyid_each_public_status'>each_public_status</span><span class='period'>.</span><span class='id identifier rubyid_to_a'>to_a</span>
+    <span class='comment'># Retrieve the last 100 statuses in an array
+</span>    <span class='id identifier rubyid_statuses'>statuses</span> <span class='op'>=</span> <span class='id identifier rubyid_session'>session</span><span class='period'>.</span><span class='id identifier rubyid_each_status'>each_status</span><span class='lparen'>(</span><span class='id identifier rubyid_account'>account</span><span class='comma'>,</span> <span class='label'>limit:</span> <span class='int'>100</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_a'>to_a</span>
+    <span class='comment'># Retrieve the last 200 statuses via an enumerator and do
+</span>    <span class='comment'># extra transformation on the result before collecting
+</span>    <span class='comment'># them in an array.
+</span>    <span class='id identifier rubyid_statuses'>statuses</span> <span class='op'>=</span> <span class='id identifier rubyid_session'>session</span><span class='period'>.</span><span class='id identifier rubyid_each_status'>each_status</span><span class='lparen'>(</span><span class='id identifier rubyid_account'>account</span><span class='comma'>,</span> <span class='label'>limit:</span> <span class='int'>200</span><span class='rparen'>)</span>
+        <span class='period'>.</span><span class='id identifier rubyid_select'>select</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_status'>status</span><span class='op'>|</span> <span class='const'>BESTIES</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_status'>status</span><span class='period'>.</span><span class='id identifier rubyid_account'>account</span><span class='period'>.</span><span class='id identifier rubyid_username'>username</span> <span class='rbrace'>}</span>
+        <span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_status'>status</span><span class='op'>|</span> <span class='id identifier rubyid_status'>status</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rbrace'>}</span>
+        <span class='period'>.</span><span class='id identifier rubyid_to_a'>to_a</span>
 </code></pre>
-<p>will retrieve the server’s entire public timeline and put it in an array. (Note: don’t do this.) The <code>limit:</code> keyword option will set an upper limit on the number of items retrieved (but note that the method may retrieve more from the API endpoint).</p>
+<p>The actual web API &quot;paginates&quot; the output.  That is, it returns
+the first 40 (or so) items and then provides a link to the next
+chunk.  Shep&#39;s <code>each_*</code> methods handle this for you automatically.
+This means that unless you use <code>limit:</code>, the <code>each_*</code> methods will
+retrieve <strong>all</strong> available items, at least until you reach the
+rate limit (see below).</p>
+<p>Note that it is safe to leave an <code>each_*</code> methods block with
+<code>break</code>, <code>return</code>, an exception, or any other such mechanism.</p>
-<p>The remaining Mastodon API methods will in some way modify the state of the server and return an Entity subinstance on success.</p>
+<p>The remaining Mastodon API methods will in some way modify the
+state of the server and return an Entity subinstance on success.</p>
 <p>All API calls throw an exception on failure.</p>
+<h2 id="rate-limits">Rate Limits</h2>
+<p>Mastodon servers restrict the number of times you can use a
+specific endpoint within a time period as a way to prevent abuse.
+Shep provides several tools for handling these limits gracefully.</p>
+<ol>
+<li><p>The method <span class='object_link'><a href="#rate_limit-instance_method" title="Shep::Session#rate_limit (method)">#rate_limit</a></span> will return a Struct that tells you how
+many requests you have left and when the count is reset.</p></li>
+<li><p>If a rate limit is exceeded, the method will throw an
+<span class='object_link'><a href="Error/RateLimit.html" title="Shep::Error::RateLimit (class)">Error::RateLimit</a></span> exception instead of an ordinary
+<span class='object_link'><a href="Error/Http.html" title="Shep::Error::Http (class)">Error::Http</a></span> exception.</p></li>
+<li><p>If the Session is created with argument <code>rate_limit_retry:</code> set
+to true, the Session will instead wait out the reset time and
+try again.</p></li>
+</ol>
+<p>If you enable the wait-and-retry mechanism, you can also provide a
+hook function (i.e. a thing that responds to <code>call</code>) via
+constructor argument <code>retry_hook:</code>.  This is called with one
+argument, the result of <span class='object_link'><a href="#rate_limit-instance_method" title="Shep::Session#rate_limit (method)">#rate_limit</a></span> for the limited API endpoint,
+immediately before Shep starts waiting for the limit to reset.</p>
+<p>The built-in wait time takes the callback&#39;s execution time into
+account so it&#39;s possible to use the callback to do your own
+waiting and use that time more productively.</p>
+<p>Alternately, all of the <code>each_*</code> methods have a <code>limit:</code> parameter
+so it&#39;s easy to avoid making too many API calls and many have a
+<code>max_id:</code> parameter that allows you to continue where you left off.</p>
   </div>
 </div>
@@ -156,8 +211,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>The Server’s hostname.</p>
+    <span class="summary_desc"><div class='inline'><p>The Server&#39;s hostname.</p>
 </div></span>
 </li>
@@ -185,8 +239,35 @@
-    <span class="summary_desc"><div class='inline'>
-<p>The logger object.</p>
+    <span class="summary_desc"><div class='inline'><p>The logger object.</p>
+</div></span>
+</li>
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#user_agent-instance_method" title="#user_agent (instance method)">#<strong>user_agent</strong>  &#x21d2; String </a>
+  </span>
+      <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'><p>User-Agent string; frozen.</p>
 </div></span>
 </li>
@@ -222,8 +303,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Delete the status at ID.</p>
+    <span class="summary_desc"><div class='inline'><p>Delete the status at ID.</p>
 </div></span>
 </li>
@@ -246,8 +326,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Dismiss the notification with the given ID.</p>
+    <span class="summary_desc"><div class='inline'><p>Dismiss the notification with the given ID.</p>
 </div></span>
 </li>
@@ -270,8 +349,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve each Entity::Account that boosted the given status.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve each Entity::Account that boosted the given status.</p>
 </div></span>
 </li>
@@ -294,8 +372,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve each account that favourited the given status.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve each account that favourited the given status.</p>
 </div></span>
 </li>
@@ -318,8 +395,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve the follower list of an account.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve the follower list of an account.</p>
 </div></span>
 </li>
@@ -342,8 +418,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve the list of accounts this account follows.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve the list of accounts this account follows.</p>
 </div></span>
 </li>
@@ -352,7 +427,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#each_home_status-instance_method" title="#each_home_status (instance method)">#<strong>each_home_status</strong>(limit: nil, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; Enumerator </a>
+      <a href="#each_home_status-instance_method" title="#each_home_status (instance method)">#<strong>each_home_status</strong>(limit: nil, local: false, max_id: &quot;&quot;, remote: false, only_media: false) {|item| ... } &#x21d2; Enumerator </a>
@@ -366,8 +441,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve each Entity::Status in the home timeline.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve each Entity::Status in the home timeline.</p>
 </div></span>
 </li>
@@ -390,8 +464,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve each notification.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve each notification.</p>
 </div></span>
 </li>
@@ -400,7 +473,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#each_public_status-instance_method" title="#each_public_status (instance method)">#<strong>each_public_status</strong>(limit: nil, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; Enumerator </a>
+      <a href="#each_public_status-instance_method" title="#each_public_status (instance method)">#<strong>each_public_status</strong>(limit: nil, max_id: &quot;&quot;, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; Enumerator </a>
@@ -414,8 +487,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve the instance’s public timeline(s).</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve the instance&#39;s public timeline(s).</p>
 </div></span>
 </li>
@@ -424,7 +496,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#each_status-instance_method" title="#each_status (instance method)">#<strong>each_status</strong>(account_id, limit: nil, only_media: false, exclude_replies: false, exclude_reblogs: false, pinned: false, tagged: nil) {|item| ... } &#x21d2; Enumerator </a>
+      <a href="#each_status-instance_method" title="#each_status (instance method)">#<strong>each_status</strong>(account_id, limit: nil, max_id: &quot;&quot;, only_media: false, exclude_replies: false, exclude_reblogs: false, pinned: false, tagged: nil) {|item| ... } &#x21d2; Enumerator </a>
@@ -438,8 +510,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve the account’s statuses.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve the account&#39;s statuses.</p>
 </div></span>
 </li>
@@ -448,7 +519,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#each_tag_status-instance_method" title="#each_tag_status (instance method)">#<strong>each_tag_status</strong>(hashtag_s, limit: nil, local: false, remote: false, only_media: false, all: [], none: []) {|item| ... } &#x21d2; Enumerator </a>
+      <a href="#each_tag_status-instance_method" title="#each_tag_status (instance method)">#<strong>each_tag_status</strong>(hashtag_s, limit: nil, max_id: &quot;&quot;, local: false, remote: false, only_media: false, all: [], none: []) {|item| ... } &#x21d2; Enumerator </a>
@@ -462,8 +533,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve a tag’s timeline.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve a tag&#39;s timeline.</p>
 </div></span>
 </li>
@@ -486,8 +556,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Update the status with the given Id.</p>
+    <span class="summary_desc"><div class='inline'><p>Update the status with the given Id.</p>
 </div></span>
 </li>
@@ -510,8 +579,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch user details by ID.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch user details by ID.</p>
 </div></span>
 </li>
@@ -520,7 +588,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#fetch_account_by_username-instance_method" title="#fetch_account_by_username (instance method)">#<strong>fetch_account_by_username</strong>(handle)  &#x21d2; Entity::Account </a>
+      <a href="#fetch_account_by_username-instance_method" title="#fetch_account_by_username (instance method)">#<strong>fetch_account_by_username</strong>(handle)  &#x21d2; Entity::Account<sup>?</sup> </a>
@@ -534,8 +602,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch user details by username.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch user details by username.</p>
 </div></span>
 </li>
@@ -558,8 +625,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch the context (parent and child status) of status at ‘id’.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch the context (parent and child status) of status at &#39;id&#39;.</p>
 </div></span>
 </li>
@@ -582,8 +648,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch an individual notification by ID.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch an individual notification by ID.</p>
 </div></span>
 </li>
@@ -606,8 +671,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch a single status.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch a single status.</p>
 </div></span>
 </li>
@@ -630,8 +694,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch the editable source of status at id.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch the editable source of status at id.</p>
 </div></span>
 </li>
@@ -654,8 +717,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Fetch the given status and also any attached media.</p>
+    <span class="summary_desc"><div class='inline'><p>Fetch the given status and also any attached media.</p>
 </div></span>
 </li>
@@ -664,7 +726,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>(host:, token: nil, logger: nil, debug_http: false)  &#x21d2; Session </a>
+      <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>(host:, token: nil, user_agent: &quot;ShepRubyGem/#{Shep::Version}&quot;, ua_comment: nil, rate_limit_retry: false, retry_hook: nil, logger: nil, debug_http: false)  &#x21d2; Session </a>
@@ -680,8 +742,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Initialize a new <span class='object_link'><a href="" title="Shep::Session (class)">Session</a></span>.</p>
+    <span class="summary_desc"><div class='inline'><p>Initialize a new <span class='object_link'><a href="" title="Shep::Session (class)">Session</a></span>.</p>
 </div></span>
 </li>
@@ -690,7 +751,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#post_status-instance_method" title="#post_status (instance method)">#<strong>post_status</strong>(text, visibility: :private, media_ids: [], spoiler_text: &quot;&quot;, language: &quot;&quot;)  &#x21d2; Object </a>
+      <a href="#post_status-instance_method" title="#post_status (instance method)">#<strong>post_status</strong>(text, visibility: :private, media_ids: [], spoiler_text: &quot;&quot;, language: &quot;&quot;)  &#x21d2; Entity::Status </a>
@@ -704,8 +765,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Post a status containing the given text at the specified visibility with zero or more media attachments.</p>
+    <span class="summary_desc"><div class='inline'><p>Post a status containing the given text at the specified visibility with zero or more media attachments.</p>
 </div></span>
 </li>
@@ -728,8 +788,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Return the rate limit information as of the last operation.</p>
+    <span class="summary_desc"><div class='inline'><p>Return the rate limit information from the last REST request.</p>
 </div></span>
 </li>
@@ -752,8 +811,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Return a human-readable summary of the rate limit.</p>
+    <span class="summary_desc"><div class='inline'><p>Return a human-readable summary of the rate limit.</p>
 </div></span>
 </li>
@@ -776,8 +834,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Upload the media contained in the file at ‘path’.</p>
+    <span class="summary_desc"><div class='inline'><p>Upload the media contained in the file at &#39;path&#39;.</p>
 </div></span>
 </li>
@@ -800,8 +857,7 @@
-    <span class="summary_desc"><div class='inline'>
-<p>Return the Entity::Account object for the token we’re using.</p>
+    <span class="summary_desc"><div class='inline'><p>Return the Entity::Account object for the token we&#39;re using.</p>
 </div></span>
 </li>
@@ -816,7 +872,7 @@
     <div class="method_details first">
   <h3 class="signature first" id="initialize-instance_method">
-    #<strong>initialize</strong>(host:, token: nil, logger: nil, debug_http: false)  &#x21d2; <tt><span class='object_link'><a href="" title="Shep::Session (class)">Session</a></span></tt>
+    #<strong>initialize</strong>(host:, token: nil, user_agent: &quot;ShepRubyGem/#{Shep::Version}&quot;, ua_comment: nil, rate_limit_retry: false, retry_hook: nil, logger: nil, debug_http: false)  &#x21d2; <tt><span class='object_link'><a href="" title="Shep::Session (class)">Session</a></span></tt>
@@ -824,12 +880,27 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Initialize a new <span class='object_link'><a href="" title="Shep::Session (class)">Shep::Session</a></span>.</p>
+    <p>Initialize a new <span class='object_link'><a href="" title="Shep::Session (class)">Shep::Session</a></span>.</p>
+<p>By default, the User-Agent header is set to the gem&#39;s
+identifier, but may be overridden with the <code>user_agent</code>
+parameter.  It is your responsibility to make sure it is
+formatted correctly.  You can also append comment text to the
+given User-Agent string with <code>ua_comment</code>; this lets you add a
+comment to the default text.</p>
+<p>Parameter <code>logger</code> may be a <code>Logger</code> object, <code>nil</code>, or a
+<code>Symbol</code> whose value is the name of one of the supported log
+levels.  In the latter case, a new Logger is created and set to
+that level.  If <code>nil</code> is given, a dummy <code>Logger</code> is created and
+used.</p>
-<p>Parameter <code>logger</code> may be a <code>Logger</code> object, <code>nil</code>, or a <code>Symbol</code> whose value is the name of one of the supported log levels. In the latter case, a new Logger is created and set to that level. If <code>nil</code> is given, a dummy <code>Logger</code> is created and used.</p>
+<p>If <code>debug_http</code> is true, compression is disabled and the
+transactions are sent to <code>STDERR</code> via
+<code>Net::HTTP.set_debug_output</code>.</p>
-<p>If <code>debug_http</code> is true, compression is disabled and the transactions are sent to <code>STDERR</code> via <code>Net::HTTP.set_debug_output</code>. <strong>WARNING:</strong> this opens a serious security hole and should not be used in production.</p>
+<p><strong>WARNING:</strong> this opens a serious security hole and should not
+be used in production.</p>
   </div>
@@ -848,8 +919,7 @@
         &mdash;
-        <div class='inline'>
-<p>Hostname of the server</p>
+        <div class='inline'><p>Hostname of the server</p>
 </div>
     </li>
@@ -866,8 +936,79 @@
         &mdash;
-        <div class='inline'>
-<p>Bearer token; optional</p>
+        <div class='inline'><p>Bearer token; optional</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>user_agent</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>&quot;ShepRubyGem/#{Shep::Version}&quot;</tt>)</em>
+        &mdash;
+        <div class='inline'><p>User-Agent string to use</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>ua_comment</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Comment part of User-Agent string</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>rate_limit_retry</span>
+        <span class='type'>(<tt>Boolean</tt>)</span>
+        <em class="default">(defaults to: <tt>false</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Handle request limits by waiting
+for the count to reset and trying
+again.</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>retry_hook</span>
+        <span class='type'>(<tt>Proc</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>One-argument hook function to call
+before waiting for the rate limit
+to reset</p>
 </div>
     </li>
@@ -884,8 +1025,7 @@
         &mdash;
-        <div class='inline'>
-<p>The logger or mode; optional</p>
+        <div class='inline'><p>The logger or mode; optional</p>
 </div>
     </li>
@@ -902,14 +1042,27 @@
         &mdash;
-        <div class='inline'>
-<p>Enable <code>Net::HTTP</code> debugging; insecure!</p>
+        <div class='inline'><p>Enable <code>Net::HTTP</code> debugging;
+<strong>insecure!</strong></p>
 </div>
     </li>
 </ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="Error/Caller.html" title="Shep::Error::Caller (class)">Error::Caller</a></span></tt>)</span>
+    </li>
+</ul>
 </div><table class="source_code">
   <tr>
@@ -917,29 +1070,65 @@
       <pre class="lines">
-61
-62
-63
-64
-65
-66
-67
-68
-69
-70</pre>
+132
+133
+134
+135
+136
+137
+138
+139
+140
+141
+142
+143
+144
+145
+146
+147
+148
+149
+150
+151
+152
+153
+154
+155
+156
+157
+158
+159</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 61</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 132</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>host:</span><span class='comma'>,</span>
-               <span class='label'>token:</span> <span class='kw'>nil</span><span class='comma'>,</span>
-               <span class='label'>logger:</span> <span class='kw'>nil</span><span class='comma'>,</span>
-               <span class='label'>debug_http:</span> <span class='kw'>false</span><span class='rparen'>)</span>
+               <span class='label'>token:</span>               <span class='kw'>nil</span><span class='comma'>,</span>
+               <span class='label'>user_agent:</span>          <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ShepRubyGem/</span><span class='embexpr_beg'>#{</span><span class='const'><span class='object_link'><a href="../Shep.html" title="Shep (module)">Shep</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Shep.html#Version-constant" title="Shep::Version (constant)">Version</a></span></span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+               <span class='label'>ua_comment:</span>          <span class='kw'>nil</span><span class='comma'>,</span>
+               <span class='label'>rate_limit_retry:</span>    <span class='kw'>false</span><span class='comma'>,</span>
+               <span class='label'>retry_hook:</span>          <span class='kw'>nil</span><span class='comma'>,</span>
+               <span class='label'>logger:</span>              <span class='kw'>nil</span><span class='comma'>,</span>
+               <span class='label'>debug_http:</span>          <span class='kw'>false</span><span class='rparen'>)</span>
   <span class='ivar'>@host</span> <span class='op'>=</span> <span class='id identifier rubyid_host'>host</span>
   <span class='ivar'>@token</span> <span class='op'>=</span> <span class='id identifier rubyid_token'>token</span>
   <span class='ivar'>@logger</span> <span class='op'>=</span> <span class='id identifier rubyid_init_logger'>init_logger</span><span class='lparen'>(</span><span class='id identifier rubyid_logger'>logger</span><span class='rparen'>)</span>
-  <span class='ivar'>@rate_limit</span> <span class='op'>=</span> <span class='const'>Struct</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='symbol'>:limit</span><span class='comma'>,</span> <span class='symbol'>:remaining</span><span class='comma'>,</span> <span class='symbol'>:reset</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='ivar'>@user_agent</span> <span class='op'>=</span> <span class='id identifier rubyid_user_agent'>user_agent</span>
+  <span class='ivar'>@user_agent</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_ua_comment'>ua_comment</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_ua_comment'>ua_comment</span>
+  <span class='ivar'>@user_agent</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span>
+  <span class='ivar'>@rate_limit_retry</span> <span class='op'>=</span> <span class='id identifier rubyid_rate_limit_retry'>rate_limit_retry</span>
+  <span class='ivar'>@retry_hook</span> <span class='op'>=</span> <span class='id identifier rubyid_retry_hook'>retry_hook</span>
   <span class='ivar'>@debug_http</span> <span class='op'>=</span> <span class='id identifier rubyid_debug_http'>debug_http</span>
+  <span class='ivar'>@rate_limit</span> <span class='op'>=</span> <span class='const'>Struct</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='symbol'>:limit</span><span class='comma'>,</span> <span class='symbol'>:remaining</span><span class='comma'>,</span> <span class='symbol'>:reset</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Error.html" title="Shep::Error (class)">Error</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Error/Caller.html" title="Shep::Error::Caller (class)">Caller</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>retry_hook: must a callable or nil</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>unless</span>
+    <span class='ivar'>@retry_hook</span> <span class='op'>==</span> <span class='kw'>nil</span> <span class='op'>||</span> <span class='ivar'>@retry_hook</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:call</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -964,8 +1153,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>The Server’s hostname</p>
+    <p>The Server&#39;s hostname</p>
   </div>
@@ -983,8 +1171,7 @@
         &mdash;
-        <div class='inline'>
-<p>the current value of host</p>
+        <div class='inline'><p>the current value of host</p>
 </div>
     </li>
@@ -997,12 +1184,12 @@
       <pre class="lines">
-41
-42
-43</pre>
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 90</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_host'>host</span>
   <span class='ivar'>@host</span>
@@ -1025,8 +1212,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>The logger object</p>
+    <p>The logger object</p>
   </div>
@@ -1044,8 +1230,7 @@
         &mdash;
-        <div class='inline'>
-<p>the current value of logger</p>
+        <div class='inline'><p>the current value of logger</p>
 </div>
     </li>
@@ -1058,12 +1243,12 @@
       <pre class="lines">
-41
-42
-43</pre>
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 90</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_logger'>logger</span>
   <span class='ivar'>@logger</span>
@@ -1073,6 +1258,65 @@
 </table>
 </div>
+      <span id=""></span>
+      <div class="method_details ">
+  <h3 class="signature " id="user_agent-instance_method">
+    #<strong>user_agent</strong>  &#x21d2; <tt>String</tt>  <span class="extras">(readonly)</span>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>User-Agent string; frozen</p>
+  </div>
+</div>
+<div class="tags">
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'><p>the current value of user_agent</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+90
+91
+92</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 90</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_user_agent'>user_agent</span>
+  <span class='ivar'>@user_agent</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
   </div>
@@ -1091,8 +1335,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Delete the status at ID.</p>
+    <p>Delete the status at ID.</p>
   </div>
@@ -1110,8 +1353,7 @@
         &mdash;
-        <div class='inline'>
-<p>the deleted status</p>
+        <div class='inline'><p>the deleted status</p>
 </div>
     </li>
@@ -1131,10 +1373,10 @@
       <pre class="lines">
-657</pre>
+789</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 657</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 789</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_delete_status'>delete_status</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_rest_delete'>rest_delete</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>statuses/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Status.html" title="Shep::Entity::Status (class)">Status</a></span></span><span class='rparen'>)</span></pre>
     </td>
@@ -1153,10 +1395,11 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Dismiss the notification with the given ID.</p>
+    <p>Dismiss the notification with the given ID.</p>
-<p>Warning: due to the complexity involved in repeatably sending a notification to an account, there is limited test coverage for this method.</p>
+<p>Warning: due to the complexity involved in repeatably sending a
+notification to an account, there is limited test coverage for
+this method.</p>
   </div>
@@ -1177,14 +1420,14 @@
       <pre class="lines">
-666
-667
-668
-669
-670</pre>
+798
+799
+800
+801
+802</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 666</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 798</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_dismiss_notification'>dismiss_notification</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_url'>url</span> <span class='op'>=</span> <span class='id identifier rubyid_rest_uri'>rest_uri</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>notifications/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_content'>/dismiss</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
@@ -1207,8 +1450,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve each Entity::Account that boosted the given status.</p>
+    <p>Retrieve each Entity::Account that boosted the given status.</p>
   </div>
@@ -1229,8 +1471,7 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of items to retrieve</p>
+        <div class='inline'><p>Maximum number of items to retrieve</p>
 </div>
     </li>
@@ -1276,8 +1517,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -1297,16 +1537,16 @@
       <pre class="lines">
-460
-461
-462
-463
-464
-465
-466</pre>
+574
+575
+576
+577
+578
+579
+580</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 460</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 574</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_boost_acct'>each_boost_acct</span><span class='lparen'>(</span><span class='id identifier rubyid_status_id'>status_id</span><span class='comma'>,</span>
                     <span class='label'>limit:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -1331,8 +1571,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve each account that favourited the given status.</p>
+    <p>Retrieve each account that favourited the given status.</p>
   </div>
@@ -1353,8 +1592,7 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of items to retrieve</p>
+        <div class='inline'><p>Maximum number of items to retrieve</p>
 </div>
     </li>
@@ -1400,8 +1638,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -1421,16 +1658,16 @@
       <pre class="lines">
-480
-481
-482
-483
-484
-485
-486</pre>
+594
+595
+596
+597
+598
+599
+600</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 480</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 594</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_fave_acct'>each_fave_acct</span><span class='lparen'>(</span><span class='id identifier rubyid_status_id'>status_id</span><span class='comma'>,</span>
                    <span class='label'>limit:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -1455,8 +1692,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve the follower list of an account.</p>
+    <p>Retrieve the follower list of an account.</p>
 <p>As of Mastodon 4.0, no longer requires a token.</p>
@@ -1477,8 +1713,7 @@
         &mdash;
-        <div class='inline'>
-<p>The account</p>
+        <div class='inline'><p>The account</p>
 </div>
     </li>
@@ -1495,8 +1730,7 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of items to retrieve</p>
+        <div class='inline'><p>Maximum number of items to retrieve</p>
 </div>
     </li>
@@ -1514,8 +1748,7 @@
         &mdash;
-        <div class='inline'>
-<p>Optional; applied to each item</p>
+        <div class='inline'><p>Optional; applied to each item</p>
 </div>
     </li>
@@ -1547,8 +1780,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -1568,16 +1800,16 @@
       <pre class="lines">
-268
-269
-270
-271
-272
-273
-274</pre>
+366
+367
+368
+369
+370
+371
+372</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 268</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 366</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_follower'>each_follower</span><span class='lparen'>(</span><span class='id identifier rubyid_account_id'>account_id</span><span class='comma'>,</span>
                   <span class='label'>limit:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -1602,8 +1834,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve the list of accounts this account follows</p>
+    <p>Retrieve the list of accounts this account follows</p>
   </div>
@@ -1622,8 +1853,7 @@
         &mdash;
-        <div class='inline'>
-<p>The account</p>
+        <div class='inline'><p>The account</p>
 </div>
     </li>
@@ -1640,8 +1870,7 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of items to retrieve</p>
+        <div class='inline'><p>Maximum number of items to retrieve</p>
 </div>
     </li>
@@ -1659,8 +1888,7 @@
         &mdash;
-        <div class='inline'>
-<p>Optional; applied to each item</p>
+        <div class='inline'><p>Optional; applied to each item</p>
 </div>
     </li>
@@ -1692,8 +1920,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -1713,16 +1940,16 @@
       <pre class="lines">
-288
-289
-290
-291
-292
-293
-294</pre>
+386
+387
+388
+389
+390
+391
+392</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 288</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 386</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_following'>each_following</span><span class='lparen'>(</span><span class='id identifier rubyid_account_id'>account_id</span><span class='comma'>,</span>
                    <span class='label'>limit:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -1739,7 +1966,7 @@
       <div class="method_details ">
   <h3 class="signature " id="each_home_status-instance_method">
-    #<strong>each_home_status</strong>(limit: nil, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; <tt>Enumerator</tt>
+    #<strong>each_home_status</strong>(limit: nil, local: false, max_id: &quot;&quot;, remote: false, only_media: false) {|item| ... } &#x21d2; <tt>Enumerator</tt>
@@ -1747,8 +1974,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve each Entity::Status in the home timeline.</p>
+    <p>Retrieve each Entity::Status in the home timeline.</p>
 <p>Requires token.</p>
@@ -1771,8 +1997,24 @@
         &mdash;
-        <div class='inline'>
-<p>,</p>
+        <div class='inline'><p>maximum number of items to retrieve</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>max_id</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>&quot;&quot;</tt>)</em>
+        &mdash;
+        <div class='inline'><p>retrieve results older than this ID.</p>
 </div>
     </li>
@@ -1789,8 +2031,7 @@
         &mdash;
-        <div class='inline'>
-<p>,</p>
+        <div class='inline'><p>retrieve only local statuses</p>
 </div>
     </li>
@@ -1807,8 +2048,7 @@
         &mdash;
-        <div class='inline'>
-<p>,</p>
+        <div class='inline'><p>retrieve only remote statuses</p>
 </div>
     </li>
@@ -1825,8 +2065,7 @@
         &mdash;
-        <div class='inline'>
-<p>,</p>
+        <div class='inline'><p>retrieve only media status</p>
 </div>
     </li>
@@ -1872,8 +2111,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -1893,20 +2131,22 @@
       <pre class="lines">
-438
-439
-440
-441
-442
-443
-444
-445</pre>
+551
+552
+553
+554
+555
+556
+557
+558
+559</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 438</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 551</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_home_status'>each_home_status</span><span class='lparen'>(</span><span class='label'>limit:</span>              <span class='kw'>nil</span><span class='comma'>,</span>
                      <span class='label'>local:</span>              <span class='kw'>false</span><span class='comma'>,</span>
+                     <span class='label'>max_id:</span>             <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                      <span class='label'>remote:</span>             <span class='kw'>false</span><span class='comma'>,</span>
                      <span class='label'>only_media:</span>         <span class='kw'>false</span><span class='comma'>,</span>
                      <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
@@ -1929,8 +2169,18 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve each notification.</p>
+    <p>Retrieve each notification.</p>
+<p>Requires a bearer token.</p>
+<p>Notification types are indicated by of the following symbols:</p>
+<p><code>:mention</code>, <code>:status</code>, <code>:reblog</code>, <code>:follow</code>, <code>:follow_request</code>
+<code>:favourite</code>, <code>:poll</code>, <code>:update</code>, <code>:admin.sign_up</code>, or
+<code>:admin.report</code></p>
+<p>This method will throw an <code>Error::Caller</code> exception if an
+unknown value is used.</p>
   </div>
@@ -1951,8 +2201,8 @@
         &mdash;
-        <div class='inline'>
-<p>list of notifications types to enumerate; others are ignoredn</p>
+        <div class='inline'><p>list of notifications types to
+enumerate; others are ignoredn</p>
 </div>
     </li>
@@ -1969,8 +2219,7 @@
         &mdash;
-        <div class='inline'>
-<p>types of notifications to exclude</p>
+        <div class='inline'><p>types of notifications to exclude</p>
 </div>
     </li>
@@ -1987,8 +2236,7 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of items to retrieve</p>
+        <div class='inline'><p>Maximum number of items to retrieve</p>
 </div>
     </li>
@@ -2005,8 +2253,8 @@
         &mdash;
-        <div class='inline'>
-<p>Only retrieve notifications from the account with this ID.</p>
+        <div class='inline'><p>Only retrieve notifications from
+the account with this ID.</p>
 </div>
     </li>
@@ -2024,8 +2272,7 @@
         &mdash;
-        <div class='inline'>
-<p>Applied to each Notification</p>
+        <div class='inline'><p>Applied to each Notification</p>
 </div>
     </li>
@@ -2057,8 +2304,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -2078,30 +2324,34 @@
       <pre class="lines">
-508
-509
-510
-511
-512
-513
-514
-515
-516
-517
-518
-519
-520
-521
-522
-523
-524
-525
-526
-527
-528</pre>
+634
+635
+636
+637
+638
+639
+640
+641
+642
+643
+644
+645
+646
+647
+648
+649
+650
+651
+652
+653
+654
+655
+656
+657
+658</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 508</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 634</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_notification'>each_notification</span><span class='lparen'>(</span><span class='label'>types:</span>            <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span>
                       <span class='label'>exclude_types:</span>    <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span>
@@ -2112,10 +2362,14 @@
                              </span><span class='tstring_content'>favourite</span><span class='words_sep'> </span><span class='tstring_content'>poll</span><span class='words_sep'> </span><span class='tstring_content'>update</span><span class='words_sep'> </span><span class='tstring_content'>admin.sign_up</span><span class='words_sep'>
                              </span><span class='tstring_content'>admin.report</span><span class='tstring_end'>}</span></span>
-  <span class='comment'># Ensure valid filter values
-</span>  <span class='id identifier rubyid_types'>types</span><span class='period'>.</span><span class='id identifier rubyid_uniq!'>uniq!</span>
-  <span class='id identifier rubyid_exclude_types'>exclude_types</span><span class='period'>.</span><span class='id identifier rubyid_uniq!'>uniq!</span>
-  <span class='lparen'>(</span><span class='id identifier rubyid_types'>types</span> <span class='op'>+</span> <span class='id identifier rubyid_exclude_types'>exclude_types</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_filter'>filter</span><span class='op'>|</span>
+  <span class='comment'># Remove duplicates and convert strings to symbols
+</span>  <span class='lbracket'>[</span><span class='id identifier rubyid_types'>types</span><span class='comma'>,</span> <span class='id identifier rubyid_exclude_types'>exclude_types</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_param'>param</span><span class='op'>|</span>
+    <span class='id identifier rubyid_param'>param</span><span class='period'>.</span><span class='id identifier rubyid_map!'>map!</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_item'>item</span><span class='op'>|</span> <span class='id identifier rubyid_item'>item</span><span class='period'>.</span><span class='id identifier rubyid_intern'>intern</span><span class='rbrace'>}</span>
+    <span class='id identifier rubyid_param'>param</span><span class='period'>.</span><span class='id identifier rubyid_uniq!'>uniq!</span>
+  <span class='rbrace'>}</span>
+  <span class='comment'># Now, ensure there are no incorrect notification types.
+</span>  <span class='lparen'>(</span><span class='id identifier rubyid_types'>types</span> <span class='op'>+</span> <span class='id identifier rubyid_exclude_types'>exclude_types</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_filter'>filter</span><span class='op'>|</span>
     <span class='id identifier rubyid_assert'>assert</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown notification type: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_filter'>filter</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='lbrace'>{</span>
       <span class='id identifier rubyid_allowed_notifications'>allowed_notifications</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='id identifier rubyid_filter'>filter</span><span class='period'>.</span><span class='id identifier rubyid_intern'>intern</span><span class='rparen'>)</span>
     <span class='rbrace'>}</span>
@@ -2132,7 +2386,7 @@
       <div class="method_details ">
   <h3 class="signature " id="each_public_status-instance_method">
-    #<strong>each_public_status</strong>(limit: nil, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; <tt>Enumerator</tt>
+    #<strong>each_public_status</strong>(limit: nil, max_id: &quot;&quot;, local: false, remote: false, only_media: false) {|item| ... } &#x21d2; <tt>Enumerator</tt>
@@ -2140,10 +2394,9 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve the instance’s public timeline(s)</p>
+    <p>Retrieve the instance&#39;s public timeline(s)</p>
-<p>May require a token depending on the instance’s settings.</p>
+<p>May require a token depending on the instance&#39;s settings.</p>
   </div>
@@ -2164,8 +2417,24 @@
         &mdash;
-        <div class='inline'>
-<p>Max. items to retrieve.</p>
+        <div class='inline'><p>Max. items to retrieve.</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>max_id</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>&quot;&quot;</tt>)</em>
+        &mdash;
+        <div class='inline'><p>retrieve results older than this ID.</p>
 </div>
     </li>
@@ -2182,8 +2451,7 @@
         &mdash;
-        <div class='inline'>
-<p>Retrieve only local statuses</p>
+        <div class='inline'><p>Retrieve only local statuses</p>
 </div>
     </li>
@@ -2200,8 +2468,7 @@
         &mdash;
-        <div class='inline'>
-<p>Retrieve only remote statuses</p>
+        <div class='inline'><p>Retrieve only remote statuses</p>
 </div>
     </li>
@@ -2218,8 +2485,7 @@
         &mdash;
-        <div class='inline'>
-<p>Retrieve only statuses with media</p>
+        <div class='inline'><p>Retrieve only statuses with media</p>
 </div>
     </li>
@@ -2237,8 +2503,7 @@
         &mdash;
-        <div class='inline'>
-<p>Optional; applied to each item</p>
+        <div class='inline'><p>Optional; applied to each item</p>
 </div>
     </li>
@@ -2270,8 +2535,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -2291,19 +2555,21 @@
       <pre class="lines">
-353
-354
-355
-356
-357
-358
-359
-360</pre>
+456
+457
+458
+459
+460
+461
+462
+463
+464</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 353</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 456</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_public_status'>each_public_status</span><span class='lparen'>(</span><span class='label'>limit:</span>              <span class='kw'>nil</span><span class='comma'>,</span>
+                       <span class='label'>max_id:</span>             <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                        <span class='label'>local:</span>              <span class='kw'>false</span><span class='comma'>,</span>
                        <span class='label'>remote:</span>             <span class='kw'>false</span><span class='comma'>,</span>
                        <span class='label'>only_media:</span>         <span class='kw'>false</span><span class='comma'>,</span>
@@ -2319,7 +2585,7 @@
       <div class="method_details ">
   <h3 class="signature " id="each_status-instance_method">
-    #<strong>each_status</strong>(account_id, limit: nil, only_media: false, exclude_replies: false, exclude_reblogs: false, pinned: false, tagged: nil) {|item| ... } &#x21d2; <tt>Enumerator</tt>
+    #<strong>each_status</strong>(account_id, limit: nil, max_id: &quot;&quot;, only_media: false, exclude_replies: false, exclude_reblogs: false, pinned: false, tagged: nil) {|item| ... } &#x21d2; <tt>Enumerator</tt>
@@ -2327,8 +2593,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve the account’s statuses</p>
+    <p>Retrieve the account&#39;s statuses</p>
   </div>
@@ -2347,8 +2612,7 @@
         &mdash;
-        <div class='inline'>
-<p>The ID of the account</p>
+        <div class='inline'><p>The ID of the account</p>
 </div>
     </li>
@@ -2365,8 +2629,25 @@
         &mdash;
-        <div class='inline'>
-<p>Maximum number of accounts to retrieve</p>
+        <div class='inline'><p>Maximum number of accounts to
+retrieve</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>max_id</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>&quot;&quot;</tt>)</em>
+        &mdash;
+        <div class='inline'><p>retrieve results older than this ID.</p>
 </div>
     </li>
@@ -2383,8 +2664,8 @@
         &mdash;
-        <div class='inline'>
-<p>If true, filter for statuses with media</p>
+        <div class='inline'><p>If true, filter for statuses
+with media</p>
 </div>
     </li>
@@ -2401,8 +2682,7 @@
         &mdash;
-        <div class='inline'>
-<p>If true, exclude replies</p>
+        <div class='inline'><p>If true, exclude replies</p>
 </div>
     </li>
@@ -2419,8 +2699,7 @@
         &mdash;
-        <div class='inline'>
-<p>If true, exclude boosts</p>
+        <div class='inline'><p>If true, exclude boosts</p>
 </div>
     </li>
@@ -2437,8 +2716,8 @@
         &mdash;
-        <div class='inline'>
-<p>If true, filter for pinned statuses</p>
+        <div class='inline'><p>If true, filter for pinned
+statuses</p>
 </div>
     </li>
@@ -2455,8 +2734,8 @@
         &mdash;
-        <div class='inline'>
-<p>Filter for statuses containing the given tag</p>
+        <div class='inline'><p>Filter for statuses containing the
+given tag</p>
 </div>
     </li>
@@ -2474,8 +2753,7 @@
         &mdash;
-        <div class='inline'>
-<p>Optional; applied to each item</p>
+        <div class='inline'><p>Optional; applied to each item</p>
 </div>
     </li>
@@ -2507,8 +2785,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -2528,23 +2805,25 @@
       <pre class="lines">
-322
-323
-324
-325
-326
-327
-328
-329
-330
-331
-332</pre>
+422
+423
+424
+425
+426
+427
+428
+429
+430
+431
+432
+433</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 322</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 422</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_status'>each_status</span><span class='lparen'>(</span><span class='id identifier rubyid_account_id'>account_id</span><span class='comma'>,</span>
                 <span class='label'>limit:</span>              <span class='kw'>nil</span><span class='comma'>,</span>
+                <span class='label'>max_id:</span>             <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                 <span class='label'>only_media:</span>         <span class='kw'>false</span><span class='comma'>,</span>
                 <span class='label'>exclude_replies:</span>    <span class='kw'>false</span><span class='comma'>,</span>
                 <span class='label'>exclude_reblogs:</span>    <span class='kw'>false</span><span class='comma'>,</span>
@@ -2562,7 +2841,7 @@
       <div class="method_details ">
   <h3 class="signature " id="each_tag_status-instance_method">
-    #<strong>each_tag_status</strong>(hashtag_s, limit: nil, local: false, remote: false, only_media: false, all: [], none: []) {|item| ... } &#x21d2; <tt>Enumerator</tt>
+    #<strong>each_tag_status</strong>(hashtag_s, limit: nil, max_id: &quot;&quot;, local: false, remote: false, only_media: false, all: [], none: []) {|item| ... } &#x21d2; <tt>Enumerator</tt>
@@ -2570,10 +2849,12 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Retrieve a tag’s timeline.</p>
+    <p>Retrieve a tag&#39;s timeline.</p>
-<p>The tag may either be a String (containing one hashtag) or an Array containing one or more. If more than one hashtag is given, all statuses containing <strong>any</strong> of the given hashtags are retrieved. (This uses the <code>any[]</code> parameter in the API.)</p>
+<p>The tag may either be a String (containing one hashtag) or an
+Array containing one or more.  If more than one hashtag is
+given, all statuses containing <strong>any</strong> of the given hashtags are
+retrieved.  (This uses the <code>any[]</code> parameter in the API.)</p>
 <p>There is currently no check for contradictory tag lists.</p>
@@ -2594,8 +2875,7 @@
         &mdash;
-        <div class='inline'>
-<p>Hashtag(s) to retrieve.</p>
+        <div class='inline'><p>Hashtag(s) to retrieve.</p>
 </div>
     </li>
@@ -2612,8 +2892,24 @@
         &mdash;
-        <div class='inline'>
-<p>maximum number of items to retrieve</p>
+        <div class='inline'><p>maximum number of items to retrieve</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>max_id</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        <em class="default">(defaults to: <tt>&quot;&quot;</tt>)</em>
+        &mdash;
+        <div class='inline'><p>return results older than this ID.</p>
 </div>
     </li>
@@ -2630,8 +2926,7 @@
         &mdash;
-        <div class='inline'>
-<p>retrieve only local statuses</p>
+        <div class='inline'><p>retrieve only local statuses</p>
 </div>
     </li>
@@ -2648,8 +2943,7 @@
         &mdash;
-        <div class='inline'>
-<p>retrieve only remote statuses</p>
+        <div class='inline'><p>retrieve only remote statuses</p>
 </div>
     </li>
@@ -2666,8 +2960,7 @@
         &mdash;
-        <div class='inline'>
-<p>retrieve only media status</p>
+        <div class='inline'><p>retrieve only media status</p>
 </div>
     </li>
@@ -2684,8 +2977,8 @@
         &mdash;
-        <div class='inline'>
-<p>list of other tags that must also be present.</p>
+        <div class='inline'><p>list of other tags that
+must also be present.</p>
 </div>
     </li>
@@ -2702,8 +2995,7 @@
         &mdash;
-        <div class='inline'>
-<p>list of tags that are excluded.</p>
+        <div class='inline'><p>list of tags that are excluded.</p>
 </div>
     </li>
@@ -2721,8 +3013,7 @@
         &mdash;
-        <div class='inline'>
-<p>block to apply to each Status; optional</p>
+        <div class='inline'><p>block to apply to each Status; optional</p>
 </div>
     </li>
@@ -2754,8 +3045,7 @@
         &mdash;
-        <div class='inline'>
-<p>if block is not given, otherwise self</p>
+        <div class='inline'><p>if block is not given, otherwise self</p>
 </div>
     </li>
@@ -2775,38 +3065,40 @@
       <pre class="lines">
-393
-394
-395
-396
-397
-398
-399
-400
-401
-402
-403
-404
-405
-406
-407
-408
-409
-410
-411
-412
-413
-414
-415
-416
-417
-418</pre>
+499
+500
+501
+502
+503
+504
+505
+506
+507
+508
+509
+510
+511
+512
+513
+514
+515
+516
+517
+518
+519
+520
+521
+522
+523
+524
+525</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 393</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 499</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_tag_status'>each_tag_status</span><span class='lparen'>(</span><span class='id identifier rubyid_hashtag_s'>hashtag_s</span><span class='comma'>,</span>
                     <span class='label'>limit:</span>              <span class='kw'>nil</span><span class='comma'>,</span>
+                    <span class='label'>max_id:</span>             <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                     <span class='label'>local:</span>              <span class='kw'>false</span><span class='comma'>,</span>
                     <span class='label'>remote:</span>             <span class='kw'>false</span><span class='comma'>,</span>
                     <span class='label'>only_media:</span>         <span class='kw'>false</span><span class='comma'>,</span>
@@ -2847,12 +3139,17 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Update the status with the given Id.</p>
+    <p>Update the status with the given Id.</p>
-<p>Requires token with sufficient permission for the account that owns the status.</p>
+<p>Requires token with sufficient permission for the account that
+owns the status.</p>
-<p>Notionally, this method will change <em>all</em> of the affected status parts each time it’s invoked, passing the default parameter if none is given. This is because it is unclear how the API handles omitted fields so we just don’t do that. (You can force it to omit an argument by setting it to nil; this may or may not work for you.)</p>
+<p>Notionally, this method will change <em>all</em> of the affected status
+parts each time it&#39;s invoked, passing the default parameter if
+none is given.  This is because it is unclear how the API
+handles omitted fields so we just don&#39;t do that.  (You can force
+it to omit an argument by setting it to nil; this may or may not
+work for you.)</p>
   </div>
@@ -2871,8 +3168,7 @@
         &mdash;
-        <div class='inline'>
-<p>id of the status to edit</p>
+        <div class='inline'><p>id of the status to edit</p>
 </div>
     </li>
@@ -2887,8 +3183,7 @@
         &mdash;
-        <div class='inline'>
-<p>new status text</p>
+        <div class='inline'><p>new status text</p>
 </div>
     </li>
@@ -2905,8 +3200,8 @@
         &mdash;
-        <div class='inline'>
-<p>array of media object IDs to attach to this status.</p>
+        <div class='inline'><p>array of media object IDs
+to attach to this status.</p>
 </div>
     </li>
@@ -2923,8 +3218,9 @@
         &mdash;
-        <div class='inline'>
-<p>Sets or clears the content warning. Non-empty value also sets the <code>sensitive</code> field.</p>
+        <div class='inline'><p>Sets or clears the content
+warning. Non-empty value also
+sets the <code>sensitive</code> field.</p>
 </div>
     </li>
@@ -2941,8 +3237,10 @@
         &mdash;
-        <div class='inline'>
-<p>The language of the status; defaults to “en”. (Apologies for the anglocentrism; this should be consistent.)</p>
+        <div class='inline'><p>The language of the status;
+defaults to &quot;en&quot;. (Apologies for
+the anglocentrism; this should be
+consistent.)</p>
 </div>
     </li>
@@ -2960,8 +3258,7 @@
         &mdash;
-        <div class='inline'>
-<p>the updated status</p>
+        <div class='inline'><p>the updated status</p>
 </div>
     </li>
@@ -2981,21 +3278,21 @@
       <pre class="lines">
-607
-608
-609
-610
-611
-612
-613
-614
-615
-616
-617
-618</pre>
+739
+740
+741
+742
+743
+744
+745
+746
+747
+748
+749
+750</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 607</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 739</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_edit_status'>edit_status</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='comma'>,</span> <span class='id identifier rubyid_status'>status</span><span class='comma'>,</span>
                 <span class='label'>media_ids:</span>          <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span>
@@ -3025,8 +3322,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch user details by ID</p>
+    <p>Fetch user details by ID</p>
   </div>
@@ -3045,8 +3341,7 @@
         &mdash;
-        <div class='inline'>
-<p>the ID code of the account</p>
+        <div class='inline'><p>the ID code of the account</p>
 </div>
     </li>
@@ -3080,12 +3375,12 @@
       <pre class="lines">
-145
-146
-147</pre>
+238
+239
+240</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 145</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 238</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_account'>fetch_account</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>accounts/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Account</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
@@ -3098,7 +3393,7 @@
       <div class="method_details ">
   <h3 class="signature " id="fetch_account_by_username-instance_method">
-    #<strong>fetch_account_by_username</strong>(handle)  &#x21d2; <tt><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Entity::Account</a></span></tt>
+    #<strong>fetch_account_by_username</strong>(handle)  &#x21d2; <tt><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Entity::Account</a></span></tt><sup>?</sup>
@@ -3106,8 +3401,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch user details by username.</p>
+    <p>Fetch user details by username.</p>
 <p>The username must belong to a user on the current server.</p>
@@ -3128,8 +3422,8 @@
         &mdash;
-        <div class='inline'>
-<p>the account’s username <strong>with</strong> the leading ‘@’ character (e.g. @benoitmandelbot)</p>
+        <div class='inline'><p>the account&#39;s username with or without the
+leading &#39;@&#39; character (e.g. @benoitmandelbot)</p>
 </div>
     </li>
@@ -3142,10 +3436,14 @@
     <li>
-        <span class='type'>(<tt><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Entity::Account</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Entity::Account</a></span></tt>, <tt>nil</tt>)</span>
+        &mdash;
+        <div class='inline'><p>The Account or nil if it can&#39;t be found.</p>
+</div>
     </li>
 </ul>
@@ -3163,15 +3461,23 @@
       <pre class="lines">
-159
-160
-161</pre>
+253
+254
+255
+256
+257
+258
+259</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 159</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 253</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_account_by_username'>fetch_account_by_username</span><span class='lparen'>(</span><span class='id identifier rubyid_handle'>handle</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>accounts/lookup</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Account</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='label'>acct:</span> <span class='id identifier rubyid_handle'>handle</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+<span class='kw'>rescue</span> <span class='const'><span class='object_link'><a href="Error.html" title="Shep::Error (class)">Error</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Error/Http.html" title="Shep::Error::Http (class)">Http</a></span></span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_oopsie'>oopsie</span>
+  <span class='comment'># As a special case, return nil if the lookup fails
+</span>  <span class='kw'>return</span> <span class='kw'>nil</span> <span class='kw'>if</span> <span class='id identifier rubyid_oopsie'>oopsie</span><span class='period'>.</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Net</span><span class='op'>::</span><span class='const'>HTTPNotFound</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='id identifier rubyid_oopsie'>oopsie</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -3189,8 +3495,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch the context (parent and child status) of status at ‘id’</p>
+    <p>Fetch the context (parent and child status) of status at &#39;id&#39;</p>
   </div>
@@ -3224,10 +3529,10 @@
       <pre class="lines">
-187</pre>
+285</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 187</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 285</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_context'>fetch_context</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>statuses/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_content'>/context</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Context.html" title="Shep::Entity::Context (class)">Context</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span></pre>
     </td>
@@ -3246,8 +3551,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch an individual notification by ID.</p>
+    <p>Fetch an individual notification by ID.</p>
 <p>Requires a token with sufficient permissions.</p>
@@ -3268,8 +3572,7 @@
         &mdash;
-        <div class='inline'>
-<p>the notification ID</p>
+        <div class='inline'><p>the notification ID</p>
 </div>
     </li>
@@ -3303,11 +3606,11 @@
       <pre class="lines">
-172
-173</pre>
+270
+271</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 172</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 270</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_notification'>fetch_notification</span><span class='lparen'>(</span><span class='id identifier rubyid_ntfn_id'>ntfn_id</span><span class='rparen'>)</span> <span class='op'>=</span>
 <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>notifications/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_ntfn_id'>ntfn_id</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Notification.html" title="Shep::Entity::Notification (class)">Notification</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span></pre>
@@ -3327,8 +3630,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch a single status</p>
+    <p>Fetch a single status</p>
   </div>
@@ -3362,10 +3664,10 @@
       <pre class="lines">
-180</pre>
+278</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 180</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 278</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_status'>fetch_status</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>statuses/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Status.html" title="Shep::Entity::Status (class)">Status</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span></pre>
     </td>
@@ -3384,8 +3686,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch the editable source of status at id.</p>
+    <p>Fetch the editable source of status at id.</p>
 <p>Requires token.</p>
@@ -3421,11 +3722,11 @@
       <pre class="lines">
-196
-197</pre>
+294
+295</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 196</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 294</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_status_src'>fetch_status_src</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>statuses/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_id'>id</span><span class='embexpr_end'>}</span><span class='tstring_content'>/source</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
 <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/StatusSource.html" title="Shep::Entity::StatusSource (class)">StatusSource</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span></pre>
@@ -3445,14 +3746,22 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Fetch the given status and also any attached media.</p>
+    <p>Fetch the given status and also any attached media.</p>
-<p>Media is downloaded into the given directory unless a file with the expected name is already there (and <code>refetch</code> is not <code>true</code>).</p>
+<p>Media is downloaded into the given directory unless a file with
+the expected name is already there (and <code>refetch</code> is not
+<code>true</code>).</p>
-<p>Filenames are chosen by the function; the second return value (a <code>Hash</code>) can be used to find them. Value order also corresponds to the order of the returned <code>Status</code>‘s <code>media_attachments</code> field.</p>
+<p>Filenames are chosen by the function; the second return value (a
+<code>Hash</code>) can be used to find them.  Value order also corresponds
+to the order of the returned <code>Status</code>&#39;s <code>media_attachments</code>
+field.</p>
-<p>Note that intermediate files unique temporary names while downloading is in progress. This means it is safe to set <code>refetch</code> to false even if a previous download attempt failed. However, it is would be necessary to delete the intermediate file, which has the suffic “.tmp”.</p>
+<p>Note that intermediate files unique temporary names while
+downloading is in progress.  This means it is safe to set
+<code>refetch</code> to false even if a previous download attempt failed.
+However, it is would be necessary to delete the intermediate
+file, which has the suffic &quot;.tmp&quot;.</p>
   </div>
@@ -3471,8 +3780,7 @@
         &mdash;
-        <div class='inline'>
-<p>ID of the status to retrieve</p>
+        <div class='inline'><p>ID of the status to retrieve</p>
 </div>
     </li>
@@ -3489,8 +3797,7 @@
         &mdash;
-        <div class='inline'>
-<p>Path to the download directory</p>
+        <div class='inline'><p>Path to the download directory</p>
 </div>
     </li>
@@ -3507,8 +3814,8 @@
         &mdash;
-        <div class='inline'>
-<p>Fetch the media even if it is already present</p>
+        <div class='inline'><p>Fetch the media even if it is already
+present</p>
 </div>
     </li>
@@ -3526,8 +3833,8 @@
         &mdash;
-        <div class='inline'>
-<p>the Status and a Hash mapping the media URL to the corresponding local file.</p>
+        <div class='inline'><p>the Status and a Hash mapping the media
+URL to the corresponding local file.</p>
 </div>
     </li>
@@ -3547,34 +3854,34 @@
       <pre class="lines">
-227
-228
-229
-230
-231
-232
-233
-234
-235
-236
-237
-238
-239
-240
-241
-242
-243
-244
-245
-246
-247
-248
-249
-250
-251</pre>
+325
+326
+327
+328
+329
+330
+331
+332
+333
+334
+335
+336
+337
+338
+339
+340
+341
+342
+343
+344
+345
+346
+347
+348
+349</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 227</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 325</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch_status_with_media'>fetch_status_with_media</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='comma'>,</span> <span class='id identifier rubyid_media_dir'>media_dir</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>refetch:</span> <span class='kw'>true</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_status'>status</span> <span class='op'>=</span> <span class='id identifier rubyid_fetch_status'>fetch_status</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
@@ -3585,18 +3892,18 @@
     <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_refetch'>refetch</span> <span class='op'>&amp;&amp;</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_exist?'>exist?</span><span class='lparen'>(</span><span class='id identifier rubyid_outfile'>outfile</span><span class='rparen'>)</span>
       <span class='ivar'>@logger</span><span class='period'>.</span><span class='id identifier rubyid_info'>info</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Found &#39;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_outfile'>outfile</span><span class='embexpr_end'>}</span><span class='tstring_content'>&#39;; skipping.</span><span class='tstring_end'>&quot;</span></span>
-      <span class='id identifier rubyid_success'>success</span> <span class='op'>=</span> <span class='kw'>true</span>
     <span class='kw'>else</span>
       <span class='id identifier rubyid_tmp'>tmp</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid_media_dir'>media_dir</span><span class='comma'>,</span> <span class='const'>SecureRandom</span><span class='period'>.</span><span class='id identifier rubyid_uuid'>uuid</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.tmp</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-      <span class='id identifier rubyid_success'>success</span> <span class='op'>=</span> <span class='id identifier rubyid_basic_get_binary'>basic_get_binary</span><span class='lparen'>(</span><span class='id identifier rubyid_ma'>ma</span><span class='period'>.</span><span class='id identifier rubyid_url'>url</span><span class='comma'>,</span> <span class='id identifier rubyid_tmp'>tmp</span><span class='rparen'>)</span>
-      <span class='kw'>if</span> <span class='id identifier rubyid_success'>success</span>
+      <span class='kw'>begin</span>
+        <span class='id identifier rubyid_basic_get_binary'>basic_get_binary</span><span class='lparen'>(</span><span class='id identifier rubyid_ma'>ma</span><span class='period'>.</span><span class='id identifier rubyid_url'>url</span><span class='comma'>,</span> <span class='id identifier rubyid_tmp'>tmp</span><span class='rparen'>)</span>
         <span class='const'>FileUtils</span><span class='period'>.</span><span class='id identifier rubyid_mv'>mv</span><span class='lparen'>(</span><span class='id identifier rubyid_tmp'>tmp</span><span class='comma'>,</span> <span class='id identifier rubyid_outfile'>outfile</span><span class='rparen'>)</span>
-      <span class='kw'>else</span>
+      <span class='kw'>rescue</span> <span class='const'><span class='object_link'><a href="Error.html" title="Shep::Error (class)">Error</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Error/Http.html" title="Shep::Error::Http (class)">Http</a></span></span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
         <span class='const'>FileUtils</span><span class='period'>.</span><span class='id identifier rubyid_rm'>rm</span><span class='lparen'>(</span><span class='id identifier rubyid_tmp'>tmp</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='kw'>true</span><span class='rparen'>)</span>
+        <span class='id identifier rubyid_raise'>raise</span> <span class='id identifier rubyid_e'>e</span>
       <span class='kw'>end</span>
     <span class='kw'>end</span>
-    <span class='id identifier rubyid_media'>media</span><span class='lbracket'>[</span><span class='id identifier rubyid_ma'>ma</span><span class='period'>.</span><span class='id identifier rubyid_url'>url</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_success'>success</span> <span class='op'>?</span> <span class='id identifier rubyid_outfile'>outfile</span> <span class='op'>:</span> <span class='kw'>nil</span>
+    <span class='id identifier rubyid_media'>media</span><span class='lbracket'>[</span><span class='id identifier rubyid_ma'>ma</span><span class='period'>.</span><span class='id identifier rubyid_url'>url</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_outfile'>outfile</span>
   <span class='rbrace'>}</span>
   <span class='kw'>return</span> <span class='lbracket'>[</span><span class='id identifier rubyid_status'>status</span><span class='comma'>,</span> <span class='id identifier rubyid_media'>media</span><span class='rbracket'>]</span>
@@ -3609,7 +3916,7 @@
       <div class="method_details ">
   <h3 class="signature " id="post_status-instance_method">
-    #<strong>post_status</strong>(text, visibility: :private, media_ids: [], spoiler_text: &quot;&quot;, language: &quot;&quot;)  &#x21d2; <tt>Object</tt>
+    #<strong>post_status</strong>(text, visibility: :private, media_ids: [], spoiler_text: &quot;&quot;, language: &quot;&quot;)  &#x21d2; <tt><span class='object_link'><a href="Entity/Status.html" title="Shep::Entity::Status (class)">Entity::Status</a></span></tt>
@@ -3617,12 +3924,14 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Post a status containing the given text at the specified visibility with zero or more media attachments.</p>
+    <p>Post a status containing the given text at the specified
+visibility with zero or more media attachments.</p>
-<p>visibility can be one of ‘public’, ‘private’, ‘unlisted’ or ‘direct’; these can be strings of symbols)</p>
+<p>visibility can be one of &#39;public&#39;, &#39;private&#39;, &#39;unlisted&#39; or
+&#39;direct&#39;; these can be strings of symbols)</p>
-<p>media_ids is an array containing the ID strings of any media that may need to be attached.</p>
+<p>media_ids is an array containing the ID strings of any media
+that may need to be attached.</p>
   </div>
@@ -3643,8 +3952,8 @@
         &mdash;
-        <div class='inline'>
-<p>Status visibility; one of :public, :public, :unlisted or :direct</p>
+        <div class='inline'><p>Status visibility; one of :public,
+:public, :unlisted or :direct</p>
 </div>
     </li>
@@ -3661,8 +3970,7 @@
         &mdash;
-        <div class='inline'>
-<p>List of IDs of attached media items.</p>
+        <div class='inline'><p>List of IDs of attached media items.</p>
 </div>
     </li>
@@ -3679,8 +3987,8 @@
         &mdash;
-        <div class='inline'>
-<p>Content warning if non-empty string. Also sets <code>sensitive</code> to true.</p>
+        <div class='inline'><p>Content warning if non-empty string.
+Also sets <code>sensitive</code> to true.</p>
 </div>
     </li>
@@ -3697,14 +4005,30 @@
         &mdash;
-        <div class='inline'>
-<p>ISO language code</p>
+        <div class='inline'><p>ISO language code</p>
 </div>
     </li>
 </ul>
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="Entity/Status.html" title="Shep::Entity::Status (class)">Entity::Status</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'><p>The new status.</p>
+</div>
+    </li>
+</ul>
 <p class="tag_title">Raises:</p>
 <ul class="raise">
@@ -3732,30 +4056,30 @@
       <pre class="lines">
-554
-555
-556
-557
-558
-559
-560
-561
-562
-563
-564
-565
-566
-567
-568
-569
-570
-571
-572
-573
-574</pre>
+686
+687
+688
+689
+690
+691
+692
+693
+694
+695
+696
+697
+698
+699
+700
+701
+702
+703
+704
+705
+706</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 554</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 686</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_post_status'>post_status</span><span class='lparen'>(</span><span class='id identifier rubyid_text'>text</span><span class='comma'>,</span>
                 <span class='label'>visibility:</span>       <span class='symbol'>:private</span><span class='comma'>,</span>
@@ -3794,19 +4118,24 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Return the rate limit information as of the last operation.</p>
+    <p>Return the rate limit information from the last REST request.</p>
 <p>The result is a Struct with the following fields:</p>
-<ul><li>
-<p>limit Integer - Number of allowed requests per time period</p>
-</li><li>
-<p>remaining Integer - Number of requests you have left</p>
-</li><li>
-<p>reset Time - Future time when the limit resets</p>
-</li></ul>
-<p>Note that different types of operations have different rate limits. For example, most endpoints can be called up to 300 times within 5 minutes but no more than 30 media uploads are allowed within a 30 minute time period.</p>
+<ul>
+<li>limit       Integer - Number of allowed requests per time period</li>
+<li>remaining   Integer - Number of requests you have left</li>
+<li>reset       Time -    Future time when the limit resets</li>
+</ul>
+<p>Note that different types of operations have different rate
+limits.  For example, most endpoints can be called up to 300
+times within 5 minutes but no more than 30 media uploads are
+allowed within a 30 minute time period.</p>
+<p>Note also that some Shep methods will perform multiple API
+requests; this is only ever the rate limit information from the
+latest of these.</p>
   </div>
@@ -3840,10 +4169,10 @@
       <pre class="lines">
-107</pre>
+200</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 107</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 200</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_rate_limit'>rate_limit</span> <span class='op'>=</span> <span class='ivar'>@rate_limit</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre>
     </td>
@@ -3862,8 +4191,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Return a human-readable summary of the rate limit.</p>
+    <p>Return a human-readable summary of the rate limit.</p>
 <p>text</p>
@@ -3883,8 +4211,7 @@
         &mdash;
-        <div class='inline'>
-<p><code>rate_limit()</code>‘s result as nicely-formatted</p>
+        <div class='inline'><p><code>rate_limit()</code>&#39;s result as nicely-formatted</p>
 </div>
     </li>
@@ -3897,16 +4224,16 @@
       <pre class="lines">
-114
-115
-116
-117
-118
-119
-120</pre>
+207
+208
+209
+210
+211
+212
+213</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 114</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 207</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_rate_limit_desc'>rate_limit_desc</span>
   <span class='id identifier rubyid_rem'>rem</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='ivar'>@rate_limit</span><span class='period'>.</span><span class='id identifier rubyid_remaining'>remaining</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>?</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>
@@ -3931,8 +4258,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Upload the media contained in the file at ‘path’.</p>
+    <p>Upload the media contained in the file at &#39;path&#39;.</p>
   </div>
@@ -3953,36 +4279,36 @@
       <pre class="lines">
-624
-625
-626
-627
-628
-629
-630
-631
-632
-633
-634
-635
-636
-637
-638
-639
-640
-641
-642
-643
-644
-645
-646
-647
-648
-649
-650</pre>
+756
+757
+758
+759
+760
+761
+762
+763
+764
+765
+766
+767
+768
+769
+770
+771
+772
+773
+774
+775
+776
+777
+778
+779
+780
+781
+782</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 624</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 756</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_upload_media'>upload_media</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span>
                  <span class='label'>content_type:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -4027,8 +4353,7 @@
 </h3><div class="docstring">
   <div class="discussion">
-<p>Return the Entity::Account object for the token we’re using.</p>
+    <p>Return the Entity::Account object for the token we&#39;re using.</p>
 <p>Requires a token (obviously).</p>
@@ -4064,12 +4389,12 @@
       <pre class="lines">
-134
-135
-136</pre>
+227
+228
+229</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 134</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/session.rb', line 227</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_verify_credentials'>verify_credentials</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_rest_get'>rest_get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>accounts/verify_credentials</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="Entity.html" title="Shep::Entity (class)">Entity</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Entity/Account.html" title="Shep::Entity::Account (class)">Account</a></span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
@@ -4084,9 +4409,9 @@
 </div>
       <div id="footer">
-  Generated on Sun Jun  4 13:40:34 2023 by
+  Generated on Sat Jun 10 19:16:30 2023 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.1.0).
+  0.9.34 (ruby-3.0.3).
 </div>
     </div>