If You Want to Code at Home

If You Want to Code at Home

Requirements

In order to code at home, please install the following first:

Github Desktop

Github Desktop is the software you use to clone the wwif repository, keep track of changes, commit changes, and sync changes. You can download and GitHub Desktop at https://desktop.github.com/.

Once downloaded, double click on the downloaded file to run the installer.

Python 3.5.2 and IDLE

Python is the programming language that the wwif games are written in. You will need to download python in order to run and test the code in the wwif repository. You can download Python 3.5.2 at https://www.python.org/downloads/release/python-352/. IDLE, which is python's Integrated Development and Learning Environment, is included in the python download.

For Mac users (if you purchased your Mac after 2009), download the Mac OS X 64-bit/32-bit installer.

For Windows users, you'll want to double check whether you're running a 32-bit or 64-bit system. Instructions for how to find out what system you're using can be found in this article:

https://www.pcworld.com/article/3096790/windows/why-it-matters-whether-your-windows-is-32-bit-or-64-bit.html

For 64-bit Windows, download the Windows x86-64 executable installer.
For 32-bit Windows, download the Windows x86 executable installer.

Once downloaded, double click on the downloaded file to run the installer.

Getting Started

Students should already be familiar with how to use the required tools. These instructions should serve to remind students of what to do.

Quick Overview

The workflow that students have been taught follows:

GitHub Desktop

1. Open GitHub Desktop.

2. Use Github Desktop to clone wwif.

   Once cloned, wwif will not need to be cloned again. Instead the 2nd step should be to Sync changes to get the most up-to-date code.

IDLE
3. Open IDLE.
4. Open a game file (or create a new one).
5. Write some code or make some changes.
6. Save.
7. Test the code or the changes by running the module.
8. Fix any errors and retest.
9. If everything looks good, go back to Github Desktop.

GitHub Desktop
10. Commit the changes.
11. Sync changes.
12. Fix conflicts, if necessary.
13. Commit fixes.
14. Sync fixes.