Marinerg-i Test Access Service
The backend for the Marinerg-i Test Access Portal: researchers apply for access to marine renewable energy test facilities, a review board evaluates the applications, a board chair decides, and accepted applications produce facility test reports.
It is a Django app exposing a REST API, built for the
Marinerg-i preparatory phase project. The Angular
frontend that consumes it lives in
marinerg-i/frontend.
Quick start
Inspect the script, then run it:
./infra/quick_start.sh
It creates a virtualenv, installs dependencies, loads the demo settings from
infra/dev.txt, sets up a local database, creates an admin user, and starts the
development server. Then browse to
localhost:8000/api.
Development
uv sync --group dev
eval export $(cat infra/dev.txt)
uv run python manage.py migrate
uv run python manage.py runserver
Tests, linting and types — the same commands CI runs:
uv run python -m pytest tests/ # add --no-cov to drop the coverage report
uv run ruff format --check src tests
uv run ruff check src tests
uv run mypy src
The PDF summary tests under tests/integration/ need a running Gotenberg and
skip without one:
podman run -d --rm -p 3000:3000 gotenberg/gotenberg:8.34.0
GOTENBERG_URL=http://localhost:3000 uv run python runtests.py
Configuration
Settings come from the environment; infra/dev.txt is a working sample for
local development. Beyond the standard Django variables:
| Variable | Default | Purpose |
|---|---|---|
GOTENBERG_URL |
unset | Document conversion service. Unset degrades the summary to a zip instead of a PDF. |
GOTENBERG_TIMEOUT_SECONDS |
120 |
Read timeout for a conversion. |
GOTENBERG_RETRY_ATTEMPTS |
3 |
Total attempts per request, including the first. |
GOTENBERG_RETRY_BACKOFF_MS |
500 |
First retry delay; doubles each attempt. |
More detail in the Developer Guide. The workflow state
machine — the transition table and its settled decisions — is in
docs/workflow-state-machine.md.
Release
Run a GitLab web pipeline with RELEASE_FIELD=patch|minor|major, then pin the
published package in ../marinerg-deploy and release its composite image.
Licensing
Copyright of the Irish Centre for High End Computing (ICHEC), released under the
MIT License. See LICENSE for the full terms.
1 maintainer
Release files for marinerg-test-access 6.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| marinerg_test_access-6.1.0.tar.gz | 346.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marinerg_test_access-6.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 689.2 kB
Release files / marinerg_test_access-6.1.0.tar.gz
| Download URL | marinerg_test_access-6.1.0.tar.gz |
|---|---|
| Size | 346.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7561082929e654622b300442cb6c92c919f18581ef62f3275b1dc7ef892bda95
|
|
BLAKE2b-256 checksum How to use checksums |
dd3f2858458ac2a3c8323eb54aebeba20bbddbb047b699a3ef656acfc9163312
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / marinerg_test_access-6.1.0-py3-none-any.whl
| Download URL | marinerg_test_access-6.1.0-py3-none-any.whl |
|---|---|
| Size | 342.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
209d82e89023520f90ae7c9c81476ddf87f54948f70a529d72e468e6a3590492
|
|
BLAKE2b-256 checksum How to use checksums |
08ed383d7d92f3c4927501a21859599e7b7c41159b337ce811640dee00c68c6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
