log/format.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
#include <ascii-chat/log/log.h>
 
/* ============================================================================
 * Format Specifier Types
 * ============================================================================ */
 
typedef enum {
  LOG_FORMAT_LITERAL,         /* Plain text (no % prefix) */
  LOG_FORMAT_TIME,            /* %time(fmt) - custom time format */
  LOG_FORMAT_LEVEL,           /* %level - log level as string */
  LOG_FORMAT_LEVEL_ALIGNED,   /* %level_aligned - log level padded */
  LOG_FORMAT_FILE,            /* %file - file path */
  LOG_FORMAT_FILE_RELATIVE,   /* %file_relative - file path relative to project root */
  LOG_FORMAT_LINE,            /* %line - line number */
  LOG_FORMAT_FUNC,            /* %func - function name */
  LOG_FORMAT_TID,             /* %tid - thread ID */
  LOG_FORMAT_TNAME,           /* %tname - thread name (from debug registry) */
  LOG_FORMAT_MESSAGE,         /* %message - log message */
  LOG_FORMAT_COLORLOG_LEVEL,  /* %colorlog_level_string_to_color - color code */
  LOG_FORMAT_COLOR,           /* %color(LEVEL, content) - colorize content using LEVEL's color */
  LOG_FORMAT_COLORED_MESSAGE, /* %colored_message - message with things like filenames and 0x numbers colored */
  LOG_FORMAT_MICROSECONDS,    /* %ms - microseconds component of current time (000000-999999) */
  LOG_FORMAT_NANOSECONDS,     /* %ns - nanoseconds component of current time (000000000-999999999) */
  LOG_FORMAT_STRFTIME_CODE,   /* %H, %M, %S, %A, %B, etc. - strftime format codes */
  LOG_FORMAT_NEWLINE,         /* Platform-aware newline (\n) */
} log_template_type_t;
 
/* ============================================================================
 * Parsed Format Specifier
 * ============================================================================ */
 
typedef struct {
  log_template_type_t type; /* Type of specifier */
  char *literal;            /* For LOG_FORMAT_LITERAL, the text; for LOG_FORMAT_TIME, the format string */
  size_t literal_len;       /* Length of literal text */
} log_format_spec_t;
 
/* ============================================================================
 * Compiled Log Format
 * ============================================================================ */
 
typedef struct {
  log_format_spec_t *specs; /* Array of parsed specifiers */
  size_t spec_count;        /* Number of specifiers */
  char *original;           /* Original format string (for debugging) */
  bool console_only;        /* If true, apply only to console (not file) */
} log_template_t;
 
/* ============================================================================
 * Public API
 * ============================================================================ */
 
#ifdef __cplusplus
extern "C" {
#endif
 
log_template_t *log_template_parse(const char *format_str, bool console_only);
 
void log_template_free(log_template_t *format);
 
int log_template_apply(const log_template_t *format, char *buf, size_t buf_size, log_level_t level,
                       const char *timestamp, const char *file, int line, const char *func, uint64_t tid,
                       const char *message, bool use_colors, uint64_t time_nanoseconds);
 
#ifdef __cplusplus
}
#endif