Marinerg-i Test Access Service
This is the backend for the Marinerg-i Test Access Portal. Researchers apply for time at marine renewable energy test facilities. A review board evaluates each application, the board chair decides, and accepted applications lead to a facility test report.
It is a Django app with a REST API, built for the
Marinerg-i project. The Angular frontend is in
marinerg-i/frontend. Run it
separately and point it at this backend.
Try it locally
Read infra/quick_start.sh, then run it:
./infra/quick_start.sh
It creates a virtual environment, installs the dependencies, sets up a local database with an admin user, and starts the server. Browse to localhost:8000/api.
Develop
The app reads its settings from the environment. infra/dev.txt has working
values for local development. Keep real deployment settings out of the repo.
uv sync --group dev
source infra/set_dev_environment.sh
uv run python manage.py migrate
uv run python manage.py sync_roles
uv run python manage.py runserver
If the server says the secret key is missing, the settings didn't load into your shell.
uv run tox runs every check CI runs: format, lint, types, the tests, the
Celery tests, the schema check and the e2e collection. After you change a model
or serializer, regenerate the schema and client, and commit them:
uv run python manage.py generate_client marinerg_test_access.client
After you change an access policy, rewrite the deployed sweep's declaration:
WRITE_DECLARATION=1 uv run pytest tests/test_policies.py
To see the portal in every state, load the demo data, locally or on a local
or dev stack, as docs/demo-data.md explains. It loads only
where DJANGO_DEMO_DATA is true. Set it only in the local and dev inventories,
so staging and prod refuse.
infra/dev.txt sets DJANGO_FRONTEND_URL to the frontend's dev server, so
signing in returns you to the frontend, not to this server's port.
PDF summaries
Each submitted application gets a PDF summary, built by
Gotenberg. Without it the summary is a zip of the
HTML and attachments, so you need it only for the PDF itself and the tests in
tests/integration/:
podman run -d --rm -p 3000:3000 gotenberg/gotenberg:8.34.0
GOTENBERG_URL=http://localhost:3000 uv run python runtests.py
utils/gotenberg.py lists its timeout and retry settings.
How an application is reviewed
Each call runs its applications through a review flow: facility review, board review, the chair's decision, then the facility's test report. docs/review-flow.md explains the flow, what is left to people, and who sees whom.
Release
Each pipeline on main has release patch, release minor and
release major buttons. Press one to publish that release. Then pin the new
version in marinerg-deploy and release its image. The deployment runs
migrate and sync_roles.
Licence
Copyright of the Irish Centre for High End Computing (ICHEC), released under the
MIT Licence. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for marinerg-test-access 9.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-9.2.0.tar.gz | 505.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marinerg_test_access-9.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.0 MB
Release files / marinerg_test_access-9.2.0.tar.gz
| Download URL | marinerg_test_access-9.2.0.tar.gz |
|---|---|
| Size | 505.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ab0ac17420a1c38c1c4861e8f6d1abcf93bcbc62d6cb3c596add25d313e4c96f
|
|
BLAKE2b-256 checksum How to use checksums |
9290174f2c2f3679ec32a264030304d9b0f4c2c606d5390bd4c6f9784b442984
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Release files / marinerg_test_access-9.2.0-py3-none-any.whl
| Download URL | marinerg_test_access-9.2.0-py3-none-any.whl |
|---|---|
| Size | 507.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3372d277a04e9910f97dfe90cbaf8a305b0ee9f25e0b6e8a9ec7eacb79d6998d
|
|
BLAKE2b-256 checksum How to use checksums |
5b958425356f552fb826d77c3677e9b3c53d19e3827e935563e20cb8f8edb363
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
