Matcher which matches any value. Implements both ArgsMatcher and ImplicitArgMatcher.

Creates an ImplicitArgMatcher from the specified ArgMatcher to be used in vector args matcher.

The same as arg macro, but string for printing the matcher must be specified explicitly.

Protocol for explicit arg matchers.

Also see: arg.

Protocol for multiple args matching.

For the specified recorded fake returns a vector of its calls. Returned vector is ordered by call time: the earliest call will be at the head.

A call is a map with keys: :args, :return-value.

If fake is not specified then it will return all the calls recorded in the context:

[[recorded-fake1 call1]
 [recorded-fake2 call2]
 ...]

Creates a new context atom.

Do not alter the atom manually, context fields should be considered a private API.

Also see: clj-fakes.core/with-fakes.

Returns a function that:

1. takes any number of arguments;
2. on each call returns the next value from coll, cyclically.

With this config fake will return a new FakeReturnValue type instance for any combination of args.

Creates a fake function. The created function must be called; otherwise, self-test-unused-fakes will fail.

Config is a vector of pairs: [args-matcher1 fn-or-value1 args-matcher2 fn-or-value2 ...]

Use fake* in case this macro is called from another macro.

The same as fake macro but for reuse in other macros.

form must be passed from the parent macro in order to correctly detect position.

Most likely you shouldn’t use this protocol. Consider creating explicit custom matchers by implementing ArgMatcher protocol and using arg macro.

After using this function self-test-unchecked-fakes will not warn about the specified recorded fake.

Returns a hash-key by which calls are recorded for the specified fake protocol instance method. Can be used in functions which take recorded fake as an input.

was-called for protocol method fakes.

was-called-once for protocol method fakes.

was-matched-once for protocol method fakes.

was-not-called for protocol method fakes.

were-called-in-order for protocol method fakes.

Syntax:

(methods-were-called-in-order ctx
  f1 obj1 args-matcher1
  f2 obj2 args-matcher2
  ...)

Creates an optional fake function which will not be checked by self-test-unused-fakes, i.e. created fake is allowed to be never called.

Config is a vector of pairs: [args-matcher1 fn-or-value1 args-matcher2 fn-or-value2 ...]

If config is not specified then fake will be created with default-fake-config.

Given a patched variable returns its original value.

Changes variable value in all threads.

Creates a fake function whose calls will be recorded.

Config is a vector of pairs: [args-matcher1 fn-or-value1 args-matcher2 fn-or-value2 ...]

Ultimatelly, the created function must be marked checked (see mark-checked); otherwise, self-test-unchecked-fakes will fail.

Use recorded-fake* in case this macro is called from another macro.

This is the same as recorded-fake macro but for reuse in other macros.

form must be passed from the parent macro in order to correctly detect position.

Works similarly to reify macro, but implements methods in terms of fake functions. Created instance will raise an exception on calling protocol method which is not defined.

Supported fake types: :optional-fake, :fake, :recorded-fake.

Syntax example:

(reify-fake my-context
  protocol-or-interface-or-Object
  [method1 :optional-fake [any 123]]

  protocol-or-interface-or-Object
  [method2 :recorded-fake]

  ; reification of Object with arbitrary methods works only in ClojureScript, note how arglist must be explicitly provided:
  Object
  [new-method3 [x y z] :recorded-fake])

The same as reify-fake but to be used inside macros.

form is needed to correctly determine fake positions, env is needed to determine target language.

Works similarly to reify-fake, but automatically generates :optional-fake implementations for methods which are not explicitly defined by user.

It cannot yet automatically fake Java interface and Object methods.

The same as reify-nice-fake but to be used inside macros.

form is needed to correctly determine fake positions, env is needed to determine target language.

Runs all available self-tests.

Raises an exception if some recorded fake was never marked checked, i.e. you forgot to assert its calls.

Raises an exception when some fake was never called after its creation.

Restores original variable value.

Restores original values for all the variables patched in the specified context.

Checks that recorded fake was called at least once with the specified args. Returns true or raises an exception.

Checks that recorded fake was called strictly once and that the call was with the specified args. Returns true or raises an exception.

Checks that recorded fake was called at least once and only a single call satisfies the provided args matcher. Returns true or raises an exception.

Checks that recorded fake was never called. Returns true or raises an exception.

Checks that recorded fakes were called in the specified order with the specified args. It does not check that there were no other calls.

Syntax: (were-called-in-order ctx f1 args-matcher1 f2 args-matcher2 ...)

Returns true or raises an exception.