Documentation: RobotLocomotion/drake@3117d17

Author: drake-jenkins-bot

code_style_tools.html

@@ -179,14 +179,21 @@ <h1 id="automated-style-checks">Automated style checks</h1>
 
 <ul>
   <li>C/C++: See the cpplint <code class="language-plaintext highlighter-rouge">USAGE</code> string at
-<a href="https://github.com/google/styleguide/blob/gh-pages/cpplint/cpplint.py">https://github.com/google/styleguide/blob/gh-pages/cpplint/cpplint.py</a>.
+<a href="https://github.com/cpplint/cpplint/blob/develop/cpplint.py">https://github.com/cpplint/cpplint/blob/develop/cpplint.py</a>.
     <ul>
       <li>In particular, note the <code class="language-plaintext highlighter-rouge">// NOLINT(foo/bar)</code> syntax to disable a warning.</li>
     </ul>
   </li>
-  <li>Python: See the pycodestyle manual at
-<a href="http://pycodestyle.readthedocs.io/en/latest/intro.html">http://pycodestyle.readthedocs.io/en/latest/intro.html</a>.
+  <li>Python:
     <ul>
+      <li>When the call to <code class="language-plaintext highlighter-rouge">add_lint_tests()</code> has <code class="language-plaintext highlighter-rouge">use_ruff = True</code>, we use <code class="language-plaintext highlighter-rouge">ruff</code> as
+the linter. Drake uses both <code class="language-plaintext highlighter-rouge">check</code> mode along with <code class="language-plaintext highlighter-rouge">format --check</code> mode.
+See the ruff manual at
+<a href="https://docs.astral.sh/ruff/linter/#error-suppression">https://docs.astral.sh/ruff/linter/#error-suppression</a>
+and
+<a href="https://docs.astral.sh/ruff/formatter/#format-suppression">https://docs.astral.sh/ruff/formatter/#format-suppression</a>.</li>
+      <li>Otherwise, we use <code class="language-plaintext highlighter-rouge">pycodestyle</code>. See the pycodestyle manual at
+<a href="http://pycodestyle.readthedocs.io/en/latest/intro.html">http://pycodestyle.readthedocs.io/en/latest/intro.html</a>.</li>
       <li>The syntax <code class="language-plaintext highlighter-rouge"># noqa</code> can be used to quiet the warning about an overly-long
 line.</li>
     </ul>
@@ -222,6 +229,14 @@ <h3 id="ide-integration">IDE integration</h3>
   <li><a href="/vscode.html#c-code-formatting">VS Code</a></li>
 </ul>
 
+<h2 id="python-ruff-format">Python: Ruff Format</h2>
+
+<p>To run <code class="language-plaintext highlighter-rouge">ruff</code> auto-formatter:</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd drake
+bazel run -- //tools/lint:ruff format path/to/my_file.py
+</code></pre></div></div>
+
       </article>
     </div>
   </section>

from_source.html

@@ -317,6 +317,23 @@ <h2 id="drake-specific-cmake-options">Drake-specific CMake Options</h2>
 <p>Drake also defines a number of CMake options to control different facets of
 the build.</p>
 
+<p>Adjusting installation:</p>
+
+<ul>
+  <li><code class="language-plaintext highlighter-rouge">DRAKE_INSTALL_JAVA</code> (default <code class="language-plaintext highlighter-rouge">ON</code>). When <code class="language-plaintext highlighter-rouge">OFF</code>, does not install Java-based
+tools (currently only the Java lcmtypes). Setting to <code class="language-plaintext highlighter-rouge">OFF</code> might be helpful to
+avoid depending on a JDK during the build.</li>
+  <li><code class="language-plaintext highlighter-rouge">DRAKE_INSTALL_PYTHON</code> (default <code class="language-plaintext highlighter-rouge">ON</code>). When <code class="language-plaintext highlighter-rouge">OFF</code>, does not install
+Python-based tools (<code class="language-plaintext highlighter-rouge">pydrake</code>, <code class="language-plaintext highlighter-rouge">pybind11</code> headers, tutorials, and Python
+lcmtypes). Setting to <code class="language-plaintext highlighter-rouge">OFF</code> might be helpful to avoid spending time compiling
+code that’s not needed.
+    <ul>
+      <li>Note that regardless of the <code class="language-plaintext highlighter-rouge">DRAKE_INSTALL_PYTHON</code> option, a working Python
+interpreter is still required to build Drake.</li>
+    </ul>
+  </li>
+</ul>
+
 <p>Adjusting open-source dependencies:</p>
 
 <ul>
@@ -378,9 +395,6 @@ <h2 id="drake-specific-cmake-options">Drake-specific CMake Options</h2>
   <li><code class="language-plaintext highlighter-rouge">WITH_LCM_RUNTIME</code> (default <code class="language-plaintext highlighter-rouge">ON</code>). When <code class="language-plaintext highlighter-rouge">OFF</code>, the LGPL-licensed LCM runtime
 library will be not installed alongside Drake. See  <code class="language-plaintext highlighter-rouge">DrakeLcm::available()</code> to
 retrieve this setting at runtime.</li>
-  <li><code class="language-plaintext highlighter-rouge">DRAKE_INSTALL_JAVA</code> (default <code class="language-plaintext highlighter-rouge">ON</code>). When <code class="language-plaintext highlighter-rouge">OFF</code>, does not install Java-based
-tools (currently only the Java lcmtypes). Setting to <code class="language-plaintext highlighter-rouge">OFF</code> might be helpful to
-avoid depending on a JDK during the build.</li>
 </ul>
 
 <p>Adjusting closed-source (commercial) software dependencies:</p>