Website build

Author: dham

11_further_object-oriented_features.html

@@ -65,7 +65,20 @@ <h1><span class="section-number">11. </span>Further object-oriented features<a c
 in the course so far.</p>
 <div class="section" id="decorators">
 <span id="id1"></span><h2><span class="section-number">11.1. </span>Decorators<a class="headerlink" href="#decorators" title="Permalink to this headline">¶</a></h2>
-<p>In <a class="reference internal" href="10_trees_and_directed_acyclic_graphs.html#trees"><span class="std std-numref">Week 10</span></a> we encountered the
+<details class="sphinx-bs dropdown card mb-3">
+<summary class="summary-title card-header">
+Video: decorators.<div class="summary-down docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
+<div class="summary-up docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
+</summary><div class="summary-content card-body docutils">
+<div class="vimeo docutils container">
+<iframe src="https://player.vimeo.com/video/526946976"
+frameborder="0" allow="autoplay; fullscreen"
+allowfullscreen></iframe></div>
+<p class="card-text">Imperial students can also <a class="reference external" href="https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f1d61410-4200-42e5-92c4-acf2011de8ab">watch this video on Panopto</a>.</p>
+</div>
+</details><p>In <a class="reference internal" href="10_trees_and_directed_acyclic_graphs.html#trees"><span class="std std-numref">Week 10</span></a> we encountered the
 <a class="reference external" href="https://docs.python.org/3/library/functools.html#functools.singledispatch" title="(in Python v3.9)"><code class="xref py py-func docutils literal notranslate"><span class="pre">functools.singledispatch()</span></code></a> decorator, which turns a function into a
 <a class="reference internal" href="10_trees_and_directed_acyclic_graphs.html#term-single-dispatch-function"><span class="xref std std-term">single dispatch function</span></a>. More generally, a decorator is a function
 which takes in a function and returns another function. In other words, the
@@ -229,7 +242,20 @@ <h3><span class="section-number">11.1.3. </span>The <a class="reference external
 </div>
 <div class="section" id="abstract-base-classes">
 <span id="id2"></span><h2><span class="section-number">11.2. </span>Abstract base classes<a class="headerlink" href="#abstract-base-classes" title="Permalink to this headline">¶</a></h2>
-<p>We have now on several occasions encountered classes which are not designed to
+<details class="sphinx-bs dropdown card mb-3">
+<summary class="summary-title card-header">
+Video: Abstract base classes.<div class="summary-down docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
+<div class="summary-up docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
+</summary><div class="summary-content card-body docutils">
+<div class="vimeo docutils container">
+<iframe src="https://player.vimeo.com/video/526947635"
+frameborder="0" allow="autoplay; fullscreen"
+allowfullscreen></iframe></div>
+<p class="card-text">Imperial students can also <a class="reference external" href="https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f4678a69-731c-45fe-bdbf-acf2011de880">watch this video on Panopto</a>.</p>
+</div>
+</details><p>We have now on several occasions encountered classes which are not designed to
 be instantiated themselves, but merely serve as parent classes to concrete
 classes which are intended to be instantiated. Examples of these classes
 include <a class="reference external" href="https://docs.python.org/3/library/numbers.html#numbers.Number" title="(in Python v3.9)"><code class="xref py py-class docutils literal notranslate"><span class="pre">numbers.Number</span></code></a>, <a class="reference internal" href="example_code.html#example_code.groups.Group" title="example_code.groups.Group"><code class="xref py py-class docutils literal notranslate"><span class="pre">example_code.groups.Group</span></code></a>, and the
@@ -426,7 +452,20 @@ <h3><span class="section-number">11.2.3. </span>Duck typing<a class="headerlink"
 </div>
 <div class="section" id="virtual-subclasses">
 <h3><span class="section-number">11.2.4. </span>Virtual subclasses<a class="headerlink" href="#virtual-subclasses" title="Permalink to this headline">¶</a></h3>
-<p>We learned in <a class="reference internal" href="3_objects.html#objects"><span class="std std-numref">Week 3</span></a> that we can determine if a type is a
+<details class="sphinx-bs dropdown card mb-3">
+<summary class="summary-title card-header">
+Video: virtual subclasses.<div class="summary-down docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
+<div class="summary-up docutils">
+<svg version="1.1" width="24" height="24" class="octicon octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
+</summary><div class="summary-content card-body docutils">
+<div class="vimeo docutils container">
+<iframe src="https://player.vimeo.com/video/526947427"
+frameborder="0" allow="autoplay; fullscreen"
+allowfullscreen></iframe></div>
+<p class="card-text">Imperial students can also <a class="reference external" href="https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=4114bb1d-cc31-4cfc-81a6-acf2011de8d6">watch this video on Panopto</a>.</p>
+</div>
+</details><p>We learned in <a class="reference internal" href="3_objects.html#objects"><span class="std std-numref">Week 3</span></a> that we can determine if a type is a
 number by checking if it is an instance of <a class="reference external" href="https://docs.python.org/3/library/numbers.html#numbers.Number" title="(in Python v3.9)"><code class="xref py py-class docutils literal notranslate"><span class="pre">numbers.Number</span></code></a>. This is a
 slightly different usage of abstract base classes. Rather than providing part
 of the implementation of, say, <a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.9)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/numbers.html#numbers.Number" title="(in Python v3.9)"><code class="xref py py-class docutils literal notranslate"><span class="pre">numbers.Number</span></code></a> provides
@@ -613,8 +652,7 @@ <h2><span class="section-number">11.3. </span>Glossary<a class="headerlink" href
 </div>
 <div class="section" id="exercises">
 <h2><span class="section-number">11.4. </span>Exercises<a class="headerlink" href="#exercises" title="Permalink to this headline">¶</a></h2>
-<p>Obtain the <a href="#id9"><span class="problematic" id="id10">`skeleton code for these exercises from GitHub classroom
-&lt;&gt;`__</span></a>.</p>
+<p>Obtain the <a class="reference external" href="https://classroom.github.com/a/qTArFlxP">skeleton code for these exercises from GitHub classroom</a>.</p>
 <div class="proof proof-type-exercise" id="id7">
 
     <div class="proof-title">
@@ -629,11 +667,11 @@ <h2><span class="section-number">11.4. </span>Exercises<a class="headerlink" hre
 taking any combination of arguments.</p>
 <p>The logging itself should be accomplished using
 the built-in <a class="reference external" href="https://docs.python.org/3/library/logging.html#module-logging" title="(in Python v3.9)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">logging</span></code></a> module by calling <a class="reference external" href="https://docs.python.org/3/library/logging.html#logging.info" title="(in Python v3.9)"><code class="xref py py-func docutils literal notranslate"><span class="pre">logging.info()</span></code></a> and passing
-the logging message.</p>
-<p>The logging message should comprise the function name (accessible using the
-<a class="reference external" href="https://docs.python.org/3/reference/import.html#__name__" title="(in Python v3.9)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">__name__</span></code></a> attribute), followed by round brackets containing first the
-<a class="reference external" href="https://docs.python.org/3/library/functions.html#repr" title="(in Python v3.9)"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> of the positional arguments, followed by the key=value pairs
-the keyword arguments.</p>
+the log message.</p>
+<p>The log message should comprise the string <code class="xref py py-obj docutils literal notranslate"><span class="pre">&quot;Calling:</span> <span class="pre">&quot;</span></code> followed by the
+function name (accessible using the <a class="reference external" href="https://docs.python.org/3/reference/import.html#__name__" title="(in Python v3.9)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">__name__</span></code></a> attribute), followed by
+round brackets containing first the <a class="reference external" href="https://docs.python.org/3/library/functions.html#repr" title="(in Python v3.9)"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> of the positional
+arguments, followed by the key=value pairs the keyword arguments.</p>
 </div></div><div class="proof proof-type-exercise" id="id8">
 
     <div class="proof-title">
@@ -643,7 +681,7 @@ <h2><span class="section-number">11.4. </span>Exercises<a class="headerlink" hre
 <p>The <code class="xref py py-mod docutils literal notranslate"><span class="pre">groups.groups</span></code> module in the skeleton code is the new version
 introduced above, using an <a class="reference internal" href="#term-abstract-base-class"><span class="xref std std-term">abstract base class</span></a>. The
 <code class="xref py py-obj docutils literal notranslate"><span class="pre">log_decorator.log_call</span></code> <a class="reference internal" href="#term-decorator"><span class="xref std std-term">decorator</span></a> has been applied to the
-<span class="math notranslate nohighlight">\(Group._validate\)</span> <a class="reference internal" href="#term-abstract-method"><span class="xref std std-term">abstract method</span></a>. However, even once you
+<code class="xref py py-meth docutils literal notranslate"><span class="pre">Group._validate()</span></code> <a class="reference internal" href="#term-abstract-method"><span class="xref std std-term">abstract method</span></a>. However, even once you
 have implemented this decorator, it never gets called. Your challenge is to
 modify <code class="xref py py-mod docutils literal notranslate"><span class="pre">groups.groups</span></code> so that the decorator is called every time a
 subclass <code class="xref py py-meth docutils literal notranslate"><span class="pre">_validate()</span></code> method is called, but <strong>without</strong> moving or

_modules/example_code/groups_abc.html

@@ -124,7 +124,7 @@ <h1>Source code for example_code.groups_abc</h1><div class="highlight"><pre>
 
     <span class="nd">@abstractmethod</span>
     <span class="k">def</span> <span class="nf">_validate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Ensure that value is a legitimate element value in this group.&quot;&quot;&quot;</span>
+        <span class="sd">&quot;&quot;&quot;Ensure that value is a legitimate element value in this Group.&quot;&quot;&quot;</span>
         <span class="k">pass</span>
 
 <div class="viewcode-block" id="Group.operation"><a class="viewcode-back" href="../../example_code.html#example_code.groups_abc.Group.operation">[docs]</a>    <span class="nd">@abstractmethod</span>

_sources/11_further_object-oriented_features.rst.txt

@@ -10,6 +10,20 @@ in the course so far.
 Decorators
 ----------
 
+.. dropdown:: Video: decorators.
+
+    .. container:: vimeo
+
+        .. raw:: html
+
+            <iframe src="https://player.vimeo.com/video/526946976"
+            frameborder="0" allow="autoplay; fullscreen"
+            allowfullscreen></iframe>
+
+    Imperial students can also `watch this video on Panopto
+    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f1d61410-4200-42e5-92c4-acf2011de8ab>`__.
+
+
 In :numref:`Week %s <trees>` we encountered the
 :func:`functools.singledispatch` decorator, which turns a function into a
 :term:`single dispatch function`. More generally, a decorator is a function
@@ -193,6 +207,19 @@ ones. We will survey just a few here:
 Abstract base classes
 ---------------------
 
+.. dropdown:: Video: Abstract base classes.
+
+    .. container:: vimeo
+
+        .. raw:: html
+
+            <iframe src="https://player.vimeo.com/video/526947635"
+            frameborder="0" allow="autoplay; fullscreen"
+            allowfullscreen></iframe>
+
+    Imperial students can also `watch this video on Panopto
+    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f4678a69-731c-45fe-bdbf-acf2011de880>`__.
+
 We have now on several occasions encountered classes which are not designed to
 be instantiated themselves, but merely serve as parent classes to concrete
 classes which are intended to be instantiated. Examples of these classes
@@ -363,6 +390,19 @@ second use of abstract base classes comes into play.
 Virtual subclasses
 ~~~~~~~~~~~~~~~~~~
 
+.. dropdown:: Video: virtual subclasses.
+
+    .. container:: vimeo
+
+        .. raw:: html
+
+            <iframe src="https://player.vimeo.com/video/526947427"
+            frameborder="0" allow="autoplay; fullscreen"
+            allowfullscreen></iframe>
+
+    Imperial students can also `watch this video on Panopto
+    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=4114bb1d-cc31-4cfc-81a6-acf2011de8d6>`__.
+
 We learned in :numref:`Week %s <objects>` that we can determine if a type is a
 number by checking if it is an instance of :class:`numbers.Number`. This is a
 slightly different usage of abstract base classes. Rather than providing part
@@ -541,7 +581,7 @@ Exercises
 ---------
 
 Obtain the `skeleton code for these exercises from GitHub classroom
-<>`__. 
+<https://classroom.github.com/a/qTArFlxP>`__. 
 
 .. proof:exercise::
 
@@ -554,19 +594,19 @@ Obtain the `skeleton code for these exercises from GitHub classroom
 
     The logging itself should be accomplished using
     the built-in `logging` module by calling :func:`logging.info` and passing
-    the logging message.
+    the log message.
 
-    The logging message should comprise the function name (accessible using the
-    `__name__` attribute), followed by round brackets containing first the
-    :func:`repr` of the positional arguments, followed by the key=value pairs
-    the keyword arguments.
+    The log message should comprise the string `"Calling: "` followed by the
+    function name (accessible using the `__name__` attribute), followed by
+    round brackets containing first the :func:`repr` of the positional
+    arguments, followed by the key=value pairs the keyword arguments.
 
 .. proof:exercise::
 
     The :mod:`groups.groups` module in the skeleton code is the new version
     introduced above, using an :term:`abstract base class`. The
     `log_decorator.log_call` :term:`decorator` has been applied to the
-    :math:`Group._validate` :term:`abstract method`. However, even once you
+    :meth:`Group._validate` :term:`abstract method`. However, even once you
     have implemented this decorator, it never gets called. Your challenge is to
     modify :mod:`groups.groups` so that the decorator is called every time a
     subclass :meth:`_validate` method is called, but **without** moving or