Website build

Author: dham

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: deaa46c820e7d7258d09a89e9a731161
+config: 6dc77e83c8ab02d3fb6e6302ff875ff3
 tags: 645f666f9bcd5a90fca523b33c5a78b7

10_trees_and_directed_acyclic_graphs.html

@@ -17,7 +17,6 @@
     <script src="_static/jquery.js"></script>
     <script src="_static/underscore.js"></script>
     <script src="_static/doctools.js"></script>
-    <script src="_static/language_data.js"></script>
     <script src="_static/proof.js"></script>
     <script async="async" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -811,10 +810,10 @@ <h3><span class="section-number">10.3.3. </span>Single dispatch functions<a clas
 </div>
 <p><a class="reference internal" href="#tree-evaluate"><span class="std std-numref">Listing 10.6</span></a> shows a single dispatch function for a visitor function
 which evaluates a <code class="xref py py-class docutils literal notranslate"><span class="pre">Expression</span></code>. Start with lines 6-19. These define a
-function <a class="reference internal" href="example_code.html#example_code.expression_tools.evaluate" title="example_code.expression_tools.evaluate"><code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code></a> which will be used in
+function <code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code> which will be used in
 the default case, that is, in the case where the <a class="reference external" href="https://docs.python.org/3/library/functions.html#type" title="(in Python v3.9)"><code class="xref py py-class docutils literal notranslate"><span class="pre">type</span></code></a> of the first
 argument doesn’t match any of the other implementations of
-<a class="reference internal" href="example_code.html#example_code.expression_tools.evaluate" title="example_code.expression_tools.evaluate"><code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code></a>. In this case, the first
+<code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code>. In this case, the first
 argument is the expression that we’re evaluating, so if the type doesn’t match
 then this means that we don’t know how to evaluate this object, and the only
 course of action available is to throw an <a class="reference internal" href="6_exceptions.html#term-exception"><span class="xref std std-term">exception</span></a>.</p>
@@ -832,13 +831,13 @@ <h3><span class="section-number">10.3.3. </span>Single dispatch functions<a clas
 Notice that the function name is given as <code class="xref py py-obj docutils literal notranslate"><span class="pre">_</span></code>. This is the Python convention for
 a name which will never be used. This function will never be called by its
 declared name. Instead, look at the decorator on line 26. The single dispatch
-function <a class="reference internal" href="example_code.html#example_code.expression_tools.evaluate" title="example_code.expression_tools.evaluate"><code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code></a> has a <a class="reference internal" href="3_objects.html#term-method"><span class="xref std std-term">method</span></a>
+function <code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code> has a <a class="reference internal" href="3_objects.html#term-method"><span class="xref std std-term">method</span></a>
 <code class="xref py py-meth docutils literal notranslate"><span class="pre">register()</span></code>. When used as a decorator, the <code class="xref py py-meth docutils literal notranslate"><span class="pre">register()</span></code> method of a
 single dispatch function registers the function that follows as implementation
 for the <a class="reference external" href="https://docs.python.org/3/reference/compound_stmts.html#class" title="(in Python v3.9)"><code class="xref std std-keyword docutils literal notranslate"><span class="pre">class</span></code></a> given as an argument to <code class="xref py py-meth docutils literal notranslate"><span class="pre">register()</span></code>. On this
 occasion, this is <code class="xref py py-class docutils literal notranslate"><span class="pre">expressions.Number</span></code>.</p>
 <p>Now look at lines 31-33. These contain the implementation of
-<a class="reference internal" href="example_code.html#example_code.expression_tools.evaluate" title="example_code.expression_tools.evaluate"><code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code></a> for <code class="xref py py-class docutils literal notranslate"><span class="pre">expressions.Symbol</span></code>.
+<code class="xref py py-func docutils literal notranslate"><span class="pre">evaluate()</span></code> for <code class="xref py py-class docutils literal notranslate"><span class="pre">expressions.Symbol</span></code>.
 In order to evaluate a symbol, we depend on the mapping from symbol names to
 numerical values that has been passed in.</p>
 <p>Finally, look at lines 36-38. These define the evaluation visitor for addition.
@@ -1244,7 +1243,7 @@ <h2><span class="section-number">10.8. </span>Exercises<a class="headerlink" hre
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2019-2020, David A. Ham.
-      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.3.1.
+      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
     </div>
   </body>
 </html>

11_further_object-oriented_features.html

@@ -17,7 +17,6 @@
     <script src="_static/jquery.js"></script>
     <script src="_static/underscore.js"></script>
     <script src="_static/doctools.js"></script>
-    <script src="_static/language_data.js"></script>
     <script src="_static/proof.js"></script>
     <script async="async" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -83,7 +82,7 @@ <h3><span class="section-number">11.3.1. </span>Glossary<a class="headerlink" hr
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2019-2020, David A. Ham.
-      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.3.1.
+      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
     </div>
   </body>
 </html>

1_introduction.html

@@ -17,7 +17,6 @@
     <script src="_static/jquery.js"></script>
     <script src="_static/underscore.js"></script>
     <script src="_static/doctools.js"></script>
-    <script src="_static/language_data.js"></script>
     <script src="_static/proof.js"></script>
     <script async="async" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -534,9 +533,11 @@ <h4><span class="section-number">1.3.8.3. </span>Including mathematics<a class="
 <h4><span class="section-number">1.3.8.4. </span>Including links<a class="headerlink" href="#including-links" title="Permalink to this headline">¶</a></h4>
 <p>Just dumping URLs into the text often results in hard to read code. Instead,
 Markdown enables you to write the link text in square brackets followed by the
-URL in round brackets. So <code class="xref py py-obj docutils literal notranslate"><span class="pre">[the</span> <span class="pre">Markdown</span> <span class="pre">Cheat</span>
-<span class="pre">Sheet](https://www.markdownguide.org/cheat-sheet/)</span></code> becomes <a class="reference external" href="https://www.markdownguide.org/cheat-sheet/">the Markdown Cheat
-Sheet</a>.</p>
+URL in round brackets. So:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">the</span> <span class="n">Markdown</span> <span class="n">Cheat</span> <span class="n">Sheet</span><span class="p">](</span><span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="o">.</span><span class="n">markdownguide</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">cheat</span><span class="o">-</span><span class="n">sheet</span><span class="o">/</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>becomes <a class="reference external" href="https://www.markdownguide.org/cheat-sheet/">the Markdown Cheat Sheet</a>.</p>
 </div>
 <div class="section" id="more-advanced-markdown">
 <h4><span class="section-number">1.3.8.5. </span>More advanced Markdown<a class="headerlink" href="#more-advanced-markdown" title="Permalink to this headline">¶</a></h4>
@@ -555,14 +556,14 @@ <h3><span class="section-number">1.3.9. </span>An example issue report<a class="
 
 The following code is in the file <span class="sb">`square.py`</span>:
 
-<span class="s">```python3</span>
+<span class="sb">```python3</span>
 <span class="k">def</span> <span class="nf">square</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
     <span class="k">return</span> <span class="n">x</span><span class="o">^</span><span class="mi">2</span>
-<span class="s">```</span>
+<span class="sb">```</span>
 
 I try out this function in iPython and observe the wrong answers:
 
-<span class="s">```ipython3</span>
+<span class="sb">```ipython3</span>
 <span class="n">In</span> <span class="p">[</span><span class="mi">1</span><span class="p">]:</span> <span class="kn">from</span> <span class="nn">square</span> <span class="kn">import</span> <span class="n">square</span>
 
 <span class="n">In</span> <span class="p">[</span><span class="mi">2</span><span class="p">]:</span> <span class="n">square</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
@@ -573,7 +574,7 @@ <h3><span class="section-number">1.3.9. </span>An example issue report<a class="
 
 <span class="n">In</span> <span class="p">[</span><span class="mi">4</span><span class="p">]:</span> <span class="n">square</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
 <span class="n">Out</span><span class="p">[</span><span class="mi">4</span><span class="p">]:</span> <span class="mi">6</span>
-<span class="s">```</span>
+<span class="sb">```</span>
 
 I would expect to see 4, 9, 16 respectively. I do not understand what is
 going wrong.
@@ -642,7 +643,7 @@ <h2><span class="section-number">1.4. </span>Exercises<a class="headerlink" href
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2019-2020, David A. Ham.
-      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.3.1.
+      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
     </div>
   </body>
 </html>

2_programs_in_files.html

@@ -17,7 +17,6 @@
     <script src="_static/jquery.js"></script>
     <script src="_static/underscore.js"></script>
     <script src="_static/doctools.js"></script>
-    <script src="_static/language_data.js"></script>
     <script src="_static/proof.js"></script>
     <script async="async" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -370,11 +369,7 @@ <h3><span class="section-number">2.5.1. </span>Importing and namespaces<a class=
 with them for as long as you have used a computer, without even
 thinking about it. This is because folders are simply namespaces
 for files. Each filename can exist only once in each folder, and
-you can nest folders inside folders. Indeed, “directory” is an
-older synonym for “folder” and makes the link to namespaces much
-clearer: a folder or directory is just a list of named files in the
-same way that a telephone directory is a list of named phone
-numbers.</p>
+you can nest folders inside folders.</p>
 </div>
 </div>
 <div class="section" id="other-forms-of-import">
@@ -507,7 +502,7 @@ <h2><span class="section-number">2.6. </span>Packages<a class="headerlink" href=
 containing a file <code class="file docutils literal notranslate"><span class="pre">__init__.py</span></code>. It can also contain modules and
 further subpackages.</p>
 </dd>
-<dt><code class="file docutils literal notranslate"><span class="pre">setup.py</span></code></dt><dd><p>This file is outside the package directory and is not
+<dt><code class="file docutils literal notranslate"><span class="pre">setup.py</span></code></dt><dd><p>This file is outside the package folder and is not
 actually a part of the package. The role of <code class="file docutils literal notranslate"><span class="pre">setup.py</span></code> will be
 covered in <a class="reference internal" href="#installable-packages"><span class="std std-numref">Section 2.6.2</span></a>.</p>
 </dd>
@@ -602,7 +597,7 @@ <h3><span class="section-number">2.6.3. </span>Installing a package from local c
 repository: the folder containing <code class="file docutils literal notranslate"><span class="pre">setup.py</span></code>. The option flag <code class="xref py py-obj docutils literal notranslate"><span class="pre">-e</span></code>
 tells pip to install the package in ‘editable’ mode. This means that
 instead of copying the package files to your venv’s Python packages
-directory, symbolic links will be created. This means that any changes
+folder, symbolic links will be created. This means that any changes
 that you make to your package will show up the next time the package
 is imported in a new Python process, avoiding the need to reinstall
 the package every time you change it.</p>
@@ -642,7 +637,7 @@ <h2><span class="section-number">2.7. </span>Testing frameworks<a class="headerl
 the practical details of including tests in your code here.</p>
 <p>There are a number of Python packages which support code testing. The
 concepts are largely similar so rather than get bogged down in the
-details of multiple frameworks, we will introduce <a class="reference external" href="https://docs.pytest.org/en/latest/index.html" title="(in pytest v6.3.0.dev67+g7585221d5)"><span class="xref std std-doc">pytest</span></a>, which is one of the most widely used.</p>
+details of multiple frameworks, we will introduce <a class="reference external" href="https://docs.pytest.org/en/latest/index.html" title="(in pytest v6.3.0.dev88+gf6529fd3a)"><span class="xref std std-doc">pytest</span></a>, which is one of the most widely used.</p>
 <div class="section" id="pytest-tests">
 <h3><span class="section-number">2.7.1. </span>Pytest tests<a class="headerlink" href="#pytest-tests" title="Permalink to this headline">¶</a></h3>
 <p>A Pytest test is simply a function whose name starts with <code class="xref py py-obj docutils literal notranslate"><span class="pre">test_</span></code>. In
@@ -682,7 +677,7 @@ <h3><span class="section-number">2.7.2. </span>Pytest files<a class="headerlink"
 </pre></div>
 </div>
 <p>These files don’t themselves form part of the package, instead they
-are usually gathered in a separate tests directory. For example:</p>
+are usually gathered in a separate tests folder. For example:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>fibonacci
 ├── fibonacci
 │   ├── __init__.py
@@ -762,7 +757,7 @@ <h3><span class="section-number">2.7.3. </span>Additional useful pytest tricks<a
 <div class="admonition note">
 <p class="admonition-title">Note</p>
 <p>The exercise repositories in this course will usually contain a
-<code class="file docutils literal notranslate"><span class="pre">tests</span></code> directory full of tests that check that you have correctly
+<code class="file docutils literal notranslate"><span class="pre">tests</span></code> folder full of tests that check that you have correctly
 implemented the week’s exercises. You should get in the habit of running the
 tests as you work through the exercises, as they are designed not just to
 pass if your code is correct, but to provide feedback as to what might be
@@ -832,9 +827,16 @@ <h2><span class="section-number">2.9. </span>Glossary<a class="headerlink" href=
 </div>
 <div class="section" id="exercises">
 <h2><span class="section-number">2.10. </span>Exercises<a class="headerlink" href="#exercises" title="Permalink to this headline">¶</a></h2>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>Put a link to the first week quiz here.</p>
+<div class="sphinx-bs container pb-4 docutils">
+<div class="row docutils">
+<div class="d-flex col-lg-6 col-md-6 col-sm-6 col-xs-12 p-2 docutils">
+<div class="card w-100 quiz shadow docutils">
+<div class="card-body docutils">
+<p class="card-text"><a class="sphinx-bs btn text-wrap stretched-link reference external" href="https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&amp;content_id=_2054443_1&amp;mode=cpview"><span>This week’s quiz</span></a></p>
+</div>
+</div>
+</div>
+</div>
 </div>
 <div class="proof proof-type-exercise" id="id5">
 
@@ -947,7 +949,7 @@ <h2><span class="section-number">2.10. </span>Exercises<a class="headerlink" hre
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2019-2020, David A. Ham.
-      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.3.1.
+      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
     </div>
   </body>
 </html>

3_objects.html

@@ -17,7 +17,6 @@
     <script src="_static/jquery.js"></script>
     <script src="_static/underscore.js"></script>
     <script src="_static/doctools.js"></script>
-    <script src="_static/language_data.js"></script>
     <script src="_static/proof.js"></script>
     <script async="async" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -867,6 +866,17 @@ <h2><span class="section-number">3.5. </span>Glossary<a class="headerlink" href=
 </div>
 <div class="section" id="exercises">
 <h2><span class="section-number">3.6. </span>Exercises<a class="headerlink" href="#exercises" title="Permalink to this headline">¶</a></h2>
+<div class="sphinx-bs container pb-4 docutils">
+<div class="row docutils">
+<div class="d-flex col-lg-6 col-md-6 col-sm-6 col-xs-12 p-2 docutils">
+<div class="card w-100 quiz shadow docutils">
+<div class="card-body docutils">
+<p class="card-text"><a class="sphinx-bs btn text-wrap stretched-link reference external" href="https://bb.imperial.ac.uk/webapps/blackboard/content/launchAssessment.jsp?course_id=_23985_1&amp;content_id=_2049499_1&amp;mode=view"><span>This week’s quiz</span></a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
 <p>Obtain the <a class="reference internal" href="not_released.html"><span class="doc">skeleton code for these exercises from GitHub classroom</span></a>.
 The skeleton code contains a <code class="xref py py-mod docutils literal notranslate"><span class="pre">polynomial</span></code> package with a version of
 the <code class="xref py py-class docutils literal notranslate"><span class="pre">Polynomial</span></code> class.</p>
@@ -944,7 +954,7 @@ <h2><span class="section-number">3.6. </span>Exercises<a class="headerlink" href
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2019-2020, David A. Ham.
-      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.3.1.
+      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
     </div>
   </body>
 </html>