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

data/doc/Shep/Entity.html

@@ -101,39 +101,52 @@
 
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-    
-<p>Abstract base class for Mastodon objects.</p>
+    <p>Abstract base class for Mastodon objects.</p>
 
-<p>Mastodon provides its content as JSON hashes with documented names and values. Shep takes this one step further and provides a class for each object type. These are similar to Ruby’s <code>Struct</code> but are also strongly typed.</p>
+<p>Mastodon provides its content as JSON hashes with documented names
+and values.  Shep takes this one step further and provides a class
+for each object type.  These are similar to Ruby&#39;s <code>Struct</code> but
+are also strongly typed.</p>
 
-<p>Typing is primarily useful for converting things that don’t have explicit JSON types (e.g. Time, URI) into Ruby types. However, it will also catch the case where you’re trying to set a field to something with the wrong type.</p>
+<p>Typing is primarily useful for converting things that don&#39;t have
+explicit JSON types (e.g. Time, URI) into Ruby types. However, it
+will also catch the case where you&#39;re trying to set a field to
+something with the wrong type.</p>
 
 <p>Supported types are:</p>
-<ul><li>
-<p>Number - (Integer but also allows Float)</p>
-</li><li>
-<p>Boolean</p>
-</li><li>
-<p>String</p>
-</li><li>
-<p>URI - (a Ruby URI object)</p>
-</li><li>
-<p>Time - parsed from and converted to ISO8601-format strings</p>
-</li><li>
-<p>Entity - an arbitrary Entity subclass</p>
-</li><li>
-<p>Array - strongly typed array of any of the above types</p>
-</li></ul>
 
-<p>Fields may also be set to nil, except for <code>Array</code> which must instead be set to an ampty array.</p>
+<ul>
+<li>Number    - (Integer but also allows Float)</li>
+<li>Boolean</li>
+<li>String</li>
+<li>URI       - (a Ruby URI object)</li>
+<li>Time      - parsed from and converted to ISO8601-format strings</li>
+<li>Entity    - an arbitrary Entity subclass</li>
+<li>Array     - strongly typed array of any of the above types</li>
+</ul>
+
+<p>Fields may also be set to nil, except for <code>Array</code> which must
+instead be set to an ampty array.</p>
 
-<p>Entities can be converted to and from Ruby Hashes. For this, we provide two flavours of Hash: the regular Ruby Hash where values are just the Ruby objects and the JSON hash where everything has been converted to the types expected by a Mastodon server.</p>
+<p>Entities can be converted to and from Ruby Hashes.  For this, we
+provide two flavours of Hash: the regular Ruby Hash where values
+are just the Ruby objects and the JSON hash where everything has
+been converted to the types expected by a Mastodon server.</p>
 
-<p>For JSON hashes, <code>Time</code> objects become ISO8601-formatted strings, <code>URI</code> objects become strings containing the url and <code>Entity</code> subobjects become their own JSON hashes. (Note that conversion to JSON hashes isn’t really used outside of some testing and internal stuff so I don’t guarantee that a Mastodon server or client will accept them.)</p>
+<p>For JSON hashes, <code>Time</code> objects become ISO8601-formatted strings,
+<code>URI</code> objects become strings containing the url and <code>Entity</code>
+subobjects become their own JSON hashes.  (Note that conversion to
+JSON hashes isn&#39;t really used outside of some testing and internal
+stuff so I don&#39;t guarantee that a Mastodon server or client will
+accept them.)</p>
 
-<p>Normally, we care about initializing Entity objects from the corresponding parsed JSON object and produce Ruby hashes when we need to use a feature <code>Hash</code> provides.</p>
+<p>Normally, we care about initializing Entity objects from the
+corresponding parsed JSON object and produce Ruby hashes when we
+need to use a feature <code>Hash</code> provides.</p>
 
-<p>Subclasses are all defined inside the Entity namespace so that it groups nicely in YARD docs (and because it makes the intent obvious).</p>
+<p>Subclasses are all defined inside the Entity namespace so that it
+groups nicely in YARD docs (and because it makes the intent
+obvious).</p>
 
 
   </div>
@@ -187,8 +200,7 @@
   <span class="private note title">private</span>
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Cool metaprogramming thing for defining <span class='object_link'><a href="" title="Shep::Entity (class)">Entity</a></span> subclasses.</p>
+    <span class="summary_desc"><div class='inline'><p>Cool metaprogramming thing for defining <span class='object_link'><a href="" title="Shep::Entity (class)">Entity</a></span> subclasses.</p>
 </div></span>
   
 </li>
@@ -211,8 +223,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Construct an instance from the (parsed) JSON object returned by Mastodon.</p>
+    <span class="summary_desc"><div class='inline'><p>Construct an instance from the (parsed) JSON object returned by Mastodon.</p>
 </div></span>
   
 </li>
@@ -235,8 +246,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Construct an instance initialized with Ruby objects.</p>
+    <span class="summary_desc"><div class='inline'><p>Construct an instance initialized with Ruby objects.</p>
 </div></span>
   
 </li>
@@ -268,8 +278,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Compare for equality.</p>
+    <span class="summary_desc"><div class='inline'><p>Compare for equality.</p>
 </div></span>
   
 </li>
@@ -292,8 +301,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Retrieve a field value by name.</p>
+    <span class="summary_desc"><div class='inline'><p>Retrieve a field value by name.</p>
 </div></span>
   
 </li>
@@ -316,8 +324,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Set a field value by name.</p>
+    <span class="summary_desc"><div class='inline'><p>Set a field value by name.</p>
 </div></span>
   
 </li>
@@ -342,8 +349,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Default constructor; creates an empty instance.</p>
+    <span class="summary_desc"><div class='inline'><p>Default constructor; creates an empty instance.</p>
 </div></span>
   
 </li>
@@ -366,8 +372,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Wrapper around <code>puts to_long_s()</code>.</p>
+    <span class="summary_desc"><div class='inline'><p>Wrapper around <code>puts to_long_s()</code>.</p>
 </div></span>
   
 </li>
@@ -390,8 +395,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Set all fields from a hash.</p>
+    <span class="summary_desc"><div class='inline'><p>Set all fields from a hash.</p>
 </div></span>
   
 </li>
@@ -414,8 +418,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Return a hash of the contents mapping field name to value.</p>
+    <span class="summary_desc"><div class='inline'><p>Return a hash of the contents mapping field name to value.</p>
 </div></span>
   
 </li>
@@ -438,8 +441,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Produce a long-form human-friendly description of this Entity.</p>
+    <span class="summary_desc"><div class='inline'><p>Produce a long-form human-friendly description of this Entity.</p>
 </div></span>
   
 </li>
@@ -464,8 +466,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>Produce a <strong>short</strong> human-friendly description.</p>
+    <span class="summary_desc"><div class='inline'><p>Produce a <strong>short</strong> human-friendly description.</p>
 </div></span>
   
 </li>
@@ -488,8 +489,8 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Default constructor; creates an empty instance. You’ll probably want to use <span class='object_link'><a href="#with-class_method" title="Shep::Entity.with (method)">with</a></span> or <span class='object_link'><a href="#from-class_method" title="Shep::Entity.from (method)">from</a></span> instead.</p>
+    <p>Default constructor; creates an empty instance.  You&#39;ll
+probably want to use <span class='object_link'><a href="#with-class_method" title="Shep::Entity.with (method)">with</a></span> or <span class='object_link'><a href="#from-class_method" title="Shep::Entity.from (method)">from</a></span> instead.</p>
 
 
   </div>
@@ -540,10 +541,10 @@
   <strong>This method is part of a private API.</strong>
   You should avoid using this method if possible, as it may be removed or be changed in the future.
 </p>
-
 <p>Cool metaprogramming thing for defining <span class='object_link'><a href="" title="Shep::Entity (class)">Shep::Entity</a></span> subclasses.</p>
 
-<p>A typical <span class='object_link'><a href="" title="Shep::Entity (class)">Shep::Entity</a></span> subclass should contain only a call to this method. For example:</p>
+<p>A typical <span class='object_link'><a href="" title="Shep::Entity (class)">Shep::Entity</a></span> subclass should contain only a call to this
+method.  For example:</p>
 
 <pre class="code ruby"><code class="ruby">  <span class='kw'>class</span> <span class='const'>Thingy</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="" title="Shep::Entity (class)">Entity</a></span></span>
       <span class='id identifier rubyid_fields'>fields</span><span class='lparen'>(</span>
@@ -555,23 +556,31 @@
   <span class='kw'>end</span>
 </code></pre>
 
-<p><span class='object_link'><a href="#fields-class_method" title="Shep::Entity.fields (method)">fields</a></span> takes a variable sequence of arguments that must be grouped as follows:</p>
-<ol><li>
-<p>The field name. This <strong>must</strong> be a symbol.</p>
-</li><li>
-<p>An optional Array containing the symbol :show. If given,  this field will be included in the string returned by  <code>to_s</code>. (This is actually a mechanism for setting various  properties, but all we need is <code>:show</code>, so that's it for  now.)</p>
-</li><li>
-<p>The type specifier. If omitted, defaults to StringBox.</p>
-</li></ol>
+<p><span class='object_link'><a href="#fields-class_method" title="Shep::Entity.fields (method)">fields</a></span> takes a variable sequence of arguments that must be
+grouped as follows:</p>
+
+<ol>
+<li><p>The field name. This <strong>must</strong> be a symbol.</p></li>
+<li><p>An optional Array containing the symbol :show.  If given,
+ this field will be included in the string returned by
+ <code>to_s</code>.  (This is actually a mechanism for setting various
+ properties, but all we need is <code>:show</code>, so that&#39;s it for
+ now.)</p></li>
+<li><p>The type specifier.  If omitted, defaults to StringBox.</p></li>
+</ol>
 
 <p>The type specifier must be either:</p>
-<ol><li>
-<p>One of the following classes: <code>TypeBox</code>, <code>StringBox</code>,  <code>TimeBox</code>, <code>URIBox</code>, or <code>NumBox</code>, corresponding to the type  this field will be.</p>
-</li><li>
-<p>A subclass of Entity, indicating that this field holds  another Mastodon object.</p>
-</li><li>
-<p>An Array holding a single element which must be one of the  above classes, indicating that the field holds an array of  items of that type.</p>
-</li></ol>
+
+<ol>
+<li><p>One of the following classes: <code>TypeBox</code>, <code>StringBox</code>,
+ <code>TimeBox</code>, <code>URIBox</code>, or <code>NumBox</code>, corresponding to the type
+ this field will be.</p></li>
+<li><p>A subclass of Entity, indicating that this field holds
+ another Mastodon object.</p></li>
+<li><p>An Array holding a single element which must be one of the
+ above classes, indicating that the field holds an array of
+ items of that type.</p></li>
+</ol>
 
 
   </div>
@@ -585,11 +594,6 @@
       <pre class="lines">
 
 
-276
-277
-278
-279
-280
 281
 282
 283
@@ -649,10 +653,15 @@
 337
 338
 339
-340</pre>
+340
+341
+342
+343
+344
+345</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 276</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 281</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_fields'>fields</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_flds'>flds</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_known_props'>known_props</span> <span class='op'>=</span> <span class='qsymbols_beg'>%i{</span><span class='tstring_content'>show</span><span class='tstring_end'>}</span></span><span class='period'>.</span><span class='id identifier rubyid_to_set'>to_set</span>
@@ -735,10 +744,13 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Construct an instance from the (parsed) JSON object returned by Mastodon.</p>
+    <p>Construct an instance from the (parsed) JSON object returned by
+Mastodon.</p>
 
-<p>Values must be of the expected types as they appear in the Mastodon object (i.e. the JSON Hash described above). Missing key/value pairs are allowed and treated as nil; unknown keys are ignored.</p>
+<p>Values must be of the expected types as they appear in the
+Mastodon object (i.e. the JSON Hash described above).  Missing
+key/value pairs are allowed and treated as nil; unknown keys are
+ignored.</p>
 
 
   </div>
@@ -776,10 +788,11 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Construct an instance initialized with Ruby objects.</p>
+    <p>Construct an instance initialized with Ruby objects.</p>
 
-<p>This intended for creating <span class='object_link'><a href="" title="Shep::Entity (class)">Shep::Entity</a></span> subobjects in Ruby code. Keys of <span class='object_link'><a href="#fields-class_method" title="Shep::Entity.fields (method)">fields</a></span> must correspond to the class’s supported fields and be of the correct type. No fields may be omitted.</p>
+<p>This intended for creating <span class='object_link'><a href="" title="Shep::Entity (class)">Shep::Entity</a></span> subobjects in Ruby code.
+Keys of <span class='object_link'><a href="#fields-class_method" title="Shep::Entity.fields (method)">fields</a></span> must correspond to the class&#39;s supported fields
+and be of the correct type.  No fields may be omitted.</p>
 
 
   </div>
@@ -827,10 +840,11 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Compare for equality.</p>
+    <p>Compare for equality.</p>
 
-<p>Two Entity subinstances are identical if they are of the same class and all of their field values are also equal according to <code>:==</code></p>
+<p>Two Entity subinstances are identical if they are of the same
+class and all of their field values are also equal according to
+<code>:==</code></p>
 
 
   </div>
@@ -857,14 +871,14 @@
       <pre class="lines">
 
 
-176
-177
-178
-179
-180</pre>
+181
+182
+183
+184
+185</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 176</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 181</span>
 
 <span class='kw'>def</span> <span class='op'>==</span><span class='lparen'>(</span><span class='id identifier rubyid_other'>other</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>unless</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span>
@@ -887,8 +901,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Retrieve a field value by name</p>
+    <p>Retrieve a field value by name</p>
 
 
   </div>
@@ -930,10 +943,10 @@
       <pre class="lines">
 
 
-156</pre>
+161</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 156</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 161</span>
 
 <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_getbox'>getbox</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span></pre>
     </td>
@@ -952,8 +965,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Set a field value by name</p>
+    <p>Set a field value by name</p>
 
 
   </div>
@@ -997,8 +1009,7 @@
       
       
         &mdash;
-        <div class='inline'>
-<p>the <code>value</code> parameter</p>
+        <div class='inline'><p>the <code>value</code> parameter</p>
 </div>
       
     </li>
@@ -1011,13 +1022,13 @@
       <pre class="lines">
 
 
-164
-165
-166
-167</pre>
+169
+170
+171
+172</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 164</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 169</span>
 
 <span class='kw'>def</span> <span class='op'>[]=</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_getbox'>getbox</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_set'>set</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
@@ -1039,8 +1050,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Wrapper around <code>puts to_long_s()</code></p>
+    <p>Wrapper around <code>puts to_long_s()</code></p>
 
 
   </div>
@@ -1054,10 +1064,10 @@
       <pre class="lines">
 
 
-227</pre>
+232</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 227</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 232</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_print'>print</span> <span class='op'>=</span> <span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span><span class='id identifier rubyid_to_long_s'>to_long_s</span><span class='rparen'>)</span></pre>
     </td>
@@ -1076,8 +1086,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Set all fields from a hash.</p>
+    <p>Set all fields from a hash.</p>
 
 <p>This is the back-end for <span class='object_link'><a href="#from-class_method" title="Shep::Entity.from (method)">from</a></span> and <span class='object_link'><a href="#with-class_method" title="Shep::Entity.with (method)">with</a></span>.</p>
 
@@ -1098,8 +1107,7 @@
       
       
         &mdash;
-        <div class='inline'>
-<p>the Hash containing the contents</p>
+        <div class='inline'><p>the Hash containing the contents</p>
 </div>
       
     </li>
@@ -1116,8 +1124,7 @@
       
       
         &mdash;
-        <div class='inline'>
-<p>if false, unknown keys cause an error</p>
+        <div class='inline'><p>if false, unknown keys cause an error</p>
 </div>
       
     </li>
@@ -1134,8 +1141,9 @@
       
       
         &mdash;
-        <div class='inline'>
-<p>if true, expect values in the format provided by the Mastodon API and convert accordingly. Otherwise, expect Ruby types.</p>
+        <div class='inline'><p>if true, expect values in the format
+provided by the Mastodon API and convert
+accordingly.  Otherwise, expect Ruby types.</p>
 </div>
       
     </li>
@@ -1205,10 +1213,10 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Return a hash of the contents mapping field name to value.</p>
+    <p>Return a hash of the contents mapping field name to value.</p>
 
-<p>If <code>json_compatible</code> is true, the resulting hash will be easily convertable to Mastodon-format JSON. See above.</p>
+<p>If <code>json_compatible</code> is true, the resulting hash will be
+easily convertable to Mastodon-format JSON.  See above.</p>
 
 <p>Unset (i.e. nil) values appear as entries with nil values.</p>
 
@@ -1231,8 +1239,7 @@
       
       
         &mdash;
-        <div class='inline'>
-<p>if true, convert to JSON-friendly form</p>
+        <div class='inline'><p>if true, convert to JSON-friendly form</p>
 </div>
       
     </li>
@@ -1259,11 +1266,6 @@
       <pre class="lines">
 
 
-192
-193
-194
-195
-196
 197
 198
 199
@@ -1272,10 +1274,15 @@
 202
 203
 204
-205</pre>
+205
+206
+207
+208
+209
+210</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 192</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 197</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_h'>to_h</span><span class='lparen'>(</span><span class='id identifier rubyid_json_compatible'>json_compatible</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
@@ -1307,8 +1314,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Produce a long-form human-friendly description of this Entity.</p>
+    <p>Produce a long-form human-friendly description of this Entity.</p>
 
 <p>This is mostly here for debugging.</p>
 
@@ -1337,11 +1343,6 @@
       <pre class="lines">
 
 
-212
-213
-214
-215
-216
 217
 218
 219
@@ -1349,10 +1350,15 @@
 221
 222
 223
-224</pre>
+224
+225
+226
+227
+228
+229</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 212</span>
+      <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 217</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_long_s'>to_long_s</span><span class='lparen'>(</span><span class='id identifier rubyid_indent_level'>indent_level</span> <span class='op'>=</span> <span class='int'>0</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_name_pad'>name_pad</span> <span class='op'>=</span> <span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:size</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_max'>max</span> <span class='op'>+</span> <span class='int'>2</span>
@@ -1387,8 +1393,7 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>Produce a <strong>short</strong> human-friendly description.</p>
+    <p>Produce a <strong>short</strong> human-friendly description.</p>
 
 
   </div>
@@ -1423,15 +1428,25 @@
 135
 136
 137
-138</pre>
+138
+139
+140
+141
+142
+143</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/shep/entity_base.rb', line 130</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span>
+  <span class='id identifier rubyid_maxlen'>maxlen</span> <span class='op'>=</span> <span class='int'>20</span>
   <span class='id identifier rubyid_notable'>notable</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_disp_fields'>disp_fields</span><span class='lparen'>(</span><span class='rparen'>)</span>
     <span class='period'>.</span><span class='id identifier rubyid_reject'>reject</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_fld'>fld</span><span class='op'>|</span> <span class='id identifier rubyid_getbox'>getbox</span><span class='lparen'>(</span><span class='id identifier rubyid_fld'>fld</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_get_for_json'>get_for_json</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</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_fld'>fld</span><span class='op'>|</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fld'>fld</span><span class='embexpr_end'>}</span><span class='tstring_content'>=</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_getbox'>getbox</span><span class='lparen'>(</span><span class='id identifier rubyid_fld'>fld</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></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_fld'>fld</span><span class='op'>|</span>
+      <span class='id identifier rubyid_valtxt'>valtxt</span> <span class='op'>=</span> <span class='id identifier rubyid_getbox'>getbox</span><span class='lparen'>(</span><span class='id identifier rubyid_fld'>fld</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span>
+      <span class='id identifier rubyid_valtxt'>valtxt</span> <span class='op'>=</span> <span class='id identifier rubyid_valtxt'>valtxt</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='id identifier rubyid_maxlen'>maxlen</span><span class='rbracket'>]</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='kw'>unless</span> <span class='id identifier rubyid_valtxt'>valtxt</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&lt;</span> <span class='id identifier rubyid_maxlen'>maxlen</span><span class='op'>+</span><span class='int'>3</span>
+      <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fld'>fld</span><span class='embexpr_end'>}</span><span class='tstring_content'>=</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_valtxt'>valtxt</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='rbrace'>}</span>
     <span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>,</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
   <span class='id identifier rubyid_notable'>notable</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0x</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_object_id'>object_id</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='int'>16</span><span class='rparen'>)</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_notable'>notable</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
 
@@ -1447,9 +1462,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sun Jun  4 13:40:31 2023 by
+  Generated on Sat Jun 10 19:16:29 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>