Migas Client

A Python package to communicate with a migas server.

About

migas (mee-gahs) is a Python client to facilitate communication with a migas server.

Usage

To start communicating with a migas server, the client must first be setup.

import migas; migas.setup()

By default, migas-py will communicate with the official hosted migas server. However it can easily be configured to communicate with any hosted migas server.

import migas; migas.setup(endpoint='your-endpoint')

setup() will populate the interal configuration, which is done at the process level.

API

migas includes the following functions to communicate with the telemetry server:

migas.add_breadcrumb()

---

Send a breadcrumb with usage information to the server.

Mandatory

• project - application name
• project_version - application version

Optional

• language (auto-detected)
• language_version (auto-detected)
• process:
  • status
  • status_desc
  • error_type
  • error_desc
• context:
  • user_id (auto-generated)
  • session_id
  • user_type
  • platform (auto-detected)
  • container (auto-detected)
  • is_ci (auto-detected)

add_breadcrumb example

>>> add_breadcrumb('nipreps/migas-py', '0.0.1', status='R', status_desc='Finished long step')
{'success': True}

migas.check_project()

---

Check a project version against later developments.

Mandatory

• project
• project_version

check_project example

>>> check_project('nipreps/migas-py', '0.0.1')
{'success': True, 'flagged': False, 'latest': '0.4.0', 'message': ''}

migas.get_usage()

---

Check number of uses a project has received from a start date, and optionally an end date. If no end date is specified, the current datetime is used.

get_usage example

>>> get_usage('nipreps/migas-py', '2022-07-01')
{'hits': 7, 'message': '', 'unique': False, 'success': True}

migas.track_exit()

---

Register an exit function to send a final ping upon termination of the Python interpretter. Useful when monitoring a process that may preemptively error. The inputs are equivalent to add_breadcrumb()

User Control

migas can controlled by the following environmental variables:

Envvar	Description	Value	Default
MIGAS_OPTOUT	Disable telemetry collection	Any	None
MIGAS_TIMEOUT	Seconds to wait for server response	Number >= 0	5
MIGAS_LOG_LEVEL	Logger level	Logging levels	WARNING

Configuration

The internal configuration stores the following telemetry information:

• language and language version
• operating system
• run within a container
• run from continuous integration