This repository gives us a chance to practice using git and virtual environments. We will take a small program and practice how we can manage its dependencies using a virtual environment. We'll also practice forking and cloning a repository, as well as making a commit and pushing changes.
- To start, we want make our own copy of the GitHub repository to work with. We do this by forking the repository. Click the Fork button on GitHub. This new repository copy will be owned by your GitHub account.
- Next, we want to copy the code from GitHub down to our computer. We will do this by cloning the code. Click the green Code Button, then copy the URL from the dropdown that appears.
- Open a terminal on your computer, and navigate to the directory where you wish to copy this exercise's code to. Once you are in the desired directory, run this command, using the URL you copied in the previous step:
git clone YOUR_REPO_URL
- After the repository is copied, move into the repository directory.
cd AdaSay
- The AdaSay project requires the cowsay package to run. We want to install this dependency in a virtual environment so that it is used only for this project. We first run the following command to create a virtaul environment:
python3 -m venv venv
-
This will create a new folder named
venvwhich will hold all the information about our virtual environment. Verify that this folder was created by runninglsand seeing thatvenvis one of the folders present. -
We now need to activate the virtual environment. Everything else up to this point was one-time setup, but we will need to repeat this step each time we open a new terminal to interact with this project. We activate the virtual environment by running the activation script in the
venvfolder.
source venv/bin/activate
-
Verify that the virtual environment has been activated. If
(venv)appears at the front of your shell prompt, you have successfully activated the environment. -
Next, we want to install all the requirements. This projects specifies the what packages it needs in the
requirements.txtfile. We use pip to read this file and install the needed dependencies:
pip install -r requirements.txt
- Now that the requirements are installed, we're ready to try running our program. Run the following command (in a terminal that has the virtual environment activated) and see if we get a cow outputted:
python main.py
- Right now the cow doesn't say anything interesting. Let's change that! Start by opening VS Code in the AdaSay directory.
code .
-
Edit
main.pyto make the cow say something interesting. Make sure to save the file in VS Code after you make your change! -
Verify that your changes work by running
main.pyagain. (Note: if you use the terminal inside VS Code, you may need to activate the virtual environment on that new terminal. See step 7.)
python main.py
- Once you're satisfied with your changes double-check which files have been changed.
git status
- You should expect to see that only
main.pywas changed. We'll now stage this for our commit.
git add main.py
- Check the status of the files again. You should see that
main.pyis now shown in green, indicating that it will be part of our commit.
git status
- Commit the changes. Add some meaningful commit message that describes the changes you made. (Hint: do not use exclamation marks in your commit message)
git commit -m "Changed cow message to COWABUNGA"
- Push the changes to GitHub. If asked for a username and password, use your GitHub username and your Personal Access Token (PAT).
git push origin
-
Check that the changes are reflected in GitHub. Refresh the GitHub page in your browser and see that your new change is present in
main.py. -
BONUS: do some searching online to figure out how to have cowsay use a dragon instead of a cow. Modify your code to use the dragon, stage your changes, make a commit, and push the commit to GitHub.
-
Once you're finished working on this exercise, deactivate the virtual environment.
deactivate