Skip to main content

Python client to get emulation environment recommendations from the EaaSI UVI.

Project description



Python client for getting emulation environment recommendations from the EaaSI software platform's Universal Virtual Interactor, or UVI.


Command-line interface

After installing package with pip, use get-eaasi-recommendations:

Usage: get-eaasi-recommendations [OPTIONS]

  Get emulation environment suggestions from EaaSI API.

  --eaasi-url TEXT  EaaSI host URL.  [required]
  --data-url TEXT   Data URL for content to characterize.  [required]
  --data-type TEXT  Data type. Allowed values: "zip", "tar", "bagit+zip",
                    "bagit+tar"  [default: zip]
  --help            Show this message and exit.

Python library

The eaasi_uvi_client Python library consists mainly of the EaaSIUVIClient class, which has the following public methods:

  • EaaSIUVIClient.get_recommendations(): returns dictionary representation of the JSON returned by EaaSI's EnvironmentProposer API endpoints; raises requests.ConnectionError or eaasi_uvi_client.ResultNotFound on error.
  • EaaSIUVIClient.parse_suggested_environments(): returns list of dictionaries with suggested emulation environments from JSON returned by EaaSI's EnvironmentProposer API endpoints; raises eaasi_uvi_client.ResultNotFound if get_recommendations() has not yet been called.

See cli/ for an implementation example.


Install eaasi_uvi_client package

eaasi-uvi-client requires Python 3.6+.

Via PyPI

pip install eaasi-uvi-client


Download this repo:

git clone

Change into the cloned directory and install:

cd eaasi-uvi-client/
pip install .



For development, it may be useful to install eaasi-uvi-client with pip install -e ., which will apply changes made to the source code immediately.

Publishing to PyPI

This repository contains a Makefile with commands to aid in building packages and publishing to [PyPI][pypi].

To check that the package is valid:

make package-check

To upload the package to PyPI (this requires PyPI credentials and being listed as a collaborator on the auditmatica project):

make package-upload

To clean up package distribution files:

make clean

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eaasi-uvi-client-0.1.0.tar.gz (4.4 kB view hashes)

Uploaded source

Built Distribution

eaasi_uvi_client-0.1.0-py2.py3-none-any.whl (9.3 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page