project0

Project 0: Setup

Due: September 16, 2022 at 11:59 PM

This project is simply to get your system ready. Although you will "submit" this project on Gradescope, it is not counted towards your final grade. The good-faith attempt (GFA) rule does not apply to this project.

Start with the Instructions!

Table of Contents

• Languages and Packages
• Instructions
  • Linux (NOT WSL)
  • Windows
  • macOS
• Verifying Setup
• Troubleshooting gradescope-submit
  • Incorrect Passwords
  • HTTP Errors
• Special macOS Instructions
  • Do you have a Mac running an older version of macOS?

Languages and Packages

In this course, we will primarily be using Ruby and OCaml. Below is a summary of the packages that need to be installed. You do not need to use these links, they are just for reference or learning more about the languages and/or packages. You can skip below to the instructions.

• Git
• Ruby
  • minitest
  • sqlite3
  • sinatra
• OCaml
  • OPAM
  • OUnit
  • dune
  • utop
• Rust
• SQLite3
• Graphviz

Instructions

First, you will need to clone this repository to your local filesystem. You'll only have to do this once this semester (unless you have multiple computers or delete the repository). To do this, run:

git clone https://github.com/umd-cmsc330/fall2022

The files in the project0 folder will be used for the Verifying Setup section at the bottom.

The following sections will help you install the necessary packages and programs on your operating system. Some steps may take a long time, please be patient. Read all instructions very carefully.

The output of each command is important, please pay careful attention to what each one prints. If you encounter an error message, do not ignore it. We will be available in office hours to help you get set up if you run into problems. As a general rule, no output means the command executed successfully.

Please skip to the section below that corresponds with your operating system.

Linux (NOT WSL)

These instructions assume you have a Debian-based system (e.g. Ubuntu). If you have a different distribution, you will have to find and download the corresponding packages in your native package manager. Note that the packages there may have slightly different names.

1. Firstly, install the basic dependencies:
   • Run sudo apt update to update your local package listing
   • Run sudo apt install ruby-dev sqlite3 libsqlite3-dev ocaml ocaml-native-compilers camlp4 make m4 curl graphviz libssl-dev pkg-config
2. Install some Ruby gems
   • Run sudo gem install --no-document minitest sqlite3 sinatra
3. Install and initialize the OCaml package manager
   • Run sh <(curl -sL https://raw.githubusercontent.com/ocaml/opam/master/shell/install.sh) (when prompted for the installation location, just hit enter to select the default)
     • Run opam --version. You should be on version 2 (followed by some versions, just make sure the major version is 2). Check out the manual if this is not the case, you may have to follow special directions for your particular operating system and version.
     • If you encounter any issues, or are running a different flavor of linux, check out the manual
   • Run opam init
   • If it hangs at "Fetching repository information" press Enter. This may take a while, be patient
   • When prompted to modify ~/.profile (or another file), type "n", but remember the filename
   • Open ~/.profile (or the file mentioned above) in your text editor
   • Add the line eval `opam config env` (note these are backticks, not single quotes)
   • Save the file
   • Run source ~/.profile (or the file you just edited)
4. Initialize OCaml
   • We will be using OCaml version 4.12.0. Run ocaml -version to check which version is currently installed
   • If you are already on 4.12.0, you can skip to #5
   • Run opam update
   • If you are on another version, run opam switch 4.12.0. If you get an error saying that switch is not currently installed, run opam switch create 4.12.0. This may take a while, please be patient
   • Run eval $(opam env)
   • Ensure you are now on the correct version by running ocaml -version
5. Install OCaml packages
   • Run opam install ocamlfind ounit utop dune qcheck
6. Install Rust
   • Go to https://www.rust-lang.org/tools/install and run the installation command provided
   • If prompted, just select the defaults
   • Append ~/.cargo/bin to the PATH environment variable. Frist, do echo $SHELL.
     • If echo $SHELL gives /bin/zsh, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.zshrc
     • If echo $SHELL gives /bin/bash, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.bashrc
7. Install gradescope-submit
   • Run cargo install gradescope-submit. If this fails, try closing and re-opening your terminal window.

Windows

This will only work on Windows 10 and newer. If you are on an older version, you will probably need to set up a Linux VM.

1. Follow the directions here to install the Windows Subsystem for Linux
2. Install the basic dependencies:
   • Run sudo apt update && sudo apt upgrade to update your local package listing
   • Run sudo apt install ruby-dev sqlite3 libsqlite3-dev ocaml ocaml-native-compilers camlp4 make m4 curl graphviz libssl-dev pkg-config
3. Install some Ruby gems
   • Run sudo gem install --no-document minitest sqlite3 sinatra
4. Install and initialize the OCaml package manager
   • Run sh <(curl -sL https://raw.githubusercontent.com/ocaml/opam/master/shell/install.sh) (when prompted for the installation location, just hit enter to select the default)
     • Run opam --version. You should be on version 2 (followed by some versions, just make sure the major version is 2). Check out the manual if this is not the case, you may have to follow special directions for your particular operating system and version.
     • If you encounter any issues, or are running a different flavor of linux, check out the manual
   • Run opam init --disable-sandboxing
   • If it hangs at "Fetching repository information" press Enter. This may take a while, be patient
   • When prompted to modify ~/.profile (or another file), type "n", but remember the filename
   • Open ~/.profile (or the file mentioned above) in your text editor
   • Add the line eval `opam config env` (note these are backticks, not single quotes)
   • Save the file
   • Run source ~/.profile (or the file you just edited)
5. Initialize OCaml
   • We will be using OCaml version 4.12.0. Run ocaml -version to check which version is currently installed
   • If you are already on 4.12.0, you can skip to #6
   • Run opam update
   • If you are on another version, run opam switch 4.12.0
   • If you get an error saying that switch is not currently installed, run opam switch create 4.12.0. This may take a while, please be patient
     • While installing the new switch, if you get an error for bwrap, first remove the .opam directory using rm -r ~/.opam and then reinitialize opam by disabling sanboxing using opam init --disable-sandboxing. Type "n" when prompted to modify ~/.profile. Once opam has been initialized, rerun opam switch create 4.12.0
   • Run eval $(opam env)
   • Ensure you are now on the correct version by running ocaml -version
6. Install OCaml packages
   • Run opam install ocamlfind ounit utop dune qcheck
7. Install Rust
   • Go to https://www.rust-lang.org/tools/install and run the installation command provided
   • If prompted, just select the defaults
   • Append ~/.cargo/bin to the PATH environment variable. First, do echo $SHELL.
     • If echo $SHELL gives /bin/zsh, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.zshrc
     • If echo $SHELL gives /bin/bash, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.bashrc
8. Install gradescope-submit
   • Run cargo install gradescope-submit. If this fails, try closing and re-opening your terminal window.

macOS

Check the Special macOS Instructions to check if you need to follow any special steps, then come back here.

1. Install the Homebrew package manager (Updated in Fall 2021)
   • Run /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Check your Ruby version by running ruby -v. If it's older than 2.2.2, you'll need to install a newer version using brew install ruby
3. Install the basic dependencies
   • Run brew install ocaml opam graphviz openssl
4. Install some Ruby gems
   • Run sudo gem install --no-document minitest sqlite3 sinatra
5. Initialize the OCaml package manager
   • Run opam init
   • When prompted to modify ~/.zshrc or ~/.bash_profile (or similar file), type "y"
   • Run source ~/.zshrc or source ~/.bash_profile (or the file mentioned above)
6. Initialize OCaml
   • We will be using OCaml version 4.12.0. Run ocaml -version to check which version is currently installed
   • If you are already on 4.12.0, you can skip to #7
   • Run opam update
   • If you are on another version, run opam switch 4.12.0. If you get an error saying that switch is not currently installed, run opam switch create 4.12.0. This may take a while, please be patient
   • Run eval $(opam env)
   • Ensure you are now on the correct version by running ocaml -version
7. Install OCaml packages
   • Run opam install ocamlfind ounit utop dune qcheck
8. Install Rust
   • Go to https://www.rust-lang.org/tools/install and run the installation command provided
   • If prompted, just select the defaults
   • Append ~/.cargo/bin to the PATH environment variable. Frist, do echo $SHELL.
     • If echo $SHELL gives /bin/zsh, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.zshrc
     • If echo $SHELL gives /bin/bash, do echo "export PATH=\"$HOME/.cargo/bin:$PATH\"" >> ~/.bashrc
9. Install gradescope-submit
   • Run cargo install gradescope-submit. If this fails, try closing and re-opening your terminal window.

Verifying Setup

This is the graded part of this project. To verify that you have the correct versions installed, run ruby test/public/public.rb in this directory. You should not get any errors. This will create a file called p0.report. Submit this file by running gradescope-submit in the project folder. You will have to enter your credentials the first time, but for future projects you should not have to. Alternatively, you can manually submit the file to Gradescope by uploading the p0.report file to the appropriate assignment.

Troubleshooting gradescope-submit

Incorrect Passwords

Make sure that the email address and password you entered is of the account where your CMSC 330 course enrollment shows up. (If you login through "school credentials" option and don't remember your Gradescope password, please reset it.) Great chances are that people have multiple Gradescope accounts, and it is suggested to merge them before trying to submit by the program.

HTTP Errors

Remove the gradescope-submit config file by doing rm -r ~/.gradescope-submit. Then, refer to the troubleshooting for incorrect passwords and try it again.

Special macOS Instructions

Verify you're running an older version of macOS. Either click the Apple button in the menubar in the top-left and click "About This Mac", or else run sw_vers from the terminal. You should only need the special section if your macos version is less than 10.15

Follow the directions for macOS, but with some changes.

• If you ran the special instructions previously, undo by uninstalling homebrew:
  • /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
  • You will probably have leftover files in /opt/homebrew or /usr/local. We will try to help you delete them in OH.
• Run brew install INDIVIDUALLY on each of ocaml, opam, openssl, graphviz.
  • so brew install ocaml, brew install opam, etc.
• If openssl or graphviz install fails, try again with -s
  • ie brew install -s graphviz