Review Topics

All of the topics below are things that have been heavily covered and used throughout the class. We will mostly be focusing on more complicated uses and mechanics of these topics.

Lists

  • What are Lists?
    • Lists are an ordered sequence of elements, where each element is a variable
    • Unlike dictionaries, lists' keys are all integers that describe the order of the list

Some examples of lists:

  • Playlist of songs
  • names of students in a class
  • contacts on your phone

  • Each element of a string is referenced by an index (which is a number) and they generally start 0 but for the AP Exam it starts at 1.

    • AP Exam: 1,2,3,4 etc.
    • Python: 0,1,2,3 etc.

How do lists Manage Complexity of a program?

  • We may not need as many variables. For example:
    • One Variable that holds all students would be better than having a variable for EACH student
    • There can also be a list of test scores so if they need to be curved then the same calculation can be applied to the list (that has all the students) instead of doing the calculations one at a time

Answer the following questions about the code block below:

  • Why do you think lists are helpful? What word does College Board like to use to describe the function of lists?
    • I think lists are helpful because they help manage complex data and sort it
    • enumeration
  • So you can store multiple variables/elements of data in one area. Easy access and you can use iterative functions to apply to all of the elements in the list instead of doing it one at a time.
# variable of type string
name = "Sri Kotturi"
print("name", name, type(name))

# variable of type integer
age = 16
print("age", age, type(age))

# variable of type float
score = 90.0
print("score", score, type(score))

print()

# variable of type list (many values in one variable)
langs = ["Python", "JavaScript", "Java", "Bash", "html"]
print("langs", langs, type(langs))
print("- langs[2]", langs[2], type(langs[2]))

print()

# variable of type dictionary (a group of keys and values)
person = {
    "name": name,
    "age": age,
    "score": score,
    "langs": langs
}
print("person", person, type(person))
print('- person["name"]', person["name"], type(person["name"]))
name Sri Kotturi <class 'str'>
age 16 <class 'int'>
score 90.0 <class 'float'>

langs ['Python', 'JavaScript', 'Java', 'Bash', 'html'] <class 'list'>
- langs[2] Java <class 'str'>

person {'name': 'Sri Kotturi', 'age': 16, 'score': 90.0, 'langs': ['Python', 'JavaScript', 'Java', 'Bash', 'html']} <class 'dict'>
- person["name"] Sri Kotturi <class 'str'>

Mathematical Expressions

What is the output of the cell below? What Mathematical Expressions do you see being used? (List them below.)

  • 10
  • Adding and dividing (sum and div) for finding the average
grade1 = 10
grade2 =  grade1 

average_grade = (grade1 + grade2) // 2 #what are these two slashes?

print(average_grade)
10

What is the value of num1, num2, and num3? Explain how each number ended up what it was.

  • num1 = 4096 because it is 4 to the power of 6 = 4096
  • num2 = 455 because it is ( 4096+ 1 ) / 9 = 4097 / 9 = 455.223
  • num 3 = 1 because it is the remainder of 4096 / 5
num1 = 2
num2 = 4
num3 = 6
num1 = num2 ** num3
num3 = num1 % 5
num2 = (num1 + num3) // 9

print(num1)
print(num2)
print(num3)
4096
455
1

Selection

Selection refers to the process of making decisions in a program based on certain conditions. It is normally done with conditional statements.

Conditionals

What is a conditional?:

  • Statement that allows code to execute different instructions if a certain condition is true of false.
  • Allows program to make decisions based on data and input

What are the main types of conditional statements?:

  • if
  • elif
  • else

If statements

  • The if statement is used to check if a certain condition is true. The condition can be any expression that evaulates to a boolean value, True or False. If the condition is True, then it executes a code block.
  • If (condition) then (consequence)
  • Example:
x = int(input("Enter a number"))
if x > 0: # if condition, check if this is true of false
    print("x is positive") # code that will execute if condition is met
x is positive

Else

  • The else statemnt executes a code block when the if condition is False.
  • If (condition) then (consequence A), else (consequence B)

Elif

  • The elif statement can check multiple conditions in a sequence, and execute a certain block of code if any of the conditions are true.
  • If (condition) then (consequence A), elif (condition) then (consequence B), else (consequence C)

  • Example adding onto the code from before to take negative numbers and 0 into account

x = int(input("Enter a number, x:"))
if x > 0: # if condition, check if this is true of false
    print("x is positive") # code that will execute if condition is met
elif x < 0: # if previous condition not true... elif condition, check if this is true of false
    print("x is negative")# code that will execute if condition is met
else: # everything else, in this case it is if x == 0 
    print("x is zero") # only executes if all previous conditions are not met
x is negative

Nested Conditionals

What is a nested conditional?:

  • Conditional statement inside another conditional statement
  • Allows to for more complex condition where one condition depends on another

Nested Conditional Statements

  • Example
x = int(input("Enter a number, x:"))
if x % 2 == 0:
    print("x is even divisible by 2")
    # only ever checks is x is divisble by 3 if x is even. nested conditional
    if x % 3 == 0:
        print("x is divisible by 3")
    else:
        print("x is not divisible by 3")
else:
    print("x is odd")
x is odd

Indentation

When using conditionals and nested conditionals in Python, it is important to pay attention to the indentation in the code. The code inside the if, elif, and else blocks must be indented so they are nested within the outer statements. This way, Python knows which code belongs to which block.

What is binary search and what is it used for?:

  • Searching algorithm that finds and selects specific elements in a sorted list, by repeatedly diving the search interval in half and comparing that value to the target value. It searches upper or lower half, eliminating half of the data each time.
  • Find and select a specific element in a sorted list of elements

How does binary search work?:

  • Repeatedly divides the search interval in half to find the middle element and compares the middle value to the target value, if not the same then it continues on to either the lower or upper half
  • Eliminate half of the remaining search interval elements each time
  • Efficient way to search for element in large dataset

What is the time complexity and why?:

  • O(log(N))
  • The maximum number of iterations is the amount of times the list can be divided in half until it reaches 1 number
  • Dividing by 2, so it is log2(N), logarigthm of n base 2

  • You may recognize the example below from the binary lesson last Friday

import random

def binary_search_game():
    low = 1
    high = 100
    target = random.randint(low, high)

    while True:
        guess = (low + high) // 2
        print(f"Is your number {guess}?")
        response = input("Enter 'higher', 'lower', or 'yes': ")

        # conditional statements to check target number and guess
        if response == 'yes':
            print(f"I guessed your number {guess}!")
            break
        elif response == 'higher':
            low = guess + 1
        elif response == 'lower':
            high = guess - 1
        else:
            print("Invalid input, please enter 'higher', 'lower', or 'yes'.")

binary_search_game()
Is your number 50?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 50?
Is your number 75?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 75?
Is your number 88?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 88?
Is your number 81?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 81?
Is your number 78?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 78?
Is your number 76?
Invalid input, please enter 'higher', 'lower', or 'yes'.
Is your number 76?
Is your number 77?
I guessed your number 77!

Quick Hack

Write a program using conditionals and nested conditionals

  • Ideas: Quiz, game (rock paper scissors, guess number), etc
import random

def rock_paper_scissors():
    choices = ['rock', 'paper', 'scissors']
    computer_choice = random.choice(choices)
    player_choice = input("Choose rock, paper, or scissors")
    print(f"Player chooses {player_choice}, computer chooses {computer_choice}")


    if player_choice == computer_choice:
        print("Tie!")
    elif player_choice == 'rock':
        if computer_choice == 'paper':
            print("I win!")
        else: 
            print("You win!")
    elif player_choice == 'paper':
        if computer_choice == 'rock':
            print("You win!")
        else:
            print("I win!")
    elif player_choice == 'scissors':
        if computer_choice == 'rock':
            print("I win!")
        else:
            print("You win!")

    else:
        print("Invalid choice. Please choose rock, paper, or scissors.")

rock_paper_scissors()
    
Player chooses rock, computer chooses rock
Tie!

Introduction to Algorithms

  • an algorithm is a set of instructions that describes how to solve a problem or perform a specific task using a computer program.
  • It is a precise sequence of computational steps that take an input and produce an output

How do Algorithms relate to data structures?

  • Algorithms often rely on specific data structures to solve problems efficiently.
  • Sorting algorithms require a data structure such as an array or a linked list to store and manipulate data.
  • Searching algorithms such as binary search require data structures like arrays or trees to organize and search through data.

Important Terms

What is an algorithm?

  • it is a finite set of instructions that accomplishes a specific task

Sequencing

  • means that there is an order in which to do things

Selection

  • Helps to choose outcomes based off of a decision that the programmer wants to make

Iteration

  • Repeat something until the condition is met. (also referred to as repetition)

Calling and Developing Procedures

  • A procedure is a sequence of instructions that performs a specific task.
  • To call a procedure, you need to know its name and any arguments it requires.
  • When a procedure is called, the program jumps to its instruction and starts executing it.
  • The arguments passed to a procedure can be used within the procedure to perform the task.
  • After the procedure has completed its task, it returns control back to the calling program.
def add_numbers(a, b):
    sum = a + b
    print("The sum of", a, "and", b, "is", sum)

# Call the procedure with arguments 5 and 7
add_numbers(39, -672)
The sum of 39 and -672 is -633
  • The result of the procedure can be stored in a variable, printed to the screen, or used in any other way that is required by the program.
  • Procedures can be defined within the same program or in external files, and can be reused across multiple parts of the program.
  • To avoid errors and improve code readability, it's important to define and call procedures with proper syntax and conventions that are appropriate for the programming language you're using.
def calculate_average(numbers):
    total = sum(numbers)
    count = len(numbers)
    average = total / count
    return average

# Call the procedure with a list of numbers
numbers_list = [10, 20, 30, 40, 50]
result = calculate_average(numbers_list)

# Display the result
print("The average of", numbers_list, "is", result)
The average of [10, 20, 30, 40, 50] is 30.0

Algorithmic Efficiency

  • Algorithmic efficiency refers to the amount of time and resources needed to execute an algorithm.
  • The efficiency of an algorithm can be measured in terms of its time and space complexity.
    • Time complexity refers to the amount of time required by an algorithm to complete its task as a function of its input size.
    • Space complexity refers to the amount of memory required by an algorithm to complete its task as a function of its input size.
    • can be analyzed using Big O, which provides an upper bound on the worst-case time and space complexity of the algorithm.

What is the time complexity of the following code:

- O(N)
- O(N*log(N))
- O(N * Sqrt(N))
- O(N*N)
a = 0
for i in range(N): # this is N
  for j in reversed(range(i, N)):
    a = a + i + j

The time complexity is O(N*N) where N is the value of the input variable N.

The outer loop runs N times, and for each iteration of the outer loop, the inner loop runs N - i times. Hence, the total number of iterations of the inner loop is the sum of the series (N-1) + (N-2) + ... + 1, which is equal to (N^2 - N)/2.

Therefore, the total number of operations performed by the code is proportional to N * (N^2 - N)/2, which simplifies to O(N^3/2). However, when we consider only the dominant term in the expression, the time complexity is O(N^2).

What will be the time complexity of the following code?

  • n
  • (n+1)
  • n(n-1)
  • n(n+1)
value = 0
for i in range(n): #iterates "n" times, with "i" taking on values from 0 to n-1.
  for j in range(i): # iterates "i" times, with "j" taking on values from 0 to i-1.
    value=value+1

The time complexity of the given code is O(n^2), where n is the value of the input variable n.

The outer loop runs n times, and for each iteration of the outer loop, the inner loop runs i times, where i takes on values from 0 to n-1. The total number of iterations of the inner loop is the sum of the series 0 + 1 + 2 + ... + (n-1), which is equal to (n^2 - n)/2.

Therefore, the total number of operations performed by the code is proportional to n * (n^2 - n)/2, which simplifies to O(n^3/2). However, when we consider only the dominant term in the expression, the time complexity is O(n^2).

  • Efficiency can be improved by optimizing algorithms or by using more efficient data structures and algorithms.
    • Some common techniques for improving efficiency include reducing the size of the input, caching results, and parallelizing tasks.
    • Understanding algorithmic efficiency is important in software development, as it can impact the performance of applications and their ability to scale with larger data sets.

Iteration and Simulations

Simulations are models of real-world phenomena or systems that use mathematical algorithms and computer programs simulate the real behavior and aspects of the subject being modeled.

Simulations are most often used to model complex or time-consuming things that would be difficult to test in real life, such as modeling the spread of diseases in certain ecosystems or testing the functionality of a potential product before it is made.

In this lesson, we will be looking at lists, iteration, and random values through the lens of simulations.

PLEASE RUN THE CODE BELOW BEFORE INTERACTING WITH THE CODE SEGMENTS IN THIS SECTION!

class Card:
    def __init__(self, suit, val):
        self.suit = suit
        self.val = val
        if val == 11:
            self.kind = "Ace"
        elif val == 12:
            self.kind = "Jack"
        elif val == 13:
            self.kind = "Queen"
        elif val == 14:
            self.kind = "King"
        else:
            self.kind = str(self.val)

    #return a formatted string version of a card
    def show(self):
        return f"{self.kind} of {self.suit}"
    
    #adjust aces to prevent breaking
    def ace_adj(self):
        if self.kind == "Ace":
            self.val = 1

Review: Lists and Iteration

Lists and iteration work hand-in-hand to efficiently process and/or modify multiple values at once. In a card game, for example, lists and iteration are used together frequently to make the game work correctly.

For Loops

For loops are probably the most well-known type of iterative loop used in code. Most of us know about the for variable in list format.

One helpful tool not a lot of people know about is the enumerate() function. When used in conjunction with a for loop, you can always have access to the index and value of each selected list entry.

numlist = [3, 5, 68, 203]

for key, num in enumerate(numlist):
    print(f"This entry's index is {str(key)}, but its value is {str(num)}.")
    print(f"The difference between the value and the index is {num - key}.")
This entry's index is 0, but its value is 3.
The difference between the value and the index is 3.
This entry's index is 1, but its value is 5.
The difference between the value and the index is 4.
This entry's index is 2, but its value is 68.
The difference between the value and the index is 66.
This entry's index is 3, but its value is 203.
The difference between the value and the index is 200.

QUESTION: How is the key, num in enumerate(list) format similar to the format used when applying a for loop to a dictionary?

Answer: It uses key:value, .items to separate the keys and values, they both allow you to iterate over a collection of items and access both the keys and values of each item

List Comprehension

You may also see for loops used within a list like below. We went over this in class fairly recently. In this case, it is used to show the cards in the hand of a player.

player_hand = [] # the player's hand is represented as a list
# because lists are mutable (can change), they can be added to, like drawing a card

# assume the deck below is a a deck of shuffled cards
deck = [Card("Hearts", 3), Card("Spades", 12), Card("Diamonds", 11)]
def draw_card(hand, deck):
    hand.append(deck.pop())

#try it out
draw_card(player_hand, deck)
print([card.show() for card in player_hand])
['Ace of Diamonds']

Recursive Loops

Recursive loops have you calling one function inside of another. If a function must make some change to a certain value multiple times, it is oftem most efficient to have a function call itself with slightly different arguments like the fibonacci sequence below.

def fibonacci(terms):
    if terms <= 1:
        return terms
    return fibonacci(terms-1) + fibonacci(terms-2)

fibonacci(5) 

# calling function adding previous numbers branching out like a tree
5

Nesting Loops

Nesting loops increases the time complexity of the program, but it can be used to do things like make a card deck (see below).

  • increases time complexity
def build(deck):
        for suit in ["Spades", "Clubs", "Diamonds", "Hearts"]:
            for val in range(2, 15): #HINT: try replacing this function
                deck.append(Card(suit, val))

build(deck)

While Loops

While loops aren't used in the program, but they offer a different way to repeat a set of instructions in a program. The procedure below the while [condition] line will occur until the condition is made not true.

Student Interaction: How could this build function be altered to function with a while loop within it?

def build(deck):
        for suit in ["Spades", "Clubs", "Diamonds", "Hearts"]:
            for val in range(2, 15):
                deck.append(Card(suit, val))

#HINT: you may want to make an incrementing i variable
def build(deck):
    suits = ["Spades", "Clubs", "Diamonds", "Hearts"]
    val = 2
    while val <= 14:
        for suit in suits:
            deck.append(Card(suit, val))
        val += 1

While loops also alter an alternative way to loop a set of instructions forever, until a precise thing occurs to break the loop. See the code below.

import random
i = 0

while True:
    i += 1
    ch = random.randint(1, 11)
    if ch == 10:
        print(f"It took {str(i)} random generations to get 10.")
        break
It took 3 random generations to get 10.

49 random generations is a lot more than it would normally take, but it's important for code to be able to model unlikely, yet possible scenarios. Speaking of random values...

Random Values

Because unpredictable randomness occurs in the real world, it's important to have a way to represent it. Simulations are able to use randomization, which could be in the form of random number generation or other methods like shuffle.

Card decks are a great example of how random values can be used to represent real-world scenarios. In the card simulation, the random module's shuffle function is used to quite literally shuffle the deck, seen below.

def shuffle(deck):
    random.shuffle(deck)

Often, random selection methods use functions like randint or randrange as ways to select certain indexes in lists, or might use the random numbers in some other way.

QUESTION: Without shuffling the card order of the deck, can you think of a way that the aforementioned random module functions could be used to get a random card from the deck? Do so in the code cell below.

import random

class Card:
    def __init__(self, suit, value):
        self.suit = suit
        self.value = value

def choose_random_card(deck):
    index = random.randint(0, len(deck)-1)
    return deck[index]

# create a deck of cards
deck = []
suits = ["Spades", "Clubs", "Diamonds", "Hearts"]
for suit in suits:
    for value in range(2, 15):
        deck.append(Card(suit, value))

# choose a random card from the deck
random_card = choose_random_card(deck)
print("Random card:", random_card.value, "of", random_card.suit)

#find another random function that could pull a random card from a deck of UNSORTED cards
Random card: 7 of Clubs

Simulation Homework

Now that you've learned about simulations and how they're used, it's time to apply that knowledge by creating a (basic) simulation of a real-world scenario. It can be something in nature, like the changes in the wildlife population of a certain area; it can be a game, like Uno (no blackjack though, that's taken); or it can be something completely random and unique.

The simulation must include...

  • Use of at least one random value
  • At least one list or similar data type (dictionary, set, etc.)
  • Efficient use of iteration (must support the purpose of the simualtion)
  • Selection (use of conditionals)

Do this in your student copy in the cell provided. This is worth 0.9 (or more with extra credit) out of the 3 possible points.

# (Concert attendance? Wind speeds? Interactions between subjects in large environments?)

# Think about the sort of things that could be saved in lists, dictionaries, etc.
# (Even better if you can take advantage of the specific features of multiple types of data sets!)

# What kind of iteration happens in the real world?
# What occurs repeatedly, even over a long period of time?
# You could model the results of a disease spreading through a population without it taking IRL years.
import random

# Define the range of temperatures for different weather conditions
weather_conditions = {
    "sunny": (70, 100),
    "cloudy": (60, 80),
    "rainy": (50, 70),
    "stormy": (40, 60)
}

# Define a list of cities with their respective elevations and latitudes
cities = [
    {"name": "New York", "elevation": 33, "latitude": 40},
    {"name": "Los Angeles", "elevation": 71, "latitude": 34},
    {"name": "Chicago", "elevation": 181, "latitude": 41},
    {"name": "Houston", "elevation": 23, "latitude": 29},
    {"name": "Miami", "elevation": 2, "latitude": 25}
]

# Simulate the weather conditions for a fixed number of days
num_days = 7
for day in range(num_days):

    # Update the weather conditions for each city based on the current elevation and latitude
    for city in cities:
        temperature_range = weather_conditions[random.choice(list(weather_conditions.keys()))]
        temperature_range_adjusted = (temperature_range[0] - city["elevation"] / 10, temperature_range[1] - city["latitude"] / 2)
        city["temperature"] = round(random.uniform(*temperature_range_adjusted), 1)

    # Print the current weather conditions for each city
    print("Weather conditions for day", day+1)
    for city in cities:
        print(city["name"], "temperature:", city["temperature"])
        if city["temperature"] >= 70:
            print("It is sunny, wear light clothing"),
        if city["temperature"] <= 60:
            print("It is cold, wear a jacket and layer your clothing"),

    print()
Weather conditions for day 1
New York temperature: 38.6
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 80.4
It is sunny, wear light clothing
Chicago temperature: 78.3
It is sunny, wear light clothing
Houston temperature: 74.3
It is sunny, wear light clothing
Miami temperature: 63.5

Weather conditions for day 2
New York temperature: 59.7
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 62.3
Chicago temperature: 49.3
It is cold, wear a jacket and layer your clothing
Houston temperature: 38.3
It is cold, wear a jacket and layer your clothing
Miami temperature: 64.6

Weather conditions for day 3
New York temperature: 76.9
It is sunny, wear light clothing
Los Angeles temperature: 47.9
It is cold, wear a jacket and layer your clothing
Chicago temperature: 73.2
It is sunny, wear light clothing
Houston temperature: 65.2
Miami temperature: 64.9

Weather conditions for day 4
New York temperature: 58.8
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 58.1
It is cold, wear a jacket and layer your clothing
Chicago temperature: 55.7
It is cold, wear a jacket and layer your clothing
Houston temperature: 82.2
It is sunny, wear light clothing
Miami temperature: 73.0
It is sunny, wear light clothing

Weather conditions for day 5
New York temperature: 57.2
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 42.3
It is cold, wear a jacket and layer your clothing
Chicago temperature: 39.9
It is cold, wear a jacket and layer your clothing
Houston temperature: 50.6
It is cold, wear a jacket and layer your clothing
Miami temperature: 44.8
It is cold, wear a jacket and layer your clothing

Weather conditions for day 6
New York temperature: 59.9
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 58.8
It is cold, wear a jacket and layer your clothing
Chicago temperature: 55.6
It is cold, wear a jacket and layer your clothing
Houston temperature: 58.5
It is cold, wear a jacket and layer your clothing
Miami temperature: 66.4

Weather conditions for day 7
New York temperature: 57.6
It is cold, wear a jacket and layer your clothing
Los Angeles temperature: 78.2
It is sunny, wear light clothing
Chicago temperature: 22.8
It is cold, wear a jacket and layer your clothing
Houston temperature: 70.0
It is sunny, wear light clothing
Miami temperature: 86.1
It is sunny, wear light clothing

Databases

We have already gone over databases in this class, but here is a refresher. A database contains data that's stored in columns and rows. The information in this database can then be pulled from the database and can be used in a program.

Setting Up the Database

Run the code cell below to prepare SQLite to create the database. If your system is struggling with the flask functions, verify that you're in the correct Python environment. REMEMBER: You should only db.init_app(app) ONCE during the process!

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

# Setup of key Flask object (app)
app = Flask(__name__)
# Setup SQLAlchemy object and properties for the database (db)
database = 'sqlite:///sqlite.db'  # path and filename of database
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
app.config['SQLALCHEMY_DATABASE_URI'] = database
app.config['SECRET_KEY'] = 'SECRET_KEY'
db = SQLAlchemy()


# This belongs in place where it runs once per project
db.init_app(app)

The Model File

The model file plays a crucial role in the formation of the database.

  • The model helps to create new databases
  • It provides a standardized method for formating the database entries across different systems
  • Objects used within the database are created
import os, base64
import json
from sqlalchemy.exc import IntegrityError

# Define the User class to manage actions in the 'users' table
class User(db.Model):
    __tablename__ = 'players'  # table name is plural, class name is singular

    # Define the User schema with "vars" from object
    id = db.Column(db.Integer, primary_key=True)
    _username = db.Column(db.String(255), unique=False, nullable=False)
    _streak = db.Column(db.Integer, unique=True, nullable=False)

    # constructor of a User object, initializes the instance variables within object (self)
    def __init__(self, username, streak):
        self._username = username
        self._streak = streak

    # a username getter method, extracts username from object
    @property
    def username(self):
        return self._username
    
    # a setter function, allows username to be updated after initial object creation
    @username.setter
    def username(self, username):
        self._username = username
    
    # a getter method, extracts streak from object
    @property
    def streak(self):
        return self._streak
    
    # a setter function, allows streak to be updated after initial object creation
    @streak.setter
    def streak(self, streak):
        self._streak = streak
    
    # output content using str(object) in human readable form, uses getter
    # output content using json dumps, this is ready for API response
    def __str__(self):
        return json.dumps(self.read())

    # CRUD create/add a new record to the table
    # returns self or None on error
    def create(self):
        try:
            # creates a person object from User(db.Model) class, passes initializers
            db.session.add(self)  # add prepares to persist person object to Users table
            db.session.commit()  # SqlAlchemy "unit of work pattern" requires a manual commit
            return self
        except IntegrityError:
            db.session.remove()
            return None

    # CRUD read converts self to dictionary
    # returns dictionary
    def read(self):
        return {
            "id": self.id,
            "username": self.username,
            "streak": self.streak
        }

    # CRUD update: updates user name, password, phone
    # returns self
    def update(self, username, streak):
        """only updates values with length"""
        if len(username) > 0:
            self.username = username
        if streak > 0:
            self.streak = streak
        db.session.commit()
        return self

    # CRUD delete: remove self
    # None
    def delete(self):
        db.session.delete(self)
        db.session.commit()
        return None


"""Database Creation and Testing """

# Builds working data for testing
def initUsers():
    with app.app_context():
        """Create database and tables"""
        db.create_all()
        """Tester data for table"""
        u1 = User(username="Mr. Cards", streak=5)
        u2 = User(username="Kard Kowntre", streak=10)
        u3 = User(username="Un Bea Table", streak=15)

        users = [u1, u2, u3]

        """Builds sample user/note(s) data"""
        for user in users:
            try:
                user.create()
                print(f'Created user with username "{user.username}".')
            except IntegrityError:
                '''fails with bad or duplicate data'''
                db.session.remove()
                print(f"Records exist, duplicate email, or error: {user.username}")

The init Fuction

The init method has one purpose which is to initialize the object's attributes. This is what is known as the constructor. In our project, the init method initalizes the username and streak as variables.

def __init__(self, username, streak):
        self._username = username
        self._score = streak

Setters and Getters

Setters and Getters are important methods used when writing code for databases.

  • Setter: a method that allows us to set or change the value of an attribute in a class.
  • Getter: a method that allows us to access an attribute in a given class.

Setter Example

@streak.setter
def streak(self, streak):
    self._streak = streak
---------------------------------------------------------------------------
NameError                                 Traceback (most recent call last)
/Users/jesa_1/vscode/andafp-1/_notebooks/2023-04-26-studenttemplate.ipynb Cell 60 in <cell line: 2>()
      <a href='vscode-notebook-cell:/Users/jesa_1/vscode/andafp-1/_notebooks/2023-04-26-studenttemplate.ipynb#Y112sZmlsZQ%3D%3D?line=0'>1</a> # a setter function, allows streak to be updated after initial object creation
----> <a href='vscode-notebook-cell:/Users/jesa_1/vscode/andafp-1/_notebooks/2023-04-26-studenttemplate.ipynb#Y112sZmlsZQ%3D%3D?line=1'>2</a> @streak.setter
      <a href='vscode-notebook-cell:/Users/jesa_1/vscode/andafp-1/_notebooks/2023-04-26-studenttemplate.ipynb#Y112sZmlsZQ%3D%3D?line=2'>3</a> def streak(self, streak):
      <a href='vscode-notebook-cell:/Users/jesa_1/vscode/andafp-1/_notebooks/2023-04-26-studenttemplate.ipynb#Y112sZmlsZQ%3D%3D?line=3'>4</a>     self._streak = streak

NameError: name 'streak' is not defined

Getter Example

@property
def streak(self):
    return self._streak

The Api File

An API is an important part of having a functional database.

  • it acts as a messenger that allows programs to access data from the others
  • it connects all information
  • for a database, an api retrieves the data requested in code for the user
import json
from flask import Blueprint, request, jsonify
from flask_restful import Api, Resource # used for REST API building

user_api = Blueprint('user_api', __name__,
                   url_prefix='/api/users')

api = Api(user_api)

class UserAPI:        
    class _CRUD(Resource):  # User API operation for Create, Read.  THe Update, Delete methods need to be implemeented
        def post(self): # Create method
            ''' Read data for json body '''
            body = request.get_json()
            
            ''' Avoid garbage in, error checking '''
            # validate name
            username = body.get('username')
            if username is None or len(username) < 1:
                return {'message': f'Username is missing, or is less than a character'}, 400
            # validate uid
            streak = body.get('streak')
            if streak is None or streak < 1:
                return {'message': f'Streak is missing, or is less than 1'}, 400

            ''' #1: Key code block, setup USER OBJECT '''
            uo = User(username=username, 
                      streak=streak)
            
            ''' #2: Key Code block to add user to database '''
            # create user in database
            user = uo.create()
            # success returns json of user
            if user:
                return jsonify(user.read())
            # failure returns error
            return {'message': f'Processed {username}, either a format error or a duplicate'}, 400

        def get(self): # Read Method
            users = User.query.all()    # read/extract all users from database
            json_ready = [user.read() for user in users]  # prepare output in json
            return jsonify(json_ready)  # jsonify creates Flask response object, more specific to APIs than json.dumps

        def put(self):
            body = request.get_json() # get the body of the request
            id = body.get('id')
            username = body.get('username')
            streak = body.get('streak') # get the UID (Know what to reference)
            user = User.query.get(id) # get the player (using the uid in this case)
            user.update(username=username, streak=streak)
            return f"{user.read()} Updated"

        def delete(self):
            body = request.get_json()
            id = body.get('id')
            player = User.query.get(id)
            player.delete()
            return f"{player.read()} Has been deleted"

    # building RESTapi endpoint
    api.add_resource(_CRUD, '/')

This is important particularly in a full flask respository context, but in this case, you'll just need to run the initUsers() function.

initUsers()
Created user with username "Mr. Cards".
Created user with username "Kard Kowntre".
Created user with username "Un Bea Table".

An Alternative Method of Making SQLite Databases

In a previous lesson, we went over using the cursor object in SQLite3. Rather than go over all of that here, this lesson goes over it thoroughly. (You may use this method for the homework below.)

Database Homework

For this assignment, we'd like you to make your own database file as instructed above. Remember, the API file isn't necessary in this case; you'll be focusing on making the model and the init function.

Your database must include these things:

  • A class with at least four attributes (if not the cursor method)
  • Setters and getters for this class (if not the cursor method)
  • Each of the CRUD functions
  • An init function with at least four entries
  • A screenshot showing proof that your SQLite file has been created correctly

Feel free to base your database on the model provided above! Ask our group if you have any questions or concerns.

# If you've already run the db.init_app(app) function while in this notebook,
# don't do it again until you've closed it!
import sqlite3

def create_database():
    # Connect to the database (will create it if it doesn't exist)
    connection = sqlite3.connect('instance/StudentClass.db')
    cursor = connection.cursor()

    # Create the professors table if it doesn't already exist
    cursor.execute('''CREATE TABLE IF NOT EXISTS Grades (
                    student TEXT,
                    fav_teacher TEXT,
                    fav_class TEXT,
                    grade INTEGER
                )''')

    # Commit changes and close the connection
    connection.commit()
    connection.close()

# Call the function to create the database
create_database()
from flask import Flask
import sqlite3

# Create a Flask application
app = Flask(__name__)

# Connect to the SQLite database using SQLite3
conn = sqlite3.connect('instance/StudentClass.db')

# Create a cursor object to execute SQL commands
cursor = conn.cursor()

# Create a table in the database using SQL commands
cursor.execute('''CREATE TABLE StudentClass
                 (id INTEGER PRIMARY KEY, student TEXT, fav_teacher TEXT, fav_class TEXT, grade INTEGER)''')

# Commit the changes to the database
conn.commit()

# Close the connection
conn.close()
import sqlite3

def create():
   database = 'instance/StudentClass.db'
   student = input("Enter the student's name: ")
   fav_teacher = input("Enter the student's favorite teacher: ")
   fav_class = input("Enter the class of the favorite teacher: ")
   grade = input("Enter the student's grade in the class: ")


   # Connect to the database and create a cursor to execute SQL commands
   connection = sqlite3.connect(database)
   cursor = connection.cursor()


   try:
       # Execute SQL to insert record into db
       cursor.execute("INSERT INTO StudentClass (student, fav_teacher, fav_class, grade) VALUES (?, ?, ?, ?)", (student, fav_teacher, fav_class, grade))
       # Commit the changes
       connection.commit()
       print(f"{student} has been added to the list of Students.")
              
   except sqlite3.Error as error:
       print("Error while inserting record", error)


   # Close cursor and connection
   cursor.close()
   connection.close()

create()
Ederick has been added to the list of Students.
import sqlite3

def read():
    try:
        # Open a connection to the database and create a cursor
        connection = sqlite3.connect('instance/StudentClass.db')
        cursor = connection.cursor()

        # Fetch all records from the professors table
        cursor.execute("SELECT * FROM StudentClass")
        rows = cursor.fetchall()

        # If there are any records, print them
        if len(rows) > 0:
            print("List of students :")
            for row in rows:
                print(f"Name: {row[1]}\nFavorite Class: {row[3]}\nTeacher of that class: {row[2]}\nGrade in the class: {row[4]}\n")
        else:
            print("There are no students in the list.")

    except sqlite3.Error as error:
        print("Error while connecting to the database:", error)

    finally:
        # Close the cursor and the connection to the database
        cursor.close()
        connection.close()

read()
List of students :
Name: Joselyn Anda
Favorite Class: US History
Teacher of that class: Simmons
Grade in the class: 99

Name: Violet
Favorite Class: BJJ
Teacher of that class: Derryck
Grade in the class: 100

Name: Elly
Favorite Class: American Literature
Teacher of that class: Mansour
Grade in the class: 98

Name: Ederick
Favorite Class: AP Comp-Sci
Teacher of that class: Yeung
Grade in the class: 88

import sqlite3

def update():
    database = 'instance/StudentClass.db'
    connection = sqlite3.connect(database)
    cursor = connection.cursor()
    
    try:
        student = input("Enter the name of the student to update: ")
        
        cursor.execute("SELECT * FROM StudentClass WHERE student=?", (student,))
        record = cursor.fetchone()
        
        if record:
            print("Enter the new information for the student:")
            fav_teacher = input(f"Current favorite teacher: {record[2]}\nNew favorite teacher: ")
            fav_class = input(f"Current class of favorite teacher: {record[3]}\nNew class: ")
            grade = input(f"Current grade in favorite class: {record[4]}\nNew grade in new class: ")
            
            cursor.execute("UPDATE StudentClass SET fav_teacher=?, fav_class=?, grade=? WHERE student=?", (fav_teacher, fav_class, grade, student))
            connection.commit()
            
            print(f"{student}'s record has been updated.")
        
        else:
            print(f"No record found for {student}.")
    
    except sqlite3.Error as error:
        print("Error while updating record", error)
    
    cursor.close()
    connection.close()
update ()
Enter the new information for the student:
Elly's record has been updated.
import sqlite3


def delete():
    # Connect to the database and create a cursor
    connection = sqlite3.connect('instance/StudentClass.db')
    cursor = connection.cursor()

    student = input("Enter the name of the student you want to delete: ")

    # Use a SQL query to find the professor with the given name
    cursor.execute("SELECT * FROM StudentClass WHERE student=?", (student,))
    row = cursor.fetchone()

    if row:
        confirm = input(f"Are you sure you want to delete {student}? (yes/no): ")
        if confirm.lower() == 'yes':
            cursor.execute("DELETE FROM StudentClass WHERE student=?", (student,))
            connection.commit()
            print(f"{student} has been deleted from the list of students.")
    else:
        print(f"{student} not found in the list of students.")

    # Close the cursor and the connection to the database
    cursor.close()
    connection.close()

delete()
Ederick has been deleted from the list of students.

Grading

Your submission will be graded based on the following criteria:

  • Filling in the blank throughout the lesson and providing code in the given cells when applicable (0.9)
  • Simulation homework (0.9)
  • Database homework (0.9)

Here are some ideas for ways to increase your score above a 2.7:

  • Make a frontend version of your simulation that can be interacted with on your blog
  • Connect your simulation to the database you create
  • Create a menu that allows a user to make an entry in your database (CRUD functions within it)
  • You can establish a relationship between two classes/tables in your database (see the relationship between the User and Note classes in the Nighthawk Coders flask repository)