beans-logging-fastapi 1.1.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

beans_logging_fastapi/_middlewares.py

@@ -1,8 +1,7 @@
-# -*- coding: utf-8 -*-
-
 import time
 from uuid import uuid4
-from typing import Callable, Dict, Any
+from typing import Any
+from collections.abc import Callable
 
 from fastapi import Request, Response
 from starlette.middleware.base import BaseHTTPMiddleware
@@ -30,11 +29,11 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
         self.has_cf_headers = has_cf_headers
 
     async def dispatch(self, request: Request, call_next: Callable) -> Response:
-        _http_info: Dict[str, Any] = {}
+        _http_info: dict[str, Any] = {}
         if hasattr(request.state, "http_info") and isinstance(
             request.state.http_info, dict
         ):
-            _http_info: Dict[str, Any] = request.state.http_info
+            _http_info: dict[str, Any] = request.state.http_info
 
         _http_info["request_id"] = uuid4().hex
         if "X-Request-ID" in request.headers:
@@ -42,18 +41,20 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
         elif "X-Correlation-ID" in request.headers:
             _http_info["request_id"] = request.headers.get("X-Correlation-ID")
 
-        ## Set request_id to request state:
+        # Set request_id to request state:
         request.state.request_id = _http_info["request_id"]
 
-        _http_info["client_host"] = request.client.host
+        if request.client:
+            _http_info["client_host"] = request.client.host
+
         _http_info["request_proto"] = request.url.scheme
         _http_info["request_host"] = (
             request.url.hostname if request.url.hostname else ""
         )
         if (request.url.port != 80) and (request.url.port != 443):
-            _http_info[
-                "request_host"
-            ] = f"{_http_info['request_host']}:{request.url.port}"
+            _http_info["request_host"] = (
+                f"{_http_info['request_host']}:{request.url.port}"
+            )
 
         _http_info["request_port"] = request.url.port
         _http_info["http_version"] = request.scope["http_version"]
@@ -63,7 +64,7 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
                 _http_info["client_host"] = request.headers.get("X-Real-IP")
             elif "X-Forwarded-For" in request.headers:
                 _http_info["client_host"] = request.headers.get(
-                    "X-Forwarded-For"
+                    "X-Forwarded-For", ""
                 ).split(",")[0]
                 _http_info["h_x_forwarded_for"] = request.headers.get("X-Forwarded-For")
 
@@ -77,12 +78,14 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
 
             if "X-Forwarded-Port" in request.headers:
                 try:
-                    _http_info["request_port"] = int(
-                        request.headers.get("X-Forwarded-Port")
-                    )
+                    _x_forwarded_port = request.headers.get("X-Forwarded-Port")
+                    if _x_forwarded_port:
+                        _http_info["request_port"] = int(_x_forwarded_port)
+
                 except ValueError:
                     logger.warning(
-                        f"`X-Forwarded-Port` header value '{request.headers.get('X-Forwarded-Port')}' is invalid, should be parseable to <int>!"
+                        f"`X-Forwarded-Port` header value '{request.headers.get('X-Forwarded-Port')}' is invalid, "
+                        "should be parseable to <int>!"
                     )
 
             if "Via" in request.headers:
@@ -137,6 +140,8 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
             _http_info["url_path"] = _http_info["url_path"].replace("{", "{{")
         if "}" in _http_info["url_path"]:
             _http_info["url_path"] = _http_info["url_path"].replace("}", "}}")
+        if "<" in _http_info["url_path"]:
+            _http_info["url_path"] = _http_info["url_path"].replace("<", "\\<")
         if request.url.query:
             _http_info["url_path"] = f"{request.url.path}?{request.url.query}"
 
@@ -155,7 +160,7 @@ class RequestHTTPInfoMiddleware(BaseHTTPMiddleware):
         if hasattr(request.state, "user_id"):
             _http_info["user_id"] = str(request.state.user_id)
 
-        ## Set http info to request state:
+        # Set http info to request state:
         request.state.http_info = _http_info
         response: Response = await call_next(request)
         return response
@@ -170,28 +175,30 @@ class ResponseHTTPInfoMiddleware(BaseHTTPMiddleware):
     """
 
     async def dispatch(self, request: Request, call_next: Callable) -> Response:
-        _http_info: Dict[str, Any] = {}
+        _http_info: dict[str, Any] = {}
         _start_time: int = time.perf_counter_ns()
-        ## Process request:
+        # Process request:
         response: Response = await call_next(request)
-        ## Response processed.
+        # Response processed.
         _end_time: int = time.perf_counter_ns()
         _response_time: float = round((_end_time - _start_time) / 1_000_000, 1)
 
         if hasattr(request.state, "http_info") and isinstance(
             request.state.http_info, dict
         ):
-            _http_info: Dict[str, Any] = request.state.http_info
+            _http_info: dict[str, Any] = request.state.http_info
 
         _http_info["response_time"] = _response_time
         if "X-Process-Time" in response.headers:
             try:
-                _http_info["response_time"] = float(
-                    response.headers.get("X-Process-Time")
-                )
+                _x_process_time = response.headers.get("X-Process-Time")
+                if _x_process_time:
+                    _http_info["response_time"] = float(_x_process_time)
+
             except ValueError:
                 logger.warning(
-                    f"`X-Process-Time` header value '{response.headers.get('X-Process-Time')}' is invalid, should be parseable to <float>!"
+                    f"`X-Process-Time` header value '{response.headers.get('X-Process-Time')}' is invalid, "
+                    "should be parseable to <float>!"
                 )
         else:
             response.headers["X-Process-Time"] = str(_http_info["response_time"])
@@ -206,16 +213,21 @@ class ResponseHTTPInfoMiddleware(BaseHTTPMiddleware):
         _http_info["content_length"] = 0
         if "Content-Length" in response.headers:
             try:
-                _http_info["content_length"] = int(
-                    response.headers.get("Content-Length")
-                )
+                _content_length = response.headers.get("Content-Length")
+                if _content_length:
+                    _http_info["content_length"] = int(_content_length)
+
             except ValueError:
                 logger.warning(
-                    f"`Content-Length` header value '{response.headers.get('Content-Length')}' is invalid, should be parseable to <int>!"
+                    f"`Content-Length` header value '{response.headers.get('Content-Length')}' is invalid, "
+                    "should be parseable to <int>!"
                 )
 
         request.state.http_info = _http_info
         return response
 
 
-__all__ = ["RequestHTTPInfoMiddleware", "ResponseHTTPInfoMiddleware"]
+__all__ = [
+    "RequestHTTPInfoMiddleware",
+    "ResponseHTTPInfoMiddleware",
+]

beans_logging_fastapi-2.0.0.dist-info/METADATA

@@ -0,0 +1,497 @@
+Metadata-Version: 2.4
+Name: beans_logging_fastapi
+Version: 2.0.0
+Summary: This is a middleware for FastAPI HTTP access logs. It is based on 'beans-logging' package.
+Author-email: Batkhuu Byambajav <batkhuu10@gmail.com>
+Project-URL: Homepage, https://github.com/bybatkhuu/module-fastapi-logging
+Project-URL: Documentation, https://fastapi-logging-docs.bybatkhuu.dev
+Project-URL: Repository, https://github.com/bybatkhuu/module-fastapi-logging.git
+Project-URL: Issues, https://github.com/bybatkhuu/module-fastapi-logging/issues
+Project-URL: Changelog, https://github.com/bybatkhuu/module-fastapi-logging/blob/main/CHANGELOG.md
+Keywords: beans_logging_fastapi,fastapi-logging,fastapi-logging-middleware,fastapi-middleware,logging-middleware,middleware,beans-logging,http-access-logging,logging,logger,loguru
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <4.0,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: fastapi<1.0.0,>=0.99.1
+Requires-Dist: beans-logging<8.0.0,>=7.1.0
+Provides-Extra: test
+Requires-Dist: pytest<10.0.0,>=8.0.2; extra == "test"
+Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == "test"
+Requires-Dist: pytest-xdist<4.0.0,>=3.6.1; extra == "test"
+Requires-Dist: pytest-benchmark<6.0.0,>=5.0.1; extra == "test"
+Provides-Extra: build
+Requires-Dist: setuptools<81.0.0,>=70.3.0; extra == "build"
+Requires-Dist: wheel<1.0.0,>=0.43.0; extra == "build"
+Requires-Dist: build<2.0.0,>=1.1.1; extra == "build"
+Requires-Dist: twine<7.0.0,>=6.0.1; extra == "build"
+Provides-Extra: docs
+Requires-Dist: pylint<5.0.0,>=3.0.4; extra == "docs"
+Requires-Dist: mkdocs-material<10.0.0,>=9.5.50; extra == "docs"
+Requires-Dist: mkdocs-awesome-nav<4.0.0,>=3.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]<2.0.0,>=0.24.3; extra == "docs"
+Requires-Dist: mike<3.0.0,>=2.1.3; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: pytest<10.0.0,>=8.0.2; extra == "dev"
+Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == "dev"
+Requires-Dist: pytest-xdist<4.0.0,>=3.6.1; extra == "dev"
+Requires-Dist: pytest-benchmark<6.0.0,>=5.0.1; extra == "dev"
+Requires-Dist: setuptools<81.0.0,>=70.3.0; extra == "dev"
+Requires-Dist: wheel<1.0.0,>=0.43.0; extra == "dev"
+Requires-Dist: build<2.0.0,>=1.1.1; extra == "dev"
+Requires-Dist: twine<7.0.0,>=6.0.1; extra == "dev"
+Requires-Dist: pylint<5.0.0,>=3.0.4; extra == "dev"
+Requires-Dist: mkdocs-material<10.0.0,>=9.5.50; extra == "dev"
+Requires-Dist: mkdocs-awesome-nav<4.0.0,>=3.0.0; extra == "dev"
+Requires-Dist: mkdocstrings[python]<2.0.0,>=0.24.3; extra == "dev"
+Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
+Requires-Dist: pyright<2.0.0,>=1.1.392; extra == "dev"
+Requires-Dist: pre-commit<5.0.0,>=4.0.1; extra == "dev"
+Dynamic: license-file
+
+# FastAPI Logging (beans-logging-fastapi)
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bybatkhuu/module-fastapi-logging/2.build-publish.yml?logo=GitHub)](https://github.com/bybatkhuu/module-fastapi-logging/actions/workflows/2.build-publish.yml)
+[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/bybatkhuu/module-fastapi-logging?logo=GitHub&color=blue)](https://github.com/bybatkhuu/module-fastapi-logging/releases)
+
+This is a middleware for FastAPI HTTP access logs. It is based on **'beans-logging'** package.
+
+## ✨ Features
+
+- **Logger** based on **'beans-logging'** package
+- **FastAPI** HTTP access logging **middleware**
+
+---
+
+## 🛠 Installation
+
+### 1. 🚧 Prerequisites
+
+- Install **Python (>= v3.10)** and **pip (>= 23)**:
+    - **[RECOMMENDED] [Miniconda (v3)](https://www.anaconda.com/docs/getting-started/miniconda/install)**
+    - *[arm64/aarch64] [Miniforge (v3)](https://github.com/conda-forge/miniforge)*
+    - *[Python virutal environment] [venv](https://docs.python.org/3/library/venv.html)*
+
+[OPTIONAL] For **DEVELOPMENT** environment:
+
+- Install [**git**](https://git-scm.com/downloads)
+- Setup an [**SSH key**](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh)
+
+### 2. 📦 Install the package
+
+[NOTE] Choose one of the following methods to install the package **[A ~ F]**:
+
+**OPTION A.** [**RECOMMENDED**] Install from **PyPi**:
+
+```sh
+pip install -U beans-logging-fastapi
+```
+
+**OPTION B.** Install latest version directly from **GitHub** repository:
+
+```sh
+pip install git+https://github.com/bybatkhuu/module-fastapi-logging.git
+```
+
+**OPTION C.** Install from the downloaded **source code**:
+
+```sh
+git clone https://github.com/bybatkhuu/module-fastapi-logging.git && \
+    cd ./module-fastapi-logging
+
+# Install directly from the source code:
+pip install .
+
+# Or install with editable mode:
+pip install -e .
+```
+
+**OPTION D.** Install for **DEVELOPMENT** environment:
+
+```sh
+pip install -e .[dev]
+
+# Install pre-commit hooks:
+pre-commit install
+```
+
+**OPTION E.** Install from **pre-built release** files:
+
+1. Download **`.whl`** or **`.tar.gz`** file from [**releases**](https://github.com/bybatkhuu/module-fastapi-logging/releases)
+2. Install with pip:
+
+```sh
+# Install from .whl file:
+pip install ./beans_logging_fastapi-[VERSION]-py3-none-any.whl
+
+# Or install from .tar.gz file:
+pip install ./beans_logging_fastapi-[VERSION].tar.gz
+```
+
+**OPTION F.** Copy the **module** into the project directory (for **testing**):
+
+```sh
+# Install python dependencies:
+pip install -r ./requirements.txt
+
+# Copy the module source code into the project:
+cp -r ./src/beans_logging_fastapi [PROJECT_DIR]
+# For example:
+cp -r ./src/beans_logging_fastapi /some/path/project/
+```
+
+## 🚸 Usage/Examples
+
+To use `beans_logging_fastapi`:
+
+### **FastAPI**
+
+[**`configs/logger.yml`**](./examples/configs/logger.yml):
+
+```yaml
+logger:
+  app_name: "fastapi-app"
+  intercept:
+    mute_modules: ["uvicorn.access"]
+  handlers:
+    default.all.file_handler:
+      enabled: true
+    default.err.file_handler:
+      enabled: true
+    default.all.json_handler:
+      enabled: true
+    default.err.json_handler:
+      enabled: true
+  extra:
+    http_std_debug_format: '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
+    http_std_msg_format: '<n><w>[{request_id}]</w></n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}" {status_code} {content_length}B {response_time}ms'
+    http_file_enabled: true
+    http_file_format: '{client_host} {request_id} {user_id} [{datetime}] "{method} {url_path} HTTP/{http_version}" {status_code} {content_length} "{h_referer}" "{h_user_agent}" {response_time}'
+    http_file_tz: "localtime"
+    http_log_path: "http/{app_name}.http.access.log"
+    http_err_path: "http/{app_name}.http.err.log"
+    http_json_enabled: true
+    http_json_path: "http.json/{app_name}.http.json.access.log"
+    http_json_err_path: "http.json/{app_name}.http.json.err.log"
+```
+
+[**`.env`**](./examples/.env):
+
+```sh
+ENV=development
+DEBUG=true
+```
+
+[**`logger.py`**](./examples/logger.py):
+
+```python
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from loguru import Record
+
+from beans_logging import Logger, LoggerLoader
+from beans_logging_fastapi import (
+    add_http_file_handler,
+    add_http_file_json_handler,
+    http_file_format,
+)
+
+logger_loader = LoggerLoader()
+logger: Logger = logger_loader.load()
+
+
+def _http_file_format(record: "Record") -> str:
+    _format = http_file_format(
+        record=record,
+        msg_format=logger_loader.config.extra.http_file_format,  # type: ignore
+        tz=logger_loader.config.extra.http_file_tz,  # type: ignore
+    )
+    return _format
+
+
+if logger_loader.config.extra.http_file_enabled:  # type: ignore
+    add_http_file_handler(
+        logger_loader=logger_loader,
+        log_path=logger_loader.config.extra.http_log_path,  # type: ignore
+        err_path=logger_loader.config.extra.http_err_path,  # type: ignore
+        formatter=_http_file_format,
+    )
+
+if logger_loader.config.extra.http_json_enabled:  # type: ignore
+    add_http_file_json_handler(
+        logger_loader=logger_loader,
+        log_path=logger_loader.config.extra.http_json_path,  # type: ignore
+        err_path=logger_loader.config.extra.http_json_err_path,  # type: ignore
+    )
+
+
+__all__ = [
+    "logger",
+    "logger_loader",
+]
+```
+
+[**`main.py`**](./examples/main.py):
+
+```python
+#!/usr/bin/env python
+
+from typing import Union
+from contextlib import asynccontextmanager
+
+import uvicorn
+from dotenv import load_dotenv
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import RedirectResponse
+
+load_dotenv()
+
+from beans_logging_fastapi import (
+    HttpAccessLogMiddleware,
+    RequestHTTPInfoMiddleware,
+    ResponseHTTPInfoMiddleware,
+)
+
+from logger import logger, logger_loader
+from __version__ import __version__
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    logger.info("Preparing to startup...")
+    logger.success("Finished preparation to startup.")
+    logger.info(f"API version: {__version__}")
+
+    yield
+    logger.info("Praparing to shutdown...")
+    logger.success("Finished preparation to shutdown.")
+
+
+app = FastAPI(lifespan=lifespan, version=__version__)
+
+app.add_middleware(ResponseHTTPInfoMiddleware)
+app.add_middleware(
+    HttpAccessLogMiddleware,
+    debug_format=logger_loader.config.extra.http_std_debug_format,  # type: ignore
+    msg_format=logger_loader.config.extra.http_std_msg_format,  # type: ignore
+)
+app.add_middleware(
+    RequestHTTPInfoMiddleware, has_proxy_headers=True, has_cf_headers=True
+)
+
+
+@app.get("/")
+def root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.get("/continue", status_code=100)
+def get_continue():
+    return {}
+
+
+@app.get("/redirect")
+def redirect():
+    return RedirectResponse("/")
+
+
+@app.get("/error")
+def error():
+    raise HTTPException(status_code=500)
+
+
+if __name__ == "__main__":
+    uvicorn.run(
+        app="main:app",
+        host="0.0.0.0",
+        port=8000,
+        access_log=False,
+        server_header=False,
+        proxy_headers=True,
+        forwarded_allow_ips="*",
+    )
+```
+
+Run the [**`examples`**](./examples):
+
+```sh
+cd ./examples
+# Install python dependencies for examples:
+pip install -r ./requirements.txt
+
+uvicorn main:app --host=0.0.0.0 --port=8000
+```
+
+**Output**:
+
+```txt
+[2025-12-01 00:00:00.735 +09:00 | TRACE | beans_logging._intercept:96]: Intercepted modules: ['potato_util.io', 'concurrent', 'potato_util', 'fastapi', 'uvicorn.error', 'dotenv.main', 'potato_util._base', 'watchfiles.watcher', 'dotenv', 'potato_util.io._sync', 'asyncio', 'uvicorn', 'concurrent.futures', 'watchfiles', 'watchfiles.main']; Muted modules: ['uvicorn.access'];
+[2025-12-01 00:00:00.735 +09:00 | INFO  | uvicorn.server:84]: Started server process [13580]
+[2025-12-01 00:00:00.735 +09:00 | INFO  | uvicorn.lifespan.on:48]: Waiting for application startup.
+[2025-12-01 00:00:00.735 +09:00 | INFO  | main:25]: Preparing to startup...
+[2025-12-01 00:00:00.735 +09:00 | OK    | main:26]: Finished preparation to startup.
+[2025-12-01 00:00:00.735 +09:00 | INFO  | main:27]: API version: 0.0.0
+[2025-12-01 00:00:00.735 +09:00 | INFO  | uvicorn.lifespan.on:62]: Application startup complete.
+[2025-12-01 00:00:00.735 +09:00 | INFO  | uvicorn.server:216]: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
+[2025-12-01 00:00:00.736 +09:00 | DEBUG | anyio._backends._asyncio:986]: [4386400aab364895ba272f3200d2a778] 127.0.0.1 - "GET / HTTP/1.1"
+[2025-12-01 00:00:00.736 +09:00 | OK    | anyio._backends._asyncio:986]: [4386400aab364895ba272f3200d2a778] 127.0.0.1 - "GET / HTTP/1.1" 200 17B 0.9ms
+^C[2025-12-01 00:00:00.750 +09:00 | INFO  | uvicorn.server:264]: Shutting down
+[2025-12-01 00:00:00.750 +09:00 | INFO  | uvicorn.lifespan.on:67]: Waiting for application shutdown.
+[2025-12-01 00:00:00.750 +09:00 | INFO  | main:30]: Praparing to shutdown...
+[2025-12-01 00:00:00.750 +09:00 | OK    | main:31]: Finished preparation to shutdown.
+[2025-12-01 00:00:00.750 +09:00 | INFO  | uvicorn.lifespan.on:76]: Application shutdown complete.
+[2025-12-01 00:00:00.750 +09:00 | INFO  | uvicorn.server:94]: Finished server process [13580]
+```
+
+👍
+
+---
+
+## ⚙️ Configuration
+
+[**`templates/configs/config.yml`**](./templates/configs/config.yml):
+
+```yaml
+logger:
+  # app_name: "app"
+  default:
+    level:
+      base: INFO
+      err: WARNING
+    format_str: "[{time:YYYY-MM-DD HH:mm:ss.SSS Z} | {extra[level_short]:<5} | {name}:{line}]: {message}"
+    file:
+      logs_dir: "./logs"
+      rotate_size: 10000000
+      rotate_time: "00:00:00"
+      retention: 90
+      encoding: utf8
+    custom_serialize: false
+  intercept:
+    enabled: true
+    only_base: false
+    ignore_modules: []
+    include_modules: []
+    mute_modules: ["uvicorn.access"]
+  handlers:
+    default.all.std_handler:
+      type: STD
+      format: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{extra[level_short]:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>"
+      colorize: true
+      enabled: true
+    default.all.file_handler:
+      type: FILE
+      sink: "{app_name}.all.log"
+      enabled: true
+    default.err.file_handler:
+      type: FILE
+      sink: "{app_name}.err.log"
+      error: true
+      enabled: true
+    default.all.json_handler:
+      type: FILE
+      sink: "json/{app_name}.json.all.log"
+      serialize: true
+      enabled: true
+    default.err.json_handler:
+      type: FILE
+      sink: "json/{app_name}.json.err.log"
+      serialize: true
+      error: true
+      enabled: true
+  extra:
+    http_std_debug_format: '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
+    http_std_msg_format: '<n><w>[{request_id}]</w></n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}" {status_code} {content_length}B {response_time}ms'
+    http_file_enabled: true
+    http_file_format: '{client_host} {request_id} {user_id} [{datetime}] "{method} {url_path} HTTP/{http_version}" {status_code} {content_length} "{h_referer}" "{h_user_agent}" {response_time}'
+    http_file_tz: "localtime"
+    http_log_path: "http/{app_name}.http.access.log"
+    http_err_path: "http/{app_name}.http.err.log"
+    http_json_enabled: true
+    http_json_path: "http.json/{app_name}.http.json.access.log"
+    http_json_err_path: "http.json/{app_name}.http.json.err.log"
+```
+
+### 🌎 Environment Variables
+
+[**`.env.example`**](./.env.example):
+
+```sh
+# ENV=LOCAL
+# DEBUG=false
+# TZ=UTC
+```
+
+---
+
+## 🧪 Running Tests
+
+To run tests, run the following command:
+
+```sh
+# Install python test dependencies:
+pip install .[test]
+
+# Run tests:
+python -m pytest -sv -o log_cli=true
+# Or use the test script:
+./scripts/test.sh -l -v -c
+```
+
+## 🏗️ Build Package
+
+To build the python package, run the following command:
+
+```sh
+# Install python build dependencies:
+pip install -r ./requirements/requirements.build.txt
+
+# Build python package:
+python -m build
+# Or use the build script:
+./scripts/build.sh
+```
+
+## 📝 Generate Docs
+
+To build the documentation, run the following command:
+
+```sh
+# Install python documentation dependencies:
+pip install -r ./requirements/requirements.docs.txt
+
+# Serve documentation locally (for development):
+mkdocs serve -a 0.0.0.0:8000
+# Or use the docs script:
+./scripts/docs.sh
+
+# Or build documentation:
+mkdocs build
+# Or use the docs script:
+./scripts/docs.sh -b
+```
+
+## 📚 Documentation
+
+- [Docs](./docs)
+
+---
+
+## 📑 References
+
+- <https://packaging.python.org/en/latest/tutorials/packaging-projects>
+- <https://python-packaging.readthedocs.io/en/latest>

beans_logging_fastapi-2.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+beans_logging_fastapi/__init__.py,sha256=hTuW6GTdPinZ1qamna7N0RsElfVJnkkOI0iLnMbQ7B8,865
+beans_logging_fastapi/__version__.py,sha256=_7OlQdbVkK4jad0CLdpI0grT-zEAb-qgFmH5mFzDXiA,22
+beans_logging_fastapi/_async_log.py,sha256=01VJ1cnzacDlIjiScm0hubhkj0xkeU5pBB_0fPJS-5w,3478
+beans_logging_fastapi/_base.py,sha256=mRAUxEBYU00IrE4QgaYDqrUxHhCiKp3cEzVNy2bDsM0,4259
+beans_logging_fastapi/_filters.py,sha256=hBhHqCWJr7c2CA7uDAje8R8x9RtpCcBHZSC6xuXLYDs,622
+beans_logging_fastapi/_formats.py,sha256=J5tu9QwU6jCNZvMt7y5WpfcM862GLvgGHGfvjh5k2T4,2600
+beans_logging_fastapi/_handlers.py,sha256=_v4VigZM2j1kphUPViKp21DiwR3CB1mM6MXz_NUAE7c,3128
+beans_logging_fastapi/_middlewares.py,sha256=gcx8NrgWv1OMFln4nvnaPgY6Np92Nv6OTMJf97EcH08,9558
+beans_logging_fastapi-2.0.0.dist-info/licenses/LICENSE.txt,sha256=CUTK-r0BWIg1r0bBiemAcMhakgV0N7HuRhw6rQ-A9A4,1074
+beans_logging_fastapi-2.0.0.dist-info/METADATA,sha256=aM3l5OHfrFiy1RYGOYHmOMl7fG0iTGmgXd1tV1F6oLQ,16031
+beans_logging_fastapi-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+beans_logging_fastapi-2.0.0.dist-info/top_level.txt,sha256=PXoqVo9HGfyd81gDi3D2mXMYPM9JKITL0ycFftJxlhw,22
+beans_logging_fastapi-2.0.0.dist-info/RECORD,,

{beans_logging_fastapi-1.1.0.dist-info → beans_logging_fastapi-2.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

beans_logging_fastapi-1.1.0.dist-info/LICENCE.txt → beans_logging_fastapi-2.0.0.dist-info/licenses/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Batkhuu Byambajav
+Copyright (c) 2025 Batkhuu Byambajav
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{beans_logging_fastapi-1.1.0.dist-info → beans_logging_fastapi-2.0.0.dist-info}/top_level.txt

@@ -1,2 +1 @@
 beans_logging_fastapi
-tests