No OneTemporary
Actions

Size

21 KB

Referenced Files

None

Subscribers

None

View Options

	diff --git a/lib/tesla.ex b/lib/tesla.ex
	index 8a566c1..f6f9e67 100644
	--- a/lib/tesla.ex
	+++ b/lib/tesla.ex
	@@ -1,544 +1,546 @@
	defmodule Tesla.Error do
	defexception message: "", reason: nil
	end

	defmodule Tesla.Env do
	@type client :: Tesla.Client.t() \| (t, stack -> t)
	@type method :: :head \| :get \| :delete \| :trace \| :options \| :post \| :put \| :patch
	@type url :: binary
	@type param :: binary \| [{binary \| atom, param}]
	@type query :: [{binary \| atom, param}]
	@type headers :: %{binary => binary}
	#
	@type body :: any
	@type status :: integer
	@type opts :: [any]
	@type __module__ :: atom
	@type __client__ :: function

	@type stack :: [{atom, atom, any} \| {atom, atom} \| {:fn, (t -> t)} \| {:fn, (t, stack -> t)}]

	@type t :: %__MODULE__{
	method: method,
	query: query,
	url: url,
	headers: headers,
	body: body,
	status: status,
	opts: opts,
	__module__: __module__,
	__client__: __client__
	}

	defstruct method: nil,
	url: "",
	query: [],
	headers: %{},
	body: nil,
	status: nil,
	opts: [],
	__module__: nil,
	__client__: nil
	end

	defmodule Tesla.Client do
	@type t :: %__MODULE__{
	fun: (Tesla.Env.t(), Tesla.Env.stack() -> Tesla.Env.t()) \| nil,
	pre: Tesla.Env.stack(),
	post: Tesla.Env.stack()
	}
	defstruct fun: nil,
	pre: [],
	post: []
	end

	defmodule Tesla.Middleware do
	@callback call(env :: Tesla.Env.t(), next :: Tesla.Env.stack(), options :: any) :: Tesla.Env.t()
	end

	defmodule Tesla.Builder do
	@http_verbs ~w(head get delete trace options post put patch)a

	defmacro __using__(opts \\ []) do
	opts = Macro.prewalk(opts, &Macro.expand(&1, __CALLER__))
	docs = Keyword.get(opts, :docs, true)

	quote do
	Module.register_attribute(__MODULE__, :__middleware__, accumulate: true)
	Module.register_attribute(__MODULE__, :__adapter__, [])

	if unquote(docs) do
	@type option ::
	{:method, Tesla.Env.method()}
	\| {:url, Tesla.Env.url()}
	\| {:query, Tesla.Env.query()}
	\| {:headers, Tesla.Env.headers()}
	\| {:body, Tesla.Env.body()}
	\| {:opts, Tesla.Env.opts()}

	@doc """
	Perform a request using client function

	Options:
	- `:method` - the request method, one of [:head, :get, :delete, :trace, :options, :post, :put, :patch]
	- `:url` - either full url e.g. "http://example.com/some/path" or just "/some/path" if using `Tesla.Middleware.BaseUrl`
	- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`
	- `:headers` - a keyworld list of headers, e.g. `[{"content-type", "text/plain"}]`
	- `:body` - depends on used middleware:
	- by default it can be a binary
	- if using e.g. JSON encoding middleware it can be a nested map
	- if adapter supports it it can be a Stream with any of the above
	- `:opts` - custom, per-request middleware or adapter options

	Examples:

	ExampleApi.request(method: :get, url: "/users/path")

	You can also use shortcut methods like:

	ExampleApi.get("/users/1")

	or

	myclient \|> ExampleApi.post("/users", %{name: "Jon"})
	"""
	@spec request(Tesla.Env.client(), [option]) :: Tesla.Env.t()
	else
	@doc false
	end

	def request(%Tesla.Client{} = client, options) do
	Tesla.perform_request(__MODULE__, client, options)
	end

	if unquote(docs) do
	@doc """
	Perform a request. See `request/2` for available options.
	"""
	@spec request([option]) :: Tesla.Env.t()
	else
	@doc false
	end

	def request(options) do
	Tesla.perform_request(__MODULE__, options)
	end

	unquote(generate_http_verbs(opts))

	import Tesla.Builder, only: [plug: 1, plug: 2, adapter: 1, adapter: 2]
	@before_compile Tesla.Builder
	end
	end

	@doc """
	Attach middleware to your API client

	```ex
	defmodule ExampleApi do
	use Tesla

	# plug middleware module with options
	plug Tesla.Middleware.BaseUrl, "http://api.example.com"
	plug Tesla.Middleware.JSON, engine: Poison

	# plug middleware function
	plug :handle_errors

	# middleware function gets two parameters: Tesla.Env and the rest of middleware call stack
	# and must return Tesla.Env
	def handle_errors(env, next) do
	env
	\|> modify_env_before_request
	\|> Tesla.run(next) # run the rest of stack
	\|> modify_env_after_request
	end
	end
	"""
	defmacro plug(middleware, opts \\ nil) do
	opts = Macro.escape(opts)
	middleware = Tesla.alias(middleware)
	quote do: @__middleware__({unquote(middleware), unquote(opts)})
	end

	@doc """
	Choose adapter for your API client

	```ex
	defmodule ExampleApi do
	use Tesla

	# set adapter as module
	adapter Tesla.Adapter.Hackney

	# set adapter as function
	adapter :local_adapter

	# set adapter as anonymous function
	adapter fn env ->
	...
	env
	end


	# adapter function gets Tesla.Env as parameter and must return Tesla.Env
	def local_adapter(env) do
	...
	env
	end
	end
	"""
	defmacro adapter({:fn, _, _} = adapter) do
	adapter = Macro.escape(adapter)
	quote do: @__adapter__(unquote(adapter))
	end

	defmacro adapter(adapter, opts \\ nil) do
	adapter = Tesla.alias(adapter)
	quote do: @__adapter__({unquote(adapter), unquote(opts)})
	end

	defp generate_http_verbs(opts) do
	only = Keyword.get(opts, :only, @http_verbs)
	except = Keyword.get(opts, :except, [])

	@http_verbs
	\|> Enum.filter(&(&1 in only && not &1 in except))
	\|> Enum.map(&generate_api(&1, Keyword.get(opts, :docs, true)))
	end

	defp generate_api(method, docs) when method in [:post, :put, :patch] do
	quote do
	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	myclient \|> ExampleApi.#{unquote(method)}("/users", %{name: "Jon"}, query: [scope: "admin"])
	"""
	@spec unquote(method)(Tesla.Env.client(), Tesla.Env.url(), Tesla.Env.body(), [option]) ::
	Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(%Tesla.Client{} = client, url, body, options) when is_list(options) do
	request(client, [method: unquote(method), url: url, body: body] ++ options)
	end

	# fallback to keep backward compatibility
	def unquote(method)(fun, url, body, options) when is_function(fun) and is_list(options) do
	unquote(method)(%Tesla.Client{fun: fun}, url, body, options)
	end

	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	myclient \|> ExampleApi.#{unquote(method)}("/users", %{name: "Jon"})
	ExampleApi.#{unquote(method)}("/users", %{name: "Jon"}, query: [scope: "admin"])
	"""
	@spec unquote(method)(Tesla.Env.client(), Tesla.Env.url(), Tesla.Env.body()) ::
	Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(%Tesla.Client{} = client, url, body) do
	request(client, method: unquote(method), url: url, body: body)
	end

	# fallback to keep backward compatibility
	def unquote(method)(fun, url, body) when is_function(fun) do
	unquote(method)(%Tesla.Client{fun: fun}, url, body)
	end

	if unquote(docs) do
	@spec unquote(method)(Tesla.Env.url(), Tesla.Env.body(), [option]) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(url, body, options) when is_list(options) do
	request([method: unquote(method), url: url, body: body] ++ options)
	end

	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	ExampleApi.#{unquote(method)}("/users", %{name: "Jon"})
	"""
	@spec unquote(method)(Tesla.Env.url(), Tesla.Env.body()) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(url, body) do
	request(method: unquote(method), url: url, body: body)
	end
	end
	end

	defp generate_api(method, docs) when method in [:head, :get, :delete, :trace, :options] do
	quote do
	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	myclient \|> ExampleApi.#{unquote(method)}("/users", query: [page: 1])
	"""
	@spec unquote(method)(Tesla.Env.client(), Tesla.Env.url(), [option]) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(%Tesla.Client{} = client, url, options) when is_list(options) do
	request(client, [method: unquote(method), url: url] ++ options)
	end

	# fallback to keep backward compatibility
	def unquote(method)(fun, url, options) when is_function(fun) and is_list(options) do
	unquote(method)(%Tesla.Client{fun: fun}, url, options)
	end

	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	myclient \|> ExampleApi.#{unquote(method)}("/users")
	ExampleApi.#{unquote(method)}("/users", query: [page: 1])
	"""
	@spec unquote(method)(Tesla.Env.client(), Tesla.Env.url()) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(%Tesla.Client{} = client, url) do
	request(client, method: unquote(method), url: url)
	end

	# fallback to keep backward compatibility
	def unquote(method)(fun, url) when is_function(fun) do
	unquote(method)(%Tesla.Client{fun: fun}, url)
	end

	if unquote(docs) do
	@spec unquote(method)(Tesla.Env.url(), [option]) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(url, options) when is_list(options) do
	request([method: unquote(method), url: url] ++ options)
	end

	if unquote(docs) do
	@doc """
	Perform a #{unquote(method \|> to_string \|> String.upcase())} request.
	See `request/1` or `request/2` for options definition.

	Example
	ExampleApi.#{unquote(method)}("/users")
	"""
	@spec unquote(method)(Tesla.Env.url()) :: Tesla.Env.t()
	else
	@doc false
	end

	def unquote(method)(url) do
	request(method: unquote(method), url: url)
	end
	end
	end

	defmacro __before_compile__(env) do
	adapter = Module.get_attribute(env.module, :__adapter__)
	middleware = Module.get_attribute(env.module, :__middleware__) \|> Enum.reverse()

	quote do
	def __middleware__, do: unquote(middleware)
	def __adapter__, do: Tesla.adapter(__MODULE__, unquote(adapter))
	end
	end
	end

	defmodule Tesla do
	use Tesla.Builder

	@moduledoc """
	A HTTP toolkit for building API clients using middlewares

	Include Tesla module in your api client:

	```ex
	defmodule ExampleApi do
	use Tesla

	plug Tesla.Middleware.BaseUrl, "http://api.example.com"
	plug Tesla.Middleware.JSON
	end
	"""

	defmacro __using__(opts \\ []) do
	quote do
	use Tesla.Builder, unquote(opts)
	end
	end

	@aliases [
	httpc: Tesla.Adapter.Httpc,
	hackney: Tesla.Adapter.Hackney,
	ibrowse: Tesla.Adapter.Ibrowse,
	mock: Tesla.Mock,
	base_url: Tesla.Middleware.BaseUrl,
	headers: Tesla.Middleware.Headers,
	query: Tesla.Middleware.Query,
	opts: Tesla.Middleware.Opts,
	follow_redirects: Tesla.Middleware.FollowRedirects,
	method_override: Tesla.Middleware.MethodOverride,
	logger: Tesla.Middleware.Logger,
	debug_logger: Tesla.Middleware.DebugLogger,
	form_urlencoded: Tesla.Middleware.FormUrlencoded,
	json: Tesla.Middleware.JSON,
	compression: Tesla.Middleware.Compression,
	decode_rels: Tesla.Middleware.DecodeRels,
	basic_auth: Tesla.Middleware.BasicAuth,
	digest_auth: Tesla.Middleware.DigestAuth,
	timeout: Tesla.Middleware.Timeout,
	retry: Tesla.Middleware.Retry,
	fuse: Tesla.Middleware.Fuse,
	tuples: Tesla.Middleware.Tuples
	]
	def alias(key) when is_atom(key), do: Keyword.get(@aliases, key, key)
	def alias(key), do: key

	def perform_request(module, client \\ nil, options) do
	%{fun: fun, pre: pre, post: post} = client \|\| %Tesla.Client{}

	stack =
	pre ++
	prepare(module, List.wrap(fun) ++ module.__middleware__ ++ default_middleware()) ++
	post ++ prepare(module, [module.__adapter__])

	env = struct(Tesla.Env, options ++ [__module__: module, __client__: client])
	run(env, stack)
	end

	@spec prepare(atom, [any]) :: Tesla.Env.stack()
	def prepare(module, stack) do
	Enum.map(stack, fn
	{name, opts} -> prepare_module(module, name, opts)
	name when is_atom(name) -> prepare_module(module, name, nil)
	fun when is_function(fun) -> {:fn, fun}
	end)
	end

	defp prepare_module(module, name, opts) do
	case Atom.to_charlist(name) do
	~c"Elixir." ++ _ -> {name, :call, [opts]}
	_ -> {module, name}
	end
	end

	# empty stack case is useful for reusing/testing middlewares (just pass [] as next)
	def run(env, []), do: env

	# last item in stack is adapter - skip passing rest of stack
	def run(env, [{:fn, f}]), do: apply(f, [env])
	def run(env, [{m, f}]), do: apply(m, f, [env])
	def run(env, [{m, f, a}]), do: apply(m, f, [env \| a])

	# for all other elements pass (env, next, opts)
	def run(env, [{:fn, f} \| rest]), do: apply(f, [env, rest])
	def run(env, [{m, f} \| rest]), do: apply(m, f, [env, rest])
	def run(env, [{m, f, a} \| rest]), do: apply(m, f, [env, rest \| a])

	# useful helper fuctions
	def put_opt(env, key, value) do
	Map.update!(env, :opts, &Keyword.put(&1, key, value))
	end

	def adapter(module, custom) do
	module_adapter_from_config(module) \|\| custom \|\| default_adapter()
	end

	defp module_adapter_from_config(module) do
	Application.get_env(:tesla, module, [])[:adapter] \|> Tesla.alias()
	end

	def default_adapter do
	Application.get_env(:tesla, :adapter, :httpc) \|> Tesla.alias()
	end

	def run_default_adapter(env, opts \\ []) do
	apply(default_adapter(), :call, [env, opts])
	end

	def default_middleware do
	[{Tesla.Middleware.Normalize, nil}]
	end

	@doc """
	Dynamically build client from list of middlewares.

	```ex
	defmodule ExampleAPI do
	use Tesla

	def new(token) do
	Tesla.build_client([
	{Tesla.Middleware.Headers, %{"Authorization" => token}}
	])
	end
	end

	client = ExampleAPI.new(token: "abc")
	client \|> ExampleAPI.get("/me")
	```
	"""
	defmacro build_client(pre, post \\ []) do
	quote do
	%Tesla.Client{
	pre: Tesla.prepare(__MODULE__, unquote(pre)),
	post: Tesla.prepare(__MODULE__, unquote(post))
	}
	end
	end

	def build_adapter(fun) do
	%Tesla.Client{post: [{:fn, fn env, _next -> fun.(env) end}]}
	end

	def build_url(url, []), do: url

	def build_url(url, query) do
	join = if String.contains?(url, "?"), do: "&", else: "?"
	url <> join <> encode_query(query)
	end

	defp encode_query(query) do
	query
	\|> Enum.flat_map(&encode_pair/1)
	\|> URI.encode_query()
	end

	- defp encode_pair({key, value}) when is_list(value) do
	+ @doc false
	+ def encode_pair({key, value}) when is_list(value) do
	if Keyword.keyword?(value) do
	Enum.flat_map(value, fn {k, v} -> encode_pair({"#{key}[#{k}]", v}) end)
	else
	Enum.map(value, fn e -> {"#{key}[]", e} end)
	end
	end

	- defp encode_pair({key, value}), do: [{key, value}]
	+ @doc false
	+ def encode_pair({key, value}), do: [{key, value}]
	end
	diff --git a/lib/tesla/middleware/logger.ex b/lib/tesla/middleware/logger.ex
	index b579e46..4709e1d 100644
	--- a/lib/tesla/middleware/logger.ex
	+++ b/lib/tesla/middleware/logger.ex
	@@ -1,190 +1,192 @@
	defmodule Tesla.Middleware.Logger do
	@behaviour Tesla.Middleware

	@moduledoc """
	Log requests as single line.

	Logs request method, url, response status and time taken in milliseconds.

	### Example usage
	```
	defmodule MyClient do
	use Tesla

	plug Tesla.Middleware.Logger
	end
	```

	### Logger output
	```
	2017-09-30 13:39:06.663 [info] GET http://example.com -> 200 (736.988 ms)
	```

	See `Tesla.Middleware.DebugLogger` to log request/response body
	"""

	require Logger

	def call(env, next, _opts) do
	{time, env} = :timer.tc(Tesla, :run, [env, next])
	_ = log(env, time)
	env
	rescue
	ex in Tesla.Error ->
	stacktrace = System.stacktrace()
	_ = log(env, ex)
	reraise ex, stacktrace
	end

	defp log(env, %Tesla.Error{message: message}) do
	Logger.error("#{normalize_method(env)} #{env.url} -> #{message}")
	end

	defp log(env, time) do
	ms = :io_lib.format("~.3f", [time / 1000])
	message = "#{normalize_method(env)} #{env.url} -> #{env.status} (#{ms} ms)"

	cond do
	env.status >= 400 -> Logger.error(message)
	env.status >= 300 -> Logger.warn(message)
	true -> Logger.info(message)
	end
	end

	defp normalize_method(env) do
	env.method \|> to_string() \|> String.upcase()
	end
	end

	defmodule Tesla.Middleware.DebugLogger do
	@behaviour Tesla.Middleware

	@moduledoc """
	Log full reqeust/response content


	### Example usage
	```
	defmodule MyClient do
	use Tesla

	plug Tesla.Middleware.DebugLogger
	end
	```

	### Logger output
	```
	2017-09-30 13:41:56.281 [debug] > POST https://httpbin.org/post
	2017-09-30 13:41:56.281 [debug]
	2017-09-30 13:41:56.281 [debug] > a=3
	2017-09-30 13:41:56.432 [debug]
	2017-09-30 13:41:56.432 [debug] < HTTP/1.1 200
	2017-09-30 13:41:56.432 [debug] < access-control-allow-credentials: true
	2017-09-30 13:41:56.432 [debug] < access-control-allow-origin: *
	2017-09-30 13:41:56.432 [debug] < connection: keep-alive
	2017-09-30 13:41:56.432 [debug] < content-length: 280
	2017-09-30 13:41:56.432 [debug] < content-type: application/json
	2017-09-30 13:41:56.432 [debug] < date: Sat, 30 Sep 2017 11:41:55 GMT
	2017-09-30 13:41:56.432 [debug] < server: meinheld/0.6.1
	2017-09-30 13:41:56.432 [debug] < via: 1.1 vegur
	2017-09-30 13:41:56.432 [debug] < x-powered-by: Flask
	2017-09-30 13:41:56.432 [debug] < x-processed-time: 0.0011260509491
	2017-09-30 13:41:56.432 [debug]
	2017-09-30 13:41:56.432 [debug] > {
	"args": {},
	"data": "a=3",
	"files": {},
	"form": {},
	"headers": {
	"Connection": "close",
	"Content-Length": "3",
	"Content-Type": "",
	"Host": "httpbin.org"
	},
	"json": null,
	"origin": "0.0.0.0",
	"url": "https://httpbin.org/post"
	}
	```
	"""

	require Logger

	def call(env, next, _opts) do
	env
	\|> log_request
	\|> log_headers("> ")
	\|> log_params("> ")
	\|> log_body("> ")
	\|> Tesla.run(next)
	\|> log_response
	\|> log_headers("< ")
	\|> log_body("< ")
	rescue
	ex in Tesla.Error ->
	stacktrace = System.stacktrace()
	_ = log_exception(ex, "< ")
	reraise ex, stacktrace
	end

	defp log_request(env) do
	_ = Logger.debug("> #{env.method \|> to_string \|> String.upcase()} #{env.url}")
	env
	end

	defp log_response(env) do
	_ = Logger.debug("")
	_ = Logger.debug("< HTTP/1.1 #{env.status}")
	env
	end

	defp log_headers(env, prefix) do
	for {k, v} <- env.headers do
	_ = Logger.debug("#{prefix}#{k}: #{v}")
	end

	env
	end

	defp log_params(env, prefix) do
	- for {k, v} <- env.query do
	+ encoded_query = Enum.flat_map(env.query, &Tesla.encode_pair/1)
	+
	+ for {k, v} <- encoded_query do
	_ = Logger.debug("#{prefix} Query Param '#{k}': '#{v}'")
	end

	env
	end

	defp log_body(%Tesla.Env{} = env, _prefix) do
	Map.update!(env, :body, &log_body(&1, "> "))
	end

	defp log_body(nil, _), do: nil
	defp log_body([], _), do: nil
	defp log_body(%Stream{} = stream, prefix), do: log_body_stream(stream, prefix)
	defp log_body(stream, prefix) when is_function(stream), do: log_body_stream(stream, prefix)
	defp log_body(%Tesla.Multipart{} = mp, prefix), do: log_multipart_body(mp, prefix)

	defp log_body(data, prefix) when is_binary(data) or is_list(data) do
	_ = Logger.debug("")
	_ = Logger.debug(prefix <> to_string(data))
	data
	end

	defp log_body_stream(stream, prefix) do
	_ = Logger.debug("")
	Stream.each(stream, fn line -> Logger.debug(prefix <> line) end)
	end

	defp log_multipart_body(%Tesla.Multipart{} = mp, prefix) do
	_ = Logger.debug("")
	_ = Logger.debug(prefix <> "boundary: " <> mp.boundary)
	_ = Logger.debug(prefix <> "content_type_params: " <> inspect(mp.content_type_params))
	Enum.each(mp.parts, &Logger.debug(prefix <> inspect(&1)))

	mp
	end

	defp log_exception(%Tesla.Error{message: message, reason: reason}, prefix) do
	_ = Logger.debug(prefix <> message <> " (#{inspect(reason)})")
	end
	end

File Metadata

Mime Type: text/x-diff
Expires: Sun, Nov 24, 8:05 PM (1 d, 6 h)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 39482
Default Alt Text: (21 KB)

No OneTemporaryActions

View Options

File Metadata

Event Timeline

No OneTemporary
Actions