Initial Commit

.gitignore

@@ -0,0 +1 @@
+__pycache__

README.md

@@ -0,0 +1,5 @@
+# HAC API
+
+## Introduction
+
+This is a simple API to access the Home Access Center (HAC) of the [Frisco Independent School District](https://www.friscoisd.org/). This API is not affiliated with the school district in any way.

__init__.py

@@ -0,0 +1,13 @@
+# Importing the modules
+from file_modification import clear_files, returnGradeTables
+from login import login, getTime
+from grades import initializeClasses, returnGrades
+from notification import isUpdated
+from test import userInput
+
+# Initalization
+print("--------------------------------------------\n\tWelcome to the HAC API!\n--------------------------------------------")
+print("    https://github.com/Nazchanel")
+print()
+print("\t  Version: 1.0.0")
+print("\t Date: 4/01/2023")

file_modification.py

@@ -0,0 +1,59 @@
+
+import json
+import pandas as pd
+import requests
+from lxml import html
+
+def clear_files():
+    for i in range(9):
+        name = f"class{i}.html"
+        f = open(f"templates/{name}", "w")
+        f.write("")
+        f.close()
+def returnGradeTables(username, password, logged_in, quarter):
+  login_url = 'https://hac.friscoisd.org/HomeAccess/Account/LogOn?ReturnUrl=%2fHomeAccess%2f'
+
+  session_requests = requests.session()
+
+  urls = "https://hac.friscoisd.org/HomeAccess/Content/Student/Assignments.aspx"
+
+  result = session_requests.get(login_url)
+  tree = html.fromstring(result.text)
+  authenticity_token = list(set(tree.xpath("//input[@name='__RequestVerificationToken']/@value")))[0]
+
+  login_payload = {
+      "VerificationOption": "UsernamePassword",
+      "Database": "10",
+      "LogOnDetails.Password": password,
+      "__RequestVerificationToken": authenticity_token,
+      "LogOnDetails.UserName": username
+  }
+
+  # Logs in
+  session_requests.post(login_url, data=login_payload, headers=dict(referer=login_url))
+
+  initial_html = session_requests.get(urls, headers=dict(referer=urls))
+
+  if logged_in:
+    with open(f'static/payloads/{quarter}.json', 'r') as file:
+        json_str = file.read()
+    json_obj = json.loads(json_str)
+
+    specific_quarter = session_requests.post(urls, data=json_obj,headers=dict(referer=urls))
+    df = pd.read_html(specific_quarter.text)
+  else:
+      result = session_requests.get(urls, headers=dict(referer=urls))
+      df = pd.read_html(result.text)
+
+  index_list = []
+  for i in range(len(df)):
+      if len(df[i].columns) == 10:
+          index_list.append(i)
+
+  j = 1
+  for i in index_list:
+      name = f"class{j}.html"
+      f = open(f"templates/{name}", "w")
+      f.write(df[i].to_html())
+      f.close()
+      j+=1

grades.py

@@ -0,0 +1,185 @@
+from login import login, getTime
+import requests
+from colorama import Fore
+
+def initializeClasses(a, b):
+    class1 = 0
+    try:
+        class1 = str(a[0])
+        class1 = class1[116:121]
+    except IndexError:
+        print("Enter a valid six digit Student ID and password!")
+        exit(0)
+
+    class2 = "0"
+    try:
+        class2 = str(a[1])
+        class2 = class2[116:121]
+        if class2 == "":
+            class2 = "0"
+    except IndexError:
+        pass
+
+    class3 = "0"
+    try:
+        class3 = str(a[2])
+        class3 = class3[116:121]
+        if class3 == "":
+            class3 = "0"
+    except IndexError:
+        pass
+
+    class4 = "0"
+    try:
+        class4 = str(a[3])
+        class4 = class4[116:121]
+        if class4 == "":
+            class4 = "0"
+    except IndexError:
+        pass
+
+    class5 = "0"
+    try:
+        class5 = str(a[4])
+        class5 = class5[116:121]
+        if class5 == "":
+            class5 = "0"
+    except IndexError:
+        pass
+
+    class6 = "0"
+    try:
+        class6 = str(a[5])
+        class6 = class6[116:121]
+        if class6 == "":
+            class6 = "0"
+    except IndexError:
+        pass
+
+    class7 = "0"
+    try:
+        class7 = str(a[6])
+        class7 = class7[116:121]
+        if class7 == "":
+            class7 = "0"
+    except IndexError:
+        pass
+
+    class8 = "0"
+    try:
+        class8 = str(a[7])
+        class8 = class8[116:121]
+        if class8 == "":
+            class8 = "0"
+    except IndexError:
+        pass
+
+    class_name_1 = "No class"
+    try:
+        class_name_1 = (str(b[0].text)).strip()
+        index_of_deletion = class_name_1.index("-")
+        class_name_1 = (class_name_1[index_of_deletion + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_2 = "No class"
+    try:
+        class_name_2 = (str(b[1].text)).strip()
+        index_of_deletion = class_name_2.index("-")
+        class_name_2 = (class_name_2[index_of_deletion + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_3 = "No class"
+    try:
+        class_name_3 = (str(b[2].text)).strip()
+        index_of_deletion = class_name_3.index("-")
+        class_name_3 = (class_name_3[index_of_deletion + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_4 = "No class"
+    try:
+        class_name_4 = (str(b[3].text)).strip()
+        index_of_deletion = class_name_4.index("-")
+        class_name_4 = (class_name_4[index_of_deletion + 4:]).strip()
+    except IndexError:
+        pass
+    class_name_5 = "No class"
+    try:
+        class_name_5 = (str(b[4].text)).strip()
+        dash_index = class_name_5.index("-")
+        class_name_5 = (class_name_5[dash_index + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_6 = "No class"
+    try:
+        class_name_6 = (str(b[5].text)).strip()
+        dash_index = class_name_6.index("-")
+        class_name_6 = (class_name_6[dash_index + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_7 = "No class"
+    try:
+        class_name_7 = (str(b[6].text)).strip()
+        dash_index = class_name_7.index("-")
+        class_name_7 = (class_name_7[dash_index + 4:]).strip()
+    except IndexError:
+        pass
+
+    class_name_8 = "No class"
+    try:
+        class_name_8 = (str(b[7].text)).strip()
+        dash_index = class_name_8.index("-")
+        class_name_8 = (class_name_8[dash_index + 4:]).strip()
+    except IndexError:
+        pass
+
+    return [class_name_1, class_name_2, class_name_3, class_name_4, class_name_5, class_name_6, class_name_7,
+            class_name_8], [class1, class2, class3, class4, class5, class6, class7, class8]
+def returnGrades(usr, pswd, dly, quarter):
+# Creates a session to maintain credentials
+    session_requests = requests.session()
+
+    current_time = getTime()
+
+    username = usr
+    password = pswd
+
+    # Will be in use for checking
+    delay = dly
+
+    login_url = 'https://hac.friscoisd.org/HomeAccess/Account/LogOn?ReturnUrl=%2fHomeAccess%2f'
+
+    html = login(session_requests, login_url, password, username, quarter=quarter)
+    grades_html = html[0]
+    name_html = html[1]
+    classes = initializeClasses(grades_html, name_html)
+
+    class_names = classes[0]
+    class_grades = classes[1]
+    try:
+        class_grades_ = [i.replace("%", "") for i in class_grades]
+    except:
+        class_grades_ = 0
+        print("FAILIURE")
+
+    class_grades = []    
+    for i in class_grades_: # type: ignore
+        try:
+            class_grades.append(float(i))
+        except:
+            print("\n" + Fore.RED + "ERROR: " + Fore.RESET + "Could not convert " + i + " to a float." + "\n")
+            class_grades.append(float(0))
+
+    names_ = []
+    grades_ = []
+
+    for i in range(len(class_names)):
+
+        names_.append(class_names[i])
+        grades_.append(class_grades[i])
+
+    return (names_, grades_, current_time)

login.py

@@ -0,0 +1,50 @@
+from datetime import datetime
+import pytz
+from bs4 import BeautifulSoup
+from lxml import html
+import json
+
+def login(session_requests, login_url, password, username, quarter):
+    urls = "https://hac.friscoisd.org/HomeAccess/Content/Student/Assignments.aspx"
+    result = session_requests.get(login_url)
+    tree = html.fromstring(result.text)
+    authenticity_token = list(set(tree.xpath("//input[@name='__RequestVerificationToken']/@value")))[0]
+
+    payload = {
+        "VerificationOption": "UsernamePassword",
+        "Database": "10",
+        "LogOnDetails.Password": password,
+        "__RequestVerificationToken": authenticity_token,
+        "LogOnDetails.UserName": username
+    }
+    session_requests.post(
+        login_url,
+        data=payload,
+        headers=dict(referer=login_url)
+    )
+
+    if quarter == None:
+        result = session_requests.get(urls, headers=dict(referer=urls))
+
+        soup = BeautifulSoup(result.text, "html.parser")
+
+        h1 = soup.find_all(class_="sg-header-heading sg-right")
+
+        h2 = soup.findAll('a', {"class": ["sg-header-heading"]})
+    else:
+        with open(f'static/payloads/{quarter}.json', 'r') as file:
+            json_str = file.read()
+        json_obj = json.loads(json_str)
+
+        specific_quarter = session_requests.post(urls, data=json_obj,headers=dict(referer=urls))
+
+        soup = BeautifulSoup(specific_quarter.text, "html.parser")
+
+        h1 = soup.find_all(class_="sg-header-heading sg-right")
+
+        h2 = soup.findAll('a', {"class": ["sg-header-heading"]})
+
+    return h1, h2
+def getTime():
+    my_date = datetime.now(pytz.timezone('US/Central'))
+    return my_date.strftime("%m/%d/%Y %I:%M:%S %p")

notification.py

@@ -0,0 +1,9 @@
+def isUpdated(original, new):
+    matching = True
+
+    try:
+        return_value = new.index([x for x in new if x not in original][0])
+    except IndexError:
+        matching = False
+
+    return matching, return_value

setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='your_package_name',
+    version='0.1',
+    packages=find_packages(),
+    install_requires=[],
+    url='https://your_package_url.com',
+    license='',
+    author='Your Name',
+    author_email='[email protected]',
+    description='A short description of your package',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown'
+)

test.py

@@ -0,0 +1,19 @@
+def userInput():
+    minutes_per_check = None
+    try:
+        minutes_per_check = float(input("Per how many minutes should the program check your grades >>> "))
+    except ValueError:
+        print("Enter a number without any spaces or letters!")
+        exit(0)
+
+    print()
+
+    username = input("Enter your Student ID >>> ")
+    password = input("Enter your password >>> ")
+    spacing = ""
+
+    for i in range(30):
+        spacing += "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+    print(spacing)
+
+    return username, password, minutes_per_check