Tidying up the demo projects and adding clarity

Author: dominict

2 ksu scrape/ksu_scrape.py

@@ -1,5 +1,6 @@
 '''
-TO use this code, you will first need to install the three packages being imported below using pip or a manual install method.
+To use this code, you will first need to install the three packages being imported below using pip or a manual install method.
+This code was updated in August 2021 to use the new KSU news feed design.
 '''
 from bs4 import BeautifulSoup
 import requests

2 ksu scrape/ksu_scrape_new.py

@@ -1,5 +1,26 @@
+'''
+This code is a demo of how to create a database with a schema structure in Python using SQL Lite.
+For more information, see: https://datatofish.com/create-database-python-using-sqlite3/ 
+'''
 import sqlite3
-
+#we can name the file antyhing we want, but it is common to use .db
 db_file = "new.db"
 
-connection = sqlite3.connect(db_file)
+#the connection is the database file itself represented in python
+connection = sqlite3.connect(db_file)
+
+#the cursor is the object that will allow us to execute SQL commands
+cursor = connection.cursor()
+
+#execute runs the SQL command but does not save it, the results are just in memory for now
+cursor.execute('''
+          CREATE TABLE IF NOT EXISTS products
+          ([product_id] INTEGER PRIMARY KEY, [product_name] TEXT)
+          ''')
+          
+cursor.execute('''
+          CREATE TABLE IF NOT EXISTS prices
+          ([product_id] INTEGER PRIMARY KEY, [price] INTEGER)
+          ''')
+#commit is when we actually save the changes we made to the database            
+connection.commit()

4 DB in Python/SQLite Demo/newdb.py

@@ -1,15 +1,25 @@
+'''
+This is a basic web page running with Flask.
+'''
+
 from flask import Flask, render_template, request
+#This is the Flask object, we are creating an instance of the Flask class and storing it in the variable app
+#__name__ is a special variable in Python that is the name of the module, which is this file's name without the .py extension
 app=Flask(__name__)
+
+#This is a decorator, it is a function that takes a function as a parameter!
+#A decorator is a function that wraps another function
+#This decorator is saying that when someone goes to the URL /greet, run the greet function
 @app.route('/greet', methods=['POST'])
 def greet():
     inputName = request.form['myName']
     ip = request.remote_addr
     #write data to file or to DB
     inputName = inputName.upper()+" hi!  Visiting from " + str(ip)
     return render_template("home.html",myName=inputName)
+
 @app.route('/')
-def home():
-    
+def home():  
     return render_template("home.html",myName="Type your name in the box and click submit!")
 
 @app.route('/about/')