Merge from master to my branch

.github/workflows/ci.yaml

@@ -8,7 +8,7 @@ on:
 jobs:
   backend-unit-tests:
     name: pytest
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
     timeout-minutes: 5
     container: python:3.8
 

.github/workflows/prod-update.yaml

@@ -11,7 +11,7 @@ jobs:
 
     strategy:
       matrix:
-        semester: [spring-2023]
+        semester: [summer-2023]
 
     steps:
       - name: Checkout repository

docs/contributing/how_to_review.md

@@ -0,0 +1,13 @@
+# How to Review a Pull Request
+
+1. Find  a pull request.
+2. Find the name of the branch in the pull request:
+   * ![showing name of a pull request](img/pull_request_name.png)
+   * In this case, the branch name would be `contributing_guide`.
+3. Open a terminal and navigate to your local repository (the `yacs.n` folder)
+4. Make sure your computer's repo is up to date by running `git pull`.
+5. Run `git switch <branch name>`.
+6. On some computers, if you are running the local version of YACS already, it will update automatically. If it doesn't, restart Docker and refresh the localhost page.
+7. Look at the pull request and verify that whatever functionality it adds works and doesn't seem to cause any problems. 
+8. Add your review (whether it's an approval or not) hitting the "add your review" button:
+   * ![add your review](img/add_review.png)

docs/contributing/opening_an_issue.md

@@ -0,0 +1,15 @@
+# Opening an Issue:
+
+1. Go to issues and hit "New Issue":
+
+* ![new issue button](img/new_issue.png)
+
+2. Hit "Feature Request":
+
+* ![get started button](img/feature_request.png)
+
+3. Fill out the template (make sure to add the appropriate labels/projects!):
+
+* ![template screenshot](img/feature_request_template.png)
+
+4. Hit submit issue when done.

docs/contributing/working_on_an_issue.md

@@ -0,0 +1,26 @@
+# Working on an Issue:
+
+1. Find an issue you want to work on and open it:
+
+* ![issues page with one issue highlighted](img/issue_listing.png)
+
+2. Assign yourself to the issue:
+
+* ![assigning self to issue](img/issue_assign.png)
+
+3. Add the "in progress" label:
+
+* ![assigning in progress label](img/inprogress_label.png)
+
+4. Create / assign a branch to the issue:
+
+* ![creating a branch for the issue](img/assign_branch.png)
+
+5. When done, make a pull request:
+
+* click the branch name in the issue:
+	* ![hitting branch name](img/navigating_to_branch.png)
+* Hit "Contribute", then hit "Open pull request":
+	* ![opening the pull request](img/opening_pull_request.png)
+* Fill out the template and, when ready, hit "Create pull Request": (make sure to assign yourself in the Assignees section!)
+	* ![new pull request page](img/new_pull_request.png)

rpi_data/get-fall-2023.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+export SEMESTER="FALL 2023"
+SOURCE_URL=https://sis.rpi.edu/reg/zfs202309.htm DEST=p0.csv HEADERS=True python modules/rpi-parse.py
+cat p* > fall-2023.csv
+rm -rf p*.csv

rpi_data/get-summer-2023.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+export SEMESTER="SUMMER 2023"
+SOURCE_URL=https://sis.rpi.edu/reg/zs20230501.htm DEST=p0.csv HEADERS=True python ./modules/rpi-parse.py
+SOURCE_URL=https://sis.rpi.edu/reg/zs20230502.htm DEST=p1.csv HEADERS=False python ./modules/rpi-parse.py
+SOURCE_URL=https://sis.rpi.edu/reg/zs20230503.htm DEST=p2.csv HEADERS=False python ./modules/rpi-parse.py
+cat p* > summer-2023.csv
+rm -rf p*.csv

rpi_data/modules/build_semester.py

@@ -1,7 +1,7 @@
 import os
 
 if __name__ == '__main__':
-	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20200501.htm DEST=out1.csv HEADERS=True python rpi-parse.py")
-	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20200502.htm DEST=out2.csv HEADERS=False python rpi-parse.py")
-	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20200503.htm DEST=out3.csv HEADERS=False python rpi-parse.py")
+	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20230501.htm DEST=out1.csv HEADERS=True python rpi-parse.py")
+	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20230502.htm DEST=out2.csv HEADERS=False python rpi-parse.py")
+	os.system("SOURCE_URL=https://sis.rpi.edu/reg/zs20230503.htm DEST=out3.csv HEADERS=False python rpi-parse.py")
 	os.system("cat out1.csv out2.csv out3.csv > out.csv")

src/web/src/assets/dark.scss

@@ -123,6 +123,9 @@
   .dropdown-item {
     color: var(--dark-text-primary) !important;
   }
+  .dropdown-item:hover {
+    background-color: var(--dark-border-primary) !important;
+  }
 
   .link {
     color: var(--dark-text-primary) !important;

src/web/src/components/CourseListing.vue

@@ -45,7 +45,7 @@
           <b-list-group-item
             class="selected"
             button
-            v-for="section in course.sections"
+            v-for="section in sortedSections"
             :key="section.crn"
             @click.stop="toggleCourseSection(section)"
             :style="{
@@ -66,7 +66,8 @@
           >
             <b-row class="mb-2" align-h="between">
               <b-col cols="auto">
-                {{ section.crn }} - {{ section.sessions[0].section }}
+                {{ section.crn }} - {{ section.sessions[0].section }} -
+                {{ getInstructor(section.sessions) }}
               </b-col>
               <b-col v-if="section.seats_total > 0" cols="auto">
                 <course-section-seats-badge
@@ -99,21 +100,16 @@
 
 <script>
 import "@/typedef";
-
 import { DAY_SHORTNAMES, readableTime, readableDate } from "@/utils";
-
 import { getBackgroundColor, getBorderColor } from "@/services/ColorService";
-
 import {
   faTimes,
   faPlus,
   faChevronDown,
   faChevronUp,
 } from "@fortawesome/free-solid-svg-icons";
-
 import CourseSectionSeatsBadge from "./CourseSectionSeatsBadge.vue";
 import CourseSectionsOpenBadge from "./CourseSectionsOpenBadge.vue";
-
 // Course Listing by default is a collapsible display of a course and its
 // sections and sessions
 // However, there are slots available to customize the information displayed
@@ -128,7 +124,6 @@ export default {
   },
   props: {
     course: Object,
-
     // If true, collapse is open when created
     // If lazyLoadCollapse is true, this is ignored
     openInitial: {
@@ -142,7 +137,6 @@ export default {
       type: Boolean,
       default: false,
     },
-
     // Method name of default action
     // When body of CourseListing is clicked on, the
     // defaultAction is called
@@ -152,7 +146,6 @@ export default {
       type: String,
       default: "toggleCollapse",
     },
-
     //if this is false the add course + button wont appear
     //this is useful for the course explorer
     showAddButton: {
@@ -167,15 +160,12 @@ export default {
       faChevronDown,
       faChevronUp,
       DAY_SHORTNAMES,
-
       // v-model with collapse
       // true or false for open or close respectively collapse
       showCollapse: !this.lazyLoadCollapse && this.openInitial,
-
       // initially false, set to true on first collapse toggle
       // Used for lazy loading
       loaded: false,
-
       showAdd: this.showAddButton,
     };
   },
@@ -184,12 +174,10 @@ export default {
     readableDate,
     getBackgroundColor,
     getBorderColor,
-
     // Just a wrapper, can't call `[defaultAction]()` in html
     callDefaultAction() {
       this[this.defaultAction]();
     },
-
     /**
      * Toggle collapse state
      * @param {boolean} collapse If provided, set collapse state
@@ -198,11 +186,9 @@ export default {
       if (!this.loaded) {
         this.loaded = true;
       }
-
       this.showCollapse =
         collapse !== undefined ? collapse : !this.showCollapse;
     },
-
     /**
      * Toggle course selected state
      * Emits removeCourse and addCourse events
@@ -229,11 +215,24 @@ export default {
         this.$emit("addCourseSection", this.course, section);
       }
     },
-
     //used in the course explorer to show a courses info modal
     showInfoModal() {
       this.$emit("showCourseInfo", this.course);
     },
+    getInstructor(sessions) {
+      for (let i = 0; i < sessions.length; i++) {
+        if (sessions[i].instructor !== "Staff") {
+          return sessions[i].instructor;
+        }
+      }
+    },
+  },
+  computed: {
+    sortedSections() {
+      return this.course.sections
+        .slice()
+        .sort((a, b) => a.sessions[0].section - b.sessions[0].section);
+    },
   },
 };
 </script>

src/web/src/components/DepartmentList.vue

@@ -15,7 +15,7 @@
               params: { subject: major },
             }"
           >
-            <b>{{ major }}</b>
+            <b class="majorShort">{{ major }}</b>
             - {{ getLongName(major) }}
           </b-button>
         </div>
@@ -69,4 +69,8 @@ export default {
   //important because when you click the color changes and thats annoying
   background: rgba(108, 90, 90, 0.15) !important;
 }
+
+.majorShort {
+  color: #3395ff;
+}
 </style>