cham-logging 0.1.0__py3-none-any.whl

cham_logging/bootstrap.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+import datetime
+import logging
+import os
+
+
+class MicrosecondFormatter(logging.Formatter):
+    def formatTime(  # noqa: N802
+        self,
+        record: logging.LogRecord,
+        datefmt: str | None = None,
+    ) -> str:
+        dt = datetime.datetime.fromtimestamp(record.created, datetime.UTC)
+        return dt.strftime(datefmt) if datefmt else dt.isoformat()
+
+
+FORMATTER = MicrosecondFormatter("%(asctime)s - %(levelname)s - %(message)s")
+
+
+def init_logger() -> None:
+    log_level = os.environ.get("LOG_LEVEL", "INFO").upper()
+
+    logger = logging.getLogger()
+    logger.setLevel(log_level)
+
+    handler = logging.StreamHandler()
+    handler.setLevel(log_level)
+    handler.setFormatter(FORMATTER)
+    logger.addHandler(handler)
+
+    log_file = os.environ.get("LOG_FILE")
+    if log_file:
+        file_handler = logging.FileHandler(log_file, encoding="utf-8")
+        file_handler.setLevel(log_level)
+        file_handler.setFormatter(FORMATTER)
+        logger.addHandler(file_handler)

cham_logging-0.1.0.dist-info/METADATA

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: cham-logging
+Version: 0.1.0
+Summary: A small stdlib-only helper for configuring Python logging.
+Author: Cham
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# cham-logging
+
+A small stdlib-only helper for configuring Python logging.
+
+## Usage
+
+Call `init_logger()` once near the start of your process.
+
+```python
+import logging
+
+from cham_logging.bootstrap import init_logger
+
+
+init_logger()
+
+logger = logging.getLogger(__name__)
+logger.info("service started")
+```
+
+## Environment variables
+
+`LOG_LEVEL` controls the root logger and handler level.
+
+```bash
+LOG_LEVEL=DEBUG python -m your_app
+```
+
+If `LOG_LEVEL` is not set, `INFO` is used.
+
+`LOG_FILE` enables an additional UTF-8 file handler.
+
+```bash
+LOG_FILE=app.log python -m your_app
+```
+
+Both variables can be used together.
+
+```bash
+LOG_LEVEL=DEBUG LOG_FILE=app.log python -m your_app
+```
+
+## Format
+
+Logs use UTC with microsecond precision:
+
+```text
+2026-06-14T13:30:00.123456+00:00 - INFO - service started
+```
+
+The timezone is fixed to UTC for now and cannot be configured.

cham_logging-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+cham_logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cham_logging/bootstrap.py,sha256=5-s5KAcyZwbns5s0lBuXhczZdkUEpamiJxXljiF8Lxo,1030
+cham_logging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cham_logging-0.1.0.dist-info/METADATA,sha256=5rp1-ikUMBAO3iPRo3UTx3ABbxCsjNQ9CU4byJ-kEaQ,1124
+cham_logging-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+cham_logging-0.1.0.dist-info/licenses/LICENSE,sha256=R2JKtKOoqKohwk31ygpA8Udqk6nZjU-sWPhtwYxj0M8,1061
+cham_logging-0.1.0.dist-info/RECORD,,

cham_logging-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

cham_logging-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.