/nerves_hub_user_api

HTTP Client for interacting with the NervesHub API

Primary LanguageElixirApache License 2.0Apache-2.0

NervesHubUserAPI

CircleCI Hex version

This is a library for interacting with a NervesHub website programmatically. See NervesHubCLI for using it with mix.

Devices do not use this library to connect to a NervesHub server. See NervesHub for the reference client.

Installation

The package can be installed by adding nerves_hub_user_api to your list of dependencies in mix.exs:

def deps do
  [
    {:nerves_hub_user_api, "~> 0.1.0"}
  ]
end

The docs can be found at HexDocs.

Environment variables

NervesHubUserAPI may be configured using environment variables to simplify automation. Environment variables take precedence over configuration. The following variables are available:

  • NERVES_HUB_HOST - NervesHub API endpoint IP address or hostname (defaults to api.nerves-hub.org)
  • NERVES_HUB_PORT - NervesHub API endpoint port (defaults to 443)
  • NERVES_LOG_DISABLE_PROGRESS_BAR - Set to disable the progress bar on file transfers
  • NERVES_HUB_CA_CERTS - The path to a directory containing CA certificates for authenticating NervesHub endpoints. Defaults to nerves-hub.org certificates.

Configuration

NervesHubUserAPI may also be configured in the config.exs. It supports the following keys:

  • host - NervesHub API endpoint address (defaults to api.nerves-hub.org)
  • port - NervesHub API endpoint port (defaults to 443)
  • ca_certs - The path to a directory containing CA certificates for authenticating NervesHub endpoints. Defaults to nerves-hub.org certificates.