mirror of
https://github.com/pim-n/pg-rad
synced 2026-02-02 14:33:09 +01:00
50 lines
952 B
Markdown
50 lines
952 B
Markdown
# pg-rad
|
|
Primary Gamma RADiation landscape - Development
|
|
|
|
## Clone
|
|
```
|
|
git clone https://github.com/pim-n/pg-rad
|
|
cd pg-rad
|
|
git checkout dev
|
|
```
|
|
|
|
or
|
|
|
|
```
|
|
git@github.com:pim-n/pg-rad.git
|
|
cd pg-rad
|
|
git checkout dev
|
|
```
|
|
|
|
## Dependencies / venv
|
|
|
|
With Python verion `>=3.12.4` and `<3.13`, create a virtual environment and install pg-rad.
|
|
|
|
```
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
With the virtual environment activated, run:
|
|
|
|
```
|
|
pip install -e .[dev]
|
|
```
|
|
|
|
## Tests
|
|
|
|
Tests can be run with `pytest` from the root directory of the repository. With the virtual environment activated, run:
|
|
|
|
```
|
|
pytest
|
|
```
|
|
|
|
## Local viewing of documentation
|
|
|
|
PG-RAD uses [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) for generating documentation. It can be locally viewed by (in the venv) running:
|
|
```
|
|
mkdocs serve
|
|
```
|
|
|
|
where you can add the `--livereload` flag to automatically update the documentation as you write to the Markdown files.
|