<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - fork/team @ master</title>
<meta name="description" content="README.md in fork/team at master.">
<meta property="og:title" content="README.md - fork/team @ master">
<meta property="og:description" content="README.md in fork/team at master.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="master" data-tip="a5260e76d3aa894c64c56e6ddc8545b9a98043ec">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/team</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/team</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Jakub Beránek</span><span class="commit-message" data-commit="4869ca9fa24aef05f4c2504b91da6e157a7798f0">Document the new command</span><span class="snapshot-sha sha" data-commit="4869ca9fa24aef05f4c2504b91da6e157a7798f0">4869ca9</span><time datetime="2024-01-23T14:18:36+01:00" title="2024-01-23 14:18:36 +0100">2024-01-23</time></p>
<header class="topbar"><details class="switcher"><summary>master</summary><div class="menu"><strong>branches</strong><a href="/fork/team/ref/dependabot/cargo/h2-0.3.26/">dependabot/cargo/h2-0.3.26</a><a href="/fork/team/ref/gh-pages/">gh-pages</a><a class="current" href="/fork/team/ref/master/">master</a><a href="/fork/team/ref/remove-fuchsia/">remove-fuchsia</a><a class="all" href="/fork/team/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/team/">team</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>4.9 KiB</span><span>147 lines</span></span><span class="actions"><a class="raw" href="/fork/team/raw/38c85b83854cc0bb5959a41b97b705917d600bd3/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Rust teams structure</h1>
<p>This repository contains the structure of the Rust teams. The repository is
automatically synchronized with:</p>
<table><thead><tr><th>Service</th><th style="text-align: center">Synchronized every</th><th></th></tr></thead><tbody>
<tr><td><a href="https://buildbot2.rust-lang.org/homu">@bors</a></td><td style="text-align: center"><em>In real time</em></td><td><a href="https://github.com/rust-lang/homu/blob/master/homu/auth.py">Integration source</a></td></tr>
<tr><td><a href="https://github.com/rust-lang-nursery/crater">Crater and @craterbot</a></td><td style="text-align: center"><em>In real time</em></td><td><a href="https://github.com/rust-lang-nursery/crater/blob/master/src/server/auth.rs">Integration source</a></td></tr>
<tr><td><a href="https://perf.rust-lang.org">Perf and @rust-timer</a></td><td style="text-align: center"><em>In real time</em></td><td><a href="https://github.com/rust-lang-nursery/rustc-perf/blob/master/site/src/server.rs">Integration source</a></td></tr>
<tr><td><a href="https://rfcbot.rs">@rfcbot</a></td><td style="text-align: center">5 minutes</td><td><a href="https://github.com/anp/rfcbot-rs/blob/master/src/teams.rs">Integration source</a></td></tr>
<tr><td>GitHub teams membership</td><td style="text-align: center"><em>Shortly after merge</em></td><td><a href="https://github.com/rust-lang/sync-team">Integration source</a></td></tr>
<tr><td>Mailing lists and aliases (<code>@rust-lang.org</code>, <code>@crates.io</code>)</td><td style="text-align: center"><em>Shortly after merge</em></td><td><a href="https://github.com/rust-lang/sync-team">Integration source</a></td></tr>
<tr><td>Zulip user group membership</td><td style="text-align: center"><em>Shortly after merge</em></td><td><a href="https://github.com/rust-lang/sync-team">Integration source</a></td></tr>
<tr><td><a href="https://www.rust-lang.org/governance">Governance section on the website</a></td><td style="text-align: center">2 minutes</td><td><a href="https://github.com/rust-lang/www.rust-lang.org/blob/master/src/teams.rs">Integration source</a></td></tr>
<tr><td>crates.io admin access</td><td style="text-align: center">1 hour</td><td><a href="https://github.com/rust-lang/crates.io/blob/main/src/worker/jobs/sync_admins.rs">Integration source</a></td></tr>
</tbody></table>
<p>If you need to add or remove a person from a team, send a PR to this
repository.  After it's merged, their account will be added/removed
from all the supported services.</p>
<h2>Documentation</h2>
<ul>
<li><a href="/fork/team/ref/master/blob/docs/toml-schema.md">TOML schema reference</a></li>
</ul>
<h2>Using the CLI tool</h2>
<p>It's possible to interact with this repository through its CLI tool.</p>
<h3>Verifying the integrity of the repository</h3>
<p>This repository contains some sanity checks to avoid having stale or broken
data. You can run the checks locally with the <code>check</code> command:</p>
<pre>cargo run check
</pre>
<p>Note that some of these checks will be skipped due to missing API tokens.</p>
<h3>Adding a person to the repository</h3>
<p>It's possible to fetch the public information present in a GitHub profile and
store it in a person's TOML file:</p>
<pre>cargo run add-person &lt;github-username&gt;
</pre>
<p>You can also add additional information, such as someone's Discord or Zulip ID by adding additional fields to their <code>.toml</code> file.</p>
<p>To determine someone's Zulip ID, find them in the list of people on the
right-hand side in Zulip, click the "three dots" menu, and copy the 'User ID'
into the toml file:</p>
<pre>zulip-id = &lt;user id&gt;
</pre>
<h3>Querying information out of the repository</h3>
<p>There are a few CLI commands that allow you to get some information generated
from the data in the repository.</p>
<p>You can get a list of all the people in a team:</p>
<pre>cargo run dump-team all
</pre>
<p>You can get a list of all the email addresses subscribed to a list:</p>
<pre>cargo run dump-list all@rust-lang.org
</pre>
<p>You can get a list of all the users with a permission:</p>
<pre>cargo run dump-permission perf
</pre>
<p>You can generate <a href="https://github.com/rust-lang/www.rust-lang.org">www.rust-lang.org</a>'s locales/en-US/tools.ftl file by running</p>
<pre>cargo run dump-website
</pre>
<p>The website will automatically load new teams added here, however they cannot be translated unless <code>tools.ftl</code> is also updated.</p>
<p>You can also print a list of users with individual access to repositories</p>
<pre># Group the accesses by repository
cargo run dump-individual-access --group-mode repo

# Group the accesses by contributor
cargo run dump-individual-access --group-mode person
</pre>
<h3>Building the static API</h3>
<p>You can build locally the content of <code>https://team-api.infra.rust-lang.org/v1/</code>
by running the command:</p>
<pre>cargo run static-api output-dir/
</pre>
<p>The content will be placed in <code>output-dir/</code>.</p>
<h3>Encrypting email addresses</h3>
<p>If an email address in a list needs to be confidential it's possible to encrypt
it. Encrypted email addresses look like this:</p>
<pre>encrypted+3eeedb8887004d9a8266e9df1b82a2d52dcce82c4fa1d277c5f14e261e8155acc8a66344edc972fa58b678dc2bcad2e8f7c201a1eede9c16639fe07df8bac5aa1097b2ad9699a700edb32ef192eaa74bf7af0a@rust-lang.invalid
</pre>
<p>The production key is accessible to select Infrastructure Team members, so if
you need to add an encrypted email address you'll need to reach out to that
team. The key is stored in the following parameter on AWS SSM Parameter Store:</p>
<pre>/prod/sync-team/email-encryption-key
</pre>
<p>The <code>cargo run encrypt-email</code> and <code>cargo run decrypt-email</code> interactive CLI
commands are available for infra team members to interact with encrypted
emails. The <code>rust_team_data</code> (with the <code>email-encryption</code> feature enabled) also
provides a module to programmatically encrypt and decrypt.</p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Rust teams structure</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">This repository contains the structure of the Rust teams. The repository is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">automatically synchronized with:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">| Service | Synchronized every | |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">| --- | :---: | --- |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">| [@bors][bors] | *In real time* | [Integration source][bors-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">| [Crater and @craterbot][crater] | *In real time* | [Integration source][crater-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text">| [Perf and @rust-timer][perf] | *In real time* | [Integration source][perf-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">| [@rfcbot][rfcbot] | 5 minutes | [Integration source][rfcbot-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text">| GitHub teams membership | *Shortly after merge* | [Integration source][sync-team-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">| Mailing lists and aliases (`@rust-lang.org`, `@crates.io`) | *Shortly after merge* | [Integration source][sync-team-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text">| Zulip user group membership | *Shortly after merge* | [Integration source][sync-team-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">| [Governance section on the website][www] | 2 minutes | [Integration source][www-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text">| crates.io admin access | 1 hour | [Integration source][crates-io-admin-src] |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text">If you need to add or remove a person from a team, send a PR to this</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text">repository.  After it&#39;s merged, their account will be added/removed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text">from all the supported services.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-tu>[bors]</a-tu>: <a-tu>https://buildbot2.rust-lang.org/homu</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-tu>[bors-src]</a-tu>: <a-tu>https://github.com/rust-lang/homu/blob/master/homu/auth.py</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-tu>[www]</a-tu>: <a-tu>https://www.rust-lang.org/governance</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-tu>[www-src]</a-tu>: <a-tu>https://github.com/rust-lang/www.rust-lang.org/blob/master/src/teams.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-tu>[crater]</a-tu>: <a-tu>https://github.com/rust-lang-nursery/crater</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-tu>[crater-src]</a-tu>: <a-tu>https://github.com/rust-lang-nursery/crater/blob/master/src/server/auth.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-tu>[perf]</a-tu>: <a-tu>https://perf.rust-lang.org</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-tu>[perf-src]</a-tu>: <a-tu>https://github.com/rust-lang-nursery/rustc-perf/blob/master/site/src/server.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-tu>[rfcbot]</a-tu>: <a-tu>https://rfcbot.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-tu>[rfcbot-src]</a-tu>: <a-tu>https://github.com/anp/rfcbot-rs/blob/master/src/teams.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-tu>[sync-team-src]</a-tu>: <a-tu>https://github.com/rust-lang/sync-team</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-tu>[crates-io-admin-src]</a-tu>: <a-tu>https://github.com/rust-lang/crates.io/blob/main/src/worker/jobs/sync_admins.rs</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>##</a-p> <a-tt>Documentation</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>* </a-p>[TOML schema reference](docs/toml-schema.md)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>## </a-p><a-tt>Using the CLI tool</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>It&#39;s possible to interact with this repository through its CLI tool.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>### </a-p><a-tt>Verifying the integrity of the repository</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>This repository contains some sanity checks to avoid having stale or broken</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>data. You can run the checks locally with the `check` command:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>cargo run check</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>Note that some of these checks will be skipped due to missing API tokens.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>### </a-p><a-tt>Adding a person to the repository</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>It&#39;s possible to fetch the public information present in a GitHub profile and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>store it in a person&#39;s TOML file:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>cargo run add-person &lt;github-username&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>You can also add additional information, such as someone&#39;s Discord or Zulip ID by adding additional fields to their `.toml` file.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>To determine someone&#39;s Zulip ID, find them in the list of people on the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>right-hand side in Zulip, click the &quot;three dots&quot; menu, and copy the &#39;User ID&#39;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>into the toml file:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>zulip-id = &lt;user id&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>### </a-p><a-tt>Querying information out of the repository</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>There are a few CLI commands that allow you to get some information generated</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>from the data in the repository.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>You can get a list of all the people in a team:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>cargo run dump-team all</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>You can get a list of all the email addresses subscribed to a list:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>cargo run dump-list all@rust-lang.org</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>You can get a list of all the users with a permission:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>cargo run dump-permission perf</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>You can generate [www.rust-lang.org](https://github.com/rust-lang/www.rust-lang.org)&#39;s locales/en-US/tools.ftl file by running</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>cargo run dump-website</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>The website will automatically load new teams added here, however they cannot be translated unless `tools.ftl` is also updated.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>You can also print a list of users with individual access to repositories</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"><a-p># Group the accesses by repository</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>cargo run dump-individual-access --group-mode repo</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"><a-p># Group the accesses by contributor</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"><a-p>cargo run dump-individual-access --group-mode person</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"><a-p>### </a-p><a-tt>Building the static API</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"><a-p>You can build locally the content of `https://team-api.infra.rust-lang.org/v1/`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>by running the command:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>cargo run static-api output-dir/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>The content will be placed in `output-dir/`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>### </a-p><a-tt>Encrypting email addresses</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>If an email address in a list needs to be confidential it&#39;s possible to encrypt</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><a-p>it. Encrypted email addresses look like this:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>encrypted+3eeedb8887004d9a8266e9df1b82a2d52dcce82c4fa1d277c5f14e261e8155acc8a66344edc972fa58b678dc2bcad2e8f7c201a1eede9c16639fe07df8bac5aa1097b2ad9699a700edb32ef192eaa74bf7af0a@rust-lang.invalid</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p>The production key is accessible to select Infrastructure Team members, so if</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>you need to add an encrypted email address you&#39;ll need to reach out to that</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>team. The key is stored in the following parameter on AWS SSM Parameter Store:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>/prod/sync-team/email-encryption-key</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text">The `cargo run encrypt-email` and `cargo run decrypt-email` interactive CLI</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text">commands are available for infra team members to interact with encrypted</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text">emails. The `rust_team_data` (with the `email-encryption` feature enabled) also</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text">provides a module to programmatically encrypt and decrypt.</span></span></pre></div></div>
</main>
</body>
</html>
