Marinerg-i Facility Service
The record of MARINERG-i's marine renewable energy test facilities and their equipment: who runs each facility, where it is, and the persistent identifiers (ROR, PIDINST) that let the wider research infrastructure cite it.
It is an installable Django app, marinerg_facility, exposing a REST API. It
runs standalone for development, and in production is composed into the
Test Access Service,
which depends on it. Built for the
Marinerg-i preparatory phase project.
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 for the facilities,
equipment and tag endpoints.
Development
uv sync --group dev
source infra/set_dev_environment.sh
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 # 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
Tests run against SQLite by default; CI runs them against Postgres, which is what production uses. The full-text-search tests self-skip on SQLite, so run them against Postgres before trusting a search change.
More detail in the Developer Guide.
Partner ROR identifiers
Partner facilities carry a ROR identifier. The values live in a reviewable data file, applied by a management command that validates each ROR — format, checksum, and existence in the public registry — before writing it:
uv run python manage.py populate_ror --emit-template > facility_rors.yaml
# fill in each `ror:` field, then apply (idempotent)
uv run python manage.py populate_ror --mapping facility_rors.yaml
--dry-run previews, --no-verify skips the registry check, --strict fails
if a partner facility is left without one, and --all widens the template
beyond partners. See populate_ror --help.
Release
Published by the shared python-package CI component: run a web pipeline with
RELEASE_FIELD=patch|minor|major. Consumers pin this package exactly, so a
release is only visible once they bump their pin.
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-facility 2.5.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_facility-2.5.0.tar.gz | 49.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marinerg_facility-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 90.9 kB
Release files / marinerg_facility-2.5.0.tar.gz
| Download URL | marinerg_facility-2.5.0.tar.gz |
|---|---|
| Size | 49.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5e30d8c5242ffc35a8220479d98ffeb7e9c2a55462661301fb1eda3983e19064
|
|
BLAKE2b-256 checksum How to use checksums |
5a40b79916c7d2e958d658691bc26985380ab43f414c984489968af4eca828ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / marinerg_facility-2.5.0-py3-none-any.whl
| Download URL | marinerg_facility-2.5.0-py3-none-any.whl |
|---|---|
| Size | 41.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c7baaa66f8a886e3d0499baacc171571e12f9537ff4266b3085c01d483873d1
|
|
BLAKE2b-256 checksum How to use checksums |
bff2e6c3b6dcdc1d8e46fe14285e18c7728021ee0bc50379de1ec4ce5706d096
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
