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