Skip to main content

Python client library to connect to the VDX Core API

Project description

PyPI version Downloads

VDX Helper

This repository provides a wrapper for every call made to VDX Core Api.

How it works

This helper first needs to be authorized by wielding valid token from the authentication server, then use that token for further requests as long as it has not expired.

Each method also allows one to include their own custom mappers, enabling the method to return the result in the format the user wishes.


  • Python Poetry
  • Docker + Docker-compose



Required parameters:

  • api_url: The url leading to Core API server
  • auth_url: The url leading to authentication server
  • client_secret: The authentication secret
  • client_id: The ID of the client / partner
vdx_helper = VDXHelper(api_url='', auth_url='', client_secret=secret, client_id=client_id)

Mapper example

A mapper will receive a json-formatted parameter as their input. The following example mapper will add a field

def example_mapper(json_file):
    returned_json = copy.deepcopy(json_file)
    returned_json['additional_field'] = 'additional_value'
    return returned_json

Usage example

vdx_helper.upload_file(file=the_file_to_upload, mapper=example_mapper)

Running the tests

You can run the tests with poetry if you like. You can also obtain the code coverage.

poetry run pytest --cov=vdx_helper
  • Mypy:
poetry run mypy --config-file conf/mypy.ini vdx_helper
  • Coverage:
poetry run coverage run --source=vdx_helper -m pytest
poetry run coverage report
  • Tox:
tox -p

Run the test locally with docker-compose step-by-step

  1. Spin up the docker-containers
docker-compose up -d
  1. Run the tests via the vdx-helper docker container
docker-compose run vdx-helper pytest tests


To build the documentation locally:

cd docs
make html

The build files can be found in docs/build. Open the generated index.html file in the html folder, and you can now navigate the documentation. Repeat the above command and refresh your browser every time you update the documentation. All source files are in docs/source, with vdx_helper containing the documentation generated from docstrings.


  • Tiago Santos - Initial work - Vizidox
  • Joana Teixeira - Corrections and improvements - Vizidox
  • Rita Mariquitos - Corrections and improvements - Vizidox

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

vdx_helper-3.2.4.tar.gz (13.4 kB view hashes)

Uploaded source

Built Distribution

vdx_helper-3.2.4-py3-none-any.whl (14.4 kB view hashes)

Uploaded 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