Parksort

Table of Contents

• Parksort
• Table of Contents
• Quick Links
• Parking Results Legend
• Installation Instructions
  • 1. Download the code:
  • 2. Download the parking_service_account.json:
  • 3. Install everything:
• Using the program
• Uninstalling parksort

Quick Links

This week's parking results
Project Requirements Document (project overview)

Parking Results Legend

SML: On-campus parking, spots 38-46 (Small spots)
REG: On-campus parking, spots 52-89
PAR: On-campus parking, 90-93 (Parallel spots)
BART: Parking at St. Barts

Installation Instructions

These instructions are for people with macs. If you have windows, this won't work, and you should find someone with a mac. If you have linux, this might work, or might not, but you can figure it out yourself like you do for everything else.

Note This installation guide requires Python 2.7, which is installed by default on Macs running anything before MacOS Monterey. We chose Python 2.7, even though it is deprecated, because of this ease-of-installation benefit. If you have updated to (or past) Monterey, use the MacOS installer here to restore python before continuing.

Warning If you've messed with your ~/.bash_profile or ~/.zshrc, make sure everyone has read and write access: sudo chmod 666 [file]. This technically gives execute access too, but I don't remember the numbers for only r/w, it's not a security problem, and is confirmed to work.

1. Download the code:

1. Open the Terminal application by searching for Terminal in Spotlight Search.
2. paste this line in, and run it with enter:

wget https://github.com/Parking-Lab/parking/archive/refs/heads/py2.7-release.zip; unzip py2.7-release.zip; rm -rf py2.7-release.zip; mv parking-py2.7-release/ parking/; chmod +x parking/setup.sh

2. Download the parking_service_account.json:

1. Get the parking_service_account.json file from asoong23@csus.org or rdye23@csus.org
2. Download parking_service_account.json and make sure the file is in Downloads

Warning Never share this file with anyone or upload it anywhere. It contains sensitive information.

3. Install everything:

1. Go to the directory tab on MyCSUS and select your grade in list view.
2. select and copy all names and emails (just click and drag allllll the way down)
3. In terminal, run this command. A text editor should open up, with a file repeating these instructions. Paste the copied data into the editor after the instructions, and SAVE THE FILE. Then close the text editor.

open parking/students.txt

4. Finally, run this command in Terminal.

./parking/setup.sh

Once you have run that command, close Terminal. This ensures that the shell updates before you try to run the program.

The program is now ready to use. Further instructions and documentation are available on the PRD and Instructions document.

Using the program

This program is a command line utility, meaning that it runs in terminal and has a text-based interface. It is called parksort. To run the sort, just run this command:

parksort run

For a general blurb:

parksort

For quick reference, either of these work:

parksort -h
parksort --help

And to change the sort settings:

parksort config

And that's it!

---

Uninstalling parksort

To uninstall parksort, just run this:

parksort uninstall

This will remove the software and the configuration files, and will remove the lines added to ~/.bash_profile and ~/.zshrc.
This does not remove any installed python libraries (nose, tornado, toml, numpy, pandas, gspread) or python itself.

---

If you have any questions or problems, email rdye23@csus.org, asoong23@csus.org, or consult the internet.