Module hex_core
hex_core entrypoint module.
Description
Config
Most functions in the hex_core API takes a configuration. The configuration sets things like HTTP client to use, and API and repository URL. Some of these configuration options will likely be static for your application and some may change depending on the function you call.
Options
api_key
- Authentication key used when accessing the HTTP API.api_organization
- Name of the organization endpoint in the API, this should for example be set when accessing key for a specific organization.api_repository
- Name of the repository endpoint in the API, this should for example be set when accessing packages from a specific repository.api_url
- URL to the HTTP API (default:https://hex.pm/api
).http_adapter
- Callback module used for HTTP requests, seehex_http
(default:hex_http_httpc
).http_etag
- Sets theif-none-match
HTTP header with the given value to do a conditional HTTP request.http_adapter_config
- Configuration to pass to the HTTP adapter.http_user_agent_fragment
- Will be appended to theuser-agent
HTTP header (default:(httpc)
).repo_key
- Authentication key used when accessing the repository.repo_name
- Name of the repository, used for verifying the repository signature authenticity (default:hexpm
).repo_public_key
- Public key used to verify the repository signature (defaults to hexpm public keyhttps://hex.pm/docs/public_keys
).repo_url
- URL to the repository (default:https://repo.hex.pm
).repo_organization
- Name of the organization repository, appends/repos/:name
to the repository URL and overrides therepo_name
option.repo_verify
- Iftrue
will verify the repository signature (default:true
).repo_verify_origin
- Iftrue
will verify the repository signature origin, requires protobuf messages as of hex_core v0.4.0 (default:true
).
Data Types
config()
config() = #{api_key => binary() | undefined, api_organization => binary() | undefined, api_repository => binary() | undefined, api_url => binary(), http_adapter => module(), http_etag => binary() | undefined, http_adapter_config => map(), http_headers => map(), http_user_agent_fragment => binary(), repo_key => binary() | undefined, repo_name => binary(), repo_public_key => binary(), repo_url => binary(), repo_organization => binary() | undefined, repo_verify => boolean(), repo_verify_origin => boolean()}
Function Index
default_config/0 |
Function Details
default_config/0
default_config() -> config()