mangocli - A utility for querying Mango's REST API
Since Mango 3.3 introduces the use of JWT tokens for authentication, I decided that using the REST API is a bit more appealing. So I decided to write a little utility to make it easier to query.
You can review the code and download it here: https://github.com/iA3io/mangocli
This is an open source tool and you are free to use and modify it however you see fit. I hope you find it helpful.
More information is in the README in the Git repo but here is a snippet:
Query all data points
$ mangocli -a ./jwt-token data-points
The default HTTP action is GET. The default host is http://localhost:8080.
Create a new data point
$ mangocli -a ./jwt-token -d @./new-point.json data-points
-doption is just the
the argument to be parsed as a file. Using the
-doption changes the default
HTTP action to POST.
Enable and restart a data point
$ mangocli -a ./jwt-token -u enabled=true -u restart=true PUT data-points/enable-disable/DP_XID
-uoption defines a URL query parameter.
Delete a data point.
$ mangocli -a ./jwt-token DELETE data-points/DP_XID
Usage: mangocli [OPTION...] [ACTION] PATH Options: -h HOST HOST is the domain name or IP address of the Mango server. Can be set using the environment variable MANGOCLI_HOST. Defaults to 'http://localhost:8080' if not specified. A HOST without a specified protocol will default to HTTPS. -a AUTH AUTH is the JWT token or the path to a file containing it. Can be set using the environment variable MANGOCLI_AUTH -d DATA DATA to include in the body of a request. Can be specified multiple times. Use `-d @-' to read from stdin or `-d @filename' to read from a file. Equivalent to `curl --data="DATA"'. Changes default ACTION to POST. -u PARAM PARAM is URL encoded data. Can be specified multiple times. Using this option will pass all data as URL parameters. Use `-u @-' to read from stdin or `-u @file' to read from a file. Equivalent to `curl --get --data-urlencode="PARAM"'. -C CURL_OPTS CURL_OPTS is a space separated list of additional options to pass to curl. Can be specified multiple times. -V VERSION VERSION is the REST API version number: 1 or 2. Can be set using the environment variable MANGOCLI_VERSION. Defaults to v2. -c Compact JSON output. Removes all whitespace. -v Increase verbosity. Once for info, twice for debug output. -q Quiet mode. Suppresses all error, info and debug messages. Overrides any `-v' options. Arguments: ACTION The HTTP action: GET, POST, PUT, DELETE Defaults to GET. PATH The path or route for the request
phildunlap last edited by
Thanks for sharing! That's really cool!