1 defmodule Pleroma.HTTP.RequestBuilder do
3 Helper functions for building Tesla requests
7 Specify the request method when building a request
11 - request (Map) - Collected request options
12 - m (atom) - Request method
18 @spec method(map(), atom) :: map()
19 def method(request, m) do
20 Map.put_new(request, :method, m)
24 Specify the request method when building a request
28 - request (Map) - Collected request options
29 - u (String) - Request URL
35 @spec url(map(), String.t()) :: map()
36 def url(request, u) do
37 Map.put_new(request, :url, u)
41 Add headers to the request
43 @spec headers(map(), list(tuple)) :: map()
44 def headers(request, h) do
45 Map.put_new(request, :headers, h)
49 Add custom, per-request middleware or adapter options to the request
51 @spec opts(map(), Keyword.t()) :: map()
52 def opts(request, options) do
53 Map.put_new(request, :opts, options)
57 Add optional parameters to the request
61 - request (Map) - Collected request options
62 - definitions (Map) - Map of parameter name to parameter location.
63 - options (KeywordList) - The provided optional parameters
69 @spec add_optional_params(map(), %{optional(atom) => atom}, keyword()) :: map()
70 def add_optional_params(request, _, []), do: request
72 def add_optional_params(request, definitions, [{key, value} | tail]) do
74 %{^key => location} ->
76 |> add_param(location, key, value)
77 |> add_optional_params(definitions, tail)
80 add_optional_params(request, definitions, tail)
85 Add optional parameters to the request
89 - request (Map) - Collected request options
90 - location (atom) - Where to put the parameter
91 - key (atom) - The name of the parameter
92 - value (any) - The value of the parameter
98 @spec add_param(map(), atom, atom, any()) :: map()
99 def add_param(request, :body, :body, value), do: Map.put(request, :body, value)
101 def add_param(request, :body, key, value) do
103 |> Map.put_new_lazy(:body, &Tesla.Multipart.new/0)
106 &Tesla.Multipart.add_field(&1, key, Poison.encode!(value),
107 headers: [{:"Content-Type", "application/json"}]
112 def add_param(request, :file, name, path) do
114 |> Map.put_new_lazy(:body, &Tesla.Multipart.new/0)
115 |> Map.update!(:body, &Tesla.Multipart.add_file(&1, path, name: name))
118 def add_param(request, :form, name, value) do
120 |> Map.update(:body, %{name => value}, &Map.put(&1, name, value))
123 def add_param(request, location, key, value) do
124 Map.update(request, location, [{key, value}], &(&1 ++ [{key, value}]))