package octez-libs

  1. Overview
  2. Docs
A package that contains multiple base libraries used by the Octez suite

Install 

dune-project
 Dependency

www.tezos.com Readme Edit opam file Versions (5)

Authors

  1. T
    Tezos devteam

Maintainers

  1. C
    contact@tezos.com

Sources

tezos-octez-v20.1.tag.bz2
sha256=ddfb5076eeb0b32ac21c1eed44e8fc86a6743ef18ab23fff02d36e365bb73d61
sha512=d22a827df5146e0aa274df48bc2150b098177ff7e5eab52c6109e867eb0a1f0ec63e6bfbb0e3645a6c2112de3877c91a17df32ccbff301891ce4ba630c997a65

doc/octez-libs.event-logging-test-helpers/Tezos_event_logging_test_helpers/Mock_sink/index.html

Module Tezos_event_logging_test_helpers.Mock_sinkSource

A mock event sink that records handled events for verifying test expectations.

include Tezos_event_logging.Internal_event.SINK
Sourcetype t

A sink can store any required state, e.g. a database handle, in a value of the t type see configure.

Sourceval uri_scheme : string

Registered sinks are a distinguished by their URI scheme.

When a registered sink is activated the configure function is called to initialize it. The parameters should be encoded or obtained from the URI (the scheme of the URI is already uri_scheme).

Predicate deciding whether a sink should handle the event or not.

A sink's main function is to handle incoming events from the code base.

A function to be called on graceful termination of processes (e.g. to flush file-descriptors, etc.).

A filter can be applied when asserting the contents of the sink. This restricts assertions to events from a specific section or to those that have no section. The value filter has the following meaning:

  • filter = None: only keep events that have no section.
  • filter = Some s: only keep events with section s.

Note that the filter is always passed as an optional parameter. It can be omited to keep all events.

Sourcetype event = {
  1. level : Tezos_event_logging.Internal_event.Level.t;
  2. section : Tezos_event_logging.Internal_event.Section.t option;
  3. name : string;
  4. message : string;
  5. json : Data_encoding.json;
}
Sourcemodule Pattern : sig ... end

Describes an event pattern to search for in the sink.

Sourcetype pattern = Pattern.t
Sourceval assert_has_event : string -> ?filter:filter -> ?strict:bool -> pattern -> unit

assert_has_event str filter strict e asserts that Mock_sink has recorded an event e, and fails with the assertion message str if not. If filter is set, only the events whose section is filter are searched. If strict is set, then e must be the only event recorded (subject to filter).

Sourceval assert_has_events : string -> ?filter:filter -> ?strict:bool -> pattern list -> unit

assert_has_events str filter strict es asserts that Mock_sink has recorded the list of events es, and fails with the assertion message str if not. If filter is set, only the events whose section is filter are searched. If strict is set, then es must be the only events recorded (subject to filter).

Sourceval clear_events : unit -> unit

Clears recorded events, typically called in the initialization of each test.

Sourceval is_activated : unit -> bool

Returns true if this sink has been activated

Sourceval pp_state : ?filter:filter -> unit -> unit

Pretty prints the list of recorded events

Sourceval pp_events_json : Format.formatter -> event list -> unit
Sourceval get_events : ?filter:filter -> unit -> event list