This repository accompanies the Oxford RSE online course delivered on 17 Feb 2021.
Before starting, make sure that you have
- a GitHub account, and are logged in
- Git installed on your computer
- Python installed on your computer, v3.5 or newer
- a text editor installed on your computer. If you don't have a favourite, we suggest VS Code and the Python extension.
If you already have Python installed on your computer, you can check which version you have by opening a terminal (on macOS or Linux) or a command prompt (on Windows) and typing
python --version
If you install Python for this course, go to the link above and choose the default option for your operating system. If you install Python on Windows, make sure you click the "add to path" option during installation.
Click the green "Use this template" button at the top of this page. Follow the prompt to give it a name, but otherwise leave the defaults as they are.
On your computer, clone the repository you have just imported:
- Click the green Code button at the top of the page containing your imported version of this repository
- Select HTTPS and copy the text provided
- From a terminal (on macOS or Linux) or a command prompt (on Windows), run
git clone <paste-string-here>
From a terminal (on macOS or Linux) or a command prompt (on Windows), change to the directory created by running the git command above.
We recommend creating a virtual environment for this course. Type
python -m venv venv
On macOS or Linux, activate this environment by running
source venv/bin/activate
On Windows, activate this environment by running
venv\Scripts\activate.bat
Run the following commands:
pip install --upgrade pip setuptools wheel
pip install -e .
You should see a message that ends with Successfully installed <list of packages>
.
Then run:
pytest -v
You should see a message that ends with
tests/test_models.py::test_everything_works PASSED [100%]
===================== 1 passed in 0.08s ======================
If you see this, you're all set for the course!
Some material and code used in this course is based on Software Carpentry courses.
Software Carpentry material is made available under the CC BY 4.0 license, and example code under the MIT license.