Terminal Adventure

Lab setup

First, make sure you have completed the initial setup.

Open Terminal. Run the update command to make sure you have the latest code.
```
$ mwc update
```

Move to this lab's directory.

$ cd ~/Desktop/making_with_code/mwc1/unit1/lab_terminal

Enter this lab's shell environment.
```
$ poetry shell
```

Move to your MWC directory.
```
$ cd ~/Desktop/making_with_code
```

Get a copy of this lab's materials.

git clone https://git.makingwithcode.org/mwc/lab_terminal.git

This lab will explore one of the most important tools we'll use in this course: the Terminal. While it may seem complicated at first, it will quickly become your go-to tool for computer science class. The Terminal is what we'll use to navigate our filesystem, run code files, install software, and do all kinds of other tasks.

👾 💬 FYI

In this lab, we will just use $ to represent the terminal prompt unless the path to the current directory is important. If you see this in the lab:

$ ls
some-directory some-file.txt

but your computer shows something like this:

(lab-terminal-py3.11) mwc1/unit1/lab_terminal % ls
some-directory some-file.txt

don't worry. As long as you see the $ at the end, it means you can put in new commands to your Terminal. Some terminals (including recent versions of Mac OS) use % instead of $. That's fine too.

Terminal Adventure Lab

💻 Open a Terminal window and run mwc update. It's a good idea to run mwc update every time you start a new lab to make sure you have the latest and greatest.

💻 Open a new Terminal window and enter the commands below, one at a time. (Don't type the $.)

$ cd Desktop/making_with_code/mwc1/unit1/lab_terminal
$ poetry shell
$ ls
adventure
fancy_printing.py
poetry.lock
pyproject.toml
return_to_ship.py

return_to_ship.py is a runnable Python file (you can tell by the .py at the end). pyproject.toml and poetry.lock are a configuration files. You'll see them in every lab, and you may ignore them every time.

💻 Run return_to_ship.py to see what happens:

$ python return_to_ship.py
    Your adventure has only just begun. You are not yet ready to
    return to the ship. More secrets await you in the ocean's depths.
    Use `ls` to look around, and use `cd adventure` to start the
    adventure...

Your challenge is to see if you can find the treasure and bring it back to the ship, using just the Terminal.

💻 Begin by going into into the adventure directory and looking around:

$ cd adventure
$ ls
seafloor	sinking.txt

sinking.txt is a text file, so we can read it.

💻 Use the cat command to print out the contents of a file:

$ cat sinking.txt

Terminal Commands

Here are some Terminal commands which might come in handy on your adventure.

Command	What it does
`ls`	List what's in the current directory.
`pwd`	Prints the "present working directory," or the path to where you are in the filesystem
`cd ~`	Go to your home directory
`cd somewhere`	Go to `somewhere`
`cd ..`	Go to the parent directory
`open file.txt`	Opens `file.txt` with its default program
`cat file.txt`	Prints out the contents of `file.txt`
`python fun.py`	Runs the Python program `fun.py`
`mv old.txt new.txt`	Renames a file from `old.txt` to `new.txt`. Also works for directories.
`mv file.txt dir`	Moves a file to directory `dir`.
`cp old.txt new.txt`	Copy a file from `old.txt` to `new.txt`.
`mkdir bag`	Creates a new directory called `bag`
`rm file.txt`	removes (deletes) the file `file.txt`
`rm -d dir`	removes (deletes) the directory `dir`
`rm -r dir`	recursively removes (deletes) the directory `dir` and all subdirectories and files within that directory. Be careful, this is a powerful tool!