Skip to content

README log format example omits timezone offset — contradicts prose description #125

Description

@codeforester

Problem

README.md:812–813 correctly states:

Log timestamps use the host's local timezone and include its numeric offset by default.

But the example at README.md:865 shows:

2026-05-26 12:34:56 INFO    path/to/file.py:42 message

No timezone offset. This directly contradicts the prose two paragraphs above it.

The actual datefmt in logging.py is "%Y-%m-%d %H:%M:%S %z" for local time, producing output like:

2026-05-26 12:34:56 -0400 INFO    path/to/file.py:42 message

With LOG_UTC=1, the format is "%Y-%m-%d %H:%M:%S UTC", producing:

2026-05-26 16:34:56 UTC INFO    path/to/file.py:42 message

Fix

Update the example at README.md:865 to include the timezone offset. Show both local and UTC variants if space allows, or add a note pointing to the LOG_UTC environment variable.

Metadata

Metadata

Assignees

Labels

documentationDocumentation improvements

Type

No type

Projects

Status
Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions