akkoma/lib/pleroma/http.ex

87 lines
2.7 KiB
Elixir
Raw Normal View History

# Pleroma: A lightweight social networking server
# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
# SPDX-License-Identifier: AGPL-3.0-only
defmodule Pleroma.HTTP do
2018-12-04 14:51:49 +00:00
@moduledoc """
2020-02-11 07:12:57 +00:00
Wrapper for `Tesla.request/2`.
2018-12-04 14:51:49 +00:00
"""
alias Pleroma.HTTP.AdapterHelper
2020-02-11 07:12:57 +00:00
alias Pleroma.HTTP.Request
alias Pleroma.HTTP.RequestBuilder, as: Builder
2020-02-11 07:12:57 +00:00
alias Tesla.Client
alias Tesla.Env
require Logger
@type t :: __MODULE__
@type method() :: :get | :post | :put | :delete | :head
2018-12-04 14:48:55 +00:00
@doc """
2020-02-11 07:12:57 +00:00
Performs GET request.
See `Pleroma.HTTP.request/5`
"""
@spec get(Request.url() | nil, Request.headers(), keyword()) ::
nil | {:ok, Env.t()} | {:error, any()}
def get(url, headers \\ [], options \\ [])
def get(nil, _, _), do: nil
def get(url, headers, options), do: request(:get, url, nil, headers, options)
2020-02-11 07:12:57 +00:00
@spec head(Request.url(), Request.headers(), keyword()) :: {:ok, Env.t()} | {:error, any()}
def head(url, headers \\ [], options \\ []), do: request(:head, url, nil, headers, options)
2020-02-11 07:12:57 +00:00
@doc """
Performs POST request.
See `Pleroma.HTTP.request/5`
"""
@spec post(Request.url(), String.t(), Request.headers(), keyword()) ::
{:ok, Env.t()} | {:error, any()}
def post(url, body, headers \\ [], options \\ []),
do: request(:post, url, body, headers, options)
@doc """
Builds and performs http request.
2018-12-04 14:51:49 +00:00
# Arguments:
`method` - :get, :post, :put, :delete, :head
2020-02-11 07:12:57 +00:00
`url` - full url
`body` - request body
2018-12-04 14:51:49 +00:00
`headers` - a keyworld list of headers, e.g. `[{"content-type", "text/plain"}]`
`options` - custom, per-request middleware or adapter options
# Returns:
`{:ok, %Tesla.Env{}}` or `{:error, error}`
2018-12-04 14:48:55 +00:00
"""
@spec request(method(), Request.url(), String.t(), Request.headers(), keyword()) ::
2020-02-11 07:12:57 +00:00
{:ok, Env.t()} | {:error, any()}
def request(method, url, body, headers, options) when is_binary(url) do
2020-03-03 12:11:48 +00:00
uri = URI.parse(url)
adapter_opts = AdapterHelper.options(uri, options || [])
2020-03-03 12:11:48 +00:00
options = put_in(options[:adapter], adapter_opts)
params = options[:params] || []
request = build_request(method, headers, options, url, body, params)
2022-11-12 15:11:38 +00:00
client = Tesla.client([Tesla.Middleware.FollowRedirects, Tesla.Middleware.Telemetry])
request(client, request)
end
@spec request(Client.t(), keyword()) :: {:ok, Env.t()} | {:error, any()}
def request(client, request), do: Tesla.request(client, request)
2020-02-11 07:12:57 +00:00
defp build_request(method, headers, options, url, body, params) do
Builder.new()
|> Builder.method(method)
|> Builder.headers(headers)
|> Builder.opts(options)
|> Builder.url(url)
|> Builder.add_param(:body, :body, body)
|> Builder.add_param(:query, :query, params)
|> Builder.convert_to_keyword()
end
end