~jiglesias/azufre

#Table of Contents

Azufre: A fennel wrapper for az cli.

#Azufre: A fennel wrapper for az cli.

#Requisites

This library just wraps the az command line client, making direct system calls to it. In order to use it, you'll need to have properly installed and set up the az command line client. Check out the documetation.

#Features

While you are wrapped in azufre, you'll be:
- Using your favorite lang
- in a repl and data driven way
- from the comfort of your favorite text editor.
It's tested!
There are examples!

#Usage

#Getting help

Running the following should give you the az help page.

(local azufre-client (require :azufre))
(local azufre azufre-client.azufre)
(azufre [] :h)

Wondering why do we need that ugly empty list? There you fill in your az subgroups and command.

(azufre [:storage] :h)

It's not like you need to call just az often, and if asking for help you'll need to use some subgroup soon, so better put the empty list now.

#Running commands

Follow the help or documentation and fill in you subgroups and command list. Easy.

(azufre [:storage :account :list])

The az json output is returned parsed into a table.

If you need to pass parameters to your call, pass a table with {:param "value"} to azufre

(azufre [:storage :account :list]
        {:query "[].name"})

#Further Usage

Check out the examples. utlils.fnl queries storage accounts and their keys. create-containers.fnl and delete-containers.fnl use those accounts and keys to manipulate storage containers.

#Known issues

If instead of a table, :h or :help, you pass something else as last argument, you'll probably break things.

If you need to use a call with parameters that don't have an associated value, you can do this, which is clunky, but works:

(azufre [:storage :fake :subgroup] {:query "[].name" :verbose ""})

All errors are fatal. Is this a feature or a bug?

refs

clone