|
1 | 1 | --- |
2 | | -title: Setup |
| 2 | +title: "Setup" |
3 | 3 | --- |
4 | 4 |
|
5 | | -FIXME: Setup instructions live in this document. Please specify the tools and |
6 | | -the data sets the Learner needs to have installed. |
| 5 | +## Exercises repository |
7 | 6 |
|
8 | | -## Data Sets |
| 7 | +Throughout this walkthrough, we will use the repository [UCL-ARC/fortran-unit-testing-exercises](https://github.com/UCL-ARC/fortran-unit-testing-exercises) which contains example exercises written in Fortran. |
9 | 8 |
|
10 | | -<!-- |
11 | | -FIXME: place any data you want learners to use in `episodes/data` and then use |
12 | | - a relative link ( [data zip file](data/lesson-data.zip) ) to provide a |
13 | | - link to it, replacing the example.com link. |
14 | | ---> |
15 | | -Download the [data zip file](https://example.com/FIXME) and unzip it to your Desktop |
| 9 | +::::::::::::::::::::::::::::::::::::: challenge |
16 | 10 |
|
17 | | -## Software Setup |
18 | | - |
19 | | -::::::::::::::::::::::::::::::::::::::: discussion |
| 11 | +### Challenge 1: Can you clone the exercises repository |
20 | 12 |
|
21 | | -### Details |
| 13 | +Try to clone the exercises we will use throughout this lesson. |
22 | 14 |
|
23 | | -Setup for different systems can be presented in dropdown menus via a `spoiler` |
24 | | -tag. They will join to this discussion block, so you can give a general overview |
25 | | -of the software used in this lesson here and fill out the individual operating |
26 | | -systems (and potentially add more, e.g. online setup) in the solutions blocks. |
| 15 | +:::::::::::::::::::::::::::: solution |
27 | 16 |
|
28 | | -::::::::::::::::::::::::::::::::::::::::::::::::::: |
| 17 | +```bash |
| 18 | +$ git clone https://github.com/UCL-ARC/fortran-unit-testing-exercises.git |
| 19 | +Cloning into 'fortran-unit-testing-exercises'... |
| 20 | +remote: Enumerating objects: 256, done. |
| 21 | +remote: Counting objects: 100% (256/256), done. |
| 22 | +remote: Compressing objects: 100% (140/140), done. |
| 23 | +remote: Total 256 (delta 98), reused 229 (delta 71), pack-reused 0 (from 0) |
| 24 | +Receiving objects: 100% (256/256), 45.96 KiB | 4.18 MiB/s, done. |
| 25 | +Resolving deltas: 100% (98/98), done. |
| 26 | +``` |
29 | 27 |
|
30 | | -:::::::::::::::: spoiler |
| 28 | +::::::::::::::::::::::::::::::::::::: |
| 29 | +::::::::::::::::::::::::::::::::::::::::::::::: |
31 | 30 |
|
32 | | -### Windows |
33 | | - |
34 | | -Use PuTTY |
| 31 | +## Software Setup |
35 | 32 |
|
36 | | -:::::::::::::::::::::::: |
| 33 | +To following along with this lesson's exercises you will require the following |
37 | 34 |
|
38 | | -:::::::::::::::: spoiler |
| 35 | +- Fortran Package Manager (FPM) |
| 36 | +- CMake |
| 37 | +- pFUnit |
39 | 38 |
|
40 | | -### MacOS |
| 39 | +::::::::::::::::::::::::::::::::::::: challenge |
41 | 40 |
|
42 | | -Use Terminal.app |
| 41 | +### Challenge 2: Can you install the above dependencies? |
43 | 42 |
|
44 | | -:::::::::::::::::::::::: |
| 43 | +Try to install the dependencies listed above. |
45 | 44 |
|
| 45 | +- FPM [Install instructions](https://fpm.fortran-lang.org/install/index.html) |
| 46 | +- CMake can be installed via [homebrew](https://formulae.brew.sh/formula/cmake) on mac or your package manager (apt, etc) on Linux. |
| 47 | +- pFUnit can be install via the bash script provided in the exercises repo [build-pfunit.sh](https://github.com/UCL-ARC/fortran-unit-testing-exercises/build-pfunit.sh). |
46 | 48 |
|
47 | | -:::::::::::::::: spoiler |
| 49 | +:::::::::::::::::::::::::::: solution |
48 | 50 |
|
49 | | -### Linux |
| 51 | +```bash |
| 52 | +$ fpm --version |
| 53 | +Version: 0.12.0, alpha |
50 | 54 |
|
51 | | -Use Terminal |
| 55 | +$ cmake --version |
| 56 | +cmake version 3.27.0 |
52 | 57 |
|
53 | | -:::::::::::::::::::::::: |
| 58 | +$ ./build-pfunit.sh -t |
| 59 | +TODO: Add output from tetsing pfunit and implement testing pFUnit. |
| 60 | +``` |
54 | 61 |
|
| 62 | +::::::::::::::::::::::::::::::::::::: |
| 63 | +::::::::::::::::::::::::::::::::::::::::::::::: |
0 commit comments