EXP: cover search via Brave API

lib/brave_search/api.ex

@@ -0,0 +1,87 @@
+defmodule BraveSearch.API do
+  @moduledoc """
+  Interface to the Brave Search API.
+  """
+
+  require Logger
+
+  def search_images(query, opts, config) do
+    params = [q: query, count: Keyword.get(opts, :count, 20)]
+
+    case config
+         |> new_request()
+         |> Req.merge(url: "/res/v1/images/search", params: params)
+         |> get_request() do
+      {:ok, body} ->
+        results =
+          body
+          |> Map.get("results", [])
+          |> Enum.map(fn result ->
+            %{
+              thumbnail_url: get_in(result, ["thumbnail", "src"]),
+              image_url: get_in(result, ["properties", "url"]),
+              title: Map.get(result, "title", ""),
+              source: Map.get(result, "source", "")
+            }
+          end)
+
+        {:ok, results}
+
+      {:error, reason} ->
+        {:error, reason}
+    end
+  end
+
+  def download_image(url, config) do
+    case Req.new(url: url, max_retries: 1, user_agent: config.user_agent)
+         |> Req.Request.merge_options(config.req_options)
+         |> Req.Request.append_request_steps(log_attempt: &log_attempt/1)
+         |> Req.Request.append_response_steps(log_error: &log_error/1)
+         |> get_request() do
+      {:ok, data} -> {:ok, data}
+      {:error, _reason} -> {:error, :download_failed}
+    end
+  end
+
+  defp new_request(config) do
+    Req.new(
+      base_url: "https://api.search.brave.com",
+      max_retries: 1,
+      user_agent: config.user_agent,
+      headers: %{"x-subscription-token" => config.api_key}
+    )
+    |> Req.Request.merge_options(config.req_options)
+    |> Req.Request.append_request_steps(log_attempt: &log_attempt/1)
+    |> Req.Request.append_response_steps(log_error: &log_error/1)
+  end
+
+  defp get_request(request) do
+    case Req.get(request) do
+      {:ok, response} when response.status == 200 ->
+        {:ok, response.body}
+
+      {:ok, response} ->
+        {:error, response.body}
+
+      error ->
+        error
+    end
+  end
+
+  defp log_attempt(request) do
+    url = URI.to_string(request.url)
+    Logger.debug("Fetching data from #{url}")
+    request
+  end
+
+  defp log_error({request, response}) do
+    if response.status in 400..499 or response.status in 500..599 do
+      Logger.error(fn ->
+        url = URI.to_string(request.url)
+        "Failed to fetch data from #{url}, reason: #{inspect(response.body)}"
+      end)
+    end
+
+    {request, response}
+  end
+end

lib/brave_search/config.ex

@@ -0,0 +1,39 @@
+defmodule BraveSearch.Config do
+  @type t :: %__MODULE__{
+          api_key: String.t(),
+          user_agent: String.t(),
+          req_options: Keyword.t()
+        }
+
+  @enforce_keys [:api_key]
+  defstruct api_key: "",
+            user_agent: "change me",
+            req_options: []
+
+  @schema NimbleOptions.new!(
+            api_key: [
+              type: :string,
+              required: true
+            ],
+            user_agent: [
+              type: :string,
+              required: false,
+              default: "change me"
+            ],
+            req_options: [
+              type: :keyword_list,
+              required: false,
+              default: []
+            ]
+          )
+
+  @doc NimbleOptions.docs(@schema)
+  @spec resolve(Application.app()) :: t | no_return
+  def resolve(otp_app) do
+    app_config =
+      Application.get_env(otp_app, BraveSearch)
+      |> NimbleOptions.validate!(@schema)
+
+    struct(__MODULE__, app_config)
+  end
+end