update headers for day 3

converter.py

@@ -1,3 +1,5 @@
+#!/usr/bin/env/python3
+
 import subprocess
 import os
 import time

docs/day2.md

@@ -81,8 +81,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     ![create_file](img/day2/create_file.gif)
 
-2. We're going to create an app where the user has to guess the weather. We're going to need the python random module to generate random weather conditions.
-3. Add the following to the top of the page:
+2. We're going to create an app where the user has to guess the weather. We're going to need the python random module to generate random weather conditions. Add the following to the top of the page:
 
     ```python
     import random
@@ -92,7 +91,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     This tells python we intend to use the `random` package
 
-4. We'll generate 4 weather conditions. Add the following after `import random`
+3. We'll generate 4 weather conditions. Add the following after `import random`
 
     ```python
     warm = random.choice([True, False])
@@ -105,7 +104,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     random.choice([True, False]) selects either True or False randomly.
 
-5. Let's print our weather conditions in a cryptic way. Add the following below our variables:
+4. Let's print our weather conditions in a cryptic way. Add the following below our variables:
 
     ```python
     if warm or cold:
@@ -125,7 +124,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     This will print weather conditions in pairs to make it more challenging for our users to guess the weather.
 
-6. Now let's get our user input. Since we have 4 possible weather conditions we'll need 4 "guessing modules". Let's build the first one:
+5. Now let's get our user input. Since we have 4 possible weather conditions we'll need 4 "guessing modules". Let's build the first one:
 
     ```python
     warm_guess = input("Is it warm? (y/n) ")
@@ -141,7 +140,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     We ask the user if it's warm. If they say 'y' and it is warm we tell them they got it right! If they guess wrong we tell them they are wrong.
 
-7. We'll just repeat the guess module 3 more times for cold, raining, and snowing.
+6. We'll just repeat the guess module 3 more times for cold, raining, and snowing.
 
     ```python
     cold_guess = input("Is it cold? (y/n) ")
@@ -171,7 +170,7 @@ Before we do anything more interesting we're going to have to cover our logical
 
     ![modules](img/day2/modules.png)
 
-8. Save with ++ctrl++ + S and run your weather app by typing `python weather_app.py`. Try to guess the weather.
+7. Save with ++ctrl++ + S and run your weather app by typing `python weather_app.py`. Try to guess the weather.
 
     ![run_app](img/day2/run_app.gif)
 

docs/day3.md

@@ -0,0 +1,352 @@
+# Day 3
+
+## "For"
+
+Let's cover our first loop - the "for" loop. In Python the "for" loop is absurdly powerful. Let me show you why.
+
+### Looping without code
+
+"For" loops in Python make intuitive sense even without code. I can demonstrate with this basket of fruit:
+
+```text
+|         |
+|  apple  |
+|  banana |
+ \ pear  /
+  \_____/
+```
+
+For each fruit I want you to take it out of the basket say its name. You start with the apple, since it's at the top, and say "apple". Then you'd take out the banana and say "banana". Finally you'd take our the pear and say "pear". 
+
+In Python our "basket" is a list. Lists look like this:
+
+```python
+["apple", "banana", "pear"]
+```
+
+They're very similar to tuples. A list is "ordered", the first item in the list will always be the apple - much like the top item in the basket will always be the apple.
+
+If I asked you to repeat the basket exercise above but with our python list - remove each item and say its name - you'd start with the apple, then remove the banana, and finally remove the pear.
+
+### Looping with code
+
+You saying the names of fruit out loud is funny but not very practical. Instead I want you to print the names of the fruit from our basket in the Python interpretor.
+
+1. Start you interpretor by typing `python` and pressing ++enter++
+2. In your interpretor type the following:
+
+    ```python
+    fruits = ["apple", "banana", "pear"]
+    for fruit in fruits:
+        print(fruit)
+    ```
+
+    You should see the fruit print out:
+
+    ```python
+    >>> fruits = ["apple", "banana", "pear"]
+    >>> for fruit in fruits:
+    ...     print(fruit)
+    ...
+    apple
+    banana
+    pear
+    >>>
+    ```
+
+    you've just used a for loop!
+
+3. So we can do something with each item in a list. But what if we need the index of each item? Type the following:
+
+    ```python
+    fruits = ["apple", "banana", "pear"]
+    for index, fruit in enumerate(fruits):
+        print(f"fruit {fruit} is at index {index}")
+    ```
+
+    with `enumerate` we can capture the position of the item and the item itself in the list.
+
+    Why is this useful?
+
+4. We can modify elements in a list if we have their position. Paste the following and press enter:
+
+    ```python
+    fruits = ["apple", "banana", "pear"]
+    print(f"Our original list is: {fruits}")
+    ```
+
+    Now let's modify our list. Type the following and press enter:
+
+    ```python
+    for index, fruit in enumerate(fruits):
+        print(f"fruit {fruit} is at index {index}")
+        if fruits[index] == "apple":
+            fruits[index] = "apricot"
+        print(f"fruit is still {fruit} but {fruits[index]} is at position {index} now")
+    ```
+
+    Now paste this:
+
+    ```python
+    print(f"Our modified list is: {fruits}")
+    ```
+
+5. We can also loop through the contents of a dictionary. Let's recreate our dictionary from before:
+
+    ```python
+    vocabulary = {"apple": "the usually round, red or yellow, edible fruit of a small tree, Malus sylvestris, of the rose family.", "banana": "a tropical plant of the genus Musa, certain species of which are cultivated for their nutritious fruit."}
+    ```
+
+    Now we'll loop through the keys in the dictionary:
+
+    ```python
+    for word in vocabulary:
+        print(word)
+    ```
+
+    We can access any item in the dictionary with its key:
+
+    ```python
+    for word in vocabulary:
+        print(vocabulary[word])
+    ```
+
+    And we can access both the key and value by using the `items()` function:
+
+    ```python
+    for word, definition in vocabulary.items():
+        print(f"{word}: {definition}")
+    ```
+
+6. One common data format you'll run into is a list of dictionaries. You can think of this like spreadsheet columns:
+
+    | first name | last name | age |
+    |-|-|-|
+    | Jim | Fowler | 24 |
+    | Bob | Jones | 36 |
+    | Alice | Appleseed | 52 |
+
+    Behind the scenes this table data might look like:
+
+    ```json
+    [
+        {"first name" : "Jim", "last name": "Fowler", "age": 24},
+        {"first name" : "Bob", "last name": "Jones", "age": 36},
+        {"first name" : "Alice", "last name": "Appleseed", "age": 52}
+    ]
+    ```
+
+    Notice how the headers are copied each time - this is the only way to ensure headers are preserved when translated to this format. This is called "json" and is the current preferred way to send data over the web.
+
+    Let's create this data in Python
+
+    ```python
+    people = [
+        {"first name" : "Jim", "last name": "Fowler", "age": 24},
+        {"first name" : "Bob", "last name": "Jones", "age": 36},
+        {"first name" : "Alice", "last name": "Appleseed", "age": 52}
+    ]
+    ```
+
+    We're building a program that checks each person and lets you know if they're over 30 years old. This is easy with for loops:
+
+    ```python
+    for person in people:
+        if person["age"] > 30:
+            print(f"{person['first name']} {person['last name']} is over 30.")
+    ```
+
+7. Another common data format is a dictionary of lists. You can think of this like acceptible responses on a web form:
+
+    The form below has 3 valid states and 4 valid emotions:
+
+    <label>Choose a state:</label>
+    <select>
+    <option>Ohio</option>
+    <option>Virginia</option>
+    <option>Alask</option>
+    </select>
+
+    <label>How you are feeling today:</label>
+    <select>
+    <option>Happy</option>
+    <option>Sad</option>
+    <option>Excited</option>
+    <option>Nope</option>
+    </select>
+
+    These could be represented by the following data:
+
+    ```json
+    {
+        "states": ["Ohio", "Virginia", "Alaska"],
+        "emotions": ["Happy", "Sad", "Excited", "Nope"]
+    }
+    ```
+
+    Let's add this data to python:
+
+    ```python
+    choices = {
+        "states": ["Ohio", "Virginia", "Alaska"],
+        "emotions": ["Happy", "Sad", "Excited", "Nope"]
+    }
+    ```
+
+    Now imagine you have to check if someone entered the right answer when filling out the form. Type the following:
+
+    ```python
+    state = input("Type the state you live in: ")
+    ```
+
+    ```python
+    emotion = input("How are you feeling: ")
+    ```
+
+    ```python
+    if state in choices["states"]:
+        print("Good state")
+    else:
+        print("I don't know where that is.")
+    ```
+
+    ```python
+    if emotion in choices["emotions"]:
+        print("Same")
+    else:
+        print("Not a valid emotion")
+    ```
+
+8. Exit your terminal with `exit()`
+
+## Creating an API
+
+You've got enough at this point to make a substantial API. Usually we'd write a python script at this point but we're going to build a Django API first this time. We'll use the people data we have above.
+
+1. Open mysite/views.py
+2. At the top of views.py add the following:
+
+    ```python hl_lines="3 3"
+    import random
+    from django.shortcuts import render
+    from django.http import JsonResponse
+    ```
+
+3. At the very bottom (below your weather function) add another function like so:
+
+    ```python
+    def api(request):
+    people = [
+        {"first name" : "Jim", "last name": "Fowler", "age": 24},
+        {"first name" : "Bob", "last name": "Jones", "age": 36},
+        {"first name" : "Alice", "last name": "Appleseed", "age": 52}
+    ]
+
+    return JsonResponse({"data": people})
+    ```
+
+    We're returning a "JsonResponse" this time. Remember how json is the current preferred way to send data over the web? Django has a formatter built in for it.
+
+4. let's add a url that points to our api endpoint. Open mysite/urls.py.
+5. Add the following:
+
+    ```python hl_lines="4 4"
+    urlpatterns = [
+        path('', views.index),
+        path('weather/', views.weather),
+        path('people/', views.api),
+    ]
+    ```
+
+6. Start your server with `python manage.py runserver`
+7. Navigate to <http://localhost:8000/people>
+8. You should see people data!
+9. Stop your server with ++ctrl+c++
+
+## Reading an API with python
+
+You have an API! Now let's read it with python. This is one of the most common applications for python in a work environment.
+
+1. First we need a pip package called `requests`. `requests` can make web requests on our behalf. Install it by typing the following in your terminal:
+
+    ```bash
+    pip install requests
+    ```
+
+    ![install_requests](img/day3/install_requests.gif)
+
+2. Let's make sure that install worked. Open the python prompt by typing `python`
+3. In your interpretor type:
+
+    ```python
+    import requests
+    requests.get("https://google.com")
+    ```
+
+    You should see a `<Response [200]>`. That means everything worked!
+
+4. Type `exit()` to exit.
+
+5. Create a new file called `api.py` in your my_website folder:
+
+    ![api](img/day3/api.gif)
+
+6. Add the following to `api.py`
+
+    ```python
+    import requests
+
+    response = requests.get("http://localhost:8000")
+    print(response.text)
+    ```
+
+7. Save with ++ctrl+s++
+8. Run your server by typing `python manage.py runserver`
+9. Open a new terminal window by click the plus icon:
+
+    ![open_terminal](img/day3/open_terminal.gif)
+
+10. Type `python api.py` and press ++enter++
+
+    ![index](img/day3/index.gif)
+
+    We got our index page! Now let's get our API call:
+
+11. Modify api.py by changing our web call to <http://localhost:8000/people>
+
+    ```python hl_lines="3 3"
+    import requests
+
+    response = requests.get("http://localhost:8000/people")
+    print(response.text)
+    ```
+
+12. Type `python api.py` and press ++enter++
+
+    ![people](img/day3/people.gif)
+
+13. Now we want to save our api response as python data. Let's add the following to `api.py`
+
+    ```python hl_lines="2 5-8"
+    import requests
+    import json
+
+    response = requests.get("http://localhost:8000/people")
+    people = response.json()["data"]
+    for person in people:
+        if person["age"] > 30:
+            print(f"{person['first name']} {person['last name']} is over 30.")
+    ```
+
+14. Type `python api.py` and press ++enter++
+
+    ![read_api](img/day3/read_api.gif)
+
+    You've just done one of the most important things in Python programming: used the results of an api call to do something!
+
+15. Click the terminal dropdown and switch back to the terminal running your web server:
+
+    ![switch_term](img/day3/switch_term.gif)
+
+16. Stop your server with ++ctrl+c++
+17. Type `python api.py` and press ++enter++. Notice how you get an error that says "failed to establish new connection"? If requests can't connect to the web server you'll see this error. Remember it!

docs/index.md

@@ -22,3 +22,9 @@
 - Back to the basics: and, or, not, if
 - Building a Terrible Weather App
 - Pulling it all together with some Django
+
+### [Day 3](day3.md): for
+
+- "For"
+- Creating an API
+- Reading an API with Python

mkdocs.yml

@@ -4,6 +4,7 @@ nav:
   - Day 0: day0.md
   - Day 1: day1.md
   - Day 2: day2.md
+  - Day 3: day3.md
 theme:
   name: material
 markdown_extensions: