Merge pull request #272 from Ry4an/issue-51-source-links

Inline the code that produces errors

Author: valentina-s

_episodes/07-errors.md

@@ -32,22 +32,34 @@ called a [traceback]({{ page.root }}/reference/#traceback).
 Let's examine one:
 
 ~~~
-import errors_01
-errors_01.favorite_ice_cream()
+# This code has an intentional error. You can type it directly or
+# use it for reference to understand the error message below.
+def favorite_ice_cream():
+    ice_creams = [
+        "chocolate",
+        "vanilla",
+        "strawberry"
+    ]
+    print(ice_creams[3])
+
+favorite_ice_cream()
 ~~~
 {: .python}
 
 ~~~
 ---------------------------------------------------------------------------
 IndexError                                Traceback (most recent call last)
-<ipython-input-1-9d0462a5b07c> in <module>()
-      1 import errors_01
-----> 2 errors_01.favorite_ice_cream()
-
-/Users/jhamrick/project/swc/novice/python/errors_01.pyc in favorite_ice_cream()
-      5         "strawberry"
-      6     ]
-----> 7     print(ice_creams[3])
+<ipython-input-1-70bd89baa4df> in <module>()
+      6     print(ice_creams[3])
+      7 
+----> 8 favorite_ice_cream()
+
+<ipython-input-1-70bd89baa4df> in favorite_ice_cream()
+      4         "vanilla",                                                                    "strawberry"
+      5     ]
+----> 6     print(ice_creams[3])
+      7 
+      8 favorite_ice_cream()
 
 IndexError: list index out of range
 ~~~
@@ -58,16 +70,16 @@ You can determine the number of levels by looking for the number of arrows on th
 In this case:
 
 1.  The first shows code from the cell above,
-    with an arrow pointing to Line 2 (which is `favorite_ice_cream()`).
+    with an arrow pointing to Line 8 (which is `favorite_ice_cream()`).
 
-2.  The second shows some code in another function (`favorite_ice_cream`, located in the file `errors_01.py`),
-    with an arrow pointing to Line 7 (which is `print(ice_creams[3])`).
+2.  The second shows some code in the function `favorite_ice_cream`,
+    with an arrow pointing to Line 6 (which is `print(ice_creams[3])`).
 
 The last level is the actual place where the error occurred.
 The other level(s) show what function the program executed to get to the next level down.
 So, in this case, the program first performed a [function call]({{ page.root }}/reference/#function-call) to the function `favorite_ice_cream`.
 Inside this function,
-the program encountered an error on Line 7, when it tried to run the code `print(ice_creams[3])`.
+the program encountered an error on Line 6, when it tried to run the code `print(ice_creams[3])`.
 
 > ## Long Tracebacks
 >
@@ -410,51 +422,68 @@ often reveals common reasons why you might get that error.
 
 > ## Reading Error Messages
 >
-> Read the traceback below, and identify the following pieces of information about it:
+> Read the python code and the resulting traceback below, and answer the following questions:
 >
 > 1.  How many levels does the traceback have?
-> 2.  What is the file name where the error occurred?
-> 3.  What is the function name where the error occurred?
-> 4.  On which line number in this function did the error occurr?
-> 5.  What is the type of error?
-> 6.  What is the error message?
+> 2.  What is the function name where the error occurred?
+> 3.  On which line number in this function did the error occurr?
+> 4.  What is the type of error?
+> 5.  What is the error message?
 >
 > ~~~
-> import errors_02
-> errors_02.print_friday_message()
+> # This code has an intentional error. Do not type it directly;
+> # use it for reference to understand the error message below.
+> def print_message(day):
+>     messages = {
+>         "monday": "Hello, world!",
+>         "tuesday": "Today is tuesday!",
+>         "wednesday": "It is the middle of the week.",
+>         "thursday": "Today is Donnerstag in German!",
+>         "friday": "Last day of the week!",
+>         "saturday": "Hooray for the weekend!",
+>         "sunday": "Aw, the weekend is almost over."
+>     }
+>     print(messages[day])
+>
+> def print_friday_message():
+>     print_message("Friday")
+>
+> print_friday_message()
 > ~~~
 > {: .python}
 >
 > ~~~
 > ---------------------------------------------------------------------------
 > KeyError                                  Traceback (most recent call last)
-> <ipython-input-2-e4c4cbafeeb5> in <module>()
->       1 import errors_02
-> ----> 2 errors_02.print_friday_message()
+> <ipython-input-1-4be1945adbe2> in <module>()
+>      14     print_message("Friday")
+>      15
+> ---> 16 print_friday_message()
 >
-> /Users/jhamrick/project/swc/novice/python/errors_02.py in print_friday_message()
->      13
->      14 def print_friday_message():
-> ---> 15     print_message("Friday")
+> <ipython-input-1-4be1945adbe2> in print_friday_message()
+>      12
+>      13 def print_friday_message():
+> ---> 14     print_message("Friday")
+>      15
+>      16 print_friday_message()
 >
-> /Users/jhamrick/project/swc/novice/python/errors_02.py in print_message(day)
+> <ipython-input-1-4be1945adbe2> in print_message(day)
 >       9         "sunday": "Aw, the weekend is almost over."
 >      10     }
 > ---> 11     print(messages[day])
 >      12
->      13
+>      13 def print_friday_message():
 >
 > KeyError: 'Friday'
 > ~~~
 > {: .error}
 >
 > > ## Solution
 > > 1. 3 levels
-> > 2. `errors_02.py`
-> > 3. `print_message`
-> > 4. 11
-> > 5. `KeyError`
-> > 6. There isn't really a message; you're supposed to infer that `Friday` is not a key in `messages`.
+> > 2. `print_message`
+> > 3. 11
+> > 4. `KeyError`
+> > 5. There isn't really a message; you're supposed to infer that `Friday` is not a key in `messages`.
 > {: .solution}
 {: .challenge}