-[Jupyter](https://jupyter.org/) and [IJulia.jl](https://github.com/JuliaLang/IJulia.jl)
-[Jupyter](https://jupyter.org/) and [IJulia.jl](https://github.com/JuliaLang/IJulia.jl)
- This repository of workshop materials
- This repository of workshop materials
- All required dependencies (Julia packages) for the workshop
- All required dependencies (Julia packages) for the workshop
### Getting Julia
### Getting Julia
For following the course you will need at least Julia 1.6, but for full compatibility **Julia 1.8** is recommended.
For following the course you will need at least Julia 1.6, but for full compatibility **Julia 1.8** is recommended.
Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/).
Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/).
### Getting all the rest
### Getting all the rest
The easiest way to get the remaining files and dependencies
The easiest way to get the remaining files and dependencies
is to [download the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/blob/main/install.jl?ref_type=heads) and run it from julia. See the instructions [on the github repository](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/).
is to [download the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/blob/main/install.jl?ref_type=heads) and run it from julia. See the instructions [on the github repository](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/).
As an alternative you can also also run the following commands manually
As an alternative you can also also run the following commands manually
(this requires to have `git` and `julia` available from the commandline):
(this requires to have `git` and `julia` available from the commandline):
@@ -46,3 +46,34 @@ from the WorkshopWizard package by Carsten Bauer (which `install.jl` is using).
...
@@ -46,3 +46,34 @@ from the WorkshopWizard package by Carsten Bauer (which `install.jl` is using).
There is a section in the [00_Installation](00_Installation.ipynb) notebook
There is a section in the [00_Installation](00_Installation.ipynb) notebook
with a few quick commands to check everything works as expected.
with a few quick commands to check everything works as expected.
Please run these **before the course**.
Please run these **before the course**.
### For Developers: Setting Up `pre-commit`
[`pre-commit`](https://pre-commit.com/) is a framework that helps to manage and maintain pre-commit hooks to ensure that your code adheres to a consistent style, prevents errors, and adheres to other quality assurance checks.
1.**Install `pre-commit`:**
To ensure smooth development, install `pre-commit` using pip by running the following command:
```bash
pip install pre-commit
```
For more information and installation options, visit the [`pre-commit`](https://pre-commit.com/) website.
2.**Navigate to the Project Directory:**
Change into the project directory, i.e., `julia-seminar` by running:
```bash
cd julia-seminar
```
3.**Install Hooks:**
Install the git hooks by executing:
```bash
pre-commit install
```
This command installs the pre-commit script alongside existing git hooks.
Once the pre-commit hook is installed, it will automatically check your code for any issues before each commit. If the checks do not pass, you will be prompted to fix them before proceeding.