api-tools

A set of tools helpful in interacting with the Manetu Control Plane

Getting started

Prerequisites

• Install babashka

Install api-tools into your path

make install

Set the following environment variables

• MANETU_TOKEN: A personal access token to the Manetu Platform
• MANETU_GRAPHQL_URL: A URL pointing to the Manetu Platform instance, e.g. https://test.manetu.io/graphql

Usage

manetu-graphql-cli

$ manetu-graphql-cli -h
Usage: graphcli [options]

Options:
  -h, --help
  -m, --mutation
  -l, --log-level LEVEL  :info  Select the output-types from [trace, debug, info, warn, error, fatal, report]

Generally speaking, the tool accepts graphql queries in district0x EDN format on stdin and outputs JSON results on stdout

Examples

Query

$ echo '[:search {:term "Ellen"}  [:name :email]]' | manetu-graphql-cli | jq .data.search
[
  {
    "name": "Ellen Cabane",
    "email": "[email protected]"
  }
]

Mutation

Add the -m switch

$ echo '[:create_iam_group {:name "test" :description "test" :mrn_roles ["mrn:iam:manetu.io:role:admin"]}] ' | manetu-graphql-cli -m | jq .data
{
  "create_iam_group": "mrn:iam:piedpiper:group:ca3bbda6-9d97-46fb-94df-b9be1477dc4e"
}

manetu-sparql-cli

$ manetu-sparql-cli -h
Usage: manetu-sparql-cli [options]

Options:
  -h, --help
      --update VAULTLABEL
  -s, --show                      Display the SPARQL query
  -l, --log-level LEVEL    :info  Select the output-types from [trace, debug, info, warn, error, fatal, report]
  -o, --output TYPE        :json  Select the output-types from [table, json]

Examples

$ cat <<EOF | ./manetu-sparql-cli
> PREFIX person: <http://www.w3.org/ns/person#>
>
> SELECT ?a ?v
>
> WHERE {
>     ?p person:Email "[email protected]" .
>     ?p ?a ?v .
> }
> EOF
|--------------------------------------+----------------------------------------------|
|                  ?v                  |                      ?a                      |
|--------------------------------------+----------------------------------------------|
| <http://www.w3.org/ns/person#Person> | <http://www.w3.org/2000/01/rdf-schema#Class> |
| [email protected]               | <http://www.w3.org/ns/person#Email>          |
| Karel                                | <http://www.w3.org/ns/person#FirstName>      |
| Rangeley                             | <http://www.w3.org/ns/person#LastName>       |
|--------------------------------------+----------------------------------------------|