package stdune

  1. Overview
  2. Docs
package stdune
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Module Stdune.User_messageSource

A message for the user

User messages are styled document that can be printed to the console or in the log file.

Sourcemodule Style : sig ... end

Symbolic styles that can be used inside messages. These styles are later converted to actual concrete styles depending on the output device. For instance, when printed to the terminal they are converted to ansi terminal styles (Ansi_color.Style.t list values).

Sourcemodule Annots : sig ... end
Sourcetype t = {
  1. loc : Stdune__.Loc0.t option;
  2. paragraphs : Style.t Pp.t list;
  3. hints : Style.t Pp.t list;
  4. annots : Annots.t;
}

A user message.contents composed of an optional file location and a list of paragraphs.

The various paragraphs will be printed one after the other and will all start at the beginning of a line. They are all wrapped inside a Pp.box.

When hints are provided, they are printed as last paragraphs and prefixed with "Hint:". Hints should give indication to the user for how to fix the issue.

The annots field is intended to carry extra context for other, non-user-facing purposes (such as data for the RPC).

Sourceval compare : t -> t -> Ordering.t
Sourceval equal : t -> t -> bool
Sourceval pp : t -> Style.t Pp.t
Sourcemodule Print_config : sig ... end
Sourceval make : ?loc:Stdune__.Loc0.t -> ?prefix:Style.t Pp.t -> ?hints:Style.t Pp.t list -> ?annots:Annots.t -> Style.t Pp.t list -> t

Construct a user message from a list of paragraphs.

The first paragraph is prefixed with prefix inside the box. prefix should not end with a space as a space is automatically inserted by make if necessary.

Sourceval print : ?config:Print_config.t -> t -> unit

Print to stdout (not thread safe)

Sourceval prerr : ?config:Print_config.t -> t -> unit

Print to stderr (not thread safe)

Sourceval did_you_mean : string -> candidates:string list -> Style.t Pp.t list

Produces a "Did you mean ...?" hint

Sourceval to_string : t -> string

Produces a plain text representation of the error message, without the "Error: " prefix.

Sourceval has_location : t -> bool

Returns true if the message has an explicit location or one embedded in the text.

Sourceval has_embedded_location : t -> bool

Returns true if the message's annotations contains Annot.Has_embedded_location.

Sourceval needs_stack_trace : t -> bool

Returns true if the message's annotations contains Annot.Needs_stack_trace.

OCaml

Innovation. Community. Security.

GitHub Discord Twitter Peertube RSS
About
Changelog Releases Industrial Users Academic Users Why OCaml
Ecosystem
Packages Community Events OCaml Planet Jobs
Resources
Install OCaml Get Started Platform Tools Language Manual Standard Library API Books Exercises Papers OCaml Playground Logo
Policies
Carbon Footprint Governance Privacy Code of Conduct