ManGO: an iRODS Python Client based portal
WARNING: the current state is geared towards deployments in the KU Leuven specific cloud services, see Custom deployments for your options. In the near future, the KU Leuven specifics will be entirely decoupled from the generic code base so a default installation will work with a vanilla iRODS installation
The current version requires python 3.10 or higher. See also the section on changing the python version below.
Installation (local development mode, Linux, KULeuven specific for now)
You need to have a valid and initialised iRODS environment for your account, the easiest is to install the iRODS icommands and execute the instructions from the ManGO landing page for the chosen iRODS zone
Create a python virtual environment in the root of this repository checkout and install the required modules, for example
$ python3 -m venv venv
$ . venv/bin/activate
$ pip3 install -r requirements.txt
Vue2.js development and building
Currently the node module parcel and its dependencies are required for building, see https://parceljs.org/
Before using the first time, execute the following steps
$ cd src
$ npm install
$ npm run build
Starting the development server (waitress version, recommended)
Make sure you activated the virtual environment
Launch the flask development server from the src directory:
$ cd src
$ ./run_waitress.sh
or
$ src/run_waitress.sh
This will start waitress as used in the production deployments, but adds a listener for reloading the app when you change files locally.
Point your browser to http://localhost:3000
Updating
Check for new required python modules and or versions
$ pip3 install -r requirements.txt
If you encounter javascript related errors, the used js files may need an update:
$ cd src
$ npm install
$ npm run build
Changing the python version
If you upgrade your python version, the requirements.txt may not be correct anymore (outdated packages). You can install updated python modules with:
$ pip list --outdated --format=freeze | grep -v '^\-e' | \
cut -d = -f 1 | xargs -n1 pip install -U
Technical:
- backend framework: Flask
- code organisation: Flask blueprints for making things modular
- leverage the irods-Python client
- optional OpenSearch integration
Development guidelines
Python
The preferred formatter is black with its default options, it also has an integration with IDE's such as VSCode
Javascript
The preferred formatter is prettier with indenting to 4 spaces, no TAB's and single quotes for strings
Metadata
Release files for mango-portal 0.50.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 | Provenance | Actions |
|---|---|---|---|---|
| mango_portal-0.50.0.tar.gz | 8.8 MB | Without provenance | Details for mango_portal-0.50.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mango_portal-0.50.0-py3-none-any.whl | Python 3 | none | any | Details for mango_portal-0.50.0-py3-none-any.whl |
Total release size: 17.8 MB
Release files / mango_portal-0.50.0.tar.gz
| Download URL | mango_portal-0.50.0.tar.gz |
|---|---|
| Size | 8.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f802b3b15caf2c0cbc09a8ed0dd9a53564c61d974e92799687c2a0683574c0f0
|
|
BLAKE2b-256 checksum How to use checksums |
aabca7a6f9a3608ff8def7491acce2195e1cc0961eda9c748c921592f85eb703
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mango_portal-0.50.0-py3-none-any.whl
| Download URL | mango_portal-0.50.0-py3-none-any.whl |
|---|---|
| Size | 8.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3476b435df4e253c2282ed1721e86316cc9a9d26bebedc129717443dc8b6e466
|
|
BLAKE2b-256 checksum How to use checksums |
a753091b643cc9e37fa6cbea2b8b319b936930d95f71cc49c601aa6d6384bc11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for mango-portal 0.50.0
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.