Skip to content

Commit

Permalink
[skip ci] Update site
Browse files Browse the repository at this point in the history
  • Loading branch information
ci-build committed Nov 22, 2023
1 parent 5c1c31c commit 1737239
Showing 1 changed file with 7 additions and 35 deletions.
42 changes: 7 additions & 35 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2089,14 +2089,18 @@ <h3 id="no-braces-opts-hash"><a class="anchor" href="#no-braces-opts-hash"></a><
<div class="sect2">
<h3 id="no-dsl-decorating"><a class="anchor" href="#no-dsl-decorating"></a><a class="link" href="#no-dsl-decorating">DSL Method Calls</a></h3>
<div class="paragraph">
<p>Omit both the outer braces and parentheses for methods that are part of an internal DSL.</p>
<p>Omit both the outer braces and parentheses for methods that are part of an internal DSL (e.g., Rake, Rails, RSpec).</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="rouge highlight"><code data-lang="ruby"><span class="k">class</span> <span class="nc">Person</span> <span class="o">&lt;</span> <span class="no">ActiveRecord</span><span class="o">::</span><span class="no">Base</span>
<span class="c1"># bad</span>
<span class="n">validates</span><span class="p">(</span><span class="ss">:name</span><span class="p">,</span> <span class="p">{</span> <span class="ss">presence: </span><span class="kp">true</span><span class="p">,</span> <span class="ss">length: </span><span class="p">{</span> <span class="ss">within: </span><span class="mi">1</span><span class="o">..</span><span class="mi">10</span> <span class="p">}</span> <span class="p">})</span>
<span class="nb">attr_reader</span><span class="p">(</span><span class="ss">:name</span><span class="p">,</span> <span class="ss">:age</span><span class="p">)</span>
<span class="c1"># good</span>
<span class="nb">attr_reader</span> <span class="ss">:name</span><span class="p">,</span> <span class="ss">:age</span>

<span class="c1"># bad</span>
<span class="n">validates</span><span class="p">(</span><span class="ss">:name</span><span class="p">,</span> <span class="p">{</span> <span class="ss">presence: </span><span class="kp">true</span><span class="p">,</span> <span class="ss">length: </span><span class="p">{</span> <span class="ss">within: </span><span class="mi">1</span><span class="o">..</span><span class="mi">10</span> <span class="p">}</span> <span class="p">})</span>
<span class="c1"># good</span>
<span class="n">validates</span> <span class="ss">:name</span><span class="p">,</span> <span class="ss">presence: </span><span class="kp">true</span><span class="p">,</span> <span class="ss">length: </span><span class="p">{</span> <span class="ss">within: </span><span class="mi">1</span><span class="o">..</span><span class="mi">10</span> <span class="p">}</span>
<span class="k">end</span></code></pre>
Expand Down Expand Up @@ -4612,20 +4616,6 @@ <h4 id="method-call-with-no-arguments"><a class="anchor" href="#method-call-with
</div>
</div>
<div class="sect3">
<h4 id="methods-that-are-part-of-an-internal-dsl"><a class="anchor" href="#methods-that-are-part-of-an-internal-dsl"></a><a class="link" href="#methods-that-are-part-of-an-internal-dsl">Methods That are Part of an Internal DSL <a id="method-invocation-parens-internal-dsl"></a><a id="method-call-parens-internal-dsl"></a></a></h4>
<div class="paragraph">
<p>Always omit parentheses for methods that are part of an internal DSL (e.g., Rake, Rails, RSpec):</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="rouge highlight"><code data-lang="ruby"><span class="c1"># bad</span>
<span class="n">validates</span><span class="p">(</span><span class="ss">:name</span><span class="p">,</span> <span class="ss">presence: </span><span class="kp">true</span><span class="p">)</span>
<span class="c1"># good</span>
<span class="n">validates</span> <span class="ss">:name</span><span class="p">,</span> <span class="ss">presence: </span><span class="kp">true</span></code></pre>
</div>
</div>
</div>
<div class="sect3">
<h4 id="methods-that-have-keyword-status-in-ruby"><a class="anchor" href="#methods-that-have-keyword-status-in-ruby"></a><a class="link" href="#methods-that-have-keyword-status-in-ruby">Methods That Have "keyword" Status in Ruby <a id="method-invocation-parens-keyword"></a><a id="method-call-parens-keyword"></a></a></h4>
<div class="paragraph">
<p>Always omit parentheses for methods that have "keyword" status in Ruby.</p>
Expand All @@ -4645,24 +4635,6 @@ <h4 id="methods-that-have-keyword-status-in-ruby"><a class="anchor" href="#metho
</table>
</div>
<div class="sect4">
<h5 id="declarative-methods-that-have-keyword-status-in-ruby"><a class="anchor" href="#declarative-methods-that-have-keyword-status-in-ruby"></a><a class="link" href="#declarative-methods-that-have-keyword-status-in-ruby">Declarative Methods That Have "keyword" Status in Ruby <a id="method-invocation-parens-declarative-keyword"></a><a id="method-call-parens-declarative-keyword"></a></a></h5>
<div class="paragraph">
<p>Always omit parentheses for declarative methods (a.k.a. DSL methods or macro methods) that have "keyword" status in Ruby (e.g., various <code>Module</code> instance methods):</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="rouge highlight"><code data-lang="ruby"><span class="k">class</span> <span class="nc">Person</span>
<span class="c1"># bad</span>
<span class="nb">attr_reader</span><span class="p">(</span><span class="ss">:name</span><span class="p">,</span> <span class="ss">:age</span><span class="p">)</span>
<span class="c1"># good</span>
<span class="nb">attr_reader</span> <span class="ss">:name</span><span class="p">,</span> <span class="ss">:age</span>

<span class="c1"># body omitted</span>
<span class="k">end</span></code></pre>
</div>
</div>
</div>
<div class="sect4">
<h5 id="non-declarative-methods-that-have-keyword-status-in-ruby"><a class="anchor" href="#non-declarative-methods-that-have-keyword-status-in-ruby"></a><a class="link" href="#non-declarative-methods-that-have-keyword-status-in-ruby">Non-Declarative Methods That Have "keyword" Status in Ruby <a id="method-invocation-parens-non-declarative-keyword"></a><a id="method-call-parens-non-declarative-keyword"></a></a></h5>
<div class="paragraph">
<p>For non-declarative methods with "keyword" status (e.g., various <code>Kernel</code> instance methods), two styles are considered acceptable.
Expand Down Expand Up @@ -8246,7 +8218,7 @@ <h2 id="spread-the-word"><a class="anchor" href="#spread-the-word"></a><a class=
</div>
<div id="footer">
<div id="footer-text">
Last updated 2023-11-17 09:07:01 UTC
Last updated 2023-11-22 21:35:29 UTC
</div>
</div>
</body>
Expand Down

0 comments on commit 1737239

Please sign in to comment.