Skip to main content

CLI client for interfacing with a MASH server.

Project description

Build Status Documentation Status Py Versions License



mash-client provides a command line utility to interface with the MASH server REST API.


To install the package use the following commands as root:

$ zypper ar<distribution>
$ zypper refresh
$ zypper in mash-client


  • Click
  • requests
  • PyYaml
  • PyJWT



Mash user commands

The mash user account is the authentication mechanism of a user against the mash server. It will store information about cloud framework specific account information. The cloud framework account information stored for a given mash user provides the credentials necessary for mash to access a cloud framework account.

mash user create

Create a mash user account.

mash user delete

Delete a mash user account.

mash user info

List information about your user account.

Mash authentication commands

Authentication command are used after a mash user has been created

mash auth login

Login to the mash user account

mash auth logout

Log out of the mash user account

mash auth token

Manage the authentication token

Mash cloud account commands

mash account <framework> add

Add cloud framework account information to the mash user account. Supported <framework>s are azure, ec2, and gce.

mash account <framework> delete

Remove cloud framework account information from the mash user account.

mash account <framework> info

Retrieve cloud framework account information from the mash user account.

mash account <framework> list

List all the framework accounts configured for the mash user.

mash account <framework> update

Update information for a cloud framework account for the mash user.

Mash job commands

mash job <framework> add [PATH_TO_JOB_DOC]

Send a job request to the mash server submitting the specified job document. The job document will be validated and a UUID is returned if the job is accepted.

mash job delete

Delete a job from the mash server. If the job is a one time job parts of the job may already be executed and created artifacts are not cleaned up.

mash job info

Retrieve information about a given job in the pipeline.

mash job list

List all the user's job in the mash pipeline.

All commands and subcommands support the --help option to provide command help. For example

mash account azure add --help


Please submit issues and requests to Github.


Contributions to mash-client are welcome and encouraged. See CONTRIBUTING for info on getting started.


Copyright (c) 2019 SUSE LLC.

Distributed under the terms of GPL-3.0+ license, see LICENSE for details.

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

mash-client-4.0.1.tar.gz (36.2 kB view hashes)

Uploaded source

Built Distribution

mash_client-4.0.1-py3-none-any.whl (50.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page