esnet-iri
A simple implementation of the IRI facility API using python and the fastApi library.
For more information, see: https://iri.science/
<img src="https://iri.science/images/doe-icon-old.png\" height=50 />
This Python package is automatically generated by the OpenAPI Generator project:
- API version: 1.0.0
- Package version: 1.0.0
- Generator version: 7.19.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://es.net/
Requirements.
Python 3.9+
Installation & Usage
pip install
If the python package is hosted on a repository, you can install directly using:
pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)
Then import the package:
import esnet_iri
Setuptools
Install via Setuptools.
python setup.py install --user
(or sudo python setup.py install to install the package for all users)
Then import the package:
import esnet_iri
Tests
Execute pytest to run the tests.
Getting Started
Please follow the installation procedure and then run the following:
import esnet_iri
from esnet_iri.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://iri-dev.ppg.es.net
# See configuration.py for a list of all supported configuration parameters.
configuration = esnet_iri.Configuration(
host = "https://iri-dev.ppg.es.net"
)
# Enter a context with an instance of the API client
with esnet_iri.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = esnet_iri.AccountApi(api_client)
name = 'name_example' # str | (optional)
modified_since = '2026-02-21T12:00:00Z' # datetime | (optional)
offset = 0 # int | (optional) (default to 0)
limit = 100 # int | (optional) (default to 100)
try:
# Get the list of capabilities
api_response = api_instance.get_capabilities(name=name, modified_since=modified_since, offset=offset, limit=limit)
print("The response of AccountApi->get_capabilities:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling AccountApi->get_capabilities: %s\n" % e)
Documentation for API Endpoints
All URIs are relative to https://iri-dev.ppg.es.net
| Class | Method | HTTP request | Description |
|---|---|---|---|
| AccountApi | get_capabilities | GET /api/v1/account/capabilities | Get the list of capabilities |
| AccountApi | get_capability | GET /api/v1/account/capabilities/{capability_id} | Get a single capability |
| AccountApi | get_project | GET /api/v1/account/projects/{project_id} | Get a single project |
| AccountApi | get_project_allocation_by_project | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id} | Get a single project allocation |
| AccountApi | get_project_allocations_by_project | GET /api/v1/account/projects/{project_id}/project_allocations | Get the allocations of the current user's projects |
| AccountApi | get_projects | GET /api/v1/account/projects | Get the projects of the current user |
| AccountApi | get_user_allocation_by_project_allocation | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id}/user_allocations/{user_allocation_id} | Get a user allocation of the current user's projects |
| AccountApi | get_user_allocations_by_project_allocation | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id}/user_allocations | Get the user allocations of the current user's projects |
| ComputeApi | cancel_job | DELETE /api/v1/compute/cancel/{resource_id}/{job_id} | Cancel Job |
| ComputeApi | get_job | GET /api/v1/compute/status/{resource_id}/{job_id} | Get Job Status |
| ComputeApi | get_jobs | POST /api/v1/compute/status/{resource_id} | Get Job Statuses |
| ComputeApi | launch_job | POST /api/v1/compute/job/{resource_id} | Submit Job |
| ComputeApi | update_job | PUT /api/v1/compute/job/{resource_id}/{job_id} | Update Job |
| FacilityApi | get_facility | GET /api/v1/facility | Get Facility |
| FacilityApi | get_site | GET /api/v1/facility/sites/{site_id} | Get Site |
| FacilityApi | get_sites | GET /api/v1/facility/sites | List Sites |
| FilesystemApi | checksum | GET /api/v1/filesystem/checksum/{resource_id} | Get Checksum |
| FilesystemApi | chmod | PUT /api/v1/filesystem/chmod/{resource_id} | Put Chmod |
| FilesystemApi | chown | PUT /api/v1/filesystem/chown/{resource_id} | Put Chown |
| FilesystemApi | compress | POST /api/v1/filesystem/compress/{resource_id} | Post Compress |
| FilesystemApi | cp | POST /api/v1/filesystem/cp/{resource_id} | Post Cp |
| FilesystemApi | download | GET /api/v1/filesystem/download/{resource_id} | Get Download |
| FilesystemApi | extract | POST /api/v1/filesystem/extract/{resource_id} | Post Extract |
| FilesystemApi | file | GET /api/v1/filesystem/file/{resource_id} | Get File |
| FilesystemApi | head | GET /api/v1/filesystem/head/{resource_id} | Get Head |
| FilesystemApi | ls | GET /api/v1/filesystem/ls/{resource_id} | Get Ls Async |
| FilesystemApi | mkdir | POST /api/v1/filesystem/mkdir/{resource_id} | Post Mkdir |
| FilesystemApi | mv | POST /api/v1/filesystem/mv/{resource_id} | Move Mv |
| FilesystemApi | rm | DELETE /api/v1/filesystem/rm/{resource_id} | Delete Rm |
| FilesystemApi | stat | GET /api/v1/filesystem/stat/{resource_id} | Get Stat |
| FilesystemApi | symlink | POST /api/v1/filesystem/symlink/{resource_id} | Post Symlink |
| FilesystemApi | tail | GET /api/v1/filesystem/tail/{resource_id} | Get Tail |
| FilesystemApi | upload | POST /api/v1/filesystem/upload/{resource_id} | Post Upload |
| FilesystemApi | view | GET /api/v1/filesystem/view/{resource_id} | Get View |
| StatusApi | get_event_by_incident | GET /api/v1/status/incidents/{incident_id}/events/{event_id} | Get a specific event |
| StatusApi | get_events_by_incident | GET /api/v1/status/incidents/{incident_id}/events | Get all events for an incident |
| StatusApi | get_incident | GET /api/v1/status/incidents/{incident_id} | Get a specific incident and its events |
| StatusApi | get_incidents | GET /api/v1/status/incidents | Get all incidents without their events |
| StatusApi | get_resource | GET /api/v1/status/resources/{resource_id} | Get a specific resource |
| StatusApi | get_resources | GET /api/v1/status/resources | Get all resources |
| TaskApi | delete_task | DELETE /api/v1/task/{task_id} | Delete Task |
| TaskApi | get_task | GET /api/v1/task/{task_id} | Get Task |
| TaskApi | get_tasks | GET /api/v1/task | Get Tasks |
Documentation For Models
- AllocationEntry
- AllocationUnit
- Capability
- CompressionType
- Container
- Event
- Facility
- Incident
- IncidentType
- Job
- JobAttributes
- JobSpecInput
- JobSpecOutput
- JobState
- JobStatus
- PostCompressRequest
- PostCopyRequest
- PostExtractRequest
- PostFileSymlinkRequest
- PostMakeDirRequest
- PostMoveRequest
- Problem
- Project
- ProjectAllocation
- PutFileChmodRequest
- PutFileChownRequest
- Resolution
- Resource
- ResourceSpec
- ResourceType
- Site
- Status
- Task
- TaskCommand
- TaskStatus
- TaskSubmitResponse
- UserAllocation
- VolumeMount
Documentation For Authorization
Authentication schemes defined for the API:
HTTPBearer
- Type: Bearer authentication
Author
Metadata
Release files for esnet-iri 1.0.0.post2
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 |
|---|---|---|---|---|
| esnet_iri-1.0.0.post2.tar.gz | 60.6 kB | Without provenance | Details for esnet_iri-1.0.0.post2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| esnet_iri-1.0.0.post2-py3-none-any.whl | Python 3 | none | any | Details for esnet_iri-1.0.0.post2-py3-none-any.whl |
Total release size: 166.7 kB
Release files / esnet_iri-1.0.0.post2.tar.gz
| Download URL | esnet_iri-1.0.0.post2.tar.gz |
|---|---|
| Size | 60.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b4ec04917dbe1bc3f0053c249503b2d909eeae287d702ce14d911a804c9d3983
|
|
BLAKE2b-256 checksum How to use checksums |
4b1352a59ddfb1f74555a6ef903b0fd9e2dcd99ac44e5fa80ab0bdfa2a4f0d02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Release files / esnet_iri-1.0.0.post2-py3-none-any.whl
| Download URL | esnet_iri-1.0.0.post2-py3-none-any.whl |
|---|---|
| Size | 106.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec1cd7fcd7c3499edd9481b8786bf97a9a6253472a1e48e31054c081cbeeb53d
|
|
BLAKE2b-256 checksum How to use checksums |
702adbbb14dab2640bc22e09ce881c6a5062327008ac70b0f9beb4d9c58e9546
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Security for esnet-iri 1.0.0.post2
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.