Merge branch 'master' of https://github.itap.purdue.edu/ECN/webqueue2

Dev Environment Setup Guide.md

@@ -10,7 +10,7 @@
 
 
 ## Setup
-- The webqueue2 API uses `gunicorn` as a WSGI server and this does not run on Windows. If you're developing on Windows, look into Ubuntu on [WSL2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-index) or use a virtual machine.
+- The webqueue2 API uses `gunicorn` as a WSGI server and this does not run on Windows. If you're developing on Windows use a virtual machine.
 
 - webqueue2 uses npm and  create-react-app to manage itself. You can learn more about npm [here](https://nodesource.com/blog/an-absolute-beginners-guide-to-using-npm/) and create-react-app [here](https://create-react-app.dev/docs/getting-started/).
 
@@ -35,9 +35,9 @@ npm install
 #### Using npm
 There are four npm scripts included in this project:
 
-- `npm run start`: This will start a local development server on [localhost:3000](http://localhost:3000) and launch your default browser at that address. As you save changes in /public and/or /src you'll see your changes in the browser. (API requests are automatically proxied to the API server.)
+- `npm run start:frontend`: This will start a development server on [localhost:3000](http://localhost:3000). (If the server is on your local machine, this will also launch your default browser at that address.) As you save changes in /public and/or /src you'll see your changes in the browser. (API requests are automatically proxied to the API server.)
 
-- `npm run start-api`: This will start a local WSGI server on [localhost:5000](http://localhost:5000) to access the API. **Note:** You will need to add Python to your PATH variable.
+- `npm run start:api`: This will start a local WSGI server on [localhost:5000](http://localhost:5000) to access the API. **Note:** You will need to add Python to your PATH variable if it is not already.
 
 - `npm run build`: This will build a static version of the site in /build ready to be placed in the document root of any web server.
 
@@ -59,6 +59,18 @@ Activate the Python virtual environment
 source venv/bin/activate
 ```
 
+If you're pip version is less than 19, upgrade pip
+```
+(venv) campb303@acererak [~/webqueue2/api]
+$ pip --version
+pip 9.0.1 from /home/pier/e/campb303/webqueue2/api/venv/lib/python3.6/site-packages (python 3.6)
+
+(venv) campb303@acererak [~/webqueue2/api]
+$ pip install --upgrade pip
+...
+Successfully installed pip-20.2.2
+```
+
 Install Python requiements
 ```
 pip install -r requirements.txt

Dev Logs.md

@@ -1,6 +1,33 @@
 # Dev Logs
 These are daily and weekly summaries of the work thats been done on webqueue2. They start on 6/23 because that's whe this document was started but other work was done before this time.
 
+## Week 10: 8/24/20 - 8/28/20
+### This Week's Goals
+- Onboard Jacob
+- Set path for frontend documentation
+
+<!-- ### This Week's Recap -->
+
+
+---
+
+### Monday 8/24/20
+- Began onboarding Jacob
+- Continued work on integrating styleguidist
+
+### Tuesday 8/25/20
+- Continued onboarding Jacob
+- Continued work on integrating styleguidist
+
+### Wednesday 8/26/20
+- Continued onboarding Jacob; assigned independent task for [this issue](https://github.itap.purdue.edu/ECN/webqueue2/issues/36)
+- Decided to shift from styleguidist to docz because styleguidist is not maintainable.
+
+<!-- ### Thursday 8/27/20 -->
+
+<!-- ### Fridayday 8/28/20 -->
+
+
 ## Week 9: 8/17/20 - 8/21/20
 ### This Week's Goals
 - Finish lingering documentation tasks
@@ -9,7 +36,7 @@ These are daily and weekly summaries of the work thats been done on webqueue2. T
 
 <!-- ### This Week's Recap -->
 
-
+- Begin porting codebase to stylguidist, more work needed
 
 ---
 
@@ -34,13 +61,13 @@ These are daily and weekly summaries of the work thats been done on webqueue2. T
 - Began destructuring exisiting componennts
 - Created proper MUI theme wrapper
 
-<!-- ### Wednesday 8/19/20 -->
-
-<!-- ### Thursday 8/20/20 -->
-
-<!-- ### Friday 8/21/20 -->
-
-
+### Wednesday 8/19/20
+- Tied Stylgudist into npm. Stylgudisit can be run with `npm run start:docs`
+- Updated stylegudist configuartion:
+	- Now launches a browser on a local machine
+	- Added title, version, sections, template (for favicon)
+	- Created style and theme config. These can be hot loaded while the server is running.
+- Moved UI snapshots and updated README snapshot
 
 ## Week 8: 8/10/20 - 8/16/20
 ### This Week's Goals

Test for webqueue2 GitHub Integration.md

@@ -0,0 +1,2 @@
+# Hello
+World

api/ECNQueue.py

@@ -14,7 +14,10 @@
 #------------------------------------------------------------------------------#
 
 # The directory where queue items are
-queueDirectory = "/Users/justincampbell/GitHub/ecn-queue/webqueue/q-snapshot"
+currentFilePath = __file__
+currentFileDirectory = os.path.dirname(currentFilePath)
+currentFileDirectoryParent = os.path.dirname(currentFileDirectory)
+queueDirectory = os.path.join(currentFileDirectoryParent, "q-snapshot")
 
 # Queues to not load in getQueues()
 queuesToIgnore = ["archives", "drafts", "inbox"]
@@ -342,4 +345,4 @@ def getQueues() -> list:
 		if isDirectory and isValid:
 			queues.append(Queue(file))
 
-	return queues
+	return queues

q-snapshot/README.md

@@ -0,0 +1,2 @@
+# q-snapshot
+This is a snapshot of the live queue for working with during testing.

q-snapshot/aae/1

@@ -0,0 +1,97 @@
+[aae] QStatus: waiting for reply
+[aae] QStatus-Updated-Time: Tue, 28 Apr 2020 14:21:42 EDT
+[aae] QStatus-Updated-By: jerry
+Status: waiting for reply
+Status-Updated-Time: Tue, 28 Apr 2020 14:21:42 EDT
+Status-Updated-By: jerry
+[aae] QTime: 00:10
+[aae] QTime-Updated-Time: Tue, 28 Apr 2020 14:21:37 EDT
+[aae] QTime-Updated-By: jerry
+Time: 00:10
+Time-Updated-Time: Tue, 28 Apr 2020 14:21:37 EDT
+Time-Updated-By: jerry
+Replied-Time: Tue, 28 Apr 2020 14:21:33 -0400
+Replied-By: jerry
+[aae] QPriority: covid
+[aae] QPriority-Updated-Time: Mon, 20 Apr 2020 11:52:28 EDT
+[aae] QPriority-Updated-By: emuffley
+Priority: covid
+Priority-Updated-Time: Mon, 20 Apr 2020 11:52:28 EDT
+Priority-Updated-By: emuffley
+[aae] QStatus: on hold
+[aae] QStatus-Updated-Time: Tue, 31 Mar 2020 10:53:26 EST
+[aae] QStatus-Updated-By: harley
+Status: on hold
+Status-Updated-Time: Tue, 31 Mar 2020 10:53:26 EST
+Status-Updated-By: harley
+[aae] QAssigned-To: kevin
+[aae] QAssigned-To-Updated-Time: Mon, 09 Dec 2019 07:50:50 EST
+[aae] QAssigned-To-Updated-By: jerry
+Assigned-To: kevin
+Assigned-To-Updated-Time: Mon, 09 Dec 2019 07:50:50 EST
+Assigned-To-Updated-By: jerry
+Refiled-Time: Fri, 06 Dec 2019 16:15:43 -0500
+Refiled-From: ece
+Refiled-By: jerry
+Date: Fri, 6 Dec 2019 16:15:11 -0500
+From: jerry@purdue.edu
+Message-ID: <20191206161511.25695.981988142@zeoclient-03.ecn.purdue.edu>
+Subject: Win7 to Win10 Migration List - kevin
+To: ecesite@ecn.purdue.edu
+Content-Type: text/plain; charset="utf-8"
+X-ECN-Queue-Original-Path: /home/pier/e/queue/Attachments/inbox/2019-12-06/364-original.txt
+X-ECN-Queue-Original-URL: https://engineering.purdue.edu/webqueue/Attachments/inbox/2019-12-06/364-original.txt
+
+
+	Name: Jerry L Guerrero
+       Login: jerry
+    Computer: x-ee270bpc1 (128.46.164.29)
+    Location: EE 270B
+       Email: jerry@purdue.edu
+       Phone: 
+      Office: 
+    UNIX Dir: /home/pier/c/jerry
+    Zero Dir: U=\\pier.ecn.purdue.edu\jerry
+  User ECNDB: http://eng.purdue.edu/jump/bcafa8
+  Host ECNDB: http://eng.purdue.edu/jump/2dbd461    
+     Subject: Win7 to Win10 Migration List - kevin
+
+We are down to 1500 hosts left to migrate from Windows 7 in ECN to
+Windows 10 in BoilerAD (as of Oct 4th). The objective is to migrate
+as
+many if not all by the end of March 2020. With this end goal in mind,
+each staffer is asked to convert 60 hosts (3 a week) from the list of
+PCs in the following Google Doc.
+
+https://docs.google.com/spreadsheets/d/1gO0y1wOA7ENHcmXI7wnZviAgSbAMKjWM3D_V4wR5o3w/edit?usp=sharing
+
+Process:
+
+1) As you select and migrate hosts listed in the Google doc, add your
+name to column M. (Plan for at least 3 hosts a week.)
+
+2) And, add each host as an edit to this item.
+
+3) For each host, make sure a ticket exists to coordinate the
+communication with the user and the progress of the migration. (Use
+an
+existing item submitted by the user or generate a new one on their
+behalf.)
+
+4) After completion, update column N with the date.
+
+Let us know if you have any questions on the process.
+
+Thanks,
+
+Jerry Guerrero
+IT Site Manager
+Engineering Computer Network
+Purdue University
+jerry@purdue.edu
+
+*** Status updated by: harley at: 3/31/2020 10:53:26 ***
+on hold
+
+*** Status updated by: jerry at: 4/28/2020 14:21:42 ***
+waiting for reply

q-snapshot/aae/10

@@ -0,0 +1,128 @@
+[aae] QPriority: covid
+[aae] QPriority-Updated-Time: Mon, 20 Apr 2020 11:51:44 EDT
+[aae] QPriority-Updated-By: emuffley
+Priority: covid
+Priority-Updated-Time: Mon, 20 Apr 2020 11:51:44 EDT
+Priority-Updated-By: emuffley
+[aae] QStatus: check when campus is open
+[aae] QStatus-Updated-Time: Fri, 03 Apr 2020 09:51:24 EST
+[aae] QStatus-Updated-By: kevin
+Status: check when campus is open
+Status-Updated-Time: Fri, 03 Apr 2020 09:51:24 EST
+Status-Updated-By: kevin
+[software] QArchived-Time: Fri, 06 Mar 2020 14:00:50 EST
+[software] QArchived-By: cs
+Archived-Time: Fri, 06 Mar 2020 14:00:50 EST
+Archived-By: cs
+Edited-Time: Fri, 06 Mar 2020 14:00:47 -0500
+Edited-By: cs
+Edited-Time: Fri, 06 Mar 2020 13:58:05 -0500
+Edited-By: cs
+[aae] QStatus: PC is now in EE 270
+[aae] QStatus-Updated-Time: Fri, 06 Mar 2020 13:39:15 EST
+[aae] QStatus-Updated-By: kevin
+Status: PC is now in EE 270
+Status-Updated-Time: Fri, 06 Mar 2020 13:39:15 EST
+Status-Updated-By: kevin
+Edited-Time: Fri, 06 Mar 2020 13:38:52 -0500
+Edited-By: kevin
+Edited-Time: Fri, 06 Mar 2020 12:48:27 -0500
+Edited-By: kevin
+[aae] QStatus: need to investigate
+[aae] QStatus-Updated-Time: Fri, 06 Mar 2020 08:58:27 EST
+[aae] QStatus-Updated-By: kevin
+Status: need to investigate
+Status-Updated-Time: Fri, 06 Mar 2020 08:58:27 EST
+Status-Updated-By: kevin
+[aae] QTime: 0:09
+[aae] QTime-Updated-Time: Fri, 06 Mar 2020 08:58:15 EST
+[aae] QTime-Updated-By: kevin
+Time: 0:09
+Time-Updated-Time: Fri, 06 Mar 2020 08:58:15 EST
+Time-Updated-By: kevin
+Edited-Time: Fri, 06 Mar 2020 08:58:10 -0500
+Edited-By: kevin
+[aae] QAssigned-To: kevin
+[aae] QAssigned-To-Updated-Time: Fri, 06 Mar 2020 08:14:35 EST
+[aae] QAssigned-To-Updated-By: jerry
+Assigned-To: kevin
+Assigned-To-Updated-Time: Fri, 06 Mar 2020 08:14:35 EST
+Assigned-To-Updated-By: jerry
+Edited-Time: Fri, 06 Mar 2020 06:52:46 -0500
+Edited-By: cs
+[software] QPriority: 2
+[software] QPriority-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+[software] QPriority-Updated-By: cs
+Priority: 2
+Priority-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+Priority-Updated-By: cs
+[software] QStatus: Curtis will work on this
+[software] QStatus-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+[software] QStatus-Updated-By: cs
+Status: Curtis will work on this
+Status-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+Status-Updated-By: cs
+[software] QAssigned-To: cs
+[software] QAssigned-To-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+[software] QAssigned-To-Updated-By: cs
+Assigned-To: cs
+Assigned-To-Updated-Time: Fri, 06 Mar 2020 06:52:27 EST
+Assigned-To-Updated-By: cs
+Shared-Folders: from aae to software
+Shared-Time: Fri, 06 Mar 2020 06:22:39 -0500
+Shared-By: cs
+Date: Fri, 6 Mar 2020 06:22:29 -0500
+From: Curtis Smith <cs@ecn.purdue.edu>
+Message-ID: <202003061122.026BMTaH014941@dreamsmasher.ecn.purdue.edu>
+Subject: Host change armsb142lnx2.ecn.purdue.edu
+To: aaesite@ecn.purdue.edu
+Content-Type: text/plain; charset="utf-8"
+X-ECN-Queue-Original-Path: /home/pier/e/queue/Attachments/inbox/2020-03-06/30-original.txt
+X-ECN-Queue-Original-URL: https://engineering.purdue.edu/webqueue/Attachments/inbox/2020-03-06/30-original.txt
+
+Investigate the host armsb142lnx2.ecn.purdue.edu in ARMS B142. The ECN
+supported CentOS 6 host is showing that the ssh key changed. See if the
+host is still running ECN's CentOS 6. Let us know immediately what the
+results are.
+
+*** Status updated by: cs at: 3/6/2020 06:52:27 ***
+Curtis will work on this
+*** Edited by: cs at: 03/06/20 06:52:28 ***
+
+I've removed armsb142lnx2.ecn.purdue.edu from netgroups, pending
+investigation.
+*** Edited by: kevin at: 03/06/20 08:56:51 ***
+
+ Met with Curtis about this PC, the last user was du185. Machine needs to be picked up
+and wiped.
+
+*** Status updated by: kevin at: 3/6/2020 08:58:27 ***
+need to investigate
+*** Edited by: kevin at: 03/06/20 12:48:27 ***
+
+stopped by armsb142 left msg for Bin Du
+
+
+
+*** Edited by: kevin at: 03/06/20 13:38:52 ***
+
+Ritu picked up the pc and I have it at my desk
+
+
+
+
+*** Status updated by: kevin at: 3/6/2020 13:39:15 ***
+PC is now in EE 270
+*** Edited by: cs at: 03/06/20 13:57:21 ***
+
+We booted up the PC and it started running Ubuntu.
+
+We are going to clear the host from ECN support. Then, once the disk
+is erased, the student can run whatever they want.
+*** Edited by: cs at: 03/06/20 14:00:11 ***
+
+Removed from ACmaint, rdist, igor, netgroup, SSH keys. Updated DNS to
+indicated "unsupported".
+
+*** Status updated by: kevin at: 4/3/2020 09:51:24 ***
+check when campus is open