Rocksky.Apikey.Builder (Rocksky v0.1.0)

Builder for app.rocksky.apikey.createApikey.

Example

alias Rocksky.Apikey.Builder, as: Apikey

Apikey.new(name: "my-bot")
|> Apikey.description("scrobbles from my home server")
|> Apikey.submit(client)

Summary

Types

t()

Functions

description(builder, value)

Set description on the builder.

name(builder, value)

Set name on the builder.

new(attrs \\ [])

Build a new request from a keyword list or map of fields.

put(builder, attrs)

Batch-set fields. attrs is a keyword list or map. Accepts the same key forms as new/1.

submit(builder, client)

Submit the builder. Returns {:ok, body} on success or {:error, %Rocksky.Error{}} on failure.

to_body(builder)

Return the JSON body that would be sent (nil fields stripped).

Types

t()

@type t() :: %Rocksky.Apikey.Builder{description: term(), name: term()}

Functions

description(builder, value)

Set description on the builder.

name(builder, value)

Set name on the builder.

new(attrs \\ [])

@spec new(keyword() | map()) :: t()

Build a new request from a keyword list or map of fields.

Accepts either the canonical lexicon key (:mbId) or its snake-cased equivalent (:mb_id). Unknown keys raise.

put(builder, attrs)

@spec put(t(), keyword() | map()) :: t()

Batch-set fields. attrs is a keyword list or map. Accepts the same key forms as new/1.

submit(builder, client)

@spec submit(t(), Rocksky.Client.t()) :: {:ok, term()} | {:error, Rocksky.Error.t()}

Submit the builder. Returns {:ok, body} on success or {:error, %Rocksky.Error{}} on failure.

Returns {:error, %Rocksky.Error{reason: :missing_fields}} without making a network call when any required field is nil.

to_body(builder)

@spec to_body(t()) :: map()

Return the JSON body that would be sent (nil fields stripped).