View Source Charon.TestHelpers (Charon v3.2.0)

Utility functions for writing tests.

Summary

Types

test_session()

Functions

create_session(config, upsert_session_opts \\ [])

Create a test session and return the session, a set of tokens for it and the response cookies.

override_opt_mod_conf(config, module, overrides)

Override configuration for an optional module.

put_token(conn, config, opts \\ [])

Create a new test session and put a token (and its cookie when needed) on the conn. This is essentially create_session/3 and put_token_for/3 combined into one convenience function.

put_token_for(conn, test_session, opts \\ [])

Put a token (and its cookie when needed) from the test session on the conn. Use create_session/3 to create the test session.

Types

test_session()

@type test_session() :: %{
  session: Charon.Models.Session.t(),
  tokens: Charon.Models.Tokens.t(),
  cookies: Plug.Conn.resp_cookies()
}

Functions

create_session(config, upsert_session_opts \\ [])

@spec create_session(Charon.Config.t(), Charon.SessionPlugs.upsert_session_opts()) ::
  test_session()

Create a test session and return the session, a set of tokens for it and the response cookies.

Options

override_opt_mod_conf(config, module, overrides)

@spec override_opt_mod_conf(Charon.Config.t(), atom() | binary(), map() | keyword()) ::
  Charon.Config.t()

Override configuration for an optional module.

put_token(conn, config, opts \\ [])

@spec put_token(Plug.Conn.t(), Charon.Config.t(), keyword()) :: Plug.Conn.t()

Create a new test session and put a token (and its cookie when needed) on the conn. This is essentially create_session/3 and put_token_for/3 combined into one convenience function.

Options

The upsert_session_opts defined in Charon.SessionPlugs.upsert_session_opts/0 AND

  • :token is either :access (default) or :refresh

put_token_for(conn, test_session, opts \\ [])

@spec put_token_for(Plug.Conn.t(), test_session(), [{:token, :access | :refresh}]) ::
  Plug.Conn.t()

Put a token (and its cookie when needed) from the test session on the conn. Use create_session/3 to create the test session.

Options

  • :token is either :access (default) or :refresh