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

{beans_logging_fastapi-2.0.0.dist-info → beans_logging_fastapi-4.0.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 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.
+Version: 4.0.0
+Summary: This is a HTTP access log module for FastAPI 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
@@ -22,7 +22,7 @@ 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
+Requires-Dist: beans-logging<10.0.0,>=9.0.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"
@@ -55,6 +55,7 @@ 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"
+Requires-Dist: fastapi[standard]<1.0.0,>=0.99.1; extra == "dev"
 Dynamic: license-file
 
 # FastAPI Logging (beans-logging-fastapi)
@@ -63,12 +64,15 @@ Dynamic: license-file
 [![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.
+This is a HTTP access log module for **FastAPI** based on **'beans-logging'** package.
 
 ## ✨ Features
 
 - **Logger** based on **'beans-logging'** package
 - **FastAPI** HTTP access logging **middleware**
+- HTTP access log as structured JSON format
+- Predefined **configuration** for HTTP access logs
+- Easy to **install** and **use**
 
 ---
 
@@ -160,28 +164,35 @@ To use `beans_logging_fastapi`:
 ```yaml
 logger:
   app_name: "fastapi-app"
+  default:
+    level:
+      base: TRACE
+  http:
+    std:
+      format_str: '<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'
+      err_format_str: '<n><w>[{request_id}]</w></n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}" <n>{status_code}</n>'
+      debug_format_str: '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
+    file:
+      format_str: '{client_host} {request_id} {user_id} [{datetime}] "{method} {url_path} HTTP/{http_version}" {status_code} {content_length} "{h_referer}" "{h_user_agent}" {response_time}'
+      tz: "localtime"
+    headers:
+      has_proxy: false
+      has_cf: false
   intercept:
     mute_modules: ["uvicorn.access"]
   handlers:
-    default.all.file_handler:
+    http.access.file_handler:
       enabled: true
-    default.err.file_handler:
+      sink: "http/{app_name}.http-access.log"
+    http.err.file_handler:
       enabled: true
-    default.all.json_handler:
+      sink: "http/{app_name}.http-err.log"
+    http.access.json_handler:
       enabled: true
-    default.err.json_handler:
+      sink: "http.json/{app_name}.http-access.json.log"
+    http.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"
+      sink: "http.json/{app_name}.http-err.json.log"
 ```
 
 [**`.env`**](./examples/.env):
@@ -191,140 +202,197 @@ ENV=development
 DEBUG=true
 ```
 
-[**`logger.py`**](./examples/logger.py):
+[**`config.py`**](./examples/config.py):
 
 ```python
-from typing import TYPE_CHECKING
+import os
 
-if TYPE_CHECKING:
-    from loguru import Record
+from pydantic_settings import BaseSettings
 
-from beans_logging import Logger, LoggerLoader
-from beans_logging_fastapi import (
-    add_http_file_handler,
-    add_http_file_json_handler,
-    http_file_format,
-)
+from potato_util import io as io_utils
+from beans_logging_fastapi import LoggerConfigPM
 
-logger_loader = LoggerLoader()
-logger: Logger = logger_loader.load()
 
+_config_path = os.path.join(os.getcwd(), "configs", "logger.yml")
+_config_data = {}
+if os.path.isfile(_config_path):
+    _config_data = io_utils.read_config_file(config_path=_config_path)
 
-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
 
+class MainConfig(BaseSettings):
+    logger: LoggerConfigPM = LoggerConfigPM()
 
-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
-    )
+config = MainConfig(**_config_data)
 
 
 __all__ = [
-    "logger",
-    "logger_loader",
+    "MainConfig",
+    "config",
 ]
 ```
 
-[**`main.py`**](./examples/main.py):
+[**`logger.py`**](./examples/logger.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__}")
+from beans_logging_fastapi import logger
 
-    yield
-    logger.info("Praparing to shutdown...")
-    logger.success("Finished preparation to shutdown.")
+__all__ = [
+    "logger",
+]
+```
 
+[**`router.py`**](./examples/router.py):
 
-app = FastAPI(lifespan=lifespan, version=__version__)
+```python
+from pydantic import validate_call
+from fastapi import FastAPI, APIRouter, HTTPException
+from fastapi.responses import RedirectResponse
 
-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
-)
+router = APIRouter()
 
 
-@app.get("/")
+@router.get("/")
 def root():
     return {"Hello": "World"}
 
 
-@app.get("/items/{item_id}")
-def read_item(item_id: int, q: Union[str, None] = None):
+@router.get("/items/{item_id}")
+def read_item(item_id: int, q: str | None = None):
     return {"item_id": item_id, "q": q}
 
 
-@app.get("/continue", status_code=100)
+@router.get("/continue", status_code=100)
 def get_continue():
     return {}
 
 
-@app.get("/redirect")
+@router.get("/redirect")
 def redirect():
     return RedirectResponse("/")
 
 
-@app.get("/error")
+@router.get("/error")
 def error():
     raise HTTPException(status_code=500)
 
 
-if __name__ == "__main__":
+@validate_call(config={"arbitrary_types_allowed": True})
+def add_routers(app: FastAPI) -> None:
+    """Add routers to FastAPI app.
+
+    Args:
+        app (FastAPI): FastAPI app instance.
+    """
+
+    app.include_router(router)
+
+    return
+
+
+__all__ = ["add_routers"]
+```
+
+[**`bootstrap.py`**](./examples/bootstrap.py):
+
+```python
+# Standard libraries
+from typing import Any
+from collections.abc import Callable
+
+# Third-party libraries
+import uvicorn
+from uvicorn._types import ASGIApplication
+from pydantic import validate_call
+from fastapi import FastAPI
+
+from beans_logging_fastapi import add_logger
+
+# Internal modules
+from __version__ import __version__
+from config import config
+from lifespan import lifespan
+from router import add_routers
+
+
+def create_app() -> FastAPI:
+    """Create FastAPI application instance.
+
+    Returns:
+        FastAPI: FastAPI application instance.
+    """
+
+    app = FastAPI(lifespan=lifespan, version=__version__)
+
+    # Add logger before any other components:
+    add_logger(app=app, config=config.logger)
+
+    # Add any other components after logger:
+    add_routers(app=app)
+
+    return app
+
+
+@validate_call(config={"arbitrary_types_allowed": True})
+def run_server(
+    app: FastAPI | ASGIApplication | Callable[..., Any] | str = "main:app",
+) -> None:
+    """Run uvicorn server.
+
+    Args:
+        app (Union[ASGIApplication, str], optional): ASGI application instance or module path.
+    """
+
     uvicorn.run(
-        app="main:app",
-        host="0.0.0.0",
+        app=app,
+        host="0.0.0.0",  # nosec B104
         port=8000,
-        access_log=False,
+        access_log=False,  # Disable default uvicorn access log
         server_header=False,
-        proxy_headers=True,
+        proxy_headers=False,
         forwarded_allow_ips="*",
     )
+
+    return
+
+
+__all__ = [
+    "create_app",
+    "run_server",
+]
+```
+
+[**`main.py`**](./examples/main.py):
+
+```python
+#!/usr/bin/env python
+
+# Third-party libraries
+from dotenv import load_dotenv
+
+load_dotenv(override=True)
+
+# Internal modules
+from bootstrap import create_app, run_server  # noqa: E402
+from logger import logger  # noqa: E402
+
+
+app = create_app()
+
+
+def main() -> None:
+    """Main function."""
+
+    run_server(app=app)
+    return
+
+
+if __name__ == "__main__":
+    logger.info("Starting server from 'main.py'...")
+    main()
+
+
+__all__ = ["app"]
 ```
 
 Run the [**`examples`**](./examples):
@@ -340,22 +408,24 @@ 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]
+[2026-01-01 12:00:00.002 +09:00 | TRACE | beans_logging.intercepters:96]: Intercepted modules: ['uvicorn', 'potato_util', 'fastapi', 'uvicorn.error', 'watchfiles.watcher', 'concurrent.futures', 'watchfiles', 'asyncio', 'concurrent', 'potato_util._base', 'dotenv', 'dotenv.main', 'watchfiles.main', 'potato_util.io', 'potato_util.io._sync']; Muted modules: ['uvicorn.access'];
+[2026-01-01 12:00:00.003 +09:00 | INFO  | uvicorn.server:84]: Started server process [88375]
+[2026-01-01 12:00:00.003 +09:00 | INFO  | uvicorn.lifespan.on:48]: Waiting for application startup.
+[2026-01-01 12:00:00.004 +09:00 | TRACE | lifespan:19]: TRACE diagnosis is ON!
+[2026-01-01 12:00:00.004 +09:00 | DEBUG | lifespan:20]: DEBUG mode is ON!
+[2026-01-01 12:00:00.004 +09:00 | INFO  | lifespan:21]: Preparing to startup...
+[2026-01-01 12:00:00.004 +09:00 | OK    | lifespan:24]: Finished preparation to startup.
+[2026-01-01 12:00:00.004 +09:00 | INFO  | lifespan:25]: Version: 0.0.0
+[2026-01-01 12:00:00.005 +09:00 | INFO  | uvicorn.lifespan.on:62]: Application startup complete.
+[2026-01-01 12:00:00.006 +09:00 | INFO  | uvicorn.server:216]: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
+[2026-01-01 12:00:01.775 +09:00 | DEBUG ]: [80138308bc00406387fb804cf6cc0e11] 127.0.0.1 - "GET / HTTP/1.1"
+[2026-01-01 12:00:01.783 +09:00 | OK    ]: [80138308bc00406387fb804cf6cc0e11] 127.0.0.1 - "GET / HTTP/1.1" 200 17B 5.7ms
+^C[2026-01-01 12:00:02.368 +09:00 | INFO  | uvicorn.server:264]: Shutting down
+[2026-01-01 12:00:02.470 +09:00 | INFO  | uvicorn.lifespan.on:67]: Waiting for application shutdown.
+[2026-01-01 12:00:02.472 +09:00 | INFO  | lifespan:29]: Preparing to shutdown...
+[2026-01-01 12:00:02.472 +09:00 | OK    | lifespan:31]: Finished preparation to shutdown.
+[2026-01-01 12:00:02.473 +09:00 | INFO  | uvicorn.lifespan.on:76]: Application shutdown complete.
+[2026-01-01 12:00:02.474 +09:00 | INFO  | uvicorn.server:94]: Finished server process [88375]
 ```
 
 👍
@@ -368,7 +438,7 @@ uvicorn main:app --host=0.0.0.0 --port=8000
 
 ```yaml
 logger:
-  # app_name: "app"
+  # app_name: fastapi-app
   default:
     level:
       base: INFO
@@ -380,50 +450,74 @@ logger:
       rotate_time: "00:00:00"
       retention: 90
       encoding: utf8
-    custom_serialize: false
+    use_custom_serialize: false
+  http:
+    std:
+      msg_format_str: '<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'
+      err_msg_format_str: '<n><w>[{request_id}]</w></n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}" <n>{status_code}</n>'
+      debug_msg_format_str: '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
+    file:
+      format_str: '{client_host} {request_id} {user_id} [{datetime}] "{method} {url_path} HTTP/{http_version}" {status_code} {content_length} "{h_referer}" "{h_user_agent}" {response_time}'
+      tz: localtime
+    headers:
+      has_proxy: false
+      has_cf: false
   intercept:
     enabled: true
     only_base: false
     ignore_modules: []
     include_modules: []
-    mute_modules: ["uvicorn.access"]
+    mute_modules: [uvicorn.access]
   handlers:
-    default.all.std_handler:
-      type: STD
+    all_std_handler:
+      enabled: true
+      h_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
+    all_file_handler:
       enabled: true
-    default.all.file_handler:
-      type: FILE
+      h_type: FILE
       sink: "{app_name}.all.log"
+    err_file_handler:
       enabled: true
-    default.err.file_handler:
-      type: FILE
+      h_type: FILE
       sink: "{app_name}.err.log"
       error: true
+    all_json_handler:
       enabled: true
-    default.all.json_handler:
-      type: FILE
-      sink: "json/{app_name}.json.all.log"
+      h_type: FILE
+      sink: "json/{app_name}.all.json.log"
       serialize: true
+    err_json_handler:
       enabled: true
-    default.err.json_handler:
-      type: FILE
-      sink: "json/{app_name}.json.err.log"
+      h_type: FILE
+      sink: "json/{app_name}.err.json.log"
       serialize: true
       error: true
+    http_access_std_handler:
+      enabled: true
+      h_type: STD
+      format: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{extra[level_short]:<5}</level> ]: <level>{message}</level>"
+      colorize: true
+    http_access_file_handler:
       enabled: true
+      h_type: FILE
+      sink: "http/{app_name}.http-access.log"
+    http_err_file_handler:
+      enabled: true
+      h_type: FILE
+      sink: "http/{app_name}.http-err.log"
+      error: true
+    http_access_json_handler:
+      enabled: true
+      h_type: FILE
+      sink: "http.json/{app_name}.http-access.json.log"
+    http_err_json_handler:
+      enabled: true
+      h_type: FILE
+      sink: "http.json/{app_name}.http-err.json.log"
+      error: 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
@@ -475,7 +569,7 @@ To build the documentation, run the following command:
 pip install -r ./requirements/requirements.docs.txt
 
 # Serve documentation locally (for development):
-mkdocs serve -a 0.0.0.0:8000
+mkdocs serve -a 0.0.0.0:8000 --livereload
 # Or use the docs script:
 ./scripts/docs.sh
 

beans_logging_fastapi-4.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+beans_logging_fastapi/__init__.py,sha256=5nnhUvYdtaMSZ1t549nhYfxOzcKsC4YPx8nEqJWfZYw,225
+beans_logging_fastapi/__version__.py,sha256=SQa6Ci17DORmGXi_wkOW9pPlUojF-qtjH6NV1WOThsU,22
+beans_logging_fastapi/_async.py,sha256=8WncsgrofroUm1z8kgUkfZYP9vwrr9Lri31PrR0NTko,3495
+beans_logging_fastapi/_core.py,sha256=Tsc99l6i0Cryrh-UJ-uUfW5FG1O3PtQjE9QNBuJ3Eyk,2915
+beans_logging_fastapi/config.py,sha256=GvEoPBexT0HXFhqd1vbiJ-XCwkBPwPqYmL33tJTGkK0,5687
+beans_logging_fastapi/constants.py,sha256=SgiS27cpih3QHejlf6db3ZnFBEEzJzC0T62l8B0ZXxs,695
+beans_logging_fastapi/filters.py,sha256=p6DgcmSByDwkw0i30AYczi26nPxWsPRfzaY8LhN1Q1I,1681
+beans_logging_fastapi/formats.py,sha256=7zr-EIYg9vRs1zlhY9If68X9rC0xDBNG9Xc7QH9_elg,2590
+beans_logging_fastapi/middlewares.py,sha256=ZOmp5oCg9RqnetSOBvwdQlOy87ix76ayS6HosbPG62k,14158
+beans_logging_fastapi-4.0.0.dist-info/licenses/LICENSE.txt,sha256=CUTK-r0BWIg1r0bBiemAcMhakgV0N7HuRhw6rQ-A9A4,1074
+beans_logging_fastapi-4.0.0.dist-info/METADATA,sha256=qOii9qAR3j67H8M3A1CW3-n4bfKTDFGNAvhwzD3FEYc,17459
+beans_logging_fastapi-4.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+beans_logging_fastapi-4.0.0.dist-info/top_level.txt,sha256=PXoqVo9HGfyd81gDi3D2mXMYPM9JKITL0ycFftJxlhw,22
+beans_logging_fastapi-4.0.0.dist-info/RECORD,,

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

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

beans_logging_fastapi/_base.py

@@ -1,107 +0,0 @@
-from typing import Any
-
-from fastapi import Request, Response
-from fastapi.concurrency import run_in_threadpool
-from starlette.middleware.base import BaseHTTPMiddleware
-
-from beans_logging import logger
-
-
-class HttpAccessLogMiddleware(BaseHTTPMiddleware):
-    """Http access log middleware for FastAPI.
-
-    Inherits:
-        BaseHTTPMiddleware: Base HTTP middleware class from starlette.
-
-    Attributes:
-        _DEBUG_FORMAT     (str ): Default http access log debug message format. Defaults to
-            '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'.
-        _MSG_FORMAT       (str ): Default http access log message format. Defaults to
-            '<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'.
-
-        debug_format      (str ): Http access log debug message format. Defaults to
-                                    `HttpAccessLogMiddleware._DEBUG_FORMAT`.
-        msg_format        (str ): Http access log message format. Defaults to `HttpAccessLogMiddleware._MSG_FORMAT`.
-        use_debug_log     (bool): If True, use debug log to log http access log. Defaults to True.
-    """
-
-    _DEBUG_FORMAT = '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
-    _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'
-    )
-
-    def __init__(
-        self,
-        app,
-        debug_format: str = _DEBUG_FORMAT,
-        msg_format: str = _MSG_FORMAT,
-        use_debug_log: bool = True,
-    ):
-        super().__init__(app)
-        self.debug_format = debug_format
-        self.msg_format = msg_format
-        self.use_debug_log = use_debug_log
-
-    async def dispatch(self, request: Request, call_next) -> Response:
-        _logger = logger.opt(colors=True, record=True)
-
-        _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
-
-        # Debug log:
-        if self.use_debug_log:
-            _debug_msg = self.debug_format.format(**_http_info)
-
-            # _logger.debug(_debug_msg)
-            await run_in_threadpool(
-                _logger.debug,
-                _debug_msg,
-            )
-        # Debug log
-
-        # Process request:
-        response: Response = await call_next(request)
-        # Response processed.
-
-        if hasattr(request.state, "http_info") and isinstance(
-            request.state.http_info, dict
-        ):
-            _http_info: dict[str, Any] = request.state.http_info
-
-        # Http access log:
-        _LEVEL = "INFO"
-        _msg_format = self.msg_format
-        if _http_info["status_code"] < 200:
-            _LEVEL = "DEBUG"
-            _msg_format = f'<d>{_msg_format.replace("{status_code}", "<n><b><k>{status_code}</k></b></n>")}</d>'
-        elif (200 <= _http_info["status_code"]) and (_http_info["status_code"] < 300):
-            _LEVEL = "SUCCESS"
-            _msg_format = f'<w>{_msg_format.replace("{status_code}", "<lvl>{status_code}</lvl>")}</w>'
-        elif (300 <= _http_info["status_code"]) and (_http_info["status_code"] < 400):
-            _LEVEL = "INFO"
-            _msg_format = f'<d>{_msg_format.replace("{status_code}", "<n><b><c>{status_code}</c></b></n>")}</d>'
-        elif (400 <= _http_info["status_code"]) and (_http_info["status_code"] < 500):
-            _LEVEL = "WARNING"
-            _msg_format = _msg_format.replace("{status_code}", "<r>{status_code}</r>")
-        elif 500 <= _http_info["status_code"]:
-            _LEVEL = "ERROR"
-            _msg_format = (
-                f'{_msg_format.replace("{status_code}", "<n>{status_code}</n>")}'
-            )
-
-        _msg = _msg_format.format(**_http_info)
-        # _logger.bind(http_info=_http_info).log(_LEVEL, _msg)
-        await run_in_threadpool(_logger.bind(http_info=_http_info).log, _LEVEL, _msg)
-        # Http access log
-
-        return response
-
-
-__all__ = [
-    "HttpAccessLogMiddleware",
-]