URP.Test (urp v0.10.0)

Test helpers for stubbing URP conversions without a running soffice.

Uses NimbleOwnership for per-process stub isolation, so async tests work without global state.

Setup

No setup needed — the ownership server starts with the :urp application.

Usage

test "generates invoice PDF" do
  URP.Test.stub(fn _input, _opts ->
    {:ok, "%PDF-fake"}
  end)

  assert {:ok, _pdf} = MyApp.generate_invoice(order)
end

The stub intercepts all URP.convert/2 calls made by the current process (or its children via $callers propagation).

Stub function

The stub receives (input, opts) where input is whatever was passed to URP.convert/2 (a path, {:binary, bytes}, or an enumerable) and opts is the keyword list including :output, :filter, etc.

Return the expected shape for the given :output mode:

{:ok, path} — default (temp file) or output: path
{:ok, binary} — when output: :binary
:ok — when output: fun/1
{:error, message} — for errors

Process allowances

Stubs are scoped to the process that called stub/1. For processes started with Task or GenServer, $callers propagation handles this automatically. For other processes, use allow/2:

test "async worker" do
  URP.Test.stub(fn _, _ -> {:ok, "pdf"} end)
  worker = start_my_worker()
  URP.Test.allow(self(), worker)
end

Summary

Functions

allow(owner_pid \\ self(), allowed_pid)

Allow allowed_pid to use the stub registered by owner_pid.

stub(fun)

Functions

allow(owner_pid \\ self(), allowed_pid)

@spec allow(pid(), pid() | (-> pid() | [pid()])) :: :ok

Allow allowed_pid to use the stub registered by owner_pid.

Usually not needed — $callers propagation handles Task and GenServer automatically. Use this for processes that don't propagate $callers.

stub(fun)

@spec stub((term(), keyword() -> term())) :: :ok

Examples

iex> URP.Test.stub(fn _input, _opts -> {:ok, "fake PDF"} end)
:ok
iex> URP.convert({:binary, "hello"}, filter: "writer_pdf_Export", output: :binary)
{:ok, "fake PDF"}

iex> URP.Test.stub(fn {:binary, bytes}, _opts -> {:ok, byte_size(bytes)} end)
:ok
iex> URP.convert({:binary, "hello"}, filter: "writer_pdf_Export", output: :binary)
{:ok, 5}