Skip to main content

amsc-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.22.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://es.net/

Requirements.

Python 3.10+

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 amsc_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 amsc_iri

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import amsc_iri
from amsc_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 = amsc_iri.Configuration(
    host = "https://iri-dev.ppg.es.net"
)



# Enter a context with an instance of the API client
with amsc_iri.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = amsc_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_compute_resources GET /api/v1/compute/resources Get Resources
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 get_filesystem_resources GET /api/v1/filesystem/resources Get Resources
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/events/{event_id} Get a specific event
StatusApi get_events_by_incident GET /api/v1/status/events Get all events
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

Documentation For Authorization

Authentication schemes defined for the API:

HTTPBearer

  • Type: Bearer authentication

Author

Metadata

Release files for amsc-iri 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amsc-iri 1.2.0
File Size Uploaded Provenance Actions
amsc_iri-1.2.0.tar.gz 61.9 kB Without provenance Details for amsc_iri-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for amsc-iri 1.2.0
File Interpreter ABI Platform Actions
amsc_iri-1.2.0-py3-none-any.whl Python 3 none any Details for amsc_iri-1.2.0-py3-none-any.whl

Total release size: 167.7 kB

Release files / amsc_iri-1.2.0.tar.gz

Download URL amsc_iri-1.2.0.tar.gz
Size 61.9 kB
Tags Source
SHA-256 checksum
How to use checksums
02a8b2d95f7e550eff07b84738e3bb5ab7cc1949ceb80e6d70309c5e5407ff2c
BLAKE2b-256 checksum
How to use checksums
f879672b778b4f6e5555348003443c619ed770948100e646819e26ed6716704a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / amsc_iri-1.2.0-py3-none-any.whl

Download URL amsc_iri-1.2.0-py3-none-any.whl
Size 105.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
310ba3cc22ddb0fa19a8d4f3da416d992e3c488d08435d84cf53a077c467fb40
BLAKE2b-256 checksum
How to use checksums
8143fc55696dc125bdebd8d38f064c6f5cccc762c9332845378997131aa38d1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Security for amsc-iri 1.2.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.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page