Tweaked slide layout
[cipher-training.git] / slides / caesar-encipher.html
index 1cdf8ddf0ad3cc22da75e10f27385c2f569ce118..4ef1d341125d73a444a6d2cbbc01a7e7dce08c7c 100644 (file)
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
   <head>
-    <title>Title</title>
+    <title>Caesar cipher</title>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
     <style type="text/css">
       /* Slideshow styles */
         font-weight: 400;
         margin-bottom: 0;
       }
-      h1 { font-size: 4em; }
+      h1 { font-size: 3em; }
       h2 { font-size: 2em; }
       h3 { font-size: 1.6em; }
       a, a > code {
-        /* color: rgb(249, 38, 114); */
         text-decoration: none;
       }
       code {
         border-radius: 5px;
         font-size: 16px;
       }
+      .plaintext {
+        background: #272822;
+        color: #80ff80;
+        text-shadow: 0 0 20px #333;
+        padding: 2px 5px;
+      }
+      .ciphertext {
+        background: #272822;
+        color: #ff6666;
+        text-shadow: 0 0 20px #333;
+        padding: 2px 5px;
+      }
+      .indexlink {
+        position: absolute;
+        bottom: 1em;
+        left: 1em;
+      }
     </style>
   </head>
   <body>
 
 ![centre-aligned Caesar wheel](caesarwheel1.gif)
 
-* Letter-by-letter enciphering
+Letter-by-letter enciphering
+
+---
+
+layout: true
+
+.indexlink[[Index](index.html)]
+
+---
+
+# Enciphering and deciphering
+
+## Arithmetic on letters
+
+Convert .plaintext[letter] → .plaintext[number] → 
+.ciphertext[number] → .ciphertext[letter]
+
+Functions you will need
+
+```python
+ord()
+
+chr()
+
+%
+```
+
+* What are good test cases?
 
 ---
 
@@ -43,6 +86,7 @@
 
 ```python
 import string
+
 string.ascii_letters
 string.ascii_lowercase
 string.ascii_uppercase
@@ -50,6 +94,11 @@ string.digits
 string.punctuation
 ```
 
+---
+# DRY and YAGNI
+
+Is your code DRY?
+
 ---
 
 # Doctest
@@ -57,6 +106,19 @@ string.punctuation
 * Why document?
 * Why test?
 
+```python
+def caesar_encipher_letter(letter, shift):
+    """Encipher a letter, given a shift amount
+
+    >>> caesar_encipher_letter('a', 1)
+    'b'
+    """
+    if letter in string.ascii_letters:
+    .
+    .
+    .
+```
+
 ---
 
 # The magic doctest incantation
@@ -71,6 +133,17 @@ if __name__ == "__main__":
 
 # Doing all the letters
 
+## Test-first developement
+
+1. Write the tests.
+    * They will fail. There is no code.
+2. Write code until the tests pass.
+3. Refactor.
+
+---
+
+# Doing all the letters
+
 ## Abysmal
 
 ```python
@@ -83,7 +156,7 @@ for i in range(len(plaintext)):
 
 # Doing all the letters
 
-## (Merely) Bad
+## Bad
 
 ```python
 ciphertext = ''
@@ -91,6 +164,8 @@ for p in plaintext:
     ciphertext += caesar_encipher_letter(p, key)
 ```
 
+...but easily generalisable
+
 ---
 
 # Doing all the letters
@@ -98,8 +173,7 @@ for p in plaintext:
 ## Good (but unPythonic)
 
 ```python
-ciphertext = map(lambda p: caesar_encipher_letter(p, key), 
-                plaintext)
+ciphertext = map(lambda p: caesar_encipher_letter(p, key), plaintext)
 ```
 
 ---
@@ -109,16 +183,21 @@ ciphertext = map(lambda p: caesar_encipher_letter(p, key),
 ## Best
 
 ```python
-ciphertext = [caesar_encipher_letter(p, key) 
-                for p in plaintext]
+ciphertext = [caesar_encipher_letter(p, key) for p in plaintext]
 ```
+---
+
+# Not all iterables are equal
 
+```python
+''.join()
+```
 
     </textarea>
     <script src="http://gnab.github.io/remark/downloads/remark-0.6.0.min.js" type="text/javascript">
     </script>
     <script type="text/javascript">
-      var slideshow = remark.create();
+      var slideshow = remark.create({ ratio: "16:9" });
     </script>
   </body>
 </html>
\ No newline at end of file