Produces an archive of the package artifact which can be fetched when calling nerves.artifact.get.

Specs

base_dir() :: String.t()

Get the base dir for where an artifact for a package should be stored.

The base dir for an artifact will point to the NERVES_ARTIFACTS_DIR or if undefined, ~/.nerves/artifacts

Specs

build(Nerves.Package.t(), Nerves.Package.t()) :: :ok

Builds the package and produces an See Nerves.Artifact for more information.

Get the path to where the artifact is built

Get the path where the global artifact will be linked to. This path is typically a location within build_path, but can be vary on different build platforms.

Produce a base16 encoded checksum for the package from the list of files and expanded folders listed in the checksum config key.

Specs

clean(Nerves.Package.t()) :: :ok | {:error, term()}

Cleans the artifacts for the package build_runners of all packages.

Specs

dir(Nerves.Package.t()) :: String.t()

The full path to the artifact.

Get the artifact download name

Get the path to where the artifact archive is downloaded to.

Specs

env_var(Nerves.Package.t()) :: String.t()

Determine the environment variable which would be set to override the path.

Specs

env_var?(Nerves.Package.t()) :: boolean()

Check to see if the artifact path is being set from the system env.

Expands the sites helpers from artifact_sites in the nerves_package config.

Artifact sites can pass options as a third parameter for adding headers or query string parameters. For example, if you are trying to resolve artifacts hosted in a private Github repo, use :github_api and pass a user, tag, and personal access token into the sites helper:

{:github_api, "owner/repo", username: "skroob", token: "1234567", tag: "v0.1.0"}

Or pass query parameters for the URL:

{:prefix, "https://my-organization.com", query_params: %{"id" => "1234567", "token" => "abcd"}}

You can also use this to add an authorization header for files behind basic auth.

{:prefix, "http://my-organization.com/", headers: [{"Authorization", "Basic " <> System.get_env("BASIC_AUTH")}}]}

Specs

ext(Nerves.Package.t()) :: String.t()

Determines the extension for an artifact based off its type. Toolchains use xz compression.

Get the host_tuple for the package. Toolchains are specifically build to run on a host for a target. Other packages are host agnostic for now. They are marked as portable.

Specs

name(Nerves.Package.t()) :: String.t()

Get the artifact name

Specs

stale?(Nerves.Package.t()) :: boolean()

Determines if the artifact for a package is stale and needs to be rebuilt.