Represents environment-specific %URI{} struct. The struct has been used internally for building a request URL by default.

The state of Tirexs.ENV is to made up a main %URI{} struct over System.get_env("ES_URI") or Application.get_env(:tirexs, :uri).

To setup your own uri to elasticsearch node you’re able to useone of these available options:

Environment variable:

ES_URI=http://127.0.0.1:9200

Over Mix.Config.config/2:

config :tirexs, :uri, %URI{ authority: "127.0.0.1:9200", scheme: "http", host: "127.0.0.1", port: 9200 }
config :tirexs, :uri, [ authority: "127.0.0.1:9200", scheme: "http", host: "127.0.0.1", port: 9200 ]
config :tirexs, :uri, "http://127.0.0.1:9200"

Over Application.put_env/3:

put_env :tirexs, :uri, %URI{ authority: "127.0.0.1:9200", scheme: "http", host: "127.0.0.1", port: 9200 }
put_env :tirexs, :uri, [ authority: "127.0.0.1:9200", scheme: "http", host: "127.0.0.1", port: 9200 ]
put_env :tirexs, :uri, "http://127.0.0.1:9200"

There is also an option to specify the %URI{} over parameter. For instance:

iex> Tirexs.HTTP.url("/articles/document/1")
"http://127.0.0.1:9200/articles/document/1"

iex> Tirexs.HTTP.url("/articles/document/1", %URI{ host: "example.com" })
"http://example.com:9200/articles/document/1"

Hint: this works over merging between parameter and environment specific %URI{} struct. That’s why the port number still is 9200.

The same interface is available across all of Tirexs functions.