package easy_logging

  1. Overview
  2. Docs
Module to log messages. Aimed at being both powerful and easy to use

Install

dune-project
 Dependency

Authors

Maintainers

Sources

v0.7.1.tar.gz
md5=ff59e729374d66cc927de16bd7b82dea
sha512=ca31fd39edab9a9592e9d5b2646dccc750037f823c4195de4b5ce4760e9463df1576806f850911ef96b359a45c35cc25f160860aa87b5519cf8b8feca8a68deb

doc/easy_logging/Easy_logging/Handlers/FileHandler/index.html

Module Handlers.FileHandler

Module to create handlers that output to a file.

type config = {
  1. logs_folder : string;
    (*

    Path in which logs files will be written.

    *)
  2. truncate : bool;
    (*

    Truncate/append if file already exists.

    *)
  3. file_perms : int;
    (*

    Unix file permissions.

    *)
  4. date_prefix : string option;
    (*

    Optional date prefix format string.

    *)
  5. versioning : int option;
    (*

    Optionaly generate new file name.

    *)
  6. suffix : string;
    (*

    Constant suffix.

    *)
}

Configuration when creating a file handler.

  • The date_prefix value is an optional Calender Printer String (as specified in the Calendar documentation), that will format the time at which the handler is created, and used as a prefix.
  • If the versioning value is not None, a versionning number is appended to the filename, based on already existing files. The integer gives the padding of versionning numbers. THIS OPTION MIGHT DISAPPEAR IN FUTURE RELEASES.
val default_config : config
val generate_prefix : config -> string
val generate_filename : config -> string -> string
val create_file : config -> string -> out_channel
val make : ?config:config -> Easy_logging__.Logging_types.level -> string -> t

make ~config level filename_base creates a Handler that will output logs to the file created from filename_base and config

val make_rotating : ?config:config -> Easy_logging__.Logging_types.level -> string -> int -> int -> t

make_rotating ~config level filename_base max_kbytes backup_count creates a Handler that will output logs to a rotating set of files. The files are from filename_base and config. When the size of a log file is about to exceed max_kbytes kb, a new file is created, and older log files are renamed. See the python RotatingFileHandler.