vimeo directive.

Author: dham

doc/source/10_trees_and_directed_acyclic_graphs.rst

@@ -27,16 +27,12 @@ The splat and double splat operators
 
 .. dropdown:: Video: splat and double splat.
 
-    .. container:: vimeo
+    .. vimeo:: 523477744
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/523477744"
-            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=2cb93382-321b-4af6-8d5e-aceb0123103d>`__.
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=2cb93382-321b-4af6-8d5e-aceb0123103d>`__.
 
 
 Before we go on to write code for trees and their traversal,  we need to
@@ -257,16 +253,12 @@ Data structures for trees
 
 .. dropdown:: Tree data structures.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 523477713
 
-            <iframe src="https://player.vimeo.com/video/523477713"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=5477e1b1-1040-4a07-97a5-aceb01230fc6>`__.
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=5477e1b1-1040-4a07-97a5-aceb01230fc6>`__.
 
 Unlike the sequence types we have previously met, trees are not linear objects.
 If we wish to iterate through every node in the tree then we have a choices to
@@ -339,16 +331,12 @@ Traversing :class:`~example_code.graphs.TreeNode`
 
 .. dropdown:: Video: tree traversal.
 
-    .. container:: vimeo
+    .. vimeo:: 523477719
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/523477719"
-            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=69b00d45-077d-46ff-933c-aceb01231001>`__.
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=69b00d45-077d-46ff-933c-aceb01231001>`__.
 
 A function which traverses a tree is often called a tree visitor, because it
 visits every node in the tree. What does it do when it visits? Well it could do
@@ -662,16 +650,12 @@ Operations on expression trees
 
 .. dropdown:: Video: evaluating expressions.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 523478799
 
-            <iframe src="https://player.vimeo.com/video/523478799"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=88f9564a-73c9-4760-8f48-aceb01230f9b>`__.
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=88f9564a-73c9-4760-8f48-aceb01230f9b>`__.
 
 Many operations on expression trees can be implemented using tree visitors, most
 frequently by visiting the tree in postorder. An example is

doc/source/11_further_object-oriented_features.rst

@@ -12,16 +12,12 @@ Decorators
 
 .. dropdown:: Video: decorators.
 
-    .. container:: vimeo
+    .. vimeo:: 526946976
 
-        .. raw:: html
+    .. only:: 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>`__.
+        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
@@ -209,16 +205,12 @@ Abstract base classes
 
 .. dropdown:: Video: Abstract base classes.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 526947635
 
-            <iframe src="https://player.vimeo.com/video/526947635"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f4678a69-731c-45fe-bdbf-acf2011de880>`__.
+        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
@@ -392,16 +384,12 @@ Virtual subclasses
 
 .. dropdown:: Video: virtual subclasses.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 526947427
 
-            <iframe src="https://player.vimeo.com/video/526947427"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=4114bb1d-cc31-4cfc-81a6-acf2011de8d6>`__.
+        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

doc/source/1_introduction.rst

@@ -6,9 +6,10 @@ Introduction: abstraction in mathematics and programming
 .. dropdown:: Video introduction.
 
     .. vimeo:: 486106801
-        :width: 100%
 
-    Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=ee8cae7f-1b42-4db3-adc0-ac840144de53>`_
+    .. only:: html
+
+        Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=ee8cae7f-1b42-4db3-adc0-ac840144de53>`_
 
 A core tool of mathematics is to define abstract objects and the
 operations which apply to them. This approach defines all the basic

doc/source/2_programs_in_files.rst

@@ -22,15 +22,11 @@ Setting up a Python environment for this course
 
 .. dropdown:: Video: setting up your virtual environment.
 
-    .. container:: vimeo
+    .. vimeo:: 486546635
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/486546635"
-            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=011d73de-d93c-4dc8-8996-ac8501521b33>`__
+        Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=011d73de-d93c-4dc8-8996-ac8501521b33>`__
 
 
 During this course, we're going to create, edit, and install a whole bunch of
@@ -93,15 +89,11 @@ The Python interpreter
 
 .. dropdown:: Video: a first Python script.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 486557682
 
-            <iframe src="https://player.vimeo.com/video/486557682"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=0f9a50a0-59b4-4bdf-ab90-ac850154fafb>`__
+        Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=0f9a50a0-59b4-4bdf-ab90-ac850154fafb>`__
 
 Before we dive into the various different ways that Python code can be
 organised and run, it's helpful to have a mental model of what it
@@ -276,15 +268,11 @@ Modules
 
 .. dropdown:: Video: a first Python module.
 
-    .. container:: vimeo
-
-        .. raw:: html
+.. vimeo:: 486845755
 
-            <iframe src="https://player.vimeo.com/video/486845755"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=972f92c6-6b55-4510-9c2c-ac8600fca11a>`__
+        Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=972f92c6-6b55-4510-9c2c-ac8600fca11a>`__
 
 A module is, like a script, a plain text file containing Python
 code. Modules must have names ending in :file:`.py`. So far, that's
@@ -442,15 +430,11 @@ Packages
 
 .. dropdown:: Video: a first Python package.
 
-    .. container:: vimeo
+    .. vimeo:: 487003753
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/487003753"
-            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=c4b0aedd-02a8-45d1-946b-ac86015b6d0b>`__
+        Imperial students can also `watch this video on Panopto <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=c4b0aedd-02a8-45d1-946b-ac86015b6d0b>`__
 
 
 Modules are the principal mechanism for storing code which is intended
@@ -654,16 +638,12 @@ Testing frameworks
 
 .. dropdown:: Video: introducing Pytest.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 486987209
 
-            <iframe src="https://player.vimeo.com/video/486987209"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=c636383d-6125-4a7c-bad7-ac86015b6d4c>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=c636383d-6125-4a7c-bad7-ac86015b6d4c>`__
 
 Attempting to establish whether a program correctly implements the
 intended algorithm is core to effective programming, and programmers

doc/source/3_objects.rst

@@ -177,16 +177,12 @@ Defining new types
 
 .. dropdown:: Video: a first class
 
-    .. container:: vimeo
+    .. vimeo:: 488143930
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/488143930"
-            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=f8b07554-16ea-47b8-bf19-ac8a010af0f6>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=f8b07554-16ea-47b8-bf19-ac8a010af0f6>`__
 
 Python has a rich set of :doc:`built-in types
 <library/stdtypes>`. These form powerful building blocks for the
@@ -326,16 +322,12 @@ Methods
 
 .. dropdown:: Video: defining methods
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 488273256
 
-            <iframe src="https://player.vimeo.com/video/488273256"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=613249ca-71b8-4f3b-8db9-ac8a0166aa42>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=613249ca-71b8-4f3b-8db9-ac8a0166aa42>`__
 
 We have already met the :term:`special method` :meth:`~object.__init__`,
 which defines the class constructor. A much more typical case is an
@@ -388,16 +380,12 @@ String representations of objects
 
 .. dropdown:: Video: printing classes
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 488275072
 
-            <iframe src="https://player.vimeo.com/video/488275072"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=b30db20c-1224-41b7-a5f2-ac8a01680608>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=b30db20c-1224-41b7-a5f2-ac8a01680608>`__
 
 
 Remember that a key reason for defining new classes is to enable users
@@ -498,16 +486,12 @@ Object equality
 
 .. dropdown:: Video: object equality and test driven development
 
-    .. container:: vimeo
+    .. vimeo:: 488981397
 
-        .. raw:: html
+    .. only:: html
 
-            <iframe src="https://player.vimeo.com/video/488981397"
-            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=821e53ec-d2c8-43a6-bb16-ac8c01045f31>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=821e53ec-d2c8-43a6-bb16-ac8c01045f31>`__
 
 When are two objects equal? For built-in types Python has equality rules which
 broadly match the mathematical identities that you might expect. For example,
@@ -602,16 +586,12 @@ Defining arithmetic options on objects
 
 .. dropdown:: Video: polynomial addition.
 
-    .. container:: vimeo
-
-        .. raw:: html
+    .. vimeo:: 489009900
 
-            <iframe src="https://player.vimeo.com/video/489009900"
-            frameborder="0" allow="autoplay; fullscreen"
-            allowfullscreen></iframe>
+    .. only:: html
 
-    Imperial students can also `watch this video on Panopto
-    <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=727c5b9a-bf61-480e-912e-ac8c01045f09>`__
+        Imperial students can also `watch this video on Panopto
+        <https://imperial.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=727c5b9a-bf61-480e-912e-ac8c01045f09>`__
 
 It's all very well to be able to compare our polynomial objects, but
 we won't really have captured the mathematical abstraction involved