ICHEC Web
ICHEC Web is the reference ICHEC web portal. It is a working portal you can run on your machine with one command, and the two libraries it is built from. Run it to see what a portal on these libraries does, or copy it to start your own.
ichec-django-core, on PyPI, is the backend. It provides secure settings, members and organisations, sign-in through Keycloak, permissions, forms, workflows and a REST API.ichec-angular-core, on npm, is the frontend. It provides pages to list, view, create and edit, and talks to the API through a client generated from the backend's schema.yaml.
Try the portal
You need Docker, or Podman with podman compose.
git clone https://git.ichec.ie/platform-engineering/modules/ichec-web.git
cd ichec-web
cp .env.example .env
docker compose up -d
The first start builds the portal, which takes several minutes. Then open
http://localhost:8080/ and sign in as admin, password admin.
http://localhost:8080/api/ is the API, and http://localhost:8025/ shows
the emails the portal sends. docker compose down -v stops it and deletes
its data.
The portal's backend is in app/, and its frontend is the test app in frontend/projects/test-app.
Build your own portal
A portal of your own uses the two libraries from PyPI and npm, and adds its own models, pages and rules. Build each side with its guide:
- Build a portal's backend covers the settings, URLs, permissions, Keycloak sign-in, the optional features and testing.
- Build a portal's frontend covers the setup, the pages and the generated API client.
The example portal shows the result: app/settings.py for the backend, and the test app's app.config.ts for the frontend.
Deploy a portal
The sample web portal
deploys a portal built on these libraries to a server, with HTTPS, Keycloak and
backups, using the ichec.platform Ansible collection. Start there when your
portal is ready to run somewhere other than your machine.
Work on this repo
The backend is at the top of the repo, and the frontend in frontend/.
docs/development.md says how to run the backend's
checks, and the frontend's README
has its own.
Licence
Copyright of the Irish Centre for High End Computing (ICHEC), released under the MIT License. See LICENSE.
Metadata
Release files for ichec-django-core 8.6.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ichec_django_core-8.6.3.tar.gz | 413.9 kB | Without provenance | Details for ichec_django_core-8.6.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ichec_django_core-8.6.3-py3-none-any.whl | Python 3 | none | any | Details for ichec_django_core-8.6.3-py3-none-any.whl |
Total release size: 770.0 kB
Release files / ichec_django_core-8.6.3.tar.gz
| Download URL | ichec_django_core-8.6.3.tar.gz |
|---|---|
| Size | 413.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1239166e587b15a0eceb1ee43d97d9d581d3c40e9a424996b67f60a9ec899cb0
|
|
BLAKE2b-256 checksum How to use checksums |
6d999b1299cfd7b2bab59939f8ddb20f21f110872a6b09153e0e15d4bf667727
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Release files / ichec_django_core-8.6.3-py3-none-any.whl
| Download URL | ichec_django_core-8.6.3-py3-none-any.whl |
|---|---|
| Size | 356.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9bd03c526b661ce5238adcf8708b3036ef4f1780762a7a963f5de632b88130b1
|
|
BLAKE2b-256 checksum How to use checksums |
387579220f3468524160ba1157e6516b4ac502f0252d46756bcb960dfe6b3163
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Security for ichec-django-core 8.6.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.