XU XUv0.8.8
中文

API

#log/slog

import: #log/slog

counts: 2 fns, 9 methods, 1 types, 4 consts, 0 ifaces

Structured logging. No package-level default logger. Text or one JSON object per line.

const level_debug

XuAPI
pub const level_debug = -4

Purpose

`log/slog` text + JSON handler subset. No default logger (Xu has no mutable globals). Attributes via with or on debug/info/warn/error/log as trailing string pairs (odd leftover is !BADKEY, same as ). Levels match slog.Level*. Context methods exist for the D1 hook; v1 does not extract trace IDs. JSON is new_json_logger ( NewJSONHandler shape, no io.Writer). with_group nests subsequent attrs (text: dotted keys; JSON: objects). Empty group name is a no-op (same as ). No syslog. Value `-4`.

Parameters

none

const level_info

XuAPI
pub const level_info = 0

Purpose

Public constant `level_info`. Value `0`.

Parameters

none

const level_warn

XuAPI
pub const level_warn = 4

Purpose

Public constant `level_warn`. Value `4`.

Parameters

none

const level_error

XuAPI
pub const level_error = 8

Purpose

Public constant `level_error`. Value `8`.

Parameters

none

struct Logger

XuAPI
pub struct Logger {
    pub min_level int
    pub add_source int
    pub add_time int
    pub use_stdout bool
}

Purpose

Public struct `Logger`.

Parameters

min_level int
field (int)
add_source int
field (int)
add_time int
field (int)
use_stdout bool
field (bool)

new_logger

XuAPI
pub fn new_logger() Logger

Purpose

Construct logger.

Parameters

none

Returns

Logger — a value of this type

new_json_logger

XuAPI
pub fn new_json_logger() Logger

Purpose

Construct json logger.

Parameters

none

Returns

Logger — a value of this type

(&mut Logger) set_level

XuAPI
pub fn (l &mut Logger) set_level(level int)

Purpose

Method on `&mut Logger`: set level.

Parameters

l &mut Logger
receiver &mut Logger (exclusive borrow)
level int
level (int)

(Logger) with

XuAPI
pub fn (l Logger) with(kvs <-> string) Logger

Purpose

Call `with` on `Logger`.

Parameters

l Logger
receiver Logger (value receiver)
kvs <-> string
variadic string (seen inside the function as []string)

Returns

Logger — a value of this type

(Logger) with_group

XuAPI
pub fn (l Logger) with_group(name string) Logger

Purpose

Method on `Logger`: derive a new value with group.

Parameters

l Logger
receiver Logger (value receiver)
name string
name (string)

Returns

Logger — a value of this type

(Logger) enabled

XuAPI
pub fn (l Logger) enabled(level int) bool

Purpose

Call `enabled` on `Logger`.

Parameters

l Logger
receiver Logger (value receiver)
level int
level (int)

Returns

bool — true or false

(&Logger) log

XuAPI
pub fn (l &Logger) log(level int, msg string)

Purpose

Method on `&Logger`: natural logarithm.

Parameters

l &Logger
receiver &Logger (borrow)
level int
level (int)
msg string
message (string)

(&Logger) debug

XuAPI
pub fn (l &Logger) debug(msg string, kvs <-> string)

Purpose

Call `debug` on `&Logger`.

Parameters

l &Logger
receiver &Logger (borrow)
msg string
message (string)
kvs <-> string
variadic string (seen inside the function as []string)

(&Logger) info

XuAPI
pub fn (l &Logger) info(msg string, kvs <-> string)

Purpose

Call `info` on `&Logger`.

Parameters

l &Logger
receiver &Logger (borrow)
msg string
message (string)
kvs <-> string
variadic string (seen inside the function as []string)

(&Logger) warn

XuAPI
pub fn (l &Logger) warn(msg string, kvs <-> string)

Purpose

Call `warn` on `&Logger`.

Parameters

l &Logger
receiver &Logger (borrow)
msg string
message (string)
kvs <-> string
variadic string (seen inside the function as []string)

(&Logger) error

XuAPI
pub fn (l &Logger) error(msg string, kvs <-> string)

Purpose

Call `error` on `&Logger`.

Parameters

l &Logger
receiver &Logger (borrow)
msg string
message (string)
kvs <-> string
variadic string (seen inside the function as []string)