oasislmf.platform_api.client

Classes

ApiEndpoint	Used to Implement the default requests common to all Oasis API
JsonEndpoint	Used for JSON data End points.
FileEndpoint	File Resources Endpoint for Upload / Downloading
API_models	Used to Implement the default requests common to all Oasis API
API_portfolios	Used to Implement the default requests common to all Oasis API
API_analyses	Used to Implement the default requests common to all Oasis API
APIClient

Module Contents

class oasislmf.platform_api.client.ApiEndpoint(session, url_endpoint, logger=None)

Bases: object

Used to Implement the default requests common to all Oasis API End points.

logger

session

url_endpoint = ''

create(data)

get(ID=None)

delete(ID)

search(metadata={})

class oasislmf.platform_api.client.JsonEndpoint(session, url_endpoint, url_resource, logger=None)

Bases: object

Used for JSON data End points.

logger

session

url_endpoint = ''

url_resource = ''

get(ID)

post(ID, data)

delete(ID)

download(ID, file_path, overwrite=True)

class oasislmf.platform_api.client.FileEndpoint(session, url_endpoint, url_resource, logger=None)

Bases: object

File Resources Endpoint for Upload / Downloading

logger

session

url_endpoint = ''

url_resource = ''

upload(ID, file_path, content_type=None)

upload_byte(ID, file_bytes, filename, content_type=None)

download(ID, file_path, overwrite=True, chuck_size=1024)

get(ID)

get_dataframe(ID)

Return file endpoint as dict of pandas Dataframes:

either ‘application/gzip’: search and extract all csv or ‘text/csv’: return as dataframe

post(ID, data_object, content_type='application/json')

post_dataframe(ID, data_frame)

delete(ID)

class oasislmf.platform_api.client.API_models(session, url_endpoint)

Bases: ApiEndpoint

Used to Implement the default requests common to all Oasis API End points.

resource_file

settings

versions

chunking_configuration

scaling_configuration

data_files(ID)

create(supplier_id, model_id, version_id, data_files=[])

update(ID, supplier_id, model_id, version_id, data_files=[])

class oasislmf.platform_api.client.API_portfolios(session, url_endpoint)

Bases: ApiEndpoint

Used to Implement the default requests common to all Oasis API End points.

accounts_file

location_file

reinsurance_info_file

reinsurance_scope_file

storage_links

create(name)

update(ID, name)

create_analyses(ID, name, model_id)

Create new analyses from Exisiting portfolio

class oasislmf.platform_api.client.API_analyses(session, url_endpoint)

Bases: ApiEndpoint

Used to Implement the default requests common to all Oasis API End points.

lookup_errors_file

lookup_success_file

lookup_validation_file

summary_levels_file

input_file

input_generation_traceback_file

output_file

run_traceback_file

run_log_file

settings_file

settings

create(name, portfolio_id, model_id, data_files=[])

update(ID, name, portfolio_id, model_id, data_files=[])

status(ID)

generate(ID)

run(ID)

generate_and_run(ID)

cancel_analysis_run(ID)

cancel_generate_inputs(ID)

cancel(ID)

copy(ID)

data_files(ID)

storage_links(ID)

sub_task_list(ID)

class oasislmf.platform_api.client.APIClient(api_url='http://localhost:8000', api_ver='V2', username='admin', password='password', timeout=25, logger=None, **kwargs)

Bases: object

logger

api

api_ver = ''

models

portfolios

analyses

data_files

task_status

oed_peril_codes()

server_info()

healthcheck()

upload_portfolio_file(portfolio_id, portfolio_file, upload_data)

Upload a portfolio file using the API. Supports absolute filepaths or bytestreams.

If uploading a byte stream upload_data is a dict with the keys name which is a str containing the filename and bytes containing the byte stream of the file data. For example:

```python upload_portfolio_file(<portfolio_id>, “location_file”,

{‘bytes’: <byte_stream>, ‘name’: <filename>})

```

Parameters :param portfolio_id: Portfolio {id} from :type portfolio_id: int

Parameters:

• portfolio_file – The name of the portfolio file to update. One of the following options location_file, accounts_file, reinsurance_info_file or reinsurance_scope_file.

• upload_data – The file to upload through the api. This should be

a str if it is a filepath or a dict if it is a byte stream with the keys name and bytes corresponding to the filename and bytestream respectively. :type upload_data: [str, dict] ———-

upload_inputs(portfolio_name=None, portfolio_id=None, location_fp=None, accounts_fp=None, ri_info_fp=None, ri_scope_fp=None)

upload_settings(analyses_id, settings)

Upload an analyses run settings to an API

Method to post JSON data or upload a settings file containing JSON data

Parameters

param analyses_id:

Analyses settings {id} from, v1/analyses/{id}/settings

type analyses_id:

int

param settings:

Either a valid filepath or dictionary holding the settings

type settings:

[str, dict]

return:

:rtype None

create_analysis(portfolio_id, model_id, analysis_name=None, analysis_settings_fp=None)

run_generate(analysis_id, poll_interval=5)

Generates the inputs for the analysis based on the portfolio. The analysis must have one of the following statuses, NEW, INPUTS_GENERATION_ERROR, INPUTS_GENERATION_CANCELLED, READY, RUN_COMPLETED, RUN_CANCELLED or RUN_ERROR.

run_analysis(analysis_id, analysis_settings_fp=None, poll_interval=5)

Runs all the analysis. The analysis must have one of the following statuses, NEW, RUN_COMPLETED, RUN_CANCELLED or RUN_ERROR

download_output(analysis_id, download_path='', filename=None, clean_up=False, overwrite=True)

cancel_generate(analysis_id)

Cancels a currently inputs generation. The analysis status must be GENERATING_INPUTS

cancel_analysis(analysis_id)

Cancels a currently running analysis. The analysis must have one of the following statuses, PENDING or STARTED