Skip to content

⚙️ Setup

Before the workshop

To get up and running quickly, please make sure you have the following ready for the workshop:

  1. Bring a laptop!
  2. A working Python binary for your OS, version 3.9 or above. You can find a guide for various operating systems here.
  3. A GitHub account.
  4. Have git installed on your system.
  5. A code editor. My preferred option is VSCode.

GitHub authentication

For some parts of the workshop, you'll need to be able to authenticate to GitHub from the terminal. If you don't know how to do this, the easiest is to use a token:

  1. Go to GitHub → Click on your profile avatar (top right) → Settings → Developer settings (bottom) → Personal access tokens → Tokens (classic).
  2. Click "Generate new token" → "Generate new token (classic)".
  3. Give it a description in the "Note" (e.g., "Software development workshop").
  4. Select scopes: check both "repo" and "workflow".
  5. Click "Generate token" at the bottom and copy the token.

Whenever you need to authenticate to GitHub (e.g. when you push to your remote), you can use this token as your password.

Warning

Be sure to copy and save the token somewhere safe!

Workshop directory

To keep things nice and organised, it's best if you create a single directory where you execute all the commands for the workshop. Navigate to a suitable parent folder, and make a new directory:

mkdir softdev-workshop
cd softdev-workshop

Operating System

You can use your preferred operating system, but I have no experience with Windows. If you are using Windows, it may be a good idea to install WSL. I'll try to also show the Windows Powershell equivalent of each command, but these don't always exist, and I may forget some here and there.