1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
5 defmodule Pleroma.HTTP.RequestBuilder do
7 Helper functions for building Tesla requests
10 alias Pleroma.HTTP.Request
18 @spec new(Request.t()) :: Request.t()
19 def new(%Request{} = request \\ %Request{}), do: request
22 Specify the request method when building a request
24 @spec method(Request.t(), Request.method()) :: Request.t()
25 def method(request, m), do: %{request | method: m}
28 Specify the request method when building a request
30 @spec url(Request.t(), Request.url()) :: Request.t()
31 def url(request, u), do: %{request | url: u}
34 Add headers to the request
36 @spec headers(Request.t(), Request.headers()) :: Request.t()
37 def headers(request, headers) do
38 headers_list = maybe_add_user_agent(headers, @mix_env)
40 %{request | headers: headers_list}
44 Add custom, per-request middleware or adapter options to the request
46 @spec opts(Request.t(), keyword()) :: Request.t()
47 def opts(request, options), do: %{request | opts: options}
50 Add optional parameters to the request
52 @spec add_param(Request.t(), atom(), atom(), any()) :: Request.t()
53 def add_param(request, :query, :query, values), do: %{request | query: values}
55 def add_param(request, :body, :body, value), do: %{request | body: value}
57 def add_param(request, :body, key, value) do
59 |> Map.put(:body, Multipart.new())
66 headers: [{"content-type", "application/json"}]
71 def add_param(request, :file, name, path) do
73 |> Map.put(:body, Multipart.new())
74 |> Map.update!(:body, &Multipart.add_file(&1, path, name: name))
77 def add_param(request, :form, name, value) do
78 Map.update(request, :body, %{name => value}, &Map.put(&1, name, value))
81 def add_param(request, location, key, value) do
82 Map.update(request, location, [{key, value}], &(&1 ++ [{key, value}]))
85 def convert_to_keyword(request) do
91 defp maybe_add_user_agent(headers, :test) do
92 with true <- Pleroma.Config.get([:http, :send_user_agent]) do
93 [{"user-agent", Pleroma.Application.user_agent()} | headers]
100 defp maybe_add_user_agent(headers, _),
101 do: [{"user-agent", Pleroma.Application.user_agent()} | headers]