Skip to content

Commit

Permalink
deploy: a252407
Browse files Browse the repository at this point in the history
  • Loading branch information
Gohla committed Dec 22, 2023
1 parent 6c03881 commit c55d9b5
Show file tree
Hide file tree
Showing 100 changed files with 2,754 additions and 1,785 deletions.
6 changes: 3 additions & 3 deletions 0_intro/1_setup/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@

<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../../0_intro/index.html"><strong aria-hidden="true">1.</strong> Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../0_intro/1_setup/index.html" class="active"><strong aria-hidden="true">1.1.</strong> Setup</a></li></ol></li><li class="chapter-item expanded "><a href="../../1_programmability/index.html"><strong aria-hidden="true">2.</strong> Programmability</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../1_programmability/1_api/index.html"><strong aria-hidden="true">2.1.</strong> Programmable Build System API</a></li><li class="chapter-item expanded "><a href="../../1_programmability/2_non_incremental/index.html"><strong aria-hidden="true">2.2.</strong> Non-Incremental Context</a></li></ol></li><li class="chapter-item expanded "><a href="../../2_incrementality/index.html"><strong aria-hidden="true">3.</strong> Incrementality</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../2_incrementality/1_require_file/index.html"><strong aria-hidden="true">3.1.</strong> Requiring Files</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/2_stamp/index.html"><strong aria-hidden="true">3.2.</strong> Stamps</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/3_dependency/index.html"><strong aria-hidden="true">3.3.</strong> Dynamic Dependencies</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/4_store/index.html"><strong aria-hidden="true">3.4.</strong> Dependency Graph Store</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/5_context/index.html"><strong aria-hidden="true">3.5.</strong> Incremental Top-Down Context</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/6_example/index.html"><strong aria-hidden="true">3.6.</strong> Incrementality Example</a></li></ol></li><li class="chapter-item expanded "><a href="../../3_min_sound/index.html"><strong aria-hidden="true">4.</strong> Testing Incrementality & Correctness</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../3_min_sound/1_session/index.html"><strong aria-hidden="true">4.1.</strong> Incrementality with Sessions</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/2_tracker/index.html"><strong aria-hidden="true">4.2.</strong> Tracking Build Events</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/3_test/index.html"><strong aria-hidden="true">4.3.</strong> Integration Testing</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/4_fix_task_dep/index.html"><strong aria-hidden="true">4.4.</strong> Fix Superfluous Task Dependency</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/5_overlap/index.html"><strong aria-hidden="true">4.5.</strong> Prevent Overlapping File Writes</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/6_hidden_dep/index.html"><strong aria-hidden="true">4.6.</strong> Prevent Hidden Dependencies</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/7_cycle/index.html"><strong aria-hidden="true">4.7.</strong> Prevent Cycles</a></li></ol></li><li class="chapter-item expanded "><a href="../../4_example/index.html"><strong aria-hidden="true">5.</strong> Project: Interactive Parser Development</a></li><li class="chapter-item expanded affix "><li class="part-title">Appendix</li><li class="chapter-item expanded "><a href="../../a_appendix/1_pie.html"><strong aria-hidden="true">6.</strong> PIE Implementations & Publications</a></li><li class="chapter-item expanded "><a href="../../a_appendix/2_related_work.html"><strong aria-hidden="true">7.</strong> Related Work</a></li><li class="chapter-item expanded "><a href="../../a_appendix/3_future_work.html"><strong aria-hidden="true">8.</strong> Future Work</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../../0_intro/index.html"><strong aria-hidden="true">1.</strong> Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../0_intro/1_setup/index.html" class="active"><strong aria-hidden="true">1.1.</strong> Setup</a></li></ol></li><li class="chapter-item expanded "><a href="../../1_programmability/index.html"><strong aria-hidden="true">2.</strong> Programmability</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../1_programmability/1_api/index.html"><strong aria-hidden="true">2.1.</strong> Programmable Build System API</a></li><li class="chapter-item expanded "><a href="../../1_programmability/2_non_incremental/index.html"><strong aria-hidden="true">2.2.</strong> Non-Incremental Context</a></li></ol></li><li class="chapter-item expanded "><a href="../../2_incrementality/index.html"><strong aria-hidden="true">3.</strong> Incrementality</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../2_incrementality/1_require_file/index.html"><strong aria-hidden="true">3.1.</strong> Requiring Files</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/2_stamp/index.html"><strong aria-hidden="true">3.2.</strong> Stamps</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/3_dependency/index.html"><strong aria-hidden="true">3.3.</strong> Dynamic Dependencies</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/4_store/index.html"><strong aria-hidden="true">3.4.</strong> Dependency Graph Store</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/5_context/index.html"><strong aria-hidden="true">3.5.</strong> Incremental Top-Down Context</a></li><li class="chapter-item expanded "><a href="../../2_incrementality/6_example/index.html"><strong aria-hidden="true">3.6.</strong> Incrementality Example</a></li></ol></li><li class="chapter-item expanded "><a href="../../3_min_sound/index.html"><strong aria-hidden="true">4.</strong> Testing Incrementality & Correctness</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../3_min_sound/1_session/index.html"><strong aria-hidden="true">4.1.</strong> Incrementality with Sessions</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/2_tracker/index.html"><strong aria-hidden="true">4.2.</strong> Tracking Build Events</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/3_test/index.html"><strong aria-hidden="true">4.3.</strong> Integration Testing</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/4_fix_task_dep/index.html"><strong aria-hidden="true">4.4.</strong> Fix Superfluous Task Dependency</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/5_overlap/index.html"><strong aria-hidden="true">4.5.</strong> Prevent Overlapping File Writes</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/6_hidden_dep/index.html"><strong aria-hidden="true">4.6.</strong> Prevent Hidden Dependencies</a></li><li class="chapter-item expanded "><a href="../../3_min_sound/7_cycle/index.html"><strong aria-hidden="true">4.7.</strong> Prevent Cycles</a></li></ol></li><li class="chapter-item expanded "><a href="../../4_example/index.html"><strong aria-hidden="true">5.</strong> Project: Interactive Parser Development</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../4_example/1_grammar/index.html"><strong aria-hidden="true">5.1.</strong> Compiling Grammars and Parsing</a></li><li class="chapter-item expanded "><a href="../../4_example/2_task/index.html"><strong aria-hidden="true">5.2.</strong> Task Implementation</a></li><li class="chapter-item expanded "><a href="../../4_example/3_cli/index.html"><strong aria-hidden="true">5.3.</strong> CLI for Incremental Batch Builds</a></li><li class="chapter-item expanded "><a href="../../4_example/4_interactive/index.html"><strong aria-hidden="true">5.4.</strong> Interactive Parser Development</a></li></ol></li><li class="chapter-item expanded "><li class="part-title">Appendix</li><li class="chapter-item expanded "><a href="../../a_appendix/1_pie.html"><strong aria-hidden="true">6.</strong> PIE Implementations & Publications</a></li><li class="chapter-item expanded "><a href="../../a_appendix/2_related_work.html"><strong aria-hidden="true">7.</strong> Related Work</a></li><li class="chapter-item expanded "><a href="../../a_appendix/3_future_work.html"><strong aria-hidden="true">8.</strong> Future Work</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>
Expand Down Expand Up @@ -197,7 +197,7 @@ <h2 id="creating-a-new-rust-project"><a class="header" href="#creating-a-new-rus
<p>In this tutorial, we will create a subset of the <a href="https://github.com/Gohla/pie" title="" target="_blank">PIE in Rust</a> library, so we want to create a Rust package called <code>pie</code>.
However, later on in the tutorial we will also create an additional package (for unit testing utilities), so we need to set up a Rust <em>workspace</em> that supports multiple packages.</p>
<p>Therefore, first create a <code>pibs</code> directory, which will serve as the workspace directory of the project.
This does not have to be called <code>pibs</code>, you can use a different name.
This does not have to be called <code>pibs</code>, you can use a different name, but this tutorial will use <code>pibs</code>.
Then create the <code>pibs/Cargo.toml</code> file with the following contents:</p>
<pre><code class="language-toml ">[workspace]
members = [
Expand Down Expand Up @@ -266,7 +266,7 @@ <h2 id="creating-a-new-rust-project"><a class="header" href="#creating-a-new-rus
<h2 id="source-control-optional-but-recommended"><a class="header" href="#source-control-optional-but-recommended">Source control (optional but recommended)</a></h2>
<p>I recommend storing your code in a source control system such as <a href="https://git-scm.com/" title="" target="_blank">Git</a>, and uploading it to a source code hub such as <a href="https://github.com/" title="" target="_blank">GitHub</a>.
A source control system allows you to look at changes and to go back to older versions, and uploading to a source code hub then provides a convenient backup.</p>
<p>If you use Git, create the <code>pie/.gitignore</code> file with:</p>
<p>If you use Git, create the <code>.gitignore</code> file with:</p>
<pre><code class="language-.gitignore">/target
</code></pre>
<p>This ignores the <code>target</code> directory that Cargo uses to store intermediate and binary files.</p>
Expand Down
Loading

0 comments on commit c55d9b5

Please sign in to comment.