A python wrapper for the ESA mustlink API
Project description
mustlink
A python wrapper for the WebMUST API (mustlink)
This is a simple wrapper in python for the WebMUST API.
Dependencies
The following dependencies must be met:
- python 3
- matplotlib
- pandas
- pyyaml
- requests
Installation
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
URL
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')
Authentication
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"
Example
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mustlink-0.3.1a1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b516be1714240e1b152eb3a4de347851f8acb158b122de492e0d7d7f96ac61de |
|
MD5 | 80fffec84e6249b3cb5901a13a177bc8 |
|
BLAKE2b-256 | 677c92fdb4b72c02b894fa91b14c29a4d3dd17b2039067bc2f4c9bb685436ecc |