A python wrapper for the WebMUST API (mustlink)
This is a simple wrapper in python for the WebMUST API.
The following dependencies must be met:
- python 3
- matplotlib
- pandas
- pyyaml
- requests
pip install mustlink
should do the job, although creating a dedicated environment is recommended (see below).
First, clone this repository. If you are using conda, the dependencies can be installed in a new environment using the provided environment file:
conda env create -f environment.yml
The newly created environment can be activated with:
conda activate mustlink
Otherwise, please make sure the dependencies are installed with your system package manager, or a tool like pip. Use of a conda environment or virtualenv is recommended!
The package can then be installed with:
python setup.py install
The URL for the WebMUST instance in use can be specified when instantiating the Must class. If none is given, a default URL is used. For example:
must = mustlink.Must(url='https://mustinstance.com/mustlink')Access to WebMUST needs authentication. This is controlled by a config file which can be pointed to by the config_file parameter when instantiating the Must class, for example:
must = mustlink.Must(config_file='path_to/config.file')If nothing is specified, a file mustlink.yml is looked for in paths pointed to by the environment variables APPDATA, XDG_CONFIG_HOME or in the .config folder in the user's home directory.
The configuration file should be in YAML format and contain the username and password as follows:
user:
login: "userone"
password: "blah"The Jupyter notebook included with this repository shows an example of how to use the code. Note that not all API functions are wrapped by this library, but only those that are commonly used. To view the notebook, click here.