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.2.1
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.2.1.tar.gz | 351.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marinerg_test_access-6.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 698.2 kB
Release files / marinerg_test_access-6.2.1.tar.gz
| Download URL | marinerg_test_access-6.2.1.tar.gz |
|---|---|
| Size | 351.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d4e67bd0bf6ca7237c3ecba24d47149c455a89cf20c2c69bd010b98c60c58378
|
|
BLAKE2b-256 checksum How to use checksums |
3abc15b14f642f1b80119eadbbc4778e0922eed1934a498c7c0726306da7f0f7
|
| 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.2.1-py3-none-any.whl
| Download URL | marinerg_test_access-6.2.1-py3-none-any.whl |
|---|---|
| Size | 347.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
509a814c44107c17eb076924e328386c9c74fa9b3e14e27ff03de848d39e7cd7
|
|
BLAKE2b-256 checksum How to use checksums |
3b80c53e5de3a8215789b441ea0415b9cc2fb5008d118a57b91cbf1db2c31b7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
